Saltar para o conteúdo principal
A API de detecção de tomada de conta (ATO) monitora a atividade de login por assunto e sinaliza padrões suspeitos em tempo real. Ela rastreia a velocidade de logins falhos em uma janela contínua de uma hora, atribui um nível de risco com base em limites configuráveis e cria automaticamente alertas e sinais de risco quando esses limites são excedidos.
A detecção de ATO faz parte do Anti-Fraud Identity Firewall. Alertas e sinais de risco fluem para o mesmo pipeline que outros sinais de fraude, para que você possa consultá-los e revisá-los na página do console Risco e Fraude > Sinais ou no endpoint de listagem de sinais.

Como funciona

1

Enviar eventos de login

Chame POST /v1/risk/ato/evaluate cada vez que um evento de login ocorrer — tentativas falhas, falhas repetidas, logins de novos dispositivos ou logins bem-sucedidos.
2

Rastreamento de velocidade

A plataforma incrementa (ou redefine) o contador de logins falhos para o assunto em uma janela contínua de uma hora. Logins bem-sucedidos redefinem a janela.
3

Atribuição de nível de risco

Um nível de risco é derivado da contagem atual de logins falhos. A resposta inclui o nível de risco, a pontuação numérica e o valor atual do contador.
4

Alertas e sinais automáticos

Quando um assunto cruza um limite, a plataforma cria um alerta e ingere um sinal de risco com signal_type: "ato". Você não precisa de uma chamada de API separada.
5

Revisar e responder

Consulte perfis ATO, liste alertas e revise sinais na console ou via API para investigar e responder a ameaças.

Pré-requisitos

  • Um inquilino Truthlocks ativo com uma chave de API
  • Dados de eventos de login do seu sistema de autenticação (logins falhos, sucessos, novos eventos de dispositivo)

Avaliando um evento de login

Envie uma requisição POST para /v1/risk/ato/evaluate com o assunto e detalhes do evento:
A resposta informa a postura de risco atual e se um alerta foi acionado:

Regras de limite

A plataforma atribui um nível de risco com base no número de logins falhos em uma janela deslizante de uma hora: Quando um limite é ultrapassado:
  1. Um alerta é criado na tabela de alertas ATO
  2. Um sinal de risco é automaticamente ingerido com signal_type: "ato" e a pontuação correspondente
  3. A resposta inclui alert: true, o alert_type e o signal_id

Tipos de eventos

Verificando o perfil de risco de um sujeito

Recupere o perfil de risco ATO atual para um assunto sem acionar uma nova avaliação:
O perfil inclui o nível de risco atual, a contagem de logins falhos e listas de endereços IP e dispositivos conhecidos associados ao sujeito.

Listando alertas

Consulte os alertas ATO para seu locatário, opcionalmente filtrados por assunto:
Cada alerta inclui o assunto, tipo de alerta, nível de risco no momento do disparo e uma referência ao sinal de risco auto-ingerido.

Padrões de integração

Bloquear ou desafiar em caso de risco elevado

Use o risk_level da resposta de avaliação para decidir se permite, desafia ou bloqueia um login:

Combinar com normalização de eventos

A avaliação de ATO pode complementar o pipeline de normalização de eventos. Use a normalização de eventos para pontuação de risco ampla em todos os eventos de identidade e a avaliação de ATO para monitoramento focado de aquisição de conta com alertas baseados em limite.

Combinar com pontuação de velocidade

A detecção de ATO se concentra em padrões de aquisição de conta baseados em login com regras de limite integradas e gerenciamento de alertas. A pontuação de velocidade rastreia qualquer tipo de ação em várias janelas de tempo contínuas (1 m, 5 m, 1 h, 24 h) com detecção de pico ponderada. Use ambos juntos para proteção em camadas:
  • Detecção de ATO para segurança de login focada — velocidade de login falho, alertas de preenchimento de credenciais, perfis de risco do sujeito
  • Pontuação de velocidade para detecção geral de abuso — abuso de taxa de API, inundação de transações, spam de registro ou qualquer tipo de ação personalizada
Ambos produzem sinais de risco no mesmo pipeline unificado, para que você possa consultar e revisar todos os sinais de um só lugar.

Monitorizar via webhooks

Configure um endpoint de webhook para receber notificações em tempo real quando alertas ATO forem criados, para que sua equipe de segurança possa responder sem sondagem.

O que vem a seguir