IP Intelligence

TRACIO analyseert het IP-adres van elke bezoeker aan de serverkant. Het markeert VPN's, proxy's, Tor-exitnodes en datacenterherkomsten en herleidt de geolocatie op stadsniveau. De volledige analyse draait aan de serverkant, zonder afhankelijkheden aan de clientkant.

Waar de gegevens leven

IP Intelligence bereikt uw applicatie via de webhook-payload: het network-object (VPN-/proxy-/Tor-/datacenter-booleans plus verbindingstype) en het geo-object (land, stad, coördinaten, tijdzone) worden bij elke webhook geleverd. ISP en ASN komen erbij vanaf Business. Zie Webhooks voor de volledige payloadstructuur en de handtekeningverificatie.

Hoe het werkt

De classificatie van VPN, proxy, Tor en datacenter wordt herleid uit het verbindende IP-adres met behulp van commerciële IP-intelligence-databases (IP2Location voor het VPN-/proxy-/Tor-type, MaxMind voor geolocatie en ASN). Elk wordt weergegeven als één enkele boolean in het network-object van de webhook — in de openbare payload is er geen uitsplitsing per methode en geen betrouwbaarheidsscore.

{
  "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- & proxydetectie

Datacenter- en residentiële proxy's verschijnen beide als network.proxy; de datacenterherkomst wordt daarnaast gemeld als network.datacenter. De classificatie komt uit de IP2Location-proxydatabase, die de grote cloud-/hostingproviders dekt (AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr en andere).

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

Tor-detectie

Een overeenkomst met een Tor-exitnode op het verbindende IP-adres verschijnt als network.tor. Los daarvan wordt de Tor-browser zelf aan de clientkant herkend aan zijn anti-fingerprinting-configuratie, onafhankelijk van het netwerkpad — zie Smart Signals.

IP-geolocatie

Geolocatie op stadsniveau wordt aan de serverkant herleid uit het verbindende IP-adres (MaxMind) en geleverd in het geo-object van de webhook.

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

ISP en ASN (Business en hoger)

Op de plannen Business en Enterprise wordt ook de provider geïdentificeerd. In de webhook-payload staan beide velden op het network-object:

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

Bij een sessie die via de Data API wordt gelezen, is de verdeling net iets anders: isp staat op geo en asn op network. Dezelfde gegevens, twee oppervlakken — lees het veld daar waar het oppervlak dat u gebruikt het plaatst.

IP-overschrijdende activiteit (Pro en hoger)

Vanaf Pro draagt de webhook een velocity-blok mee — hoeveel de bezoeker zich recent heeft verplaatst:

Het blok is aanwezig wanneer de bezoekerstellers beschikbaar zijn op het moment van het event (normaal gesproken de primary-fase). Een ontbrekend blok betekent “geen gegevens”, niet nullen — behandel de afwezigheid ervan niet als “geen ongebruikelijke activiteit”.

Niet beschikbaar gesteld

Het matchen tegen IP-blokkeerlijsten maakt geen deel uit van het openbare contract: noch de webhook-payload noch het dashboard stelt blokkeerlijstcategorieën beschikbaar. Het webhook-oppervlak voor netwerkrisico's bestaat uit de booleaanse network-flags, het verbindingstype en de bovenstaande velocity-tellers — gebruik deze samen met de velden decision en bot (zie Smart Signals) voor risicobeslissingen.

Integratievoorbeeld

Netwerkgebaseerde risicobeoordeling

Dit leest het network-object van de webhook-payload rechtstreeks. Zie Webhooks voor de volledige payload en de handtekeningverificatie.

// `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 }
}