Passer au contenu principal
L’API de score de vélocité et d’anomalie suit la fréquence à laquelle un sujet effectue une action donnée sur plusieurs fenêtres temporelles glissantes — 1 minute, 5 minutes, 1 heure et 24 heures. Lorsque le score de vélocité pondéré dépasse un seuil, la plateforme crée automatiquement un signal de risque, connectant la détection d’anomalie directement au pipeline du pare-feu d’identité anti-fraude.
La notation de vélocité fait partie du pare-feu d’identité anti-fraude. Les signaux générés par les anomalies de vélocité s’intègrent au même pipeline que les autres signaux de fraude, vous pouvez donc les interroger et les examiner depuis la page de la console Risque & Fraude > Signaux ou le point de terminaison de liste des signaux.

Comment ça marche

1

Enregistrer les actions

Appelez POST /v1/risk/velocity/record chaque fois qu’un sujet effectue une action suivie — tentatives de connexion, appels API, demandes de transaction ou tout type d’action personnalisée.
2

Suivi par fenêtre glissante

La plateforme incrémente les compteurs pour le sujet et le type d’action sur quatre fenêtres glissantes (1 m, 5 m, 1 h, 24 h). Les fenêtres se réinitialisent automatiquement à leur expiration.
3

Notation pondérée

Un score de vélocité est calculé à partir des comptes de fenêtre. Les fenêtres courtes sont pondérées plus lourdement pour détecter les rafales : 1 m × 30, 5 m × 20, 1 h × 10, 24 h × 5.
4

Ingestion automatique de signaux

Lorsque le score de vélocité atteint 60 ou plus, la plateforme ingère automatiquement un signal de risque avec signal_type: "velocity". Vous n’avez pas besoin d’un appel API séparé.
5

Examiner et répondre

Interrogez les fenêtres de vélocité pour un sujet, listez les anomalies à haute vélocité dans votre locataire, et examinez les signaux dans la console ou via l’API.

Prérequis

  • Un locataire Truthlocks actif avec une clé API
  • Données d’événements d’action de votre application (tentatives de connexion, appels API, transactions ou toute action reproductible)

Enregistrement d’une action

Envoyez une requête POST à /v1/risk/velocity/record avec le sujet, le type d’action et les métadonnées facultatives :
La réponse renvoie le nombre de fenêtres actuelles, le score de vélocité calculé et si un signal de risque a été automatiquement ingéré :

Modèle de notation

Le score de vélocité est une somme pondérée des nombres d’actions sur quatre fenêtres glissantes. Les fenêtres courtes ont un poids plus élevé pour prioriser la détection des pics: Le score final est plafonné à 100. Lorsque le score atteint 60 ou plus, un signal de risque est automatiquement ingéré avec signal_type: "velocity".

Interprétation du score

Interrogation des fenêtres de vélocité

Récupère les fenêtres de vélocité actuelles pour un sujet spécifique :
La réponse inclut tous les types d’actions suivis pour le sujet, avec des comptes par fenêtre et le score de vélocité calculé pour chacun :

Liste des anomalies à haute vélocité

Interroger les sujets avec des scores de vélocité supérieurs à un seuil dans votre locataire :
Chaque résultat inclut le sujet, le type d’action, les comptes de fenêtre actuels et le score de vélocité qui a qualifié l’anomalie :

Modèles d’intégration

Bloquer ou limiter en cas de vélocité élevée

Utilisez le score de vélocité de la réponse d’enregistrement pour décider d’autoriser, de limiter ou de bloquer une action :

Combiner avec la détection ATO

La notation de vélocité suit tout type d’action sur plusieurs fenêtres temporelles, tandis que la détection ATO est spécifiquement optimisée pour les modèles de prise de contrôle de compte basés sur la connexion avec des règles de seuil et une gestion des alertes intégrées. Utilisez les deux ensemble pour une protection multicouche :
  • Notation de vélocité pour la détection générale des abus — abus de taux d’API, inondation de transactions, spam d’inscription
  • 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

Surveiller via des webhooks

Configurez un point de terminaison de webhook pour recevoir des notifications en temps réel lorsque des signaux de risque basés sur la vélocité sont créés, afin que votre équipe de sécurité puisse réagir sans interroger.

Types d’actions personnalisées

Vous pouvez suivre tout type d’action produit par votre application. Exemples courants :

Mesure de l’utilisation

Chaque appel à POST /v1/risk/velocity/record incrémente le compteur d’utilisation antifraud.velocity_records pour votre cycle de facturation. Vous pouvez surveiller votre consommation avec l’API d’utilisation ou dans la console sous Paramètres > Facturation > Utilisation dans la section Anti-fraude.
Les quotas d’enregistrements de vélocité varient selon le niveau de plan. Consultez l’aperçu de la facturation pour plus de détails sur tous les produits mesurés Anti-Fraude.

La suite