Saltar al contenido principal
La API de puntuación de velocidad y anomalías rastrea la frecuencia con la que un sujeto realiza una acción determinada en múltiples ventanas de tiempo continuas: 1 minuto, 5 minutos, 1 hora y 24 horas. Cuando la puntuación de velocidad ponderada cruza un umbral, la plataforma crea automáticamente una señal de riesgo, conectando la detección de anomalías directamente a la tubería del Firewall de Identidad Antifraude.
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 solicitud POST a /v1/risk/velocity/record con el asunto, el tipo de acción y metadatos opcionales:
La respuesta devuelve los recuentos de la ventana actual, la puntuación de velocidad calculada y si una señal de riesgo fue ingerida automáticamente:

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:
La respuesta incluye todos los tipos de acciones rastreadas para el sujeto, con recuentos por ventana y la puntuación de velocidad calculada para cada uno:

Listado de anomalías de alta velocidad

Consultar sujetos con puntuaciones de velocidad superiores a un umbral en su inquilino:
Cada resultado incluye el sujeto, el tipo de acción, los recuentos de la ventana actual y la puntuación de velocidad que calificó la anomalía:

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 a POST /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