IP Intelligence

TRACIO는 모든 방문자의 IP 주소를 서버 측에서 분석합니다. VPN, 프록시, Tor 출구 노드, 데이터센터 출처를 플래그로 표시하고, 도시 단위 지오로케이션을 확인합니다. 모든 분석은 클라이언트 측 의존성 없이 서버 측에서 실행됩니다.

데이터가 존재하는 위치

IP 인텔리전스는 웹훅 페이로드를 통해 애플리케이션에 전달됩니다. network 객체(VPN/프록시/Tor/데이터센터 불리언과 연결 유형)와 geo 객체(국가, 도시, 좌표, 시간대)가 모든 웹훅에서 전달됩니다. ISP와 ASN은 Business 이상에서 추가됩니다. 전체 페이로드 구조와 서명 검증은 Webhooks를 참조하세요.

작동 방식

VPN, 프록시, Tor, 데이터센터 분류는 연결하는 IP를 기준으로 상용 IP 인텔리전스 데이터베이스(VPN/프록시/Tor 유형은 IP2Location, 지오로케이션과 ASN은 MaxMind)를 사용해 확인됩니다. 각 항목은 웹훅 network 객체에서 단일 불리언으로 노출되며, 공개 페이로드에는 방법별 세부 분류나 신뢰도 점수가 없습니다.

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

데이터센터 및 프록시 탐지

데이터센터 프록시와 레지덴셜 프록시는 둘 다 network.proxy로 노출되며, 데이터센터 출처는 추가로 network.datacenter로 보고됩니다. 분류는 주요 클라우드/호스팅 제공업체(AWS, Google Cloud, Azure, Oracle Cloud, Alibaba Cloud, DigitalOcean, Hetzner, OVH, Linode/Akamai, Vultr 등)를 포괄하는 IP2Location 프록시 데이터베이스에서 가져옵니다.

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

Tor 탐지

연결하는 IP에서 Tor 출구 노드가 일치하면 network.tor로 노출됩니다. 이와 별개로, Tor 브라우저 자체는 네트워크 경로와 무관하게 안티핑거프린팅 설정을 통해 클라이언트 측에서 인식됩니다 — Smart Signals를 참조하세요.

IP 지오로케이션

도시 단위 지오로케이션은 연결하는 IP(MaxMind)로부터 서버 측에서 확인되어 웹훅 geo 객체로 전달됩니다.

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

ISP와 ASN(Business 이상)

Business 및 Enterprise 플랜에서는 통신 사업자도 식별됩니다. 웹훅 페이로드에서는 두 필드 모두 network 객체에 있습니다.

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

Data API로 세션을 읽을 때는 배치가 조금 다릅니다. isp는 geo에, asn은 network에 있습니다. 같은 데이터에 표면이 둘일 뿐이므로, 사용하는 표면이 필드를 두는 위치에서 읽으세요.

IP 간 활동(Pro 이상)

Pro 이상에서는 웹훅이 velocity 블록을 함께 전달합니다. 방문자가 최근 얼마나 이동했는지를 나타냅니다.

이 블록은 이벤트 시점에 방문자 카운터를 사용할 수 있을 때 포함됩니다(일반적으로 primary 단계). 블록이 없다는 것은 “데이터 없음”을 뜻하며 0을 뜻하지 않습니다 — 블록이 없다고 해서 “비정상적인 활동이 없다”고 해석하지 마세요.

노출되지 않는 항목

IP 차단 목록 매칭은 공개 계약의 일부가 아닙니다. 웹훅 페이로드와 대시보드 모두 차단 목록 카테고리를 노출하지 않습니다. 네트워크 위험에 대한 웹훅 표면은 불리언 network 플래그, 연결 유형, 그리고 위의 벨로시티 카운터이므로, 위험 판단에는 이들을 decision 및 bot 필드(Smart Signals 참조)와 함께 사용하세요.

통합 예시

네트워크 기반 위험 평가

이 코드는 웹훅 페이로드의 network 객체를 직접 읽습니다. 전체 페이로드와 서명 검증은 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 }
}