VPN- und Tor-Signale zur Besucher-Geolokalisierung hinzufügen

Erfahren Sie, wann die Verbindung eines Besuchers mit einem bekannten VPN-Netzwerk, einem Tor-Exit-Knoten, einem Rechenzentrums-/Hosting-Netzwerk oder einer anderen unterstützten Netzwerkkategorie übereinstimmt. Watch-IP fügt diese Indikatoren berechtigten GET /v1/geo-Antworten hinzu, damit Ihre Anwendung sie neben anderem Kontext berücksichtigen kann.

Sehen Sie, welche Tarife Sicherheit enthalten Die Geo-Referenz lesen →

Berechtigte Tarife

security ist in den Tarifen Starter, Growth, Scale und Enterprise enthalten. Im kostenlosen Tarif wird es vollständig aus der Antwort ausgelassen — nicht als irreführendes, durchgehend falsches Objekt gesendet — prüfen Sie also auf seine Anwesenheit, bevor Sie ein Feld daraus lesen.

IPv4- und IPv6-Abdeckung unterscheiden sich

IPv4-Verbindungen werden gegen Tor-, VPN-, Rechenzentrums-, Bedrohungs- und sanktionierte Netzwerklisten geprüft. IPv6-Verbindungen werden gegen alles außer Tor geprüft — es gibt derzeit keine kostenlose IPv6-Tor-Exit-Listenquelle, sodass isTor für eine IPv6-Verbindung immer false ist, unabhängig davon, ob es sich tatsächlich um einen Tor-Exit handelt. Beschreiben Sie die IPv6-Abdeckung nicht als gleichwertig zur IPv4-Abdeckung.

Ausgelassen, false und true sind unterschiedliche Zustände

Ein ausgelassenes security-Objekt bedeutet, dass Ihr Tarif diese Daten nicht enthält, nicht dass die Verbindung geprüft und als sauber befunden wurde. Ein false-Wert bei einem enthaltenen Feld bedeutet keine Übereinstimmung in den derzeit geladenen Listen von Watch-IP — kein bestätigt sicheres Urteil, da listenbasierte Erkennung nicht alles sehen kann. Stellen Sie ein nicht ausgewertetes oder falsches Ergebnis niemals als „Sauber“, „Sicher“ oder „Verifiziert“ dar.

Quellen und Aktualisierungen

Die diesen Feldern zugrunde liegenden Listen werden zusammengestellt, in unserem eigenen Speicher abgelegt und nach einem Zeitplan aktualisiert. Ein Kaltstart blockiert kurz bei der ersten Abfrage; sobald geladen, wird eine Anfrage aus einem In-Memory-Cache bedient, während im Hintergrund eine Aktualisierung läuft — eine langsame oder fehlgeschlagene Aktualisierung führt also zu veralteten oder leeren Daten, nicht zu einer defekten Antwort.

Ein beispielhafter Prüfworkflow

Behandeln Sie isVpn oder isDatacenter als eine Eingabe für eine manuelle Prüfwarteschlange neben Kontohistorie und anderen Signalen, nicht als alleinige Grundlage, um einen Besucher rundweg zu sperren. Es zum Beispiel mit einer Wegwerf-E-Mail-Prüfung beim selben Signup-Ereignis zu kombinieren, ist ein sinnvoller Weg, eine kleine Zahl von Registrierungen zur Prüfung weiterzuleiten, statt jeden VPN-Nutzer abzulehnen.

Was dies nicht leistet

Diese Felder identifizieren keine residenten Proxys, verifizieren keine Identität und sind kein umfassendes Produkt zur Bedrohungs- oder Anonymitätserkennung — sie sind eine kleine Menge listenbasierter Indikatoren.

Sicherheitsfelder der Antwort

isTor: Bekannter Tor-Exit-Knoten aus der derzeit geladenen IPv4-Exit-Liste. Für IPv6 immer false.
isVpn: Bekanntes kommerzielles VPN-Anbieternetzwerk, IPv4 und IPv6.
isDatacenter: Rechenzentrums-/Hosting-Netzwerk — eine Obermenge von VPN, da viele VPN-Exits auf Hosting-Infrastruktur laufen.
isThreat: In einem bekannten bösartigen IP-Bereich oder einem bekannten Bedrohungs-ASN, IPv4 und IPv6.
isSanctionedNetwork: Auf einer von Watch-IP gepflegten Liste staatlich sanktionierter Telekommunikations-/Hosting-Netzwerkbetreiber, vierteljährlich überprüft — ein schwächeres, weniger verlässliches Signal als die anderen Felder, keine Sanktions-Compliance-Prüfung.

Die Sicherheitsfelder sicher auslesen

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) {
  // Ihr Tarif enthält keine Sicherheitsdaten — treffen Sie keine Annahmen über diese Verbindung.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Ein Listentreffer — eine Eingabe für Ihre eigene Prüflogik, keine eigenständige Sperre.
} else {
  // Keine Übereinstimmung in den derzeit geladenen Listen — keine Garantie, dass die Verbindung sicher ist.
}

Prüfen Sie immer, ob `security` vorhanden ist, bevor Sie ein Feld daraus lesen — ein fehlendes Objekt und ein vorhandenes, aber falsches Feld bedeuten unterschiedliche Dinge.

Häufig gestellte Fragen

Erkennt es residente Proxys?

Nein. Aktuelle Listen decken bekannte kommerzielle VPN-, Tor-, Rechenzentrums- und Bedrohungs-/sanktionierte Netzwerke ab — nicht die breitere Kategorie residenter Proxy-Dienste, die über echte Verbraucher-IP-Adressen laufen und viel schwerer per Liste zu erfassen sind.

Was bedeutet false?

Keine Übereinstimmung in den derzeit von Watch-IP geladenen Listen. Es ist keine positive Aussage, dass die Verbindung sicher ist, da eine Liste nicht jedes existierende VPN, jeden Exit-Knoten oder jedes bösartige Netzwerk abdecken kann.

Ist IPv6-Tor abgedeckt?

Nein. isTor ist für eine IPv6-Verbindung heute immer false — in der aktuellen Implementierung gibt es keine kostenlose IPv6-Tor-Exit-Listenquelle. Jedes andere Feld deckt IPv6 ab.

Sind diese Prüfungen für beliebige IPs verfügbar?

Derzeit nicht. Diese Daten sind ausschließlich Teil der GET /v1/geo-Antwort für den verbindenden Browser; die separaten IP-Abfrage-Endpoints (/v1/lookup) liefern keinen security-Block.

Kann ich allein anhand eines Flags sperren?

Sie können, aber ein einzelnes listenbasiertes Flag ist für sich genommen eine schwache Grundlage für eine automatische Sperre — Fehlalarme kommen vor, und legitime Nutzer verbinden aus gewöhnlichen Gründen über VPNs und gemeinsam genutzte Netzwerke. Die meisten Integrationen verwenden diese Felder als eine Eingabe für eine Prüfentscheidung.