Files
admin 5c68564b6c feat(tee): 打通 OCI 镜像流水线与在线 KBC 密钥下发,补齐运行期完整性链
交付两件此前欠着的事,并在真机(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 完整性链自测。
2026-11-07 02:07:28 +08:00
..

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