← Voltar ao blog

API de pontuação de fraude: IP, e-mail e telefone

API de pontuação de fraude: IP, e-mail e telefone

Uma API de pontuação de fraude para dados de IP, e-mail e telefone combina vários sinais de risco independentes em um único número, para que você tome uma decisão só em vez de lidar com quatro verificações separadas. A pontuação de fraude do ipto recebe um endereço IP, um e-mail, um número de telefone e um User-Agent, e retorna uma nota de 0 a 100 com um detalhamento do que contribuiu.

O motivo para fundir os sinais é que cada um é fraco isoladamente. Um endereço de VPN é normal para muitos usuários honestos. Um e-mail descartável pode ser só alguém protegendo a caixa de entrada. Um User-Agent com cara de bot pode ser uma ferramenta de monitoramento. Juntos, porém, uma saída Tor, um domínio de e-mail descartável e um User-Agent de automação em um mesmo cadastro formam uma combinação incomum, e uma pontuação combinada a evidencia.

O que entra na pontuação

Cada entrada é pontuada pela ferramenta correspondente do ipto, e os resultados são combinados com pesos fixos. O IP conta 40 por cento, e e-mail, telefone e User-Agent contam 20 por cento cada. A lógica de cada componente é deliberadamente simples e inspecionável:

  • IP. Baseado na pontuação de abuso corroborada, quando existe; caso contrário, uma saída Tor pontua alto, um endereço de VPN pontua moderadamente e um endereço sem sinalizadores pontua baixo. Você pode explorar essas entradas com o verificador de VPN, Tor e proxy e o verificador de abuso de IP.
  • E-mail. Sintaxe inválida pontua alto, um domínio descartável pontua alto, um domínio sem registros MX funcionais pontua no meio e um endereço bem formado em um domínio normal pontua baixo. É a mesma lógica do verificador de e-mail.
  • Telefone. Um número que falha na validação do plano de numeração pontua alto, um válido pontua baixo. Como o verificador de telefone usa um parser autohospedado, sem consulta ativa a operadoras, trata-se de uma verificação de plausibilidade, não de prova de que o número está ativo.
  • User-Agent. Um cliente que é interpretado como bot ou rastreador pontua alto; um navegador comum pontua baixo, usando a mesma análise do parser de User-Agent.

A resposta lista cada sinal com sua própria pontuação e os campos brutos por trás dela, como is_vpn, is_tor, risk_tier, has_mx, disposable e is_bot. Isso torna o número explicável: quando um usuário é sinalizado, você pode dizer exatamente por quê.

Como as entradas ausentes são tratadas

O tráfego real é incompleto. Uma tentativa de login pode ter IP e User-Agent, mas nenhum e-mail, e um formulário de cadastro pode pular o campo de telefone. A pontuação de fraude não trata uma entrada ausente como "limpa". Os sinais ausentes são deixados de fora, e o peso dos sinais que você forneceu é reescalado para que somem o total da pontuação.

Na prática, se você enviar apenas um IP, ele carrega o peso total, de modo que uma saída Tor produz uma pontuação alta em vez de ser diluída em direção ao seguro por três campos vazios. Se você enviar um IP e um e-mail, os pesos passam a ser aproximadamente dois terços e um terço. Vale conhecer duas limitações. Se nenhuma entrada for resolvida, a pontuação recai sobre uma linha de base baixa. E o sinal de IP atualmente cobre apenas IPv4, já que os dados de ameaças para IPv6 não estão disponíveis da mesma forma; um endereço IPv6 é ignorado em vez de pontuado como limpo, então combine-o com as outras entradas.

Da pontuação à ação

A pontuação corresponde a um nível de risco: abaixo de 20 é baixo, de 20 a 44 é médio, de 45 a 69 é alto e 70 ou mais é crítico. Trate esses níveis como uma estimativa a priori que indica onde aplicar atrito. Um padrão razoável é permitir pontuações baixas, pedir um segundo fator ou confirmação por e-mail nas médias e altas, e colocar as críticas em uma fila de revisão. A ferramenta não deve ser a única base para negar um cliente e não substitui seus próprios sinais, como histórico de pedidos, histórico de dispositivos ou registros de chargeback, que o ipto não coleta.

Experimentando

A forma mais rápida de ver o comportamento é o verificador de pontuação de fraude: preencha um campo, anote a pontuação, depois adicione os outros e observe o detalhamento mudar. O mesmo recurso está disponível pela API, documentada na documentação da API, com as quatro entradas opcionais. Executá-lo em uma amostra dos seus cadastros recentes é uma boa maneira de descobrir qual sinal impulsiona o risco no seu tráfego, e o raciocínio por trás do componente de IP é abordado com mais detalhe em pontuação de reputação de IP explicada.

Respostas diretas

É uma API que une sinais de um endereço IP, de um e-mail, de um número de telefone e, muitas vezes, de um User-Agent em uma única pontuação. A versão do ipto retorna uma nota de 0 a 100 com um detalhamento de quanto cada sinal contribuiu.
As entradas ausentes são omitidas em vez de contadas como limpas, e os pesos dos sinais restantes são reescalados para cobrir a pontuação inteira. Enviar apenas um IP, portanto, dá a ele o peso total.
O IP pesa 40 por cento e e-mail, telefone e User-Agent pesam 20 por cento cada, reescalados quando algumas entradas não são fornecidas. Pontuações de 70 ou mais são críticas, de 45 a 69 altas, de 20 a 44 médias e abaixo de 20 baixas.
← Voltar ao blog