El Firewall de Identidad Antifraude está generalmente disponible. Las cinco rutas de detección —ingesta directa de señales, normalización de eventos, escaneo de deepfakes, detección de ATO y puntuación de velocidad— están integradas con ejemplos de API en varios idiomas (cURL, JavaScript, Python), guías de principio a fin y notificaciones de webhook en tiempo real para todos los tipos de señales. Las decisiones de riesgo automatizadas, la gestión de casos y la exportación de SIEM de fraude ya están disponibles.
- Ingesta directa — envíe una señal completamente puntuada a través de
POST /v1/risk/signalscuando ya tenga una puntuación de riesgo de un proveedor externo. Admite reintentos idempotentes a través del encabezadoIdempotency-Key. - Normalización de eventos — envíe un evento de identidad sin procesar a través de
POST /v1/risk/eventsy deje que la plataforma lo asigne a un tipo de señal y una puntuación base automáticamente. Consulte normalización de eventos. - Puntuación de señales de deepfake y suplantación de identidad — envíe indicadores o puntuaciones producidos externamente para la evaluación del umbral a través de
POST /v1/risk/deepfake/scan. Los escaneos que obtienen una puntuación de 60 o más ingieren automáticamente una señal de riesgo. Consulte la guía de detección de deepfakes. - Detección de toma de control de cuenta — evalúe los eventos de inicio de sesión contra heurísticas basadas en velocidad a través de
POST /v1/risk/ato/evaluate. Las alertas se crean y las señales de riesgo se ingieren automáticamente cuando se superan los umbrales. Consulte la guía de detección de ATO. - Puntuación de velocidad y anomalías — registre las acciones del sujeto a través de
POST /v1/risk/velocity/recordy haga que la plataforma rastree la frecuencia en ventanas de tiempo continuas (1 m, 5 m, 1 h, 24 h). Las acciones que producen una puntuación de velocidad ponderada de 60 o más ingieren automáticamente una señal de riesgo. Consulte la guía de puntuación de velocidad.
Elegir una ruta de ingesta
Las cinco rutas producen los mismos registros de señales de riesgo. Puede consultar, filtrar y revisar las señales de cualquier ruta utilizando el punto final de lista y la página de la consola Riesgo y Fraude > Señales.
Cómo funciona
1
Ingerir señales
Envíe una solicitud
POST a /v1/risk/signals con la fuente de la señal, el tipo, la puntuación de riesgo y el sujeto al que se refiere. Adjunte cualquier contexto adicional en el objeto payload.2
Consultar y filtrar
Utilice
GET /v1/risk/signals para listar señales con filtros por fuente, tipo de señal, sujeto y puntuación mínima. Los resultados se paginan con paginación basada en cursor.3
Revisar en la consola
Abre Riesgo y Fraude > Señales en la consola del inquilino para explorar señales, filtrar por fuente o puntuación, e inspeccionar detalles de señales individuales.
Requisitos previos
- Un inquilino activo de Truthlocks con una clave API
- Al menos una fuente de detección de fraude ascendente que produzca señales puntuadas
Ingesta de una señal
Envíe una solicitudPOST con los campos requeridos:
Campos obligatorios
Campos opcionales
Idempotencia
Incluya un encabezadoIdempotency-Key (UUID) para evitar señales duplicadas durante los reintentos. Si envía la misma clave dos veces, el duplicado se ignora silenciosamente.
Consulta de señales
Listar con filtros
Obtener una sola señal
Vista de Console
La página Riesgo y Fraude > Señales en la consola proporciona una lista de todas las señales ingeridas, que se puede buscar y filtrar. Cada fila muestra la fuente, el tipo, la puntuación (codificada por colores según la gravedad), la referencia del sujeto y la marca de tiempo. Utilice los filtros en la parte superior de la página para restringir los resultados por fuente, tipo de señal o puntuación mínima. Haga clic en cualquier fila para ver los detalles completos de la señal, incluido el objeto de metadatospayload.
Directrices de puntuación
La puntuación consistente entre fuentes hace que el análisis posterior sea más fiable. Recomendamos los siguientes rangos:Normalización de eventos
En lugar de construir señales de riesgo manualmente, puede enviar eventos de identidad sin procesar y dejar que la plataforma los normalice en señales automáticamente. Esto es útil cuando desea alimentar eventos nativos de la plataforma —inicios de sesión fallidos, firmas no válidas, sospechosos de deepfake— directamente en la tubería de riesgo sin asignarlos usted mismo a tipos de señales. Envíe una solicitudPOST a /v1/risk/events con el origen, tipo y asunto del evento:
event_id sin procesar como el signal_id normalizado, para que pueda rastrear la tubería completa desde el evento hasta la señal:
normalized es true, el evento coincidió con una asignación conocida. Cuando false, la plataforma utilizó el recurso genérico.
Mapeos de eventos incorporados
La plataforma viene con mapeos precalibrados para eventos de identidad comunes:
Se aceptan tipos de eventos desconocidos con el tipo de señal
behavior y una puntuación base de 10.
Campos de evento
Requerido:
Opcional:
Utilice la normalización de eventos cuando sus eventos se originen dentro de la plataforma (inicios de sesión, verificaciones, atestaciones). Utilice el punto final de ingesta de señales directo cuando ya tenga una señal puntuada de una fuente externa.
Aislamiento de inquilinos
Las señales de riesgo están completamente aisladas por inquilino utilizando seguridad a nivel de fila (RLS). Cada señal está vinculada al inquilino autenticado en el momento de la ingesta, y las consultas solo pueden devolver señales que pertenecen al inquilino que realiza la llamada.Detección de deepfake e impersonación
La API de detección de deepfakes extiende la canalización de señales de riesgo con escaneo automatizado de contenido manipulado y fraude de identidad. Envíe imágenes, videos, documentos o atestaciones para su análisis, y los escaneos que excedan el umbral de riesgo crean automáticamente una señal de riesgo, sin necesidad de una llamada API adicional. Consulte la guía de detección de deepfake e suplantación de identidad para conocer el flujo de trabajo completo, la referencia de indicadores y los ejemplos de código.Detección de apropiación de cuenta
La API de detección de ATO extiende la canalización de señales de riesgo con monitoreo de inicio de sesión basado en velocidad. Envíe eventos de inicio de sesión aPOST /v1/risk/ato/evaluate y la plataforma rastrea los intentos fallidos por sujeto en una ventana móvil de una hora. Cuando un sujeto cruza un umbral (5, 10 o 20 inicios de sesión fallidos), se crea una alerta y se ingiere automáticamente una señal de riesgo, sin necesidad de una llamada API adicional.
Consulte la guía de detección de apropiación de cuentas para conocer el flujo de trabajo completo, la referencia de umbrales y los patrones de integración.
Puntuación de velocidad y anomalías
La API de puntuación de velocidad extiende la canalización de señales de riesgo con seguimiento de acciones de múltiples ventanas y detección de anomalías. Registre cualquier acción del sujeto a través dePOST /v1/risk/velocity/record y la plataforma rastrea la frecuencia en cuatro ventanas móviles (1 m, 5 m, 1 h, 24 h). Se calcula una puntuación de velocidad ponderada a partir de los recuentos de ventanas, sesgada hacia ventanas cortas para la detección de ráfagas. Cuando la puntuación alcanza 60 o más, se ingiere automáticamente una señal de riesgo con signal_type: "velocity", sin necesidad de una llamada API adicional.
Consulte la guía de puntuación de velocidad y anomalías para conocer el flujo de trabajo completo, el modelo de puntuación y los patrones de integración.
Notificaciones de webhook
Las señales de riesgo creadas por cualquiera de las cinco rutas de detección pueden activar notificaciones webhook en tiempo real. Suscríbase arisk.signal.created o risk.signal.escalated para reaccionar a nuevas señales sin sondeo. Esto cubre señales de ingesta directa, normalización de eventos, escaneos de deepfake, alertas de ATO y anomalías de velocidad.
Consulte la guía de webhooks para ejemplos de carga útil y patrones de integración.
Medición de uso
Las funciones antifraude se miden por ciclo de facturación. Cada ruta de detección incrementa su propio contador de uso:
Las cuotas varían según el nivel del plan. Puede verificar su consumo actual con la API de uso o en la consola en Configuración > Facturación > Uso en la sección Antifraude. Para verificar si una operación específica está permitida antes de realizarla, use el punto final de verificación de límites.
used, limit y period para que pueda monitorear el consumo programáticamente.
Consulte la descripción general de facturación para obtener la lista completa de 16 productos medidos y sus tarifas predeterminadas.
Qué sigue
- Guía de puntuación de velocidad y anomalías
- Guía de detección de toma de control de cuentas
- Guía de detección de deepfake e suplantación de identidad
- Referencia de la API de ingesta de señal de riesgo
- Referencia de la API de normalización de eventos de identidad
- Referencia de la API de lista de señales de riesgo
- Referencia de la API de obtención de señal de riesgo
- Seguridad a nivel de fila

