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çãoPOST para /v1/risk/ato/evaluate com o assunto e detalhes do evento:
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:
- Um alerta é criado na tabela de alertas ATO
- Um sinal de risco é automaticamente ingerido com
signal_type: "ato"e a pontuação correspondente - A resposta inclui
alert: true, oalert_typee osignal_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:Listando alertas
Consulte os alertas ATO para seu locatário, opcionalmente filtrados por assunto:Padrões de integração
Bloquear ou desafiar em caso de risco elevado
Use orisk_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

