forms-shield/1.0.0 · aggiornato il 9 lug 2026

Protezione dei moduli

Come fermare abusi, spam e invii automatizzati senza compromettere l'esperienza legittima.

Forms Shield osserva le interazioni sui moduli critici e aiuta a graduare verifica, rate limit e blocco.

La chiave è proteggere la superficie senza trasformare ogni modulo in un ostacolo. Per questo ADDA combina segnali di ritmo, user-agent, reputazione ed eventi recenti con un risultato spiegabile.

Se la stessa pressione appare su più percorsi o con variazioni coordinate, conviene passare da forms-shield a WAF, incident o intelligence.

Lista di controllo

• Identificare i moduli critici e i percorsi di invio.
• Esaminare gli eventi recenti prima di aumentare l'attrito.
• Passare a WAF o incident se il pattern diventa ripetibile.

Avvio rapido

1. Individua i moduli che concentrano abusi o volumi sensibili.
2. Esamina gli eventi recenti e regola l'attrito in base alla priorità, non all'intuizione.
3. Passa a evidence se la protezione incide sulle operazioni o su utenti rilevanti.

Flusso operativo

Osservare

Leggi gli eventi dello shield e i pattern di acquisizione o invio massivo.

Distinguere il rumore dalla pressione persistente.

Graduare l'attrito

Applica verifica o limitazione prima del blocco finché la fiducia è ancora parziale.

Preservare l'esperienza legittima.

Procedere con l'escalation

Se l'abuso persiste, collega WAF, tasks o incident per coordinare la risposta.

Non lasciare la difesa confinata alla stessa superficie.

flowchart LR
  S1["Osservare"]
  S2["Graduare l'attrito"]
  S3["Procedere con l'escalation"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

Eseguono una lettura contestuale di questa superficie e restituiscono passaggi suggeriti con un taglio operativo.

Convalidare la copertura dei moduli

Legge gli eventi recenti e consiglia i prossimi passaggi dello shield.

Esempi

Payload per un manual candidate di abuso

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

Link e riferimenti

Route correlate

Forms Shield nel workspace Centro di risposta

APIs

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

Docs e route di supporto

docs/ADDA_WAF.md
docs/ADDA_API.md

Problemi frequenti

• Aggiungere captcha o attrito senza verificare il tasso di falsi positivi peggiora l'esperienza.
• Non confrontare forms-shield con mail e WAF lascia inspiegate le campagne multicanale.

Azioni suggerite

• Raccogliere un campione di eventi prima di modificare le policy.
• Collegare il riscontro a incident o manual candidate se emerge una lacuna procedurale.

Reason code utili

Dizionario degli score

wafRiskScore

Rischio rilevato sul percorso o sul modulo osservato.

decision

Azione decisa: consentire, verificare, limitare o bloccare.

matchedRules

Regole che spiegano perché è stata attivata la protezione.

Note di protocollo

• Una buona difesa dei moduli riduce gli abusi senza rendere invisibili gli utenti legittimi.

Cronologia dell'articolo

9 lug 2026

Nuovo articolo per la superficie forms-shield con quickstart, convalida ed escalation.