Voeg VPN- en Tor-signalen toe aan bezoekersgeolocatie

Begrijp wanneer de verbinding van een bezoeker overeenkomt met een bekend VPN-netwerk, Tor-exitnode, datacenter-/hostingnetwerk of een andere ondersteunde netwerkcategorie. Watch-IP voegt deze indicatoren toe aan in aanmerking komende GET /v1/geo-antwoorden, zodat je applicatie ze kan meewegen naast andere context.

Bekijk welke abonnementen beveiliging bevatten Lees de geo-referentie →

In aanmerking komende abonnementen

security is inbegrepen bij de abonnementen Starter, Growth, Scale en Enterprise. Het wordt volledig weggelaten uit het antwoord bij het Free-abonnement — niet verzonden als een misleidend, volledig op false gezet object — dus controleer of het aanwezig is voordat je er een veld uit leest.

IPv4- en IPv6-dekking verschillen

IPv4-verbindingen worden gecontroleerd tegen lijsten voor Tor, VPN, datacenter, dreiging en gesanctioneerde netwerken. IPv6-verbindingen worden tegen alles behalve Tor gecontroleerd — er is momenteel geen gratis bron voor een IPv6-Tor-exitlijst, dus isTor is voor een IPv6-verbinding altijd false, ongeacht of het daadwerkelijk om een Tor-exit gaat. Beschrijf de IPv6-dekking niet als gelijkwaardig aan IPv4.

Weggelaten, false en true zijn verschillende toestanden

Een weggelaten security-object betekent dat je abonnement deze gegevens niet bevat, niet dat de verbinding is gecontroleerd en schoon is bevonden. Een waarde false bij een wel inbegrepen veld betekent geen match in de momenteel geladen lijsten van Watch-IP — geen bevestigd veilig oordeel, omdat op lijsten gebaseerde detectie niet alles kan zien. Toon een niet-beoordeeld of false resultaat nooit als "Schoon", "Veilig" of "Geverifieerd".

Bronnen en updates

De lijsten achter deze velden worden samengesteld en opgeslagen in onze eigen opslag en volgens een schema ververst. Een koude start blokkeert kort bij de eerste opzoeking; eenmaal geladen wordt een verzoek bediend vanuit een in-memory cache terwijl een verversing op de achtergrond draait, zodat een trage of mislukte verversing degradeert naar verouderde of lege gegevens in plaats van een kapot antwoord.

Een voorbeeld van een beoordelingsworkflow

Behandel isVpn of isDatacenter als één input voor een wachtrij voor handmatige beoordeling naast accountgeschiedenis en andere signalen, niet als enige basis om een bezoeker volledig te blokkeren. Het combineren met een controle op wegwerp-e-mail bij dezelfde aanmelding is bijvoorbeeld een redelijke manier om een klein aantal aanmeldingen naar beoordeling te sturen in plaats van elke VPN-gebruiker af te wijzen.

Wat dit niet doet

Deze velden identificeren geen residentiële proxy's, verifiëren geen identiteit en zijn geen alomvattend product voor dreigings- of anonimiteitsdetectie — het zijn een kleine set op lijsten gebaseerde indicatoren.

Beveiligingsvelden in het antwoord

isTor: Bekend Tor-exitnode, uit de momenteel geladen IPv4-exitlijst. Altijd false voor IPv6.
isVpn: Bekend commercieel VPN-providernetwerk, IPv4 en IPv6.
isDatacenter: Datacenter-/hostingnetwerk — een superset van VPN, aangezien veel VPN-exits op hostinginfrastructuur draaien.
isThreat: Op een bekend kwaadaardig IP-bereik of een bekende dreigings-ASN, IPv4 en IPv6.
isSanctionedNetwork: Op een door Watch-IP onderhouden lijst van door de staat gesanctioneerde telecom-/hostingnetwerkexploitanten, elk kwartaal beoordeeld — een zachter, minder betrouwbaar signaal dan de andere velden, geen sanctie-nalevingsscreening.

Lees de beveiligingsvelden veilig

Browser-JavaScript

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) {
  // Je abonnement bevat geen beveiligingsgegevens — neem niets aan over deze verbinding.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Een match in de lijst — één input voor je eigen beoordelingslogica, geen blokkade op zich.
} else {
  // Geen match in de momenteel geladen lijsten — geen garantie dat de verbinding veilig is.
}

Controleer altijd eerst of `security` aanwezig is voordat je er een veld uit leest — een afwezig object en een aanwezig maar op false gezet veld betekenen iets anders.

Veelgestelde vragen

Detecteert het residentiële proxy's?

Nee. De huidige lijsten dekken bekende commerciële VPN-, Tor-, datacenter- en dreigings-/gesanctioneerde netwerken — niet de bredere categorie van residentiële proxydiensten, die via echte consumenten-IP-adressen routeren en veel moeilijker met lijsten te matchen zijn.

Wat betekent false?

Geen match in de lijsten die Watch-IP momenteel heeft geladen. Het is geen positieve verklaring dat de verbinding veilig is, aangezien een lijst niet elk bestaand VPN, elke exitnode of elk kwaadaardig netwerk kan dekken.

Wordt IPv6-Tor gedekt?

Nee. isTor is vandaag altijd false voor een IPv6-verbinding — er is geen gratis bron voor een IPv6-Tor-exitlijst in de huidige implementatie. Elk ander veld dekt IPv6 wel.

Zijn deze controles beschikbaar voor willekeurige IP's?

Momenteel niet. Deze gegevens maken alleen deel uit van het GET /v1/geo-antwoord voor de verbindende browser; de aparte IP-lookup-endpoints (/v1/lookup) geven geen security-blok terug.

Kan ik uitsluitend op een vlag blokkeren?

Dat kan, maar een enkele, op een lijst gebaseerde vlag is op zichzelf een zwakke basis voor een automatische blokkade — valse positieven komen voor, en legitieme gebruikers routeren om gewone redenen via VPN's en gedeelde netwerken. De meeste integraties gebruiken deze velden als één input voor een beoordelingsbeslissing.