Ajouter des signaux VPN et Tor à la géolocalisation du visiteur

Détectez quand la connexion d'un visiteur correspond à un réseau VPN connu, un nœud de sortie Tor, un réseau de centre de données/hébergement, ou une autre catégorie de réseau prise en charge. Watch-IP ajoute ces indicateurs aux réponses GET /v1/geo éligibles afin que votre application puisse les pondérer avec d'autres éléments de contexte.

Voir quels forfaits incluent les champs de sécurité Lire la référence geo →

Forfaits éligibles

security est inclus dans les forfaits Starter, Growth, Scale et Enterprise. Il est totalement absent de la réponse sur le forfait Free — il n'est pas envoyé comme un objet trompeur où tout serait à false — vérifiez donc sa présence avant de lire l'un de ses champs.

La couverture IPv4 et IPv6 diffère

Les connexions IPv4 sont vérifiées par rapport aux listes Tor, VPN, centre de données, menace et réseaux sous sanctions. Les connexions IPv6 sont vérifiées par rapport à tout, sauf Tor — il n'existe actuellement aucune source gratuite de liste de sortie Tor pour l'IPv6, donc isTor est toujours à false pour une connexion IPv6, qu'il s'agisse réellement d'une sortie Tor ou non. Ne présentez pas la couverture IPv6 comme équivalente à celle de l'IPv4.

Absent, false et true sont trois états différents

Un objet security absent signifie que votre forfait n'inclut pas cette donnée, pas que la connexion a été vérifiée et jugée saine. Une valeur false sur un champ inclus signifie qu'il n'y a pas de correspondance dans les listes actuellement chargées par Watch-IP — pas un verdict de sécurité confirmée, car une détection basée sur des listes ne peut pas tout voir. N'affichez jamais un résultat non évalué ou à false comme « Propre », « Sûr » ou « Vérifié ».

Sources et mises à jour

Les listes derrière ces champs sont compilées, stockées dans notre propre stockage et actualisées selon un calendrier. Un démarrage à froid bloque brièvement lors de sa première recherche ; une fois chargées, les requêtes sont servies depuis un cache en mémoire pendant qu'une actualisation s'exécute en arrière-plan, si bien qu'une actualisation lente ou en échec se dégrade en données obsolètes ou vides plutôt qu'en réponse défaillante.

Exemple de workflow de revue

Considérez isVpn ou isDatacenter comme un élément parmi d'autres dans une file de revue manuelle, aux côtés de l'historique du compte et d'autres signaux, et non comme le seul critère pour bloquer un visiteur d'emblée. Le combiner à une vérification d'e-mail jetable sur le même événement d'inscription, par exemple, est un moyen raisonnable d'orienter un petit nombre d'inscriptions vers une revue plutôt que de rejeter tous les utilisateurs de VPN.

Ce que cela ne fait pas

Ces champs n'identifient pas les proxys résidentiels, ne vérifient pas l'identité et ne constituent pas un produit complet de détection de menace ou d'anonymat — ce sont un petit ensemble d'indicateurs basés sur des listes.

Champs de la réponse de sécurité

isTor: Nœud de sortie Tor connu, d'après la liste de sortie IPv4 actuellement chargée. Toujours false en IPv6.
isVpn: Réseau d'un fournisseur VPN commercial connu, en IPv4 et IPv6.
isDatacenter: Réseau de centre de données/hébergement — un sur-ensemble du VPN, car de nombreuses sorties VPN fonctionnent sur une infrastructure d'hébergement.
isThreat: Sur une plage IP malveillante connue ou un ASN de menace connu, en IPv4 et IPv6.
isSanctionedNetwork: Sur une liste maintenue par Watch-IP d'opérateurs de réseaux télécom/hébergement sous sanctions étatiques, revue trimestriellement — un signal plus faible et moins fiable que les autres champs, et non un contrôle de conformité aux sanctions.

Lire les champs de sécurité en toute sécurité

JavaScript navigateur

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) {
  // Votre forfait n'inclut pas les données de sécurité — ne présumez rien de cette connexion.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Correspondance dans une liste — un élément parmi d'autres pour votre logique de revue, pas un blocage à lui seul.
} else {
  // Aucune correspondance dans les listes actuellement chargées — pas une garantie que la connexion est sûre.
}

Vérifiez toujours si `security` est présent avant d'en lire un champ — un objet absent et un champ présent mais à false ne signifient pas la même chose.

Questions fréquentes

Détecte-t-il les proxys résidentiels ?

Non. Les listes actuelles couvrent les VPN commerciaux, Tor, les centres de données et les réseaux de menace/sanctionnés connus — pas la catégorie plus large des services de proxy résidentiel, qui transitent par de vraies adresses IP grand public et sont beaucoup plus difficiles à repérer par liste.

Que signifie false ?

Aucune correspondance dans les listes actuellement chargées par Watch-IP. Ce n'est pas une affirmation positive que la connexion est sûre, car une liste ne peut pas couvrir tous les VPN, nœuds de sortie ou réseaux malveillants existants.

L'IPv6 Tor est-il couvert ?

Non. isTor est aujourd'hui toujours à false pour une connexion IPv6 — il n'existe aucune source gratuite de liste de sortie Tor en IPv6 dans l'implémentation actuelle. Tous les autres champs couvrent bien l'IPv6.

Ces vérifications sont-elles disponibles pour des IP arbitraires ?

Pas actuellement. Ces données font partie de la réponse GET /v1/geo pour le navigateur connecté uniquement ; les points de terminaison de recherche d'IP distincts (/v1/lookup) ne renvoient pas de bloc security.

Puis-je bloquer uniquement sur un indicateur ?

Vous le pouvez, mais un seul indicateur basé sur une liste constitue une base faible pour un blocage automatique à lui seul — les faux positifs existent, et des utilisateurs légitimes passent par des VPN ou des réseaux partagés pour des raisons ordinaires. La plupart des intégrations utilisent ces champs comme un élément parmi d'autres dans une décision de revue.