IP Intelligence

TRACIO analizuje adres IP każdego odwiedzającego po stronie serwera. Oznacza sieci VPN, proxy, węzły wyjściowe Tor oraz połączenia z centrów danych, a także ustala geolokalizację na poziomie miasta. Cała analiza działa po stronie serwera, bez żadnych zależności po stronie klienta.

Gdzie znajdują się dane

IP Intelligence dociera do Twojej aplikacji przez payload webhooka: obiekt network (wartości logiczne VPN/proxy/Tor/centrum danych plus typ połączenia) oraz obiekt geo (kraj, miasto, współrzędne, strefa czasowa) są dostarczane z każdym webhookiem. ISP i ASN dochodzą od planu Business wzwyż. Pełną strukturę payloadu oraz weryfikację podpisu opisano w sekcji Webhooks.

Jak to działa

Klasyfikacja VPN, proxy, Tor i centrum danych jest ustalana na podstawie łączącego się IP przy użyciu komercyjnych baz danych IP intelligence (IP2Location dla typu VPN/proxy/Tor, MaxMind dla geolokalizacji i ASN). Każda z nich jest udostępniana jako pojedyncza wartość logiczna w obiekcie network webhooka — w publicznym payloadzie nie ma podziału na poszczególne metody ani wskaźnika pewności.

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

Wykrywanie centrów danych i proxy

Proxy z centrów danych oraz proxy residential pojawiają się obie jako network.proxy; pochodzenie z centrum danych jest dodatkowo raportowane jako network.datacenter. Klasyfikacja pochodzi z bazy danych proxy IP2Location, która obejmuje głównych dostawców chmury/hostingu (AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr i innych).

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

Wykrywanie Tor

Dopasowanie węzła wyjściowego Tor na łączącym się IP pojawia się jako network.tor. Osobno sama przeglądarka Tor jest rozpoznawana po stronie klienta po jej konfiguracji anty-fingerprintingowej, niezależnie od trasy sieciowej — zobacz Smart Signals.

Geolokalizacja IP

Geolokalizacja na poziomie miasta jest ustalana po stronie serwera na podstawie łączącego się IP (MaxMind) i dostarczana w obiekcie geo webhooka.

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

ISP i ASN (Business i wyżej)

W planach Business i Enterprise identyfikowany jest także operator. W payloadzie webhooka oba pola znajdują się w obiekcie network:

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

Przy odczycie sesji przez Data API podział jest nieco inny: isp znajduje się w geo, a asn w network. Te same dane, dwie powierzchnie — odczytuj pole stamtąd, gdzie umieszcza je używana przez Ciebie powierzchnia.

Aktywność między adresami IP (Pro i wyżej)

Od planu Pro wzwyż webhook niesie blok velocity — jak bardzo odwiedzający przemieszczał się ostatnio:

Blok jest obecny, gdy liczniki odwiedzającego są dostępne w momencie zdarzenia (zwykle faza primary). Brak bloku oznacza „brak danych”, a nie zera — nie traktuj jego nieobecności jako „brak nietypowej aktywności”.

Nieudostępniane

Dopasowywanie do list blokujących IP nie jest częścią publicznego kontraktu: ani payload webhooka, ani dashboard nie udostępniają kategorii list blokujących. Powierzchnia webhooka dla ryzyka sieciowego to logiczne flagi network, typ połączenia oraz powyższe liczniki velocity — używaj ich razem z polami decision i bot (zobacz Smart Signals) do decyzji o ryzyku.

Przykład integracji

Ocena ryzyka na podstawie sieci

To odczytuje bezpośrednio obiekt network z payloadu webhooka. Pełny payload oraz weryfikację podpisu opisano w sekcji 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 }
}