foxxelabs-sentinel-client

Django client for FoxxeLabs Sentinel — centralised IP threat intelligence. Drop it into a Django project to:

• Block known-bad IPs before they hit your views (SentinelBlockMiddleware).
• Emit 4xx/5xx probe events to Sentinel for scoring (SentinelEmitterMiddleware, fire-and-forget).
• Pull and cache the blocklist hourly (BlocklistCache).

The import package is sentinel_client (the distribution is foxxelabs-sentinel-client).

Install

pip install foxxelabs-sentinel-client

Configure

In settings.py:

SENTINEL_URL = "https://sentinel-foxxelabs.fly.dev"
SENTINEL_API_KEY = "..."            # your project's Sentinel key
SENTINEL_PROJECT_NAME = "my-app"    # identifies this project to Sentinel

MIDDLEWARE = [
    "sentinel_client.middleware.SentinelBlockMiddleware",   # FIRST — blocks before processing
    # ... your other middleware ...
    "sentinel_client.middleware.SentinelEmitterMiddleware", # LAST — reports 4xx/5xx
]

SentinelBlockMiddleware returns 403 for blocklisted IPs; the emitter is fire-and-forget and silently drops errors, so Sentinel downtime has zero impact on request processing.

Resilience

If Sentinel is unreachable, the emitter swallows the error and the blocklist cache retains its last-known-good copy. Your app keeps serving.

License

Proprietary — © FoxxeLabs Limited. All rights reserved.