Arquitetura
Fluxo de uma Requisição
Sequência de estágios do log à ação
Fluxo de uma Requisição
Quando uma linha de access log chega, o Sentry a normaliza em um Event,
envia ao pipeline, que faz fan-out paralelo para heurísticas, IA e validador
de rotas. Os resultados convergem no scorer, que produz um AnalysisResult.
O decisor aplica a política e despacha para as actions.
Detecção de rotas válidas
- Discovery controlado: o usuário fornece rotas válidas via config
(allowlist) ou o Sentry aprende em modo
learn(período de baseline sem ataques). - Estrutura: trie de paths com métodos permitidos + parâmetros esperados.
- Sinais derivados:
- Rota inexistente → +pontos (scan/directory brute-force).
- Muitos 404 do mesmo IP em janela → scan behavior.
- Hits em paths sensíveis (
/.env,/wp-admin,/api/admin) mesmo inexistentes → peso alto.
- Saída: relatório
sentry routesmostrando rotas conhecidas vs. tentadas.
Integração Cloudflare (sinergia de challenge)
- Tokens via env (
SENTRY_CF_TOKEN,SENTRY_CF_ZONE). - Cache local de IPs já desafiados (TTL configurável) para não bombardear a API.
- Modos:
block,js_challenge,managed_challenge,rate_limit. - Importante: na fase 1 o Sentry é read-only + Cloudflare action. Não
há inline proxy. Inline é fase futura (
sentry-proxy).