Saltar para o conteúdo

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.

5 min de leitura

Os três modos lado a lado

ModoBloqueia?Regista?Quando usar
Normal✅ Sim✅ SimProduçã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")✅ SimAntes 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 (ou 429 para 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_blocked sã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:

ResultadoO que aconteceu
BloqueadoModo normal: pedido travado, devolveu 403/429.
DetetadoModo auditoria: pedido passou, mas o WAF teria detetado algo de suspeito.
DesafiadoPedido recebeu um desafio (CAPTCHA-like) em vez de ser bloqueado.
PermitidoMatch 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 a shadow_log() em vez de ngx.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 como audit_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 é:

  1. Liga sombra.
  2. Espera 48 h.
  3. Verifica que waf_shadow:* counters correspondem a tráfego que achas legítimo bloquear.
  4. Passa para normal.
  5. Compara waf_blocked:* (modo normal) com o waf_shadow:* anterior — devem ser similares.

Próximos passos

← Toda a documentação