Aduana Digital de Defensa Argentina
Crea accesso ADDA
← Manuale ADDA

waf-policy/1.1.0 · aggiornato il 9 lug 2026

WAF adattivo

Come interpretare regole, corrispondenze e verifica progressiva in base alla priorità.

ADDA WAF valuta le richieste su percorsi sensibili, identifica alterazioni o ricognizioni e risponde con una misura proporzionata.

La maturità operativa del filtro web non dipende solo dal blocco. Richiede anche di distinguere esplorazione, errore legittimo, abuso ripetuto e pressione coordinata, preservando la spiegazione e la possibilità di revisione.

WAF è completato da tre superfici tattiche: forms-shield per acquisizioni e moduli, api-shield per i percorsi di integrazione e login-shield per gli accessi sensibili.

Lista di controllo

  • • Ispezionare le regole attive e le versioni pubblicate.
  • • Esaminare le corrispondenze nelle richieste di test.
  • • Passare a evidence registrata quando l'azione consiste nel bloccare.

Avvio rapido

  1. 1. Prova un percorso sensibile con un caso controllato.
  2. 2. Leggi matchedRules e decision prima di presumere che il blocco fosse corretto.
  3. 3. Apri un incident se il pattern si ripete o interessa più superfici.

Flusso operativo

Rilevare

Un percorso attiva regole in base al pattern, alla frequenza o a una combinazione di segnali.

Verificare quali regole spiegano la misura.

Graduare

ADDA può consentire, verificare, limitare o bloccare in base al contesto.

Preferire misure progressive finché la fiducia non è conclusiva.

Documentare

Se il traffico richiede misure durature, collega WAF a tasks, incidents ed evidence.

Trasformare eventi isolati in una risposta coordinata.

flowchart LR
  S1["Rilevare"]
  S2["Graduare"]
  S3["Documentare"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

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

Convalidare il livello WAF

Riepiloga articoli, check e passaggi successivi per le superfici protette.

Convalidare i moduli

Si concentra sui segnali relativi ad acquisizioni, abuse e attrito progressivo.

Esempi

Payload per la valutazione 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"
}

Link e riferimenti

APIs

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

Docs e route di supporto

  • docs/ADDA_WAF.md
  • docs/ADDA_API.md

Problemi frequenti

  • • Aumentare l'aggressività senza verificare i percorsi interessati può bloccare usi validi.
  • • Separare WAF da forms/api/login impedisce di vedere campagne che cambiano superficie.

Azioni suggerite

  • • Usare gli shield forms/api/login come letture specializzate, non come silos separati.
  • • Quando una regola blocca, lasciare evidence o almeno una task di follow-up.

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 decisione progressiva è spesso più utile di un blocco anticipato in presenza di segnali misti.
  • • Una matchedRule senza contesto operativo spiega meno di quanto sembri.

Cronologia dell'articolo

9 lug 2026

WAF è stato collegato agli shield specializzati e al circuito incidents/evidence.