forms-shield/1.0.0 · actualizado 10/7/2026

Protección de formularios

Cómo frenar abuso, spam y capturas automatizadas sin romper la experiencia legítima.

Forms Shield observa interacción sobre formularios críticos y ayuda a graduar verificación, rate-limit y bloqueo.

La clave está en proteger la superficie sin convertir cada formulario en un obstáculo. Por eso ADDA combina señales de ritmo, user-agent, reputación y eventos recientes con una salida explicable.

Si una misma presión aparece en varias rutas o con variaciones coordinadas, conviene saltar de forms-shield a WAF, incident o intelligence.

Checklist

• Identificar formularios críticos y rutas de captura.
• Revisar eventos recientes antes de endurecer la fricción.
• Escalar a WAF o incident si el patrón se vuelve repetible.

Quickstart

1. Ubicá qué formularios concentran abuso o volumen sensible.
2. Revisá eventos recientes y ajustá la fricción por prioridad, no por intuición.
3. Elevá evidence si la protección impacta operaciones o usuarios relevantes.

Flujo operativo

Observar

Leé eventos de shield y patrones de captura o envío masivo.

Distinguir ruido de presión sostenida.

Graduar fricción

Aplicá verificación o limitación antes de bloquear cuando la confianza todavía es parcial.

Conservar la experiencia legítima.

Escalar

Si el abuso insiste, conectá WAF, tasks o incident para coordinar la respuesta.

No dejar la defensa encerrada en la misma superficie.

flowchart LR
  S1["Observar"]
  S2["Graduar fricción"]
  S3["Escalar"]
  S1 --> S2
  S2 --> S3

Validadores y checks

Ejecutan una lectura contextual para esta superficie y devuelven pasos sugeridos con foco operativo.

Validar coverage de formularios

Lee eventos recientes y recomienda próximos pasos del shield.

Ejemplos

Payload para candidate 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 y referencias

Rutas relacionadas

Forms shield en workspace Centro de respuesta

APIs

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

Docs y rutas de apoyo

docs/ADDA_WAF.md
docs/ADDA_API.md

Problemas frecuentes

• Agregar captchas o fricción sin revisar tasa de falsos positivos empeora la experiencia.
• No cruzar forms-shield con mail y WAF deja sin explicar campañas multicanal.

Acciones sugeridas

• Tomar una muestra de eventos antes de mover políticas.
• Conectar el hallazgo con incident o manual candidate si aparece una brecha de procedimiento.

Reason codes útiles

Diccionario de score

wafRiskScore

Riesgo detectado sobre la ruta o formulario observado.

decision

Acción decidida: permitir, verificar, limitar o bloquear.

matchedRules

Reglas que explican por qué se activó la protección.

Notas de protocolo

• Una buena defensa de formularios reduce abuso sin invisibilizar usuarios legítimos.

Historial del artículo

10/7/2026

Nuevo artículo para la superficie forms-shield con quickstart, validación y escalado.