Files
ssw-mpc/deploy/tee/oci/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.0 KiB
Raw Blame History

OCI 分层镜像(无容器运行时依赖)

oci-image.py 用 Python 3 标准库直接生成 OCI image layout。真机现场只有 docker / runc,没有 buildah / podman / krunvm,所以这里不调用任何 容器运行时,也不需要 registry 就能本地构建与校验。

三步

# 0) 准备 base rootfs:现成 alpine rootfs 目录(含 busybox 与 musl loader)
#    macOS 上可直接用宿主解出的目录;真机上 /opt/.../kata-alpine-*.initrd
#    用 `gzip -dc | cpio -idm` 解出来即可。

# 1) 构建分层镜像(base / mpc / init)
python3 oci-image.py build \
  --base /path/to/alpine-rootfs \
  --mpc  /path/to/mpc-linux-x86_64 \
  --init ../guest/init.sh \
  --out  ./image

# 2) 校验 digest 链(index → manifest → config → layers,含 diff_id)
python3 oci-image.py verify --image ./image

# 3) 校验通过后按层解包,打成 qemu 直接启动用的 initrd
python3 oci-image.py pack --image ./image --out ./mpc-initrd.img

build 与 pack 都打印:

manifest_digest=<64hex>      # 就是 SessionBinding.code_measurement
measurement=<64hex>          # 写进节点描述的 measurement=
initrd_sha256=<64hex>        # 分发完整性用

把 measurement 填进 deploy/tee/nodes/*.node / real-machine/nodes/*.node, 并在启动 guest 时把 mpc.tee.manifest=<64hex> 钉进内核参数 (real-machine/run-guest.py 从 MPC_TEE_MANIFEST 读取,缺失即 fail-closed 拒绝启动)。

层契约

层 内容 说明
base 整个 rootfs 目录 排序 + 固定 uid/gid/mtime,保证可复现
mpc /mpc Linux 静态二进制,0755
init /init ../guest/init.sh,0755,后层覆盖 base 自带 init
offline(可选) /etc/mpc-tee/offline/{psk,seed,root-key} 仅离线演练,--offline-dir 开启时会打印警告,禁止上生产

pack 会把每层 tar.gz、manifest.json、config.json、layers.json 与 layers.sha256 一起放进 initrd 的 /etc/mpc-tee/oci/。guest init 先 sha256sum -c layers.sha256,再核对 cmdline 的 manifest digest,全部通过才启动 mpc。

为什么 measurement 取 manifest digest

SessionBinding 的 code_measurement 是 32 字节,正好是 sha256。用 manifest digest 而不是「mpc 二进制的哈希」,是因为真正决定 guest 行为的是整套层 (rootfs + 二进制 + init),换任何一层都应让旧证明失效。这也让 registry 的 按 digest 拉取与框架的 --pin 判定天然对齐。

边界

  • 层 digest 校验防的是分发过程被替换;能同时改 initrd 里 /init 与校验清单的 宿主不在防御范围内。硬件级启动度量要靠 SNP/CSV 证明,见 docs/TEE_OCI_PATH.md。
  • 本工具只产出物料,不启动任何东西;执行仍走 deploy/tee/real-machine/ 或 deploy/tee/launch.sh 的 qemu 后端。
  • 兼容 Python 3.6(海光 Anolis 8.10):不用 capture_output、walrus、 gzip.compress(mtime=)。