Passer au contenu principal
POST
Évaluation des risques ATO
Évalue un événement de connexion par rapport au moteur heuristique ATO. La plateforme suit les échecs de connexion par sujet dans une fenêtre glissante d’une heure et en déduit un niveau de risque à partir du nombre actuel. Lorsqu’un seuil est dépassé, une alerte est créée et un signal de risque est automatiquement ingéré dans le pipeline de signaux de risque. Consultez le guide de détection de prise de contrôle de compte pour le flux de travail complet, la référence des seuils et les modèles d’intégration.

Règles de seuil

Réponse

string
Le sujet qui a été évalué.
string
Type de sujet (user).
string
Niveau de risque ATO actuel : normal | elevated | high | critical
integer
Score de risque numérique : 10 (normal), 50 (élevé), 70 (haut), 90 (critique).
integer
Nombre de connexions échouées dans la fenêtre d’une heure actuelle.
boolean
true si une nouvelle alerte a été déclenchée par cette évaluation.
string
Catégorie d’alerte lorsqu’elle est déclenchée : velocity_exceeded ou credential_stuffing.
string
UUID du signal de risque auto-ingéré (présent uniquement lorsqu’une alerte a été déclenchée).
string
Le type d’événement qui a été évalué.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
event_type
string
requis
subject_id
string
requis
device
string
ip_address
string
subject_type
string
user_agent
string

Réponse

Résultat de l'évaluation ATO

risk_score
integer
decision
string
signals
object[]