IPBanManager¶

The IPBanManager class handles temporary IP bans in your Flask application.

Overview¶

from flaskapi_guard.handlers.ipban_handler import IPBanManager

ip_ban_manager = IPBanManager()

The IPBanManager uses an in-memory cache to track banned IPs and their ban durations.

Distributed Banning¶

When Redis is enabled:

Bans are shared across instances
Ban expiration is handled automatically
Supports atomic ban operations

# Cluster-wide ban
ip_ban_manager.ban_ip("192.168.1.1", 3600, distributed=True)

# Check ban status across cluster
is_banned = ip_ban_manager.is_ip_banned("192.168.1.1", check_redis=True)

Methods¶

ban_ip¶

Ban an IP address for a specified duration.

def ban_ip(ip: str, duration: int) -> None

Parameters: - ip: The IP address to ban - duration: Ban duration in seconds

Example:

ip_ban_manager.ban_ip("192.168.1.1", 3600)  # Ban for 1 hour

is_ip_banned¶

Check if an IP address is currently banned.

def is_ip_banned(ip: str) -> bool

Parameters: - ip: The IP address to check

Returns: - bool: True if the IP is banned, False otherwise

Example:

is_banned = ip_ban_manager.is_ip_banned("192.168.1.1")

reset¶

Reset all banned IPs.

def reset() -> None

Example:

ip_ban_manager.reset()

Usage with FlaskAPIGuard¶

The IPBanManager is automatically integrated when you use the FlaskAPIGuard extension:

from flask import Flask
from flaskapi_guard.extension import FlaskAPIGuard
from flaskapi_guard.models import SecurityConfig

app = Flask(__name__)

config = SecurityConfig(
    auto_ban_threshold=5,  # Ban after 5 suspicious requests
    auto_ban_duration=3600  # Ban for 1 hour
)

FlaskAPIGuard(app, config=config)