CloudManager

The CloudManager class manages detection of IP addresses from major cloud providers.

Class Definition

class CloudManager:
    def __init__(self):
        """
        Initialize cloud IP ranges manager.
        """
        self.ip_ranges: Dict[str, Set[ipaddress.IPv4Network]] = {}
        self.refresh()

Redis Integration

When Redis is enabled, CloudManager automatically: - Caches cloud IP ranges in Redis with 1-hour TTL - Uses cached ranges if available - Synchronizes ranges across instances

Methods

refresh

def refresh(self):
    """
    Refresh IP ranges from all cloud providers.
    """

is_cloud_ip

def is_cloud_ip(
    self,
    ip: str,
    providers: Set[str]
) -> bool:
    """
    Check if an IP belongs to specified cloud providers.

    Args:
        ip: IP address to check
        providers: Set of provider names ('AWS', 'GCP', 'Azure')
    """

Usage Example

from guard.handlers.cloud_handler import cloud_handler

# Refresh IP ranges
cloud_handler.refresh()

# Check if IP is from AWS
is_aws = cloud_handler.is_cloud_ip("54.239.28.85", {"AWS"})

# Check multiple providers
is_cloud = cloud_handler.is_cloud_ip(
    "35.186.224.25",
    {"AWS", "GCP", "Azure"}
)