waf-policy/1.1.0 · atualizado em 9 de jul. de 2026

WAF adaptativo

Como interpretar regras, correspondências e verificação progressiva conforme a prioridade.

O ADDA WAF avalia solicitações em rotas sensíveis, identifica alterações ou sondagens e responde com uma medida proporcional.

A maturidade operacional do filtro web não depende apenas de bloquear. Também exige diferenciar exploração, erro legítimo, abuso repetido e pressão coordenada, preservando a explicação e a possibilidade de revisão.

O WAF é complementado por três superfícies táticas: forms-shield para capturas e formulários, api-shield para rotas de integração e login-shield para acessos sensíveis.

Checklist

• Inspecionar regras ativas e versões publicadas.
• Revisar correspondências em solicitações de teste.
• Escalar para evidence registrada quando a ação for bloquear.

Início rápido

1. Teste uma rota sensível com um caso controlado.
2. Leia matchedRules e decision antes de presumir que o bloqueio foi correto.
3. Abra um incident se o padrão se repetir ou afetar várias superfícies.

Fluxo operacional

Detectar

Uma rota ativa regras por padrão, taxa ou combinação de sinais.

Confirmar quais regras explicam a medida.

Graduar

O ADDA pode permitir, verificar, limitar ou bloquear conforme o contexto.

Preferir medidas progressivas enquanto a confiança não for conclusiva.

Respaldar

Se o tráfego exigir medidas contínuas, conecte o WAF a tasks, incidents e evidence.

Transformar eventos isolados em uma resposta coordenada.

flowchart LR
  S1["Detectar"]
  S2["Graduar"]
  S3["Respaldar"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

Executam uma leitura contextual desta superfície e devolvem passos sugeridos com foco operacional.

Validar a camada WAF

Resume artigos, checks e próximos passos para superfícies protegidas.

Validar formulários

Concentra-se em sinais de capturas, abuse e fricção progressiva.

Exemplos

Payload para avaliação WAF

{
  "method": "POST",
  "url": "https://capacero.ar/api/login",
  "path": "/api/login",
  "body": "username=demo&password=test",
  "userAgent": "curl/8.0",
  "ip": "198.51.100.44"
}

Links e referências

Rotas relacionadas

Vista WAF no workspace Vista WAF admin

APIs

/api/adda/v1/waf/evaluate
/api/adda/v1/rules/evaluate
/api/adda/v1/governance

Docs e rotas de apoio

docs/ADDA_WAF.md
docs/ADDA_API.md

Problemas frequentes

• Aumentar a agressividade sem revisar as rotas afetadas pode bloquear usos válidos.
• Separar o WAF de forms/api/login impede ver campanhas que alternam de superfície.

Ações sugeridas

• Usar shields de forms/api/login como leituras especializadas, não como silos separados.
• Quando uma regra bloquear, deixar evidence ou pelo menos uma task de acompanhamento.

Reason codes úteis

Dicionário de score

wafRiskScore

Risco detectado na rota ou no formulário observado.

decision

Ação decidida: permitir, verificar, limitar ou bloquear.

matchedRules

Regras que explicam por que a proteção foi ativada.

Notas do protocolo

• Uma decisão progressiva costuma ser mais útil que um bloqueio precoce em sinais mistos.
• Uma matchedRule sem contexto operacional explica menos do que parece.

Histórico do artigo

9 de jul. de 2026

O WAF foi conectado aos shields especializados e ao fluxo de incidents/evidence.