Files
ssw-mpc/deploy/tee/real-machine/README.md
T
admin 5dec915185 feat(tee): KBS 客户端 + 证明结构校验,OCI 打包与真机编排资产入仓
- mpc-tee 新增 kbs.rs(最小 HTTP/1.1 KBS 客户端 + fail-closed 校验 + KbsKeySource 替代内置 PSK)、verify.rs(SNP 报告结构解析 + 可插拔外部芯片验签器 + verify_attestation 显式区分「芯片签名未验证」)。
- mpc-cli 新增 mpc tee verify / mpc tee kbs-get 子命令。
- catalog.rs 补 verify/kbs 模块到 TEE 直接调度段并加回归断言(清单铁律)。
- deploy/tee 新增 oci/(分层镜像构建)、kbs/(serve stub)、guest/(init)、real-machine/(跨机双 guest 编排);docs/TEE_OCI_PATH.md 记录 Kata 实测复核(仅 AMD 有、海光无且不支持 CSV,不引入)与 e2b 远程调度接口参考。
- 影响:密钥经 KBS 注入(不再内置明文 PSK),证明结论如实区分结构与芯片验签;远程调度走 OCI digest + 框架选节点,不引入 Kata/e2b 依赖。
- 测试:./tools/ci.sh 四道全绿;mpc-tee 单测 73→86。
2026-11-06 19:33:53 +08:00

3.8 KiB
Raw Blame History

真机复现:AMD SEV-SNP + 海光 CSV 双加密 guest

把 2026-11-06 的临时 /tmp 脚本整理成可复现资产。凭据不入库:SSH 口令由 xop 键名经环境变量注入,PSK / seed / 根密钥由 KBS 下发(或离线演练层), 仓库里只有占位值与示例节点描述。

前置物料

  1. Linux 静态 mpc(macOS 上交叉编译):
    RUSTFLAGS="-C link-self-contained=no" \
    CARGO_TARGET_X86_64_UNKNOWN_LINUX_MUSL_LINKER=x86_64-linux-musl-gcc \
      cargo build -p mpc-cli --features secure --target x86_64-unknown-linux-musl
    zig objcopy --strip-all \
      target/x86_64-unknown-linux-musl/debug/mpc /tmp/mpc-linux-x86_64
    
    -C link-self-contained=no 是必须的,否则 zig 的 crt 与 Rust 自带 crt 重复定义 _start。
  2. base rootfs:现成 alpine rootfs(含 /bin/busybox 与 musl loader)。
  3. OCI 镜像与 initrd:按 ../oci/README.md 跑 build / verify / pack, 记下 measurement=<64hex>。
  4. 节点描述:复制 nodes/*.node.example,把 measurement 换成上一步的 digest, 其余路径按真机 preflight.sh 结果填写。
  5. KBS(可选,在线模式):../kbs/serve.py 只是演练 stub;生产请用带证明校验的 Trustee/KBS。离线演练用 MPC_TEE_KBC=offline_fs_kbc::null, 并在 build 时加 --offline-dir 提供 psk / seed / root-key。

单 guest 自检

export MPC_TEE_MPC_BIN=/path/to/mpc
export MPC_TEE_MANIFEST=<64hex>
export MPC_TEE_KBC=offline_fs_kbc::null
python3 run-guest.py nodes/amd-sev-snp.node.example <64hex-session> <64hex-pubkey> none

role=none 不挂网卡,只验证 guest 内核、mpc selftest 与 OCI 层校验。

双 guest 跨物理机计算

export MPC_TEE_MPC_BIN=/path/to/mpc-linux-x86_64
export MPC_TEE_INITRD=/path/to/mpc-initrd.img
export MPC_TEE_AMD_NODE=nodes/amd-sev-snp.node.example
export MPC_TEE_HYGON_NODE=nodes/hygon-csv2.node.example
export MPC_TEE_MANIFEST=<64hex>
export MPC_TEE_KBC=offline_fs_kbc::null
# 可选:MPC_TEE_AMD_HOST / MPC_TEE_HYGON_HOST / *_USER_KEY / *_PASS_KEY
MPC_TEE_DRY_RUN=1 ./pair-run.sh      # 先看物料与计划,不连机
./pair-run.sh

pair-run.sh 会:分发物料到两台宿主 → 后台起 AMD SNP guest(alice,socket 监听)→ 只读确认端口 LISTEN → 起海光 CSV guest(bob,socket 连接)→ 输出两侧日志尾部。 判定成功的标志是两侧都输出 value | 35.000000,且日志里有 oci_layers: verified、manifest_digest=...、mpc selftest 全部通过。

分层与职责

层 文件 职责
框架 mpc tee plan --argv 平台中立的 qemu argv(含 user_data、kernel-hashes、pflash、cbitpos)
部署 run-guest.py 只补串口 / 角色 / manifest / KBC / socket 网卡 / NUMA,不覆盖框架参数
编排 pair-run.sh 分发物料、起两侧 guest、收日志;调度决策在本地,不在集群
guest ../guest/init.sh 校验 OCI 层 → 取密钥 → 启动 mpc node

框架原生 argv 已经过真机校正,不要再加 -machine / sev-guest / 固件 / CPU 的 部署层覆盖;真机上那次 Platform is already owned 的根因是缺 kernel-hashes=on 与 pflash,已修进 PlatformProfile,详见 docs/TEE_DIRECT_LAUNCH.md。

边界

  • 两台真机的静态 qemu 没编 slirp,-netdev user 不可用;跨 guest 链路由部署层 注入 socket netdev,核心 crate 不写死宿主网络后端。
  • 在线 KBS 的 token 目前是占位值 offline-demo(stub 非 strict 模式放行并告警)。 生产必须换成证明代理产物 + 带证明校验的 KBS。
  • pair-run.sh 只起 qemu,不做芯片证明互验;报告验签走 mpc tee verify 的外部验签器。