验证网关
按 zeroseal-verifier 的流程,先在自己的机器上复现系统,再核对线上网关的实时证明。整个过程不需要 API 密钥,也不会调用模型。
验证如何成立
TDX 的签名报告称为 quote,其中包含运行环境的度量值。验签能确认报告的来源;要知道这些值对应什么程序,还需要用公开源码和构建配方自己算一遍。
| 材料 | 来源与作用 |
|---|---|
measurements.jsonl | 发布方声明的版本、源码提交和产物哈希,每次发布追加一行。 |
reproduced.json | verify.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 不会增加这些检查。