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

92 lines
3.2 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
"""篡改 initrd 里的**活文件**,用来验证 guest 的运行期完整性校验真的会拦。
为什么不用「随便找一段字节改掉」:
早先的篡改脚本在 initrd 里搜字符串 `manifest.digest`,改掉它后面第一个
十六进制字符。真机上这个字符串**第一次出现在 `/init` 的源码里**
(`/etc/mpc-tee/manifest.digest`),于是被改坏的是 init 脚本本身 ——
guest 报的是 `syntax error`,是「脚本坏了」,不是「完整性校验拦住了」。
测出来的是 init 的语法,不是校验逻辑。
这个脚本改成**精确解析 newc cpio**,找到目标文件(默认 `/mpc`)的数据区,
改掉其中一个字节。这样被改的是「正在被执行的二进制」,init 脚本本身完好,
guest 必须靠完整性校验才能发现 —— 这才是这条负向真正想测的东西。
用法:
tamper-initrd.py <initrd> [目标路径] # 默认 /mpc
兼容 Python 3.6(海光 Anolis 8.10 自带 3.6)。
"""
import gzip
import sys
MAGIC = b"070701"
TRAILER = "TRAILER!!!"
def cpio_records(raw):
"""遍历 newc cpio,返回 (name, data_start, data_len) 序列。"""
pos = 0
while pos + 110 <= len(raw):
if raw[pos:pos + 6] != MAGIC:
raise SystemExit("不是 newc cpio(magic 不符)")
f = raw[pos + 6:pos + 110].decode("ascii")
fields = [int(f[i * 8:(i + 1) * 8], 16) for i in range(13)]
# ino mode uid gid nlink mtime filesize devmajor devminor
# rdevmajor rdevminor namesize check
filesize = fields[6]
namesize = fields[11]
name_start = pos + 110
name = raw[name_start:name_start + namesize - 1].decode("utf-8")
if name == TRAILER:
return
data_start = name_start + namesize
data_start += (4 - data_start % 4) % 4
yield (name, data_start, filesize)
pos = data_start + filesize
pos += (4 - pos % 4) % 4
def main():
if len(sys.argv) < 2:
raise SystemExit("用法: tamper-initrd.py <initrd> [目标路径]")
path = sys.argv[1]
want = sys.argv[2] if len(sys.argv) > 2 else "mpc"
with open(path, "rb") as f:
data = f.read()
gz = data[:2] == b"\x1f\x8b"
raw = gzip.decompress(data) if gz else data
target = None
for name, start, length in cpio_records(raw):
if name == want:
target = (start, length)
break
if target is None:
raise SystemExit("initrd 里找不到目标文件: %s" % want)
start, length = target
if length < 1:
raise SystemExit("目标文件是空的,没法篡改: %s" % want)
# 改数据区第一个字节。选一个非 NUL 的字节改成别的值,避免把文件
# 变成「看起来还是合法可执行文件但内容变了」以外的花样 ——
# 这里要的正是「内容变了但结构没坏」。
buf = bytearray(raw)
off = start
if buf[off] == 0x00:
buf[off] = 0x01
else:
buf[off] ^= 0xFF
raw = bytes(buf)
out = gzip.compress(raw) if gz else raw
with open(path, "wb") as f:
f.write(out)
print("tampered %s at offset %d (len=%d)" % (want, off, length))
if __name__ == "__main__":
main()