Saltar al contenido principal
POST
Evaluar riesgo ATO
Evalúa un evento de inicio de sesión contra el motor heurístico ATO. La plataforma rastrea los inicios de sesión fallidos por sujeto en una ventana móvil de una hora y deriva un nivel de riesgo del recuento actual. Cuando se cruza un umbral, se crea una alerta y una señal de riesgo se ingiere automáticamente en la canalización de señales de riesgo. 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.

Reglas de umbral

Respuesta

string
El sujeto que fue evaluado.
string
Tipo de sujeto (user).
string
Nivel de riesgo ATO actual: normal | elevated | high | critical
integer
Puntuación de riesgo numérica: 10 (normal), 50 (elevada), 70 (alta), 90 (crítica).
integer
Número de inicios de sesión fallidos en la ventana actual de una hora.
boolean
true si esta evaluación activó una nueva alerta.
string
Categoría de alerta cuando se activa: velocity_exceeded o credential_stuffing.
string
UUID de la señal de riesgo auto-ingestada (solo presente cuando se activó una alerta).
string
El tipo de evento que se evaluó.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
event_type
string
requerido
subject_id
string
requerido
device
string
ip_address
string
subject_type
string
user_agent
string

Respuesta

Resultado de la evaluación de ATO

risk_score
integer
decision
string
signals
object[]