Passer au contenu principal
Les signaux de risque vous permettent d’intégrer des données de détection de fraude dans Truthlocks depuis n’importe quel fournisseur en amont — services d’empreintes digitales d’appareils, API de réputation IP, outils de vérification d’e-mails, moteurs d’analyse de documents ou vos propres règles internes. Une fois ingérés, les signaux sont disponibles via l’API et la page Risque et Fraude > Signaux dans la console.
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.
Vous pouvez créer des signaux de cinq manières :
  • Ingestion directe — envoyez un signal entièrement noté via POST /v1/risk/signals lorsque vous avez déjà un score de risque d’un fournisseur externe. Prend en charge les tentatives idempotentes via l’en-tête Idempotency-Key.
  • Normalisation des événements — envoyez un événement d’identité brut via POST /v1/risk/events et 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/record et 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ête POST avec les champs requis :

Champs obligatoires

Champs optionnels

Idempotence

Incluez un en-tête Idempotency-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

Filtres disponibles :

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ées payload.

Lignes directrices de notation

Une notation cohérente entre les sources rend l’analyse en aval plus fiable. Nous recommandons les plages suivantes :
Les scores égaux ou supérieurs à 80 déclenchent des décisions d’examen automatiques. L’interprétation des scores au-delà du seuil automatique vous appartient — la plateforme stocke et renvoie les scores tels quels et ne les normalise pas entre les sources.

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ête POST à /v1/risk/events avec la source, le type et le sujet de l’événement :
La réponse inclut à la fois le event_id brut et le signal_id normalisé, afin que vous puissiez tracer le pipeline complet de l’événement au signal :
Lorsque 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 via POST /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.
La réponse inclut tous les compteurs anti-fraude avec les champs 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