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êtePOST à /v1/risk/velocity/record avec le sujet, le type d’action et les métadonnées facultatives :
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 :Liste des anomalies à haute vélocité
Interroger les sujets avec des scores de vélocité supérieurs à un seuil dans votre locataire :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.

