Conheça a Guarda: inteligência de IP para decisões reais sobre tráfego
Uma introdução à Guarda — o que nossa API de inteligência de IP verifica, como o score de risco é construído e como equipes usam esses sinais para diferenciar usuários reais de proxies, VPNs e bots.
Por que criamos a Guarda
Todo produto online, cedo ou tarde, esbarra no mesmo desafio: uma requisição chega, e você tem poucos milissegundos para decidir o quanto pode confiar nela. A conta pode ser legítima. Ou pode ser o quinto cadastro vindo de um IP alugado em um datacenter no último minuto. Naquele instante, o único sinal realmente disponível é a própria conexão — o endereço IP, a rede por trás dele e o uso típico dessa rede.
A Guarda nasceu para transformar esse sinal limitado em uma decisão acionável. Consultamos o endereço, classificamos a rede à qual ele pertence e devolvemos um veredito acompanhado das evidências que levaram a ele.
O que uma consulta retorna de fato
Uma única chamada à API entrega:
- Tipo de conexão — residencial, operadora móvel, corporativa ou hosting/datacenter.
- Sinais de anonimização — proxy, VPN, nó de saída TOR ou open relay.
- Identidade da rede — ASN, nome da organização e o intervalo em que o endereço está inserido.
- Geolocalização — país, região e cidade, com a observação honesta de que dados em nível de cidade são uma estimativa, não um fato absoluto.
- Score de risco — um resumo de 0 a 100 de todos os sinais acima, para que você possa definir um limite em vez de manter dez regras diferentes.
O ponto mais importante é que as evidências acompanham o score. Se um endereço for sinalizado, você consegue entender se isso aconteceu porque ele pertence a um provedor de nuvem, porque aparece em uma lista de nós de saída TOR ou porque aquele ASN de hosting tem histórico de abuso automatizado. Scores que não podem ser explicados são scores em que ninguém confia numa fila de revisão em produção.
Classificação acima de rótulos genéricos
Há algo com que nos preocupamos mais do que a maioria: chamar uma rede pelo que ela realmente é. Um resolver DNS do Google ou um endereço da Cloudflare não é uma VPN. É infraestrutura. Rotular todo tráfego não residencial como "VPN" é o caminho mais rápido para perder a confiança de uma equipe antifraude, porque basta um analista verificar um IP conhecido e encontrar um rótulo errado para que todos os outros vereditos passem a parecer suspeitos.
Por isso, a Guarda separa hosting/datacenter de VPN comercial, e ambos de proxy residencial. Na prática, essas três categorias representam riscos muito diferentes — e merecem respostas diferentes.
Como as equipes usam
Os padrões que mais vemos no dia a dia:
- Proteção no cadastro. Aplique o score no registro; envie endereços de alto risco para verificação por email ou telefone em vez de bloquear automaticamente.
- Risco em pagamentos. Combine o veredito do IP com divergência de país de cobrança e velocidade de uso do cartão. IP sozinho nunca deveria recusar um pagamento, mas é um excelente critério de desempate.
- Conteúdo e licenciamento. Detecte saídas de VPN comercial quando direitos geográficos realmente exigirem esse controle.
- Higiene de analytics. Remova tráfego de datacenter dos relatórios para que suas métricas de conversão descrevam pessoas, não automações.
Pensada para o caminho crítico
A API funciona com uma única chamada HTTP usando uma chave, com JSON na entrada e na saída. Os resultados são armazenados em cache, para que consultas repetidas ao mesmo endereço não gerem uma nova ida e volta desnecessária. Também há consultas em lote para análise de logs e backfills. E você pode testar qualquer endereço na página inicial, sem criar conta, antes de escrever uma linha de código.
O que vem a seguir neste blog
Vamos manter este blog bem prático: como os sinais de detecção funcionam de verdade, onde eles falham, quanto custam os falsos positivos e como criar políticas que bloqueiem abuso sem punir o cliente usando o Wi-Fi de um hotel. Se houver algum tema que você queira ver por aqui, conte para nós — esta é a referência que gostaríamos de ter encontrado quando começamos.
Bem-vindo a bordo.
