Files
ssw-mpc/deploy/tee/real-machine
admin 9c47e1076a feat(tee): 增加 CSV 报告离线校验器(2548B 布局 / Python 3.6 兼容)
- deploy/tee/real-machine/csv-report-check.py:按海光厂商 SDK 实测布局解析 report.cert,打印字段偏移表、核对 measure/sig1/user_pubkey_digest 非零、可选 --user-data 比对 @0x40 绑定;--selftest 自检 2548 布局、长度下限与 4096 页填充;--json 输出。仅做布局核对,不验签,签名/证书链交外部验签器。\n- README 增加「核对真实 CSV 报告」节,写明 2548≠4096、报告须在 CSV guest 内取(宿主无 /dev/csv-guest)、以及离线核对命令。\n- 兼容 Python 3.6(海光节点自带版本),无第三方依赖。
2026-11-06 20:09:18 +08:00
..

真机复现: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 的外部验签器。

核对真实 CSV 报告(2548 字节)

真机复核(2026-11-06,192.168.1.102)确认:海光厂商 SDK /opt/hygon/csv/attestation/csv_status.h 里 struct csv_attestation_report 的 sizeof 是 2548 字节,不是 4096(4096 只是 hypercall/mmap 的页大小)。 get-attestation / ioctl-get-attestation 写出的 report.cert 就是 2548 字节; 把报告长度按 4096 做下限会拒掉每一份真实报告。字段偏移: user_data@0x40、measure@0x90(32B SM3)、policy@0xB0、sig1@0xC0(144B)、 pek_cert@0x150、sn@0x974,结构体内无 version 字段。

报告必须在 CSV guest 内取(宿主机没有 /dev/csv-guest,直接跑 get-attestation 会 open /dev/csv-guest failed)。拿到 report.cert 后离线核对:

python3 deploy/tee/real-machine/csv-report-check.py --selftest   # 自检布局常量与解析
python3 deploy/tee/real-machine/csv-report-check.py --report report.cert
python3 deploy/tee/real-machine/csv-report-check.py --report report.cert \
        --user-data <64字节挑战值hex>   # 核对 user_data@0x40 与会话绑定一致

脚本只做布局与 user_data 绑定核对,不验签;sig1 / pek_cert 的签名与 证书链交给厂商 verify-attestation 或 mpc tee verify 的外部验签器。 脚本兼容 Python 3.6(海光节点自带版本),不依赖第三方库。