IP Intelligence

TRACIO は、すべての訪問者のIPアドレスをサーバー側で分析します。VPN、プロキシ、 Tor出口ノード、データセンター起点をフラグ付けし、都市レベルのジオロケーションと ASNを解決します。すべての分析はクライアント側の依存関係なしにサーバー側で実行されます。

データの所在

IP インテリジェンスは Webhookペイロード を通じてあなたのアプリケーションに届きます。 network オブジェクト（VPN/プロキシ/Tor/データセンターのブール値と接続タイプ）と geo オブジェクト（国、市、座標、タイムゾーン、ISP）は、すべての Webhookで配信されます。ペイロード全体の形状と署名検証については Webhook を参照してください。

仕組み

VPN、プロキシ、Tor、データセンターの分類は、商用のIPインテリジェンスデータベース （VPN/プロキシ/Torタイプは IP2Location、ジオロケーションとASNは MaxMind）を用いて 接続元IPから解決されます。それぞれは Webhookの network オブジェクト上に単一のブール値 として表れます — 公開ペイロードにはメソッドごとの内訳や信頼度スコアはありません。

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

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

データセンターとプロキシの検知

データセンタープロキシとレジデンシャルプロキシはいずれも network.proxy として 表れます。データセンター起点の場合はさらに network.datacenter として報告されます。 分類は IP2Location プロキシデータベースに由来し、主要なクラウド/ホスティングプロバイダー （AWS、Google Cloud、Azure、Oracle Cloud、Alibaba Cloud、DigitalOcean、Hetzner、OVH、 Linode/Akamai、Vultr など）をカバーします。

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

Tor 検知

接続元IPでのTor出口ノードの一致は network.tor として表れます。これとは別に、 Tor Browser 自体は、そのアンチフィンガープリンティング構成（canvas/WebGL耐性、 UTCタイムゾーン、丸められた画面サイズ）を通じてクライアント側で検知されます — Smart Signals を参照してください。

IP ジオロケーション

都市レベルのジオロケーションとASNは、接続元IP（MaxMind）からサーバー側で解決され、 Webhookの geo オブジェクトで配信されます。

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

現在は公開されていないもの

IPブロックリストの照合や、ベロシティ（IP横断／国横断の活動）追跡は、現在の公開契約の 一部ではありません。Webhookペイロードもダッシュボードも、ブロックリストのカテゴリや ベロシティ間隔を公開しません。ネットワークリスクに関するWebhookの表面は、ブール値の network フラグと接続タイプに限定されています。リスク判断には、それらを decision および bot フィールド（Smart Signals を参照）と併せて使用してください。

統合の例

ネットワークベースのリスク評価

これは Webhookペイロードの network オブジェクトを直接読み取ります。ペイロード全体と 署名検証については Webhook を参照してください。

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