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çãoPOST para /v1/risk/velocity/record com o assunto, tipo de ação e metadados opcionais:
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:Listando anomalias de alta velocidade
Consulte os assuntos com pontuações de velocidade acima de um limite em seu locatário: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 paraPOST /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.

