Aduana Digital de Defensa Argentina
Créer un accès ADDA
← Manuel ADDA

waf-policy/1.1.0 · mis à jour le 9 juil. 2026

WAF adaptatif

Comment interpréter les règles, les correspondances et la vérification progressive selon la priorité.

ADDA WAF évalue les requêtes sur les routes sensibles, identifie les altérations ou les sondages et répond par une mesure proportionnée.

La maturité opérationnelle du filtrage web ne dépend pas seulement du blocage. Elle exige aussi de distinguer l'exploration, l'erreur légitime, l'abus répété et la pression coordonnée, tout en préservant l'explication et la possibilité d'une révision.

WAF est complété par trois surfaces tactiques : forms-shield pour les captures et formulaires, api-shield pour les routes d'intégration et login-shield pour les accès sensibles.

Liste de contrôle

  • • Inspecter les règles actives et les versions publiées.
  • • Examiner les correspondances dans les requêtes de test.
  • • Escalader vers une evidence consignée lorsque l'action consiste à bloquer.

Démarrage rapide

  1. 1. Testez une route sensible avec un cas contrôlé.
  2. 2. Lisez matchedRules et decision avant de supposer que le blocage était correct.
  3. 3. Ouvrez un incident si le schéma se répète ou affecte plusieurs surfaces.

Flux opérationnel

Détecter

Une route active des règles selon un schéma, un taux ou une combinaison de signaux.

Vérifier quelles règles expliquent la mesure.

Graduer

ADDA peut autoriser, vérifier, limiter ou bloquer selon le contexte.

Privilégier la progressivité tant que la confiance n'est pas concluante.

Étayer

Si le trafic exige des mesures durables, reliez WAF à tasks, incidents et evidence.

Transformer les événements isolés en réponse coordonnée.

flowchart LR
  S1["Détecter"]
  S2["Graduer"]
  S3["Étayer"]
  S1 --> S2
  S2 --> S3

Validateurs et contrôles

Ils exécutent une lecture contextuelle de cette surface et proposent des étapes à visée opérationnelle.

Valider la couche WAF

Résume les articles, checks et prochaines étapes pour les surfaces protégées.

Valider les formulaires

Cible les signaux liés aux captures, à abuse et à la friction progressive.

Exemples

Payload d'évaluation 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"
}

Liens et références

APIs

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

Docs et routes d'appui

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

Problèmes fréquents

  • • Augmenter l'agressivité sans examiner les routes touchées peut bloquer des usages légitimes.
  • • Séparer WAF de forms/api/login empêche de détecter les campagnes qui changent de surface.

Actions suggérées

  • • Utiliser les shields forms/api/login comme lectures spécialisées, et non comme silos séparés.
  • • Lorsqu'une règle bloque, laisser une evidence ou au moins une task de suivi.

Reason codes utiles

Dictionnaire de score

wafRiskScore

Risque détecté sur la route ou le formulaire observé.

decision

Action décidée : autoriser, vérifier, limiter ou bloquer.

matchedRules

Règles qui expliquent pourquoi la protection a été activée.

Notes de protocole

  • • Une décision progressive est souvent plus utile qu'un blocage précoce lorsque les signaux sont mixtes.
  • • Une matchedRule sans contexte opérationnel explique moins qu'il n'y paraît.

Historique de l'article

9 juil. 2026

WAF a été relié aux shields spécialisés et au circuit incidents/evidence.