- 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。
3.0 KiB
3.0 KiB
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=)。