api-shield/1.0.0 · mis à jour le 9 juil. 2026

Protection des API

Comment gérer les limites de débit, la réputation et les routes d'intégration sans perdre en visibilité.

API Shield protège les routes d'intégration, les automatisations et la consommation programmatique avec une évaluation différente de celle d'un formulaire utilisé par une personne.

La priorité n'est pas seulement de bloquer les requêtes anormales : il faut aussi éviter de casser les intégrations valides, distinguer le trafic institutionnel du scraping et conserver une Evidence lorsqu'une limitation affecte un service important.

Recouper API Shield avec Access, WAF et Secrets aide à traiter les cas où le risque ne réside pas dans une seule requête, mais dans l'identifiant, le tunnel ou la posture de l'origine.

Liste de contrôle

• Identifier les routes d'intégration critiques.
• Vérifier si l'origine utilise des identifiants, tunnels ou sessions connus.
• Appuyer la décision par une Evidence si la mesure modifie la continuité du service.

Démarrage rapide

1. Partez de la route d'intégration, pas seulement de la requête isolée.
2. Vérifiez si l'API est liée à Secrets, Access ou à des identifiants actifs.
3. Utilisez des tasks lorsque l'ajustement exige la coordination d'une autre équipe.

Flux opérationnel

Contextualiser

Lisez la route, l'origine et la continuité de service attendue.

Éviter les blocages aveugles sur les API ayant des dépendances en aval.

Relier

Recoupez le signal avec Secrets, Access ou keyring pour déterminer si la confiance a changé.

Déterminer si le problème vient du trafic, de l'identité ou d'un identifiant.

Convenir d'une réponse

Créez une task ou un incident lorsque la mitigation implique plusieurs équipes.

Maintenir la gouvernance sur les changements sensibles.

flowchart LR
  S1["Contextualiser"]
  S2["Relier"]
  S3["Convenir d'une réponse"]
  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 protection de l'API

Renvoie des checks et des articles pour les routes intégrées ou automatisées.

Exemples

Payload pour examiner une API exposée

{
  "moduleKey": "api-shield",
  "query": "token reuse scraping",
  "domain": "api.capacero.ar"
}

Liens et références

Routes associées

API Shield dans le workspace Secrets

APIs

/api/adda/v1/shields/events
/api/adda/v1/secrets/status
/api/adda/v1/access/status

Docs et routes d'appui

docs/ADDA_API.md
docs/ADDA_WAF.md

Problèmes fréquents

• Traiter le trafic programmatique comme une navigation humaine désorganise la réponse.
• Ajuster la défense sans examiner Secrets ou Access peut laisser active la cause du risque.

Actions suggérées

• Toujours recouper le signal avec les identifiants, sessions ou tunnels associés.
• Si une API soutient des processus critiques, privilégier la limitation et la traçabilité avant un blocage brutal.

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

• La continuité du service compte autant que la maîtrise des abus.

Historique de l'article

9 juil. 2026

Nouvel article API Shield axé sur la continuité, les identifiants et la coordination.