La puntuación de velocidad forma parte del Cortafuegos de Identidad Anti-Fraude. Las señales generadas por anomalías de velocidad fluyen a la misma canalización que otras señales de fraude, por lo que puede consultarlas y revisarlas desde la página de la consola Riesgo y Fraude > Señales o el punto de conexión de lista de señales.
Cómo funciona
1
Registrar acciones
Llame a
POST /v1/risk/velocity/record cada vez que un sujeto realice una acción rastreada: intentos de inicio de sesión, llamadas a la API, solicitudes de transacciones o cualquier tipo de acción personalizada.2
Seguimiento de ventana deslizante
La plataforma incrementa los contadores para el sujeto y el tipo de acción en cuatro ventanas deslizantes (1 m, 5 m, 1 h, 24 h). Las ventanas se restablecen automáticamente cuando expiran.
3
Puntuación ponderada
Se calcula una puntuación de velocidad a partir de los recuentos de la ventana. Las ventanas cortas tienen un peso mayor para detectar ráfagas: 1 m × 30, 5 m × 20, 1 h × 10, 24 h × 5.
4
Ingesta automática de señales
Cuando la puntuación de velocidad alcanza 60 o más, la plataforma ingiere automáticamente una señal de riesgo con
signal_type: "velocity". No necesita una llamada a la API separada.5
Revisar y responder
Consulta ventanas de velocidad para un sujeto, lista anomalías de alta velocidad en tu inquilino y revisa señales en la consola o a través de la API.
Requisitos previos
- Un inquilino activo de Truthlocks con una clave API
- Datos de eventos de acción de su aplicación (intentos de inicio de sesión, llamadas API, transacciones o cualquier acción repetible)
Grabación de una acción
Envíe una solicitudPOST a /v1/risk/velocity/record con el asunto, el tipo de acción y metadatos opcionales:
Modelo de puntuación
La puntuación de velocidad es una suma ponderada de los recuentos de acciones en cuatro ventanas móviles. Las ventanas cortas tienen un peso mayor para priorizar la detección de ráfagas:
La puntuación final está limitada a 100. Cuando la puntuación alcanza 60 o más, se ingiere automáticamente una señal de riesgo con
signal_type: "velocity".
Interpretación de la puntuación
Consulta de ventanas de velocidad
Recuperar las ventanas de velocidad actuales para un sujeto específico:Listado de anomalías de alta velocidad
Consultar sujetos con puntuaciones de velocidad superiores a un umbral en su inquilino:Patrones de integración
Bloquear o limitar ante alta velocidad
Utilice la puntuación de velocidad de la respuesta del registro para decidir si permitir, limitar o bloquear una acción:Combinar con detección de ATO
La puntuación de velocidad rastrea cualquier tipo de acción en múltiples ventanas de tiempo, mientras que la detección de ATO está específicamente optimizada para patrones de toma de control de cuentas basados en inicio de sesión con reglas de umbral y gestión de alertas integradas. Utilice ambos juntos para una protección por capas:- Puntuación de velocidad para la detección general de abusos — abuso de la tasa de API, inundación de transacciones, spam de registro
- Detección de ATO para seguridad de inicio de sesión enfocada: velocidad de inicio de sesión fallida, alertas de relleno de credenciales, perfiles de riesgo del sujeto
Monitorear a través de webhooks
Configure un punto final de webhook para recibir notificaciones en tiempo real cuando se creen señales de riesgo basadas en la velocidad, para que su equipo de seguridad pueda responder sin sondeos.Tipos de acciones personalizadas
Puede rastrear cualquier tipo de acción que produzca su aplicación. Ejemplos comunes:Medición de uso
Cada llamada aPOST /v1/risk/velocity/record incrementa el contador de uso de antifraud.velocity_records para su ciclo de facturación. Puede monitorear su consumo con la API de uso o en la consola en Configuración > Facturación > Uso en la sección Antifraude.
Las cuotas de registro de velocidad varían según el nivel del plan. Consulte la descripción general de facturación para obtener detalles sobre todos los productos medidos de Anti-Fraude.
Qué sigue
- Referencia de la API de registro de acción de velocidad
- Referencia de la API de obtención de ventanas de velocidad
- Referencia de la API de lista de anomalías de velocidad
- Guía de señales de riesgo
- Guía de detección de toma de control de cuentas
- Guía de detección de deepfake e suplantación de identidad

