Saltar al contenido principal
La API de detección de toma de control de cuentas (ATO) monitorea la actividad de inicio de sesión por sujeto y marca patrones sospechosos en tiempo real. Rastrea la velocidad de inicio de sesión fallidos en una ventana móvil de una hora, asigna un nivel de riesgo basado en umbrales configurables y crea automáticamente alertas y señales de riesgo cuando se superan esos umbrales.
La detección de ATO forma parte del Cortafuegos de Identidad Antifraude. Las alertas y las señales de riesgo fluyen por el mismo conducto 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 endpoint de lista de señales.

Cómo funciona

1

Enviar eventos de inicio de sesión

Llame a POST /v1/risk/ato/evaluate cada vez que ocurra un evento de inicio de sesión: intentos fallidos, fallas repetidas, inicios de sesión en nuevos dispositivos o inicios de sesión exitosos.
2

Seguimiento de velocidad

La plataforma incrementa (o restablece) el contador de inicios de sesión fallidos para el sujeto en una ventana deslizante de una hora. Los inicios de sesión exitosos restablecen la ventana.
3

Asignación de nivel de riesgo

Se deriva un nivel de riesgo del recuento actual de inicios de sesión fallidos. La respuesta incluye el nivel de riesgo, la puntuación numérica y el valor actual del contador.
4

Alertas y señales automáticas

Cuando un sujeto cruza un umbral, la plataforma crea una alerta e ingiere una señal de riesgo con signal_type: "ato". No necesita una llamada a la API separada.
5

Revisar y responder

Consulta perfiles ATO, lista alertas y revisa señales en la consola o a través de la API para investigar y responder a amenazas.

Requisitos previos

  • Un inquilino activo de Truthlocks con una clave API
  • Datos de eventos de inicio de sesión de su sistema de autenticación (inicios de sesión fallidos, éxitos, eventos de nuevos dispositivos)

Evaluación de un evento de inicio de sesión

Envíe una solicitud POST a /v1/risk/ato/evaluate con el asunto y los detalles del evento:
La respuesta le indica la postura de riesgo actual y si se activó una alerta:

Reglas de umbral

La plataforma asigna un nivel de riesgo basado en el número de inicios de sesión fallidos dentro de una ventana móvil de una hora: Cuando se cruza un umbral:
  1. Se crea una alerta en la tabla de alertas de ATO.
  2. Se ingiere automáticamente una señal de riesgo con signal_type: "ato" y la puntuación correspondiente.
  3. La respuesta incluye alert: true, el alert_type y el signal_id

Tipos de eventos

Comprobación del perfil de riesgo de un sujeto

Recuperar el perfil de riesgo ATO actual para un sujeto sin activar una nueva evaluación:
El perfil incluye el nivel de riesgo actual, el recuento de inicios de sesión fallidos y listas de direcciones IP y dispositivos conocidos asociados con el sujeto.

Listado de alertas

Consultar alertas ATO para su inquilino, opcionalmente filtradas por asunto:
Cada alerta incluye el sujeto, el tipo de alerta, el nivel de riesgo en el momento del disparo y una referencia a la señal de riesgo auto-ingestada.

Patrones de integración

Bloquear o desafiar ante un riesgo elevado

Utilice el risk_level de la respuesta de evaluación para decidir si permitir, desafiar o bloquear un inicio de sesión:

Combinar con normalización de eventos

La evaluación de ATO puede complementar la canalización de normalización de eventos. Utilice la normalización de eventos para una puntuación de riesgo amplia en todos los eventos de identidad, y la evaluación de ATO para un monitoreo enfocado de la toma de control de cuentas con alertas basadas en umbrales.

Combinar con puntuación de velocidad

La detección de ATO se centra en patrones de toma de control de cuentas basados en el inicio de sesión con reglas de umbral integradas y gestión de alertas. La puntuación de velocidad rastrea cualquier tipo de acción en múltiples ventanas de tiempo continuas (1 m, 5 m, 1 h, 24 h) con detección de ráfagas ponderada. Use ambos juntos para una protección en capas:
  • 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
  • Puntuación de velocidad para la detección general de abusos — abuso de la tasa de API, inundación de transacciones, spam de registro o cualquier tipo de acción personalizada
Ambos producen señales de riesgo en el mismo pipeline unificado, para que pueda consultar y revisar todas las señales desde un solo lugar.

Monitorear a través de webhooks

Configure un punto final de webhook para recibir notificaciones en tiempo real cuando se creen alertas de ATO, para que su equipo de seguridad pueda responder sin sondeos.

Qué sigue