Modos normal, auditoria e sombra
O WAF tem três modos de operação. Em "normal" bloqueia mesmo. Em "auditoria" observa e regista sem bloquear nada. Em "sombra" decide como decidiria, mas deixa passar — útil para testar regras novas sem risco.
Os três modos lado a lado
| Modo | Bloqueia? | Regista? | Quando usar |
|---|---|---|---|
| Normal | ✅ Sim | ✅ Sim | Produção. É o que queres no dia-a-dia. |
| Auditoria | ❌ Não | ✅ Sim (tudo o que veria como suspeito) | Para perceber o que o WAF detetaria sem afetar visitantes. Bom para diagnóstico inicial. |
| Sombra | ❌ Não (regista como "teria bloqueado") | ✅ Sim | Antes de mudar de modo, ou ao testar regras novas. Vês exatamente o que iria ser bloqueado sem o ser. |
Modo normal (o default)
O WAF avalia cada pedido e:
- Pedido limpo → passa.
- Pedido suspeito → bloqueia com
403(ou429para rate-limit) e regista o evento.
É o modo que queres em produção. Toda a configuração do WAF é desenhada para que o "normal" seja seguro de usar diretamente — se seguires as recomendações de defaults, a taxa de falsos positivos é muito baixa.
Modo auditoria
O WAF avalia cada pedido como se fosse bloquear, mas deixa sempre passar. Em vez disso, regista um evento marcado como auditoria em Atividade → Pedidos bloqueados.
Quando faz sentido:
- Site novo, ainda não conheces o tráfego. Liga auditoria por 24-48 h, observa o que o WAF detetaria, depois ajustas as exceções (regras personalizadas, ips whitelist) antes de passar para normal.
- Após uma mudança grande no site (novo CMS, integração nova, redesign). Garante que nenhuma funcionalidade legítima está a disparar regras antes de bloqueares.
- Investigação de falsos positivos — uma queixa de utilizador, ligas auditoria temporariamente para confirmar se o problema é mesmo do WAF.
Modo sombra
Compromisso entre os outros dois: o WAF decide exatamente como decidiria em modo normal (incluindo o early-exit ao primeiro match decisivo), mas em vez de bloquear, deixa passar e regista o evento como would_have_blocked.
A diferença chave para auditoria: sombra simula o comportamento real de bloqueio. Em auditoria vês "tudo o que poderia ter saltado a atenção". Em sombra vês "exatamente o que teria sido bloqueado".
Quando faz sentido:
- Promoção segura para produção: testas em sombra durante 24-48 h, confirmas que os eventos
would_have_blockedsão todos legítimos (ataques reais, não tráfego de utilizadores), e passas para normal. - Rollouts de regras novas: criaste uma regra personalizada complexa. Em vez de a ativar logo, deixa-a a operar em sombra para ver quantos pedidos teria afetado antes de a tornar real.
- Mudanças de nível de proteção: queres subir de "Equilibrada" para "Alta" mas tens medo de falsos positivos. Sombra revela o impacto antes do switch.
Como interpretar os logs
Em Atividade → Pedidos bloqueados vais ver eventos com diferentes valores na coluna Resultado:
| Resultado | O que aconteceu |
|---|---|
| Bloqueado | Modo normal: pedido travado, devolveu 403/429. |
| Detetado | Modo auditoria: pedido passou, mas o WAF teria detetado algo de suspeito. |
| Desafiado | Pedido recebeu um desafio (CAPTCHA-like) em vez de ser bloqueado. |
| Permitido | Match com uma regra de ação allow ou log (não bloqueia, só regista). |
Em sombra, o resultado aparece como Detetado (mesma classificação que auditoria — o que distingue é a ausência ou presença de early-exit, visível no engine e na regra concreta).
Combinações: posso ter auditoria e sombra ao mesmo tempo?
Tecnicamente sim, mas se ambos estão ligados, auditoria ganha (avalia tudo, sem early-exit). O motivo: operadores que ligam os dois flags normalmente querem máxima visibilidade, não testes pré-rollout. A FortFox respeita essa intuição.
Onde mexer
Proteção → Nível de proteção → Modo de funcionamento (a primeira opção depois da master toggle).
Em mais detalhe técnico
Implementação no motor:
- Normal: chamada à função
evaluate()que early-exits no primeiro match decisivo (action =block). Resposta HTTP 403 + log. - Sombra: mesma função
evaluate()mas o bloqueio é convertido em chamada ashadow_log()em vez dengx.exit(403). Métricas separadas:waf_shadow:<category>e bucket horário. - Auditoria: variante de
evaluate()que não early-exits — itera todas as regras e regista cada match comoaudit_log(). Métrica:waf_audit:<category>.
Métricas no painel: as três variantes têm contadores independentes em Atividade. Podes comparar lado a lado quantos pedidos cada categoria de regra apanhou em cada modo.
Custo de performance: auditoria é o mais caro (avalia tudo, não early-exits). Sombra tem o mesmo custo que normal (early-exit). Normal é o "barato". Para sites de alto tráfego, evita auditoria permanente.
Telemetria de promoção segura: o padrão recomendado é:
- Liga sombra.
- Espera 48 h.
- Verifica que
waf_shadow:*counters correspondem a tráfego que achas legítimo bloquear. - Passa para normal.
- Compara
waf_blocked:*(modo normal) com owaf_shadow:*anterior — devem ser similares.
Próximos passos
- Nível de proteção — depois de saberes os modos, escolhe a agressividade.
- Firewall de aplicação (WAF) — visão geral se ainda não viste.