交付两件此前欠着的事,并在真机(192.168.1.102 海光 CSV)端到端跑通: 1. OCI 镜像流水线 build → verify → pack 三步在真机跑通,manifest digest 作 SessionBinding.code_measurement 钉进会话绑定值。 2. PSK / seed / root-key 不再内置 initrd,改由 guest 内 mpc tee kbs-get 按会话从宿主 KBS 取回(key_source=kbs)。 ★ 修掉两个框架级缺陷(都是「校验通过 ≠ 校验的是对的东西」): - guest 侧活文件链:旧 layers.sha256 只覆盖 blobs/ 下的惰性证据副本, 真正执行的 /init、/mpc 不在范围内 —— 真机改 /mpc 一个字节照样打印 oci_layers: verified。现改为从 cmdline 的 PIN 逐跳推导到活文件逐个校验, 失败时点名具体文件。 - 流水线侧自证:pack 打完 initrd 必须回读核对内嵌 digest / 清单 / manifest.json,不符即失败。缺前者不能保证「送进 guest 的是这个镜像」, 缺后者不能保证「guest 跑的是这个镜像里的活内容」,两者缺一不可。 新增真机可复现资产(deploy/tee/): - oci/oci-image.py:rootfs_state_from_layers() 直接从各层 tar 字节算活 rootfs 状态,不解包(免 mknod 权限,build 与 pack 共用同一函数防分叉); build 扫 base rootfs 里的密钥物料,命中即退出码 3。 - oci/selftest-chain.py:完整性链本地回归,含「旧口径对 /mpc 篡改完全 无感」的反向断言。 - real-machine/kbc-e2e.sh / kbc-negative.sh / kbs-net.sh:正向全链路与 5 条 fail-closed 负向矩阵、tap + bridge 出网链路。 - real-machine/tamper-initrd.py:精确解析 newc cpio 改目标文件数据区。 - real-machine/guest-syntax-check.sh:解包 initrd 后用解出来的 musl loader 跑解出来的 busybox,完全模拟 guest 内 ash 解析环境。 - real-machine/lint-shell-vars.py:shell 引号与变量名三类陷阱闸门。 框架侧:PlatformProfile.kbc 拆成 allowed_kbc(支持哪些)与 kbc(缺省); kbs_endpoint 改由节点描述给出,现场部署事实与代码分离。 真机实测:正向 KBC_E2E_OK(key_source=kbs),负向 5/5 全 fail-closed。 闸门扩到六条:ci.sh 新增 shell 引号/变量名卫生与 OCI 完整性链自测。
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=)。