Sentry
Real-time access monitor and inline edge WAF with AI-powered threat detection
Sentry
Sentry is a real-time access monitor and inline edge WAF for services exposed to the internet. In passive mode it watches nginx (access logs), syslog, the Cloudflare Logs API and TCP capture; in inline mode it becomes the reverse proxy in front of the application (HTTP 80/443 with TLS, HTTP/2, PoW challenge and body inspection). It uses rules + heuristics + AI to detect malicious payloads, suspicious behavior and invalid routes, computes a risk level per request/IP and acts: block, challenge, rate-limit, kernel bans, webhooks.
Key features
- Inline WAF: an
axumreverse proxy that rules before proxying (Block→403, RateLimit→429, Challenge→PoW page), with a per-IP block fast-path and a block table shared across nodes. - TLS 443 + JA3/JA4: HTTPS termination, ClientHello telemetry (JA3/JA4 fingerprint, SNI, ALPN) and HTTP/2 via ALPN.
- Multi-source: plugins for nginx, syslog (RFC 5424/3164), Cloudflare Logs, TCP capture with scanner fingerprinting, and non-HTTP protocols via YAML schemas (
sentry-protocol). - Layered detection: deterministic rules engine (DSL + packs) → URL-decoding heuristics → local ONNX AI → optional LLM (OpenRouter/Ollama), with repeat-offender escalation and cross-IP scan→attack correlation.
- Action at every layer: Cloudflare (block/challenge/rate-limit, IPv6 /64), kernel bans (nftables/ipset/firewalld), OPNsense/pfSense, nginx deny + challenge, signed webhooks, community reporting (AbuseIPDB).
- Operable: web dashboard with Argon2id auth + RBAC, ratatui TUI, Prometheus metrics + Grafana, SIEM export (CEF/LEEF/syslog), OS service mode.
- Exposure hardening:
[real_ip]with trusted proxies, rDNS bot verification, DB-backed datasets with hot-reload, header posture (advisory). - Fast: ~4.36 µs/event pipeline (~800× faster than v1), two action lanes and tiered degradation under overload — detection and containment never degrade.
Documentation
- Overview — goals, non-goals, stack and status (F0–F12 concluded).
- Quickstart — Docker, local build, basic configuration.
- Architecture — pipeline, data model, request flow.
- Rules Engine — deterministic rules, DSL, packs, datasets.
- Plugins —
SourceandActiontraits, challenge providers. - AI — heuristics, local ONNX, optional LLM.
- CLI & TUI — command reference and interactive interface.
- Configuration —
sentry.tomlreference. - Reference — crates, modules and types with source links.
- Examples — example configs by scenario.
- Deploy — Docker e Kubernetes.