forms-shield/1.0.0 · atualizado em 9 de jul. de 2026

Proteção de formulários

Como conter abuso, spam e envios automatizados sem prejudicar a experiência legítima.

O Forms Shield observa interações em formulários críticos e ajuda a graduar verificação, rate limit e bloqueio.

A chave é proteger a superfície sem transformar cada formulário em um obstáculo. Por isso, o ADDA combina sinais de ritmo, user-agent, reputação e eventos recentes com um resultado explicável.

Se a mesma pressão aparecer em várias rotas ou com variações coordenadas, convém passar de forms-shield para WAF, incident ou intelligence.

Checklist

• Identificar formulários críticos e rotas de envio.
• Revisar eventos recentes antes de aumentar a fricção.
• Escalar para WAF ou incident se o padrão se tornar repetível.

Início rápido

1. Identifique quais formulários concentram abuso ou volume sensível.
2. Revise eventos recentes e ajuste a fricção por prioridade, não por intuição.
3. Eleve evidence se a proteção afetar operações ou usuários relevantes.

Fluxo operacional

Observar

Leia eventos de shield e padrões de captura ou envio em massa.

Distinguir ruído de pressão contínua.

Graduar a fricção

Aplique verificação ou limitação antes de bloquear enquanto a confiança for parcial.

Preservar a experiência legítima.

Escalar

Se o abuso persistir, conecte WAF, tasks ou incident para coordenar a resposta.

Não deixar a defesa confinada à mesma superfície.

flowchart LR
  S1["Observar"]
  S2["Graduar a fricção"]
  S3["Escalar"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

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

Validar a cobertura de formulários

Lê eventos recentes e recomenda os próximos passos do shield.

Exemplos

Payload para candidato manual de abuso

{
  "title": "Refuerzo forms shield",
  "sourceType": "forms_shield_event",
  "sourceRef": "/contacto",
  "summary": "El formulario de contacto recibe envíos automatizados repetidos desde varias IP."
}

Links e referências

Rotas relacionadas

Forms Shield no workspace Centro de resposta

APIs

/api/adda/v1/shields/events
/api/adda/v1/brand-shield/check
/api/adda/v1/tasks

Docs e rotas de apoio

docs/ADDA_WAF.md
docs/ADDA_API.md

Problemas frequentes

• Adicionar captchas ou fricção sem revisar a taxa de falsos positivos piora a experiência.
• Não cruzar forms-shield com mail e WAF deixa campanhas multicanal sem explicação.

Ações sugeridas

• Coletar uma amostra de eventos antes de alterar políticas.
• Conectar o achado a incident ou manual candidate se surgir uma lacuna de procedimento.

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 boa defesa de formulários reduz o abuso sem tornar usuários legítimos invisíveis.

Histórico do artigo

9 de jul. de 2026

Novo artigo para a superfície forms-shield com quickstart, validação e escalonamento.