Saltar para o conteúdo principal
A API de pontuação de velocidade e anomalia rastreia a frequência com que um sujeito executa uma determinada ação em várias janelas de tempo contínuas — 1 minuto, 5 minutos, 1 hora e 24 horas. Quando a pontuação de velocidade ponderada ultrapassa um limite, a plataforma cria automaticamente um sinal de risco, conectando a detecção de anomalias diretamente ao pipeline do Firewall de Identidade Antifraude.
A pontuação de velocidade faz parte do Firewall de Identidade Anti-Fraude. Os sinais gerados por anomalias de velocidade 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

Registrar ações

Chame POST /v1/risk/velocity/record cada vez que um sujeito realizar uma ação rastreada — tentativas de login, chamadas de API, solicitações de transação ou qualquer tipo de ação personalizada.
2

Rastreamento de janela contínua

A plataforma incrementa contadores para o assunto e tipo de ação em quatro janelas contínuas (1 m, 5 m, 1 h, 24 h). As janelas são redefinidas automaticamente quando expiram.
3

Pontuação ponderada

Uma pontuação de velocidade é calculada a partir das contagens da janela. Janelas curtas são ponderadas mais pesadamente para detectar picos: 1 m × 30, 5 m × 20, 1 h × 10, 24 h × 5.
4

Ingestão automática de sinais

Quando a pontuação de velocidade atinge 60 ou mais, a plataforma ingere automaticamente um sinal de risco com signal_type: "velocity". Você não precisa de uma chamada de API separada.
5

Revisar e responder

Consulte janelas de velocidade para um assunto, liste anomalias de alta velocidade em seu locatário e revise sinais na console ou via API.

Pré-requisitos

  • Um inquilino Truthlocks ativo com uma chave de API
  • Dados de eventos de ação de seu aplicativo (tentativas de login, chamadas de API, transações ou qualquer ação repetível)

Registrando uma ação

Envie uma requisição POST para /v1/risk/velocity/record com o assunto, tipo de ação e metadados opcionais:
A resposta retorna as contagens da janela atual, a pontuação de velocidade calculada e se um sinal de risco foi ingerido automaticamente:

Modelo de pontuação

A pontuação de velocidade é uma soma ponderada das contagens de ações em quatro janelas contínuas. Janelas curtas têm maior peso para priorizar a detecção de picos: A pontuação final é limitada a 100. Quando a pontuação atinge 60 ou mais, um sinal de risco é automaticamente ingerido com signal_type: "velocity".

Interpretação da pontuação

Consultando janelas de velocidade

Recupere as janelas de velocidade atuais para um assunto específico:
A resposta inclui todos os tipos de ação rastreados para o sujeito, com contagens por janela e a pontuação de velocidade calculada para cada um:

Listando anomalias de alta velocidade

Consulte os assuntos com pontuações de velocidade acima de um limite em seu locatário:
Cada resultado inclui o assunto, tipo de ação, contagens da janela atual e a pontuação de velocidade que qualificou a anomalia:

Padrões de integração

Bloquear ou limitar em alta velocidade

Use a pontuação de velocidade da resposta do registro para decidir se permite, limita ou bloqueia uma ação:

Combinar com detecção de ATO

A pontuação de velocidade rastreia qualquer tipo de ação em várias janelas de tempo, enquanto a detecção de ATO é especificamente otimizada para padrões de aquisição de conta baseados em login com regras de limite e gerenciamento de alertas integrados. Use ambos juntos para proteção em camadas:
  • Pontuação de velocidade para detecção geral de abuso — abuso de taxa de API, inundação de transações, spam de registro
  • Detecção de ATO para segurança de login focada — velocidade de login falho, alertas de preenchimento de credenciais, perfis de risco do sujeito

Monitorizar via webhooks

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

Tipos de ação personalizados

Você pode rastrear qualquer tipo de ação que seu aplicativo produza. Exemplos comuns:

Medição de uso

Cada chamada para POST /v1/risk/velocity/record incrementa o contador de uso antifraud.velocity_records para o seu ciclo de faturamento. Você pode monitorar seu consumo com a API de uso ou no console em Configurações > Faturamento > Uso na seção Anti-Fraude.
As cotas de registro de velocidade variam de acordo com o nível do plano. Consulte a visão geral de faturamento para obter detalhes sobre todos os produtos medidos Anti-Fraude.

O que vem a seguir