Smart Signals

Smart Signals 是从浏览器指纹、IP 情报和行为分析中计算得出的服务端增强信号。它们在不采集任何个人身份信息的前提下，为每一位访客提供深入的上下文。

Smart Signals——即增强后的决策、风险、网络和机器人信号——通过两条路径到达你的服务器：以 webhook 的形式推送给你（参见 Webhooks），也可以按需通过 Data API 读取。它们同时也会在仪表盘中呈现。下面的示例消费的是 webhook 载荷的结构；从 API 读取会话时会出现同样的字段。

信号参考

一次访问会解析出涵盖网络、浏览器、设备和行为分析的 35+ 项 smart signals。下面的参考列出了你最常用到的那些信号，包括：

网络情报

浏览器分析

设备分析

仅限原生的检测。 Root、越狱、克隆/双开应用和 Frida 插桩所依赖的信号， 只有原生移动 SDK 才能采集。TRACIO 提供的是浏览器 SDK， 因此它们在 Web agent 中并不生效——请转而依赖自动化、无头浏览器、 反检测浏览器、模拟器和行为方面的判定。

行为分析

详细信号说明

VPN、代理与 Tor 检测

VPN、代理、Tor 和数据中心标记由服务端根据访客的 IP，使用商用 IP 情报 数据库（IP2Location / MaxMind）解析得出。公开的 webhook 载荷将合并后的结果 以布尔值的形式呈现在 network 对象上——network.vpn、network.proxy、 network.tor、network.datacenter——不包含按方法的细分或置信度字符串。 详见 IP Intelligence。

隐私浏览检测

隐私浏览会在 Chromium、Firefox 和 Safari 中被推断出来，并以 identification.incognito 的形式传给你。浏览器没有任何 API 会报告这一点，因此该判定来自对隐私窗口中存储行为的 加权投票——origin private file system 的报错、存储的持久性以及各平台特有的怪异行为 都会各自贡献一部分。

这是一个概率性信号，而非确凿事实：请把它当作多个输入之一，而不是可以单凭它就采取行动 的事实。由于隐私窗口同样不会写入 _vid_t cookie，隐私模式下的访问只能依靠信号来识别， 其 identification.confidence 也相应更低。

浏览器篡改

篡改检测器用于识别为伪装身份而修改了浏览器的访客：

• User-Agent 伪造：将 UA 字符串与 Client Hints、navigator 属性和 JavaScript 引擎行为进行交叉比对
• 属性注入：通过比较 getter 原型，检测修改 navigator 属性的扩展
• 插件篡改：验证 PluginArray.prototype 和 MimeType.prototype 原型链
• 原生函数覆盖：测试 Function.prototype.toString、Object.getOwnPropertyDescriptor 及其他关键函数是否已被 Proxy 替换

anomalyScore（0.0-1.0）量化了不一致的程度。高于 0.5 的值表示存在明显的篡改。

风险分与可疑分

webhook 的 decision 对象承载了请求的聚合风险： decision.riskScore（整数 0-100）、decision.suspectScore（数字）和 decision.action（建议的操作）。该分数聚合了各项 smart signal 的输出；下面的分段说明了 riskScore 如何映射到风险等级：

该分数聚合了处于活跃状态的 smart-signal 输出——主要是 IP 情报（VPN/代理/Tor/数据中心）、机器人判定和浏览器篡改。 经确认的人类交互（鼠标/键盘）会降低该分数。

隐私浏览器检测

可检测四种注重隐私的浏览器配置：

使用 Smart Signals

Smart Signals 通过 webhook 载荷（完整结构和签名验证请参见 Webhooks）以及通过 Data API 读取会话时到达你的 服务器。下面的示例直接从 webhook 载荷中读取字段；两种方式的字段名相同。

基于风险的访问控制

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