trustapi/1.1.0 · mis à jour le 9 juil. 2026

Indice de confiance et automatisation

Comment déterminer si une visite semble humaine, automatisée ou coordonnée, et choisir l'étape suivante.

L'indice de confiance rassemble au même endroit l'évaluation d'une IP, d'un domaine, d'une session ou d'une campagne. Il soutient le jugement humain avec des motifs explicites et une action suggérée.

La lecture du score ne remplace pas la décision de l'opérateur : elle l'oriente. Les reason codes expliquent pourquoi un cas semble bénin, mixte ou risqué et aident à escalader vers une vérification, une limitation, une watchlist ou Evidence.

Lorsque le même schéma apparaît sur plusieurs surfaces, le score gagne en qualité s'il est utilisé avec incidents, tasks, Access, Mail, WAF ou Intel.

Liste de contrôle

• Comparer la lecture d'automatisation avec celles de session et de domaine.
• Confirmer que l'action recommandée correspond à la gravité.
• Consigner un retour si les motifs n'expliquent pas suffisamment la décision.

Démarrage rapide

1. Lisez severity, action et reason codes comme une seule phrase opérationnelle.
2. Recoupez le score avec le module affecté avant de bloquer par défaut.
3. Pour un cas sensible, transférez la lecture vers un incident, une task ou Evidence.

Flux opérationnel

Consulter

Obtenez une lecture d'IP, de domaine, de session ou de campagne.

Utiliser le type de score le mieux adapté au cas.

Expliquer

Transformez les reason codes en critères partagés par l'équipe.

Aligner le langage technique et opérationnel.

Décider

Reliez l'action suggérée au module qui exécutera réellement la mesure.

Ne pas traiter le score comme s'il constituait l'action elle-même.

flowchart LR
  S1["Consulter"]
  S2["Expliquer"]
  S3["Décider"]
  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 lecture TrustAPI

Résume les articles, checks et prochaines étapes concernant le score et son explication.

Exemples

Payload pour le score d'une session

{
  "sessionId": "sess_ops_001",
  "domain": "login.capacero.ar",
  "ip": "198.51.100.18"
}

Liens et références

Routes associées

BotRadar dans la console TrustAPI publique

APIs

/api/adda/v1/trust/score
/api/adda/v1/score/ip
/api/adda/v1/score/domain

Docs et routes d'appui

docs/ADDA_API.md
docs/ADDA_PROTOCOLO.md

Problèmes fréquents

• Traiter l'action suggérée comme un ordre automatique sans examiner le module concerné.
• Ne pas enregistrer les motifs lorsque le signal est mixte empêche un examen ultérieur.

Actions suggérées

• Utiliser Copilot et Manual lorsque le score ne suffit pas à justifier l'action.
• Escalader vers Evidence si la lecture a conduit à un blocage, une révocation ou un confinement fort.

Reason codes utiles

BOT_HIGH

L'automatisation estimée est élevée pour le contexte analysé.

Appliquer une vérification ou une limitation progressive.

GEO_ANOMALY

L'origine ou le parcours attendu ne sont pas cohérents.

Recouper avec Access, DNS ou un incident avant d'accorder sa confiance.

SESSION_RISK

La session présente des caractéristiques qui exigent une surveillance étroite.

Examiner la continuité et les contrôles de la session ou de l'appareil.

Dictionnaire de score

severity

Priorité institutionnelle du signal sur l'échelle ADDA.

action

Prochaine étape opérationnelle recommandée par le moteur.

reasonCodes

Motifs explicables justifiant la lecture.

Notes de protocole

• Le score gagne en valeur lorsqu'il est relié à une surface de réponse concrète.

Historique de l'article

9 juil. 2026

Le glossaire et le parcours opérationnel du score ont été élargis.