IP Intelligence

TRACIO analizza l'indirizzo IP di ogni visitatore lato server. Segnala VPN, proxy, nodi di uscita Tor e origini datacenter, e risolve la geolocalizzazione a livello di città. Tutta l'analisi viene eseguita lato server senza dipendenze lato client.

Dove risiedono i dati

L'IP intelligence raggiunge la propria applicazione attraverso il payload del webhook: l'oggetto network (booleani VPN/proxy/Tor/datacenter più il tipo di connessione) e l'oggetto geo (paese, città, coordinate, fuso orario) sono consegnati su ogni webhook. ISP e ASN sono aggiunti da Business in su. Vedi Webhooks per la struttura completa del payload e la verifica della firma.

Come funziona

La classificazione di VPN, proxy, Tor e datacenter è risolta a partire dall'IP di connessione usando database commerciali di IP intelligence (IP2Location per il tipo VPN/proxy/Tor, MaxMind per la geolocalizzazione e l'ASN). Ciascuna è esposta come un singolo booleano sull'oggetto network del webhook — non esiste un dettaglio per metodo o un punteggio di confidenza nel payload pubblico.

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

// `payload` è il corpo di consegna del webhook (/docs/webhooks)
if (payload.network.vpn) {
  // il visitatore si connette tramite una VPN
}

Rilevamento di datacenter e proxy

I proxy datacenter e residenziali sono entrambi esposti come network.proxy; l'origine datacenter è inoltre riportata come network.datacenter. La classificazione proviene dal database proxy di IP2Location, che copre i principali provider cloud/hosting (AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr e altri).

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

Rilevamento di Tor

Una corrispondenza con un nodo di uscita Tor sull'IP di connessione è esposta come network.tor. Separatamente, il Tor Browser stesso viene riconosciuto lato client dalla sua configurazione anti-fingerprinting, indipendentemente dal percorso di rete — vedi Smart Signals.

Geolocalizzazione IP

La geolocalizzazione a livello di città è risolta lato server a partire dall'IP di connessione (MaxMind) e consegnata sull'oggetto geo del webhook.

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

ISP e ASN (Business e superiori)

Sui piani Business ed Enterprise viene identificato anche l'operatore. Nel payload del webhook entrambi i campi si trovano sull'oggetto network:

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

Leggendo una sessione dalla Server API la suddivisione è leggermente diversa: isp si trova su geo e asn su network. Stessi dati su due superfici: leggi il campo da dove lo colloca la superficie che stai usando.

Attività tra IP (Pro e superiori)

Da Pro in su il webhook trasporta un blocco velocity: quanto il visitatore si è spostato di recente:

Il blocco è presente quando i contatori del visitatore sono disponibili al momento dell'evento (normalmente la fase primary). Un blocco mancante significa «nessun dato», non zeri: non interpreti la sua assenza come «nessuna attività insolita».

Non esposto

La corrispondenza con blocklist IP non fa parte del contratto pubblico: né il payload del webhook né la dashboard espongono categorie di blocklist. La superficie del webhook per il rischio di rete è costituita dai flag booleani network, dal tipo di connessione e dai contatori di velocity sopra riportati; li usi insieme ai campi decision e bot (vedi Smart Signals) per le decisioni di rischio.

Esempio di integrazione

Valutazione del rischio basata sulla rete

Questo legge direttamente l'oggetto network del payload del webhook. Vedi Webhooks per il payload completo e la verifica della firma.

// `payload` è il corpo di consegna del webhook (/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 }
}