Adicione sinais de VPN e Tor à geolocalização do visitante

Compreenda quando a ligação de um visitante corresponde a uma rede VPN conhecida, a um nó de saída Tor, a uma rede de centro de dados/alojamento, ou a outra categoria de rede suportada. O Watch-IP adiciona estes indicadores às respostas elegíveis de GET /v1/geo, para que a sua aplicação os possa ponderar junto com outro contexto.

Ver que planos incluem segurança Ler a referência de geolocalização →

Planos elegíveis

security está incluído nos planos Starter, Growth, Scale e Enterprise. É omitido por completo da resposta no plano Free — não é enviado como um objeto enganosamente todo-false — por isso verifique a sua presença antes de ler qualquer campo dele.

A cobertura de IPv4 e IPv6 é diferente

As ligações IPv4 são verificadas em relação a listas de Tor, VPN, centro de dados, ameaça e rede sancionada. As ligações IPv6 são verificadas em relação a tudo exceto Tor — atualmente não existe nenhuma fonte gratuita de lista de saída Tor para IPv6, pelo que isTor é sempre false para uma ligação IPv6, independentemente de ser efetivamente um nó de saída Tor. Não descreva a cobertura de IPv6 como equivalente à de IPv4.

Omitido, false e true são estados diferentes

Um objeto security omitido significa que o seu plano não inclui estes dados, não que a ligação foi verificada e considerada limpa. Um valor false num campo incluído significa que não houve correspondência nas listas atualmente carregadas do Watch-IP — não é um veredito de segurança confirmado, uma vez que a deteção baseada em listas não consegue ver tudo. Nunca apresente um resultado não avaliado ou false como "Limpo", "Seguro" ou "Verificado".

Fontes e atualizações

As listas por trás destes campos são compiladas e armazenadas no nosso próprio armazenamento e atualizadas periodicamente. Um arranque a frio bloqueia brevemente na sua primeira pesquisa; depois de carregada, um pedido é servido a partir de uma cache em memória enquanto uma atualização é executada em segundo plano, pelo que uma atualização lenta ou falhada degrada para dados obsoletos ou vazios, em vez de uma resposta com falha.

Um exemplo de fluxo de revisão

Trate isVpn ou isDatacenter como uma entrada para uma fila de revisão manual, junto com o histórico da conta e outros sinais, não como base única para bloquear um visitante por completo. Combiná-lo com uma verificação de e-mail descartável no mesmo evento de registo, por exemplo, é uma forma razoável de encaminhar um pequeno número de registos para revisão, em vez de rejeitar todos os utilizadores de VPN.

O que isto não faz

Estes campos não identificam proxies residenciais, não verificam identidade, e não são um produto abrangente de deteção de ameaças ou anonimato — são um pequeno conjunto de indicadores baseados em listas.

Campos de resposta de segurança

isTor: Nó de saída Tor conhecido, a partir da lista de saída IPv4 atualmente carregada. Sempre false para IPv6.
isVpn: Rede de fornecedor de VPN comercial conhecida, IPv4 e IPv6.
isDatacenter: Rede de centro de dados/alojamento — um superconjunto de VPN, uma vez que muitas saídas de VPN funcionam sobre infraestrutura de alojamento.
isThreat: Num intervalo de IP malicioso conhecido ou num ASN de ameaça conhecida, IPv4 e IPv6.
isSanctionedNetwork: Numa lista mantida pelo Watch-IP de operadores de rede de telecomunicações/alojamento sancionados pelo Estado, revista trimestralmente — um sinal mais suave e de menor confiança do que os outros campos, não uma triagem de conformidade de sanções.

Leia os campos de segurança com segurança

JavaScript no navegador

const response = await fetch('https://api.watch-ip.com/v1/geo', {
  headers: { 'X-Api-Key': 'YOUR_PUBLISHABLE_KEY' },
});
const geo = await response.json();

if (!geo.security) {
  // O seu plano não inclui dados de segurança — não assuma nada sobre esta ligação.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Uma correspondência em lista — uma entrada para a sua própria lógica de revisão, não um bloqueio por si só.
} else {
  // Sem correspondência nas listas atualmente carregadas — não é uma garantia de que a ligação é segura.
}

Verifique sempre se `security` está presente antes de ler um campo dele — um objeto ausente e um campo presente mas false significam coisas diferentes.

Perguntas frequentes

Deteta proxies residenciais?

Não. As listas atuais cobrem VPN comercial, Tor, centro de dados e redes de ameaça/sancionadas conhecidas — não a categoria mais ampla de serviços de proxy residencial, que encaminham através de endereços IP de consumidores reais e são muito mais difíceis de corresponder por lista.

O que significa false?

Nenhuma correspondência nas listas que o Watch-IP tem atualmente carregadas. Não é uma afirmação positiva de que a ligação é segura, uma vez que uma lista não consegue cobrir todas as VPNs, nós de saída ou redes maliciosas existentes.

O Tor em IPv6 está coberto?

Não. isTor é sempre false para uma ligação IPv6 atualmente — não existe nenhuma fonte gratuita de lista de saída Tor para IPv6 na implementação atual. Todos os outros campos cobrem IPv6.

Estas verificações estão disponíveis para IPs arbitrários?

Não atualmente. Estes dados fazem parte da resposta de GET /v1/geo apenas para o navegador em ligação; os endpoints separados de pesquisa de IP (/v1/lookup) não devolvem um bloco de segurança.

Posso bloquear apenas com base num sinalizador?

Pode, mas um único sinalizador baseado em lista é uma base fraca para um bloqueio automático por si só — ocorrem falsos positivos, e utilizadores legítimos passam por VPNs e redes partilhadas por motivos comuns. A maioria das integrações utiliza estes campos como uma entrada para uma decisão de revisão.