IP Intelligence

TRACIO analysiert die IP-Adresse jedes Besuchers serverseitig. Es kennzeichnet VPNs, Proxys, Tor-Exit-Nodes und Datacenter-Herkünfte und löst die Geolokalisierung auf Stadtebene auf. Die gesamte Analyse läuft serverseitig, ohne clientseitige Abhängigkeiten.

Wo die Daten liegen

IP Intelligence erreicht Ihre Anwendung über den Webhook-Payload: das network-Objekt (VPN-/Proxy-/Tor-/Datacenter-Booleans plus Verbindungstyp) und das geo-Objekt (Land, Stadt, Koordinaten, Zeitzone) werden mit jedem Webhook geliefert. ISP und ASN kommen ab Business hinzu. Die vollständige Payload-Struktur und die Signaturprüfung finden Sie unter Webhooks.

So funktioniert es

Die Klassifizierung von VPN, Proxy, Tor und Datacenter wird anhand der verbindenden IP aus kommerziellen IP-Intelligence-Datenbanken aufgelöst (IP2Location für den VPN-/Proxy-/Tor-Typ, MaxMind für Geolokalisierung und ASN). Jede wird als einzelner Boolean im network-Objekt des Webhooks ausgegeben – im öffentlichen Payload gibt es keine Aufschlüsselung nach Methode und keinen Konfidenzwert.

{
  "network": {
    "vpn": true,
    "proxy": true,
    "tor": false,
    "datacenter": false,
    "connectionType": "VPN"
  }
}

// `payload` is the webhook delivery body (/docs/webhooks)
if (payload.network.vpn) {
  // visitor is connecting through a VPN
}

Datacenter- & Proxy-Erkennung

Datacenter- und Residential Proxys erscheinen beide als network.proxy; die Datacenter-Herkunft wird zusätzlich als network.datacenter gemeldet. Die Klassifizierung stammt aus der IP2Location-Proxy-Datenbank, die die großen Cloud-/Hosting-Anbieter abdeckt (AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr und weitere).

{
  "network": {
    "vpn": false,
    "proxy": true,
    "tor": false,
    "datacenter": true,
    "connectionType": "DCH"
  }
}

Tor-Erkennung

Eine Übereinstimmung mit einem Tor-Exit-Node auf der verbindenden IP erscheint als network.tor. Getrennt davon wird der Tor-Browser selbst clientseitig an seiner Anti-Fingerprinting-Konfiguration erkannt – unabhängig vom Netzwerkpfad – siehe Smart Signals.

IP-Geolokalisierung

Die Geolokalisierung auf Stadtebene wird serverseitig aus der verbindenden IP aufgelöst (MaxMind) und im geo-Objekt des Webhooks geliefert.

{
  "geo": {
    "country": "CZ",
    "city": "Prague",
    "lat": 50.05,
    "lon": 14.4,
    "timezone": "Europe/Prague"
  }
}

ISP und ASN (ab Business)

In den Tarifen Business und Enterprise wird zusätzlich der Anbieter identifiziert. Im Webhook-Payload liegen beide Felder im network-Objekt:

{
  "network": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "datacenter": false,
    "isp": "Comcast Cable",
    "asn": 7922
  }
}

Beim Lesen einer Session über die Server API ist die Aufteilung leicht anders: isp liegt in geo und asn in network. Dieselben Daten, zwei Oberflächen – lesen Sie das Feld dort, wo die von Ihnen genutzte Oberfläche es ablegt.

IP-übergreifende Aktivität (ab Pro)

Ab Pro führt der Webhook einen velocity-Block mit – wie stark sich der Besucher zuletzt bewegt hat:

Der Block ist vorhanden, wenn die Besucherzähler zum Zeitpunkt des Events verfügbar sind (in der Regel die primary-Phase). Ein fehlender Block bedeutet „keine Daten“, nicht Null – werten Sie sein Fehlen nicht als „keine ungewöhnliche Aktivität“.

Nicht bereitgestellt

Der Abgleich mit IP-Blocklisten ist nicht Teil des öffentlichen Vertrags: Weder der Webhook-Payload noch das Dashboard geben Blocklisten-Kategorien preis. Die Webhook-Oberfläche für Netzwerkrisiken besteht aus den booleschen network-Flags, dem Verbindungstyp und den oben genannten Velocity-Zählern – nutzen Sie diese zusammen mit den Feldern decision und bot (siehe Smart Signals) für Risikoentscheidungen.

Integrationsbeispiel

Netzwerkbasierte Risikobewertung

Dies liest das network-Objekt des Webhook-Payloads direkt. Den vollständigen Payload und die Signaturprüfung finden Sie unter Webhooks.

// `payload` is the webhook delivery body (/docs/webhooks)
function assessIPRisk(payload: WebhookPayload) {
  const { vpn, proxy, tor, datacenter } = payload.network

  const risks: string[] = []
  let riskLevel = "low"

  if (tor) {
    risks.push("Tor exit node")
    riskLevel = "critical"
  }

  if (vpn) {
    risks.push("VPN detected")
    riskLevel = riskLevel === "low" ? "medium" : riskLevel
  }

  if (proxy) {
    risks.push("Proxy detected")
    riskLevel = riskLevel === "low" ? "medium" : riskLevel
  }

  if (datacenter) {
    risks.push("Datacenter IP")
    riskLevel = riskLevel === "low" ? "medium" : riskLevel
  }

  return { riskLevel, risks }
}