Passer au contenu principal
L’API de détection de prise de contrôle de compte (ATO) surveille l’activité de connexion par sujet et signale les schémas suspects en temps réel. Elle suit la vitesse des échecs de connexion sur une fenêtre glissante d’une heure, attribue un niveau de risque basé sur des seuils configurables et crée automatiquement des alertes et des signaux de risque lorsque ces seuils sont dépassés.
La détection ATO fait partie du pare-feu d’identité anti-fraude. Les alertes et les signaux de risque sont acheminés dans le même pipeline que les autres signaux de fraude, vous pouvez donc les interroger et les examiner depuis la page de la console Risque et fraude > Signaux ou le point de terminaison de liste des signaux.

Comment ça marche

1

Envoyer les événements de connexion

Appelez POST /v1/risk/ato/evaluate chaque fois qu’un événement de connexion se produit — tentatives échouées, échecs répétés, connexions depuis un nouvel appareil ou connexions réussies.
2

Suivi de la vélocité

La plateforme incrémente (ou réinitialise) le compteur de tentatives de connexion échouées pour le sujet dans une fenêtre glissante d’une heure. Les connexions réussies réinitialisent la fenêtre.
3

Attribution du niveau de risque

Un niveau de risque est dérivé du nombre actuel d’échecs de connexion. La réponse inclut le niveau de risque, le score numérique et la valeur actuelle du compteur.
4

Alertes et signaux automatiques

Lorsqu’un sujet dépasse un seuil, la plateforme crée une alerte et ingère un signal de risque avec signal_type: "ato". Vous n’avez pas besoin d’un appel API séparé.
5

Examiner et répondre

Interrogez les profils ATO, listez les alertes et examinez les signaux dans la console ou via l’API pour enquêter et répondre aux menaces.

Prérequis

  • Un locataire Truthlocks actif avec une clé API
  • Données d’événements de connexion de votre système d’authentification (connexions échouées, réussites, nouveaux événements d’appareil)

Évaluation d’un événement de connexion

Envoyez une requête POST à /v1/risk/ato/evaluate avec le sujet et les détails de l’événement :
La réponse vous indique la posture de risque actuelle et si une alerte a été déclenchée :

Règles de seuil

La plateforme attribue un niveau de risque basé sur le nombre d’échecs de connexion dans une fenêtre glissante d’une heure : Lorsqu’un seuil est dépassé :
  1. Une alerte est créée dans le tableau des alertes ATO
  2. Un signal de risque est automatiquement ingéré avec signal_type: "ato" et le score correspondant
  3. La réponse inclut alert: true, le alert_type, et le signal_id

Types d’événements

Vérification du profil de risque d’un sujet

Récupère le profil de risque ATO actuel pour un sujet sans déclencher une nouvelle évaluation :
Le profil comprend le niveau de risque actuel, le nombre d’échecs de connexion et les listes d’adresses IP et d’appareils connus associés au sujet.

Liste des alertes

Interroger les alertes ATO pour votre locataire, éventuellement filtrées par sujet :
Chaque alerte comprend le sujet, le type d’alerte, le niveau de risque au moment du déclenchement et une référence au signal de risque auto-ingéré.

Modèles d’intégration

Bloquer ou contester en cas de risque élevé

Utilisez le risk_level de la réponse d’évaluation pour décider d’autoriser, de contester ou de bloquer une connexion :

Combiner avec la normalisation des événements

L’évaluation ATO peut compléter le pipeline de normalisation des événements. Utilisez la normalisation des événements pour une évaluation large des risques sur tous les événements d’identité, et l’évaluation ATO pour une surveillance ciblée de la prise de contrôle de compte avec des alertes basées sur des seuils.

Combiner avec la notation de vélocité

La détection ATO se concentre sur les modèles de prise de contrôle de compte basés sur la connexion avec des règles de seuil intégrées et la gestion des alertes. Le score de vélocité suit tout type d’action sur plusieurs fenêtres de temps glissantes (1 m, 5 m, 1 h, 24 h) avec détection de rafale pondérée. Utilisez les deux ensemble pour une protection multicouche :
  • Détection ATO pour une sécurité de connexion ciblée — vitesse de connexion échouée, alertes de bourrage d’identifiants, profils de risque du sujet
  • Notation de vélocité pour la détection générale des abus — abus de taux d’API, inondation de transactions, spam d’inscription ou tout type d’action personnalisée
Les deux produisent des signaux de risque dans le même pipeline unifié, vous pouvez donc interroger et examiner tous les signaux à partir d’un seul endroit.

Surveiller via des webhooks

Configurez un point de terminaison de webhook pour recevoir des notifications en temps réel lorsque des alertes ATO sont créées, afin que votre équipe de sécurité puisse réagir sans interroger.

La suite