Smart Signals

Smart Signals는 브라우저 지문, IP 인텔리전스, 행동 분석으로부터 계산되는 서버 측 강화 신호입니다. 개인 식별 정보를 전혀 수집하지 않으면서 모든 방문자에 대한 깊이 있는 컨텍스트를 제공합니다.

Smart Signals — 강화된 결정, 위험, 네트워크, 봇 신호 — 는 두 가지 경로로 서버에 도달합니다. 웹훅으로 푸시되며(자세한 내용은 Webhooks 참고), Data API를 통해 필요할 때 읽을 수도 있습니다. 또한 대시보드에도 표시됩니다. 아래 예제들은 웹훅 페이로드 형태를 사용하며, API로 세션을 읽을 때도 동일한 필드가 제공됩니다.

신호 레퍼런스

한 번의 방문은 네트워크, 브라우저, 디바이스, 행동 분석에 걸친 35+ 스마트 신호로 해석됩니다. 아래 레퍼런스는 가장 자주 사용하게 될 신호들을 정리한 것으로, 다음이 포함됩니다:

네트워크 인텔리전스

브라우저 분석

디바이스 분석

네이티브 전용 탐지. 루팅, 탈옥, 복제/듀얼 앱, Frida 인스트루멘테이션 탐지는 네이티브 모바일 SDK만 수집할 수 있는 신호에 의존합니다. TRACIO는 브라우저 SDK를 제공하므로 이러한 탐지는 웹 에이전트에서 효과가 없습니다 — 대신 자동화, 헤드리스, 안티디텍트, 에뮬레이터, 행동 판정에 의존하세요.

행동 분석

상세 신호 설명

VPN, Proxy 및 Tor 탐지

VPN, 프록시, Tor, 데이터센터 플래그는 상용 IP 인텔리전스 데이터베이스 (IP2Location / MaxMind)를 사용하여 방문자의 IP로부터 서버 측에서 해석됩니다. 공개 웹훅 페이로드는 결합된 결과를 network 객체의 불리언 값 — network.vpn, network.proxy, network.tor, network.datacenter — 으로 노출하며, 메서드별 세부 분석이나 신뢰도 문자열은 제공하지 않습니다. 자세한 내용은 IP Intelligence를 참고하세요.

시크릿 모드 탐지

시크릿 브라우징은 Chromium, Firefox, Safari에서 추론되어 identification.incognito 필드로 전달됩니다. 이를 알려주는 브라우저 API는 존재하지 않으므로, 판정은 시크릿 창에서 스토리지가 어떻게 동작하는지에 대한 가중 투표로 도출됩니다. origin private file system 오류, 스토리지 지속성, 플랫폼별 특성이 각각 판정에 기여합니다.

이는 확실한 사실이 아니라 확률적 신호입니다. 단독으로 조치의 근거가 되는 사실이 아니라 여러 입력 중 하나로 다루세요. 시크릿 창에서는 _vid_t 쿠키도 설정되지 않으므로 시크릿 방문은 신호만으로 식별되며, 그만큼 identification.confidence도 낮아집니다.

브라우저 변조

변조 탐지기는 자신의 신원을 잘못 표현하기 위해 브라우저를 변조한 방문자를 식별합니다:

• User-Agent 스푸핑: UA 문자열을 Client Hints, navigator 속성, JavaScript 엔진 동작과 상호 대조
• 속성 주입: 게터 프로토타입을 비교하여 navigator 속성을 변조하는 확장 프로그램을 탐지
• 플러그인 조작: PluginArray.prototype 및 MimeType.prototype 체인을 검증
• 네이티브 함수 재정의: Function.prototype.toString, Object.getOwnPropertyDescriptor 및 기타 핵심 함수가 Proxy로 대체되었는지 테스트

anomalyScore(0.0–1.0)는 불일치 정도를 정량화합니다. 0.5를 초과하는 값은 심각한 변조를 나타냅니다.

Risk 및 Suspect Score

웹훅 decision 객체는 요청에 대한 집계 위험을 담습니다: decision.riskScore(정수 0–100), decision.suspectScore(숫자), decision.action(권장 조치). 이 점수는 smart signal 출력을 집계하며, 아래 구간은 riskScore가 위험 수준에 어떻게 매핑되는지 설명합니다:

이 점수는 활성화된 smart-signal 출력 — 주로 IP 인텔리전스 (VPN/프록시/Tor/데이터센터), 봇 판정, 브라우저 변조 — 를 집계합니다. 확인된 사람의 상호작용(마우스/키보드)은 점수를 낮춥니다.

프라이버시 브라우저 탐지

네 가지 프라이버시 중심 브라우저 구성이 탐지됩니다:

Smart Signals 사용하기

Smart Signals는 웹훅 페이로드를 통해(전체 형태와 서명 검증은 Webhooks 참고), 그리고 Data API로 세션을 읽을 때 서버에 도달합니다. 아래 예제들은 웹훅 페이로드에서 필드를 직접 읽으며, 필드 이름은 두 경로 모두 동일합니다.

위험 기반 접근 제어

// `payload` is the webhook delivery body (/docs/webhooks)
const score = payload.decision.riskScore
const isVPN = payload.network.vpn
const isBot = payload.bot.result === "bot"

if (isBot) {
  return block("Automated access")
}

if (score > 60) {
  return requireMFA()
}

if (isVPN && score > 30) {
  return requireCaptcha()
}

return allow()

사기 스코어링 파이프라인

// `payload` is the webhook delivery body (/docs/webhooks)
function computeFraudRisk(payload: WebhookPayload): string {
  let risk = "low"

  if (payload.decision.riskScore > 60) risk = "high"
  else if (payload.decision.riskScore > 30) risk = "medium"

  // Escalate when multiple network signals agree
  if (payload.network.vpn && payload.network.proxy) risk = "high"
  if (payload.network.tor) risk = "high"
  if (payload.bot.result === "bot") risk = "high"

  return risk
}