Le pare-feu d’identité anti-fraude est généralement disponible. Les cinq chemins de détection — ingestion directe de signaux, normalisation d’événements, analyse de deepfake, détection d’ATO et score de vélocité — sont intégrés avec des exemples d’API multilingues (cURL, JavaScript, Python), des guides de bout en bout et des notifications webhook en temps réel pour tous les types de signaux. Les décisions de risque automatisées, la gestion de cas et l’exportation SIEM de fraude sont désormais disponibles.
- Ingestion directe — envoyez un signal entièrement noté via
POST /v1/risk/signalslorsque vous avez déjà un score de risque d’un fournisseur externe. Prend en charge les tentatives idempotentes via l’en-têteIdempotency-Key. - Normalisation des événements — envoyez un événement d’identité brut via
POST /v1/risk/eventset laissez la plateforme le mapper automatiquement à un type de signal et à un score de base. Voir normalisation des événements. - Notation des signaux de deepfake et d’usurpation d’identité — soumettez des indicateurs ou des scores produits en externe pour évaluation du seuil via
POST /v1/risk/deepfake/scan. Les scans qui obtiennent un score de 60 ou plus ingèrent automatiquement un signal de risque. Consultez le guide de détection de deepfake. - Détection de prise de contrôle de compte — évalue les événements de connexion par rapport aux heuristiques basées sur la vélocité via
POST /v1/risk/ato/evaluate. Des alertes sont créées et des signaux de risque sont ingérés automatiquement lorsque les seuils sont dépassés. Voir le guide de détection ATO. - Notation de vélocité et d’anomalie — enregistrez les actions du sujet via
POST /v1/risk/velocity/recordet laissez la plateforme suivre la fréquence sur des fenêtres de temps glissantes (1 m, 5 m, 1 h, 24 h). Les actions qui produisent un score de vélocité pondéré de 60 ou plus ingèrent automatiquement un signal de risque. Voir le guide de notation de vélocité.
Choisir un chemin d’ingestion
Les cinq chemins produisent les mêmes enregistrements de signaux de risque. Vous pouvez interroger, filtrer et examiner les signaux de n’importe quel chemin à l’aide du point de terminaison de liste et de la page de la console Risque et fraude > Signaux.
Comment ça marche
1
Ingérer les signaux
Envoyez une requête
POST à /v1/risk/signals avec la source du signal, le type, le score de risque et le sujet auquel il se rapporte. Joignez tout contexte supplémentaire dans l’objet payload.2
Interroger et filtrer
Utilisez
GET /v1/risk/signals pour lister les signaux avec des filtres pour la source, le type de signal, le sujet et le score minimum. Les résultats sont paginés avec une pagination basée sur un curseur.3
Examiner dans la console
Ouvrez Risque et Fraude > Signaux dans la console du locataire pour parcourir les signaux, filtrer par source ou score, et inspecter les détails de chaque signal.
Prérequis
- Un locataire Truthlocks actif avec une clé API
- Au moins une source de détection de fraude en amont qui produit des signaux notés
Ingestion d’un signal
Envoyez une requêtePOST avec les champs requis :
Champs obligatoires
Champs optionnels
Idempotence
Incluez un en-têteIdempotency-Key (UUID) pour éviter les signaux en double lors des tentatives. Si vous envoyez la même clé deux fois, le doublon est ignoré silencieusement.
Interrogation des signaux
Lister avec filtres
Obtenir un seul signal
Vue de la Console
La page Risque et fraude > Signaux dans la console fournit une liste consultable et filtrable de tous les signaux ingérés. Chaque ligne affiche la source, le type, le score (codé par couleur selon la gravité), la référence du sujet et l’horodatage. Utilisez les filtres en haut de la page pour affiner les résultats par source, type de signal ou score minimum. Cliquez sur n’importe quelle ligne pour afficher tous les détails du signal, y compris l’objet de métadonnéespayload.
Lignes directrices de notation
Une notation cohérente entre les sources rend l’analyse en aval plus fiable. Nous recommandons les plages suivantes :Normalisation des événements
Au lieu de construire manuellement des signaux de risque, vous pouvez soumettre des événements d’identité bruts et laisser la plateforme les normaliser automatiquement en signaux. Ceci est utile lorsque vous souhaitez alimenter directement le pipeline de risque avec des événements natifs de la plateforme — échecs de connexion, signatures invalides, suspects de deepfake — sans les mapper vous-même à des types de signaux. Envoyez une requêtePOST à /v1/risk/events avec la source, le type et le sujet de l’événement :
event_id brut et le signal_id normalisé, afin que vous puissiez tracer le pipeline complet de l’événement au signal :
normalized est true, l’événement correspond à un mappage connu. Lorsque false, la plateforme a utilisé le mécanisme de secours générique.
Mappages d’événements intégrés
La plateforme est livrée avec des mappages pré-calibrés pour les événements d’identité courants :
Les types d’événements inconnus sont acceptés avec le type de signal
behavior et un score de base de 10.
Champs d’événement
Requis :
Facultatif :
Utilisez la normalisation des événements lorsque vos événements proviennent de la plateforme (connexions, vérifications, attestations). Utilisez le point de terminaison d’ingestion de signal direct lorsque vous avez déjà un signal scoré provenant d’une source externe.
Isolation du locataire
Les signaux de risque sont entièrement isolés par locataire à l’aide de la sécurité au niveau des lignes (RLS). Chaque signal est lié au locataire authentifié au moment de l’ingestion, et les requêtes ne peuvent renvoyer que les signaux appartenant au locataire appelant.Détection de deepfake et d’usurpation d’identité
L’API de détection de deepfake étend le pipeline de signaux de risque avec une analyse automatisée du contenu manipulé et de la fraude d’identité. Soumettez des images, des vidéos, des documents ou des attestations pour analyse, et les analyses qui dépassent le seuil de risque créent automatiquement un signal de risque — aucun appel API supplémentaire n’est nécessaire. Consultez le guide de détection de deepfake et d’usurpation d’identité pour le flux de travail complet, la référence des indicateurs et les exemples de code.Détection de la prise de contrôle de compte
L’API de détection ATO étend le pipeline de signaux de risque avec une surveillance des connexions basée sur la vélocité. Envoyez les événements de connexion àPOST /v1/risk/ato/evaluate et la plateforme suit les tentatives échouées par sujet dans une fenêtre glissante d’une heure. Lorsqu’un sujet dépasse un seuil (5, 10 ou 20 échecs de connexion), une alerte est créée et un signal de risque est automatiquement ingéré — aucun appel API supplémentaire n’est nécessaire.
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.
Score de vélocité et d’anomalie
L’API de notation de vélocité étend le pipeline de signaux de risque avec le suivi d’actions multi-fenêtres et la détection d’anomalies. Enregistrez toute action de sujet viaPOST /v1/risk/velocity/record et la plateforme suit la fréquence sur quatre fenêtres glissantes (1 m, 5 m, 1 h, 24 h). Un score de vélocité pondéré est calculé à partir des comptes de fenêtres, biaisé vers les fenêtres courtes pour la détection de rafales. Lorsque le score atteint 60 ou plus, un signal de risque avec signal_type: "velocity" est automatiquement ingéré — aucun appel API supplémentaire n’est nécessaire.
Consultez le guide de notation de vélocité et d’anomalie pour le flux de travail complet, le modèle de notation et les modèles d’intégration.
Notifications de webhook
Les signaux de risque créés par l’un des cinq chemins de détection peuvent déclencher des notifications webhook en temps réel. Abonnez-vous àrisk.signal.created ou risk.signal.escalated pour réagir aux nouveaux signaux sans interroger. Cela couvre les signaux provenant de l’ingestion directe, de la normalisation des événements, des analyses de deepfake, des alertes ATO et des anomalies de vélocité.
Consultez le guide des webhooks pour des exemples de charge utile et des modèles d’intégration.
Mesure de l’utilisation
Les fonctionnalités anti-fraude sont mesurées par cycle de facturation. Chaque chemin de détection incrémente son propre compteur d’utilisation :
Les quotas varient selon le niveau de votre plan. Vous pouvez vérifier votre consommation actuelle avec l’API d’utilisation ou dans la console sous Paramètres > Facturation > Utilisation dans la section Anti-Fraude. Pour vérifier si une opération spécifique est autorisée avant de l’exécuter, utilisez le point de terminaison de vérification des limites.
used, limit et period afin que vous puissiez surveiller la consommation par programme.
Consultez l’aperçu de la facturation pour la liste complète des 16 produits mesurés et leurs tarifs par défaut.
La suite
- Guide de la vélocité et de la notation des anomalies
- Guide de détection de la prise de contrôle de compte
- Guide de détection des deepfakes et de l’usurpation d’identité
- Référence de l’API d’ingestion de signal de risque
- Référence de l’API de normalisation des événements d’identité
- Référence de l’API de liste des signaux de risque
- Référence de l’API de signal de risque
- Sécurité au niveau des lignes

