跳到正文

验证网关 ​

按 zeroseal-verifier 的流程,先在自己的机器上复现系统,再核对线上网关的实时证明。整个过程不需要 API 密钥,也不会调用模型。

先了解 保护范围;准备运行验证时,从 异机复验 开始。

验证如何成立 ​

TDX 的签名报告称为 quote,其中包含运行环境的度量值。验签能确认报告的来源;要知道这些值对应什么程序,还需要用公开源码和构建配方自己算一遍。

材料来源与作用
measurements.jsonl发布方声明的版本、源码提交和产物哈希,每次发布追加一行。
reproduced.jsonverify.sh 在你的机器上构建、比对后生成,保存独立复现的 RTMR1、RTMR2。
实时 quote在线网关为当前连接生成的签名报告,用来核对远端实际运行的环境。

verify-quote 按以下顺序检查:

检查确认什么
Intel 签名链、吊销状态与平台安全状态(TCB)报告通过标准证明校验,平台状态符合所选策略。验证材料由工具从 Intel PCS 获取。
TD 调试开关当前 TD 未开启调试模式。
TLS 连接绑定报告属于当前连接,不能用另一条连接的 quote 代替。
度量值比对RTMR1、RTMR2 与本机复现结果一致;固件相关值仍按 信任边界 接受。

只把 quote 与发布方声明比较,还没有完成独立复现。

开始验证 ​

完成 异机复验 后,在同一个 zeroseal-verifier 目录执行:

bash
ZEROSEAL_VERIFY_VERSION=$(jq -er '.version' reproduced.json) &&
go build -C gateway-src/gateway -o ../../verify-quote ./cmd/verify-quote &&
./verify-quote -host gw.zeroseal.cn -version "$ZEROSEAL_VERIFY_VERSION"
printf '退出码:%s\n' "$?"

命令从 reproduced.json 读取版本,避免拉取新发布记录后误用另一版声明。gateway-src 是 verify.sh 检出的对应版本源码;所选版本需包含 verify-quote,v0.2.1 尚未包含此工具。

线上验证需要访问 gw.zeroseal.cn 和 Intel PCS。默认严格要求平台安全状态为 UpToDate。

如何读结果 ​

结果含义
退出码 0在所选策略下验证通过,RTMR1、RTMR2 与本机复现值一致。使用上面的默认命令时,平台状态也通过严格检查。
退出码 2单独运行工具时缺少 reproduced.json,退回比对发布方声明;尚未独立验证。
退出码 1验证失败或材料读取失败,按终端错误处理。

通过后,工具会分别列出「已独立验证」和「按信任边界接受」的项目。退出码 0 不会让 MRTD、RTMR0 变成可独立复现的值。

平台状态为 OutOfDate ​

verifier README 记录了平台曾处于 OutOfDate 状态,并提供 -allow-tcb-status OutOfDate 参数。当前状态以实际验证结果为准,不能用 README 中的历史记录代替检查。

若要按 README 的例外策略继续评估,可显式运行:

bash
ZEROSEAL_VERIFY_VERSION=$(jq -er '.version' reproduced.json) &&
./verify-quote -host gw.zeroseal.cn -version "$ZEROSEAL_VERIFY_VERSION" \
  -allow-tcb-status OutOfDate
printf '退出码:%s\n' "$?"

该参数放宽了平台安全状态要求,其他验签、度量值和连接绑定检查仍会执行。即使退出码为 0,也不能将结果记为平台 UpToDate。按 verifier 工具的警告,不应据此向该环境注入生产凭据。

其他失败 ​

  • 版本不一致:确认 reproduced.json、measurements.jsonl 所选行与目标部署是同一版,再按 异机复验 重新生成结果。
  • RTMR1/RTMR2 不匹配:说明远端值与本机复现值不同,保留完整错误,不要直接用远端值覆盖期望值。
  • EKM 不匹配:报告未通过当前连接的绑定校验,不能视为验证成功。
  • Intel 材料获取失败:检查 Intel PCS 的网络访问,恢复后重试;缺少材料不能当作验签通过。

为什么必须验证同一条连接 ​

TLS 两端能从本次握手导出相同的 EKM。网关从自己的 TLS 连接状态取值,写入 quote 的 report_data;验证工具从同一条连接独立计算,再比较两者:

text
report_data = SHA-512(EKM 的 32 字节 || 32 字节全零预留区)

服务端不接受请求方传入 EKM。绑定校验用于识别从其他连接转发或重放的 quote;只用 cURL 下载报告,还没有完成这项检查。原理见 verifier 的连接绑定说明。

本工具验证的是它自己建立的连接。之后用普通 SDK 或智能体调用模型,会使用其他连接,不能沿用这次结果。实际业务客户端需要在每条新 TLS 连接上先完成验证,再通过该连接发送请求;验证失败就停止。只修改 base_url 不会增加这些检查。