IP Intelligence

TRACIO analyzuje IP adresu každého návštěvníka na straně serveru. Označuje sítě VPN, proxy, výstupní uzly sítě Tor a původ z datových center a určuje geolokaci na úrovni města. Veškerá analýza probíhá na straně serveru bez jakýchkoli závislostí na straně klienta.

Kde data žijí

IP intelligence se do vaší aplikace dostává prostřednictvím webhook payloadu: objekt network (booleovské hodnoty VPN/proxy/Tor/datacenter plus typ připojení) a objekt geo (země, město, souřadnice, časové pásmo) jsou doručovány s každým webhookem. ISP a ASN přibývají od plánu Business výše. Kompletní strukturu payloadu a ověření podpisu najdete v Webhookech.

Jak to funguje

Klasifikace VPN, proxy, Toru a datového centra se určuje z připojující se IP pomocí komerčních databází IP intelligence (IP2Location pro typ VPN/proxy/Tor, MaxMind pro geolokaci a ASN). Každá je vystavena jako jediná booleovská hodnota v objektu network webhooku — ve veřejném payloadu není žádné členění podle metody ani skóre spolehlivosti.

{
  "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
}

Detekce datových center a proxy

Datacentrové i rezidenční proxy se obě vystavují jako network.proxy; původ z datového centra je navíc hlášen jako network.datacenter. Klasifikace pochází z databáze proxy IP2Location, která pokrývá hlavní cloudové/hostingové poskytovatele (AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr a další).

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

Detekce sítě Tor

Shoda výstupního uzlu sítě Tor s připojující se IP se vystavuje jako network.tor. Odděleně je samotný prohlížeč Tor rozpoznán na straně klienta podle jeho konfigurace proti fingerprintingu, nezávisle na síťové cestě — viz Smart Signals.

IP geolokace

Geolokace na úrovni města se určuje na straně serveru z připojující se IP (MaxMind) a je doručena v objektu geo webhooku.

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

ISP a ASN (Business a vyšší)

V plánech Business a Enterprise je navíc identifikován operátor. Ve webhook payloadu leží obě pole na objektu network:

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

Při čtení relace přes Data API je rozdělení mírně jiné: isp leží na geo a asn na network. Stejná data, dvě rozhraní — pole čtěte tam, kam je ukládá rozhraní, které používáte.

Aktivita napříč IP (Pro a vyšší)

Od plánu Pro výše nese webhook blok velocity — nakolik se návštěvník v poslední době přesouval:

Blok je přítomen, když jsou čítače návštěvníka v okamžiku události dostupné (obvykle fáze primary). Chybějící blok znamená „žádná data“, nikoli nuly — nevykládejte si jeho nepřítomnost jako „žádná neobvyklá aktivita“.

Nevystaveno

Porovnávání IP s blokovacími seznamy není součástí veřejného kontraktu: ani webhook payload, ani dashboard nevystavuje kategorie blokovacích seznamů. Webhookové rozhraní pro síťová rizika tvoří booleovské příznaky network, typ připojení a výše uvedené čítače velocity; použijte je společně s poli decision a bot (viz Smart Signals) pro rozhodování o riziku.

Příklad integrace

Posouzení rizika na základě sítě

Toto čte objekt network webhook payloadu přímo. Kompletní payload a ověření podpisu najdete v Webhookech.

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