## 改了什么 - **SNP 芯片签名验签闭环**:新增 `snp_collect.rs`(SNP_GET_EXT_REPORT ioctl + GHCB 切分)、`snp-verify-attestation.sh`(VCEK 走 AMD KDS)、 `selftest-snp-verify.py`(正 1 + 负 8),进主闸门第 10 条。 - **框架侧补 `mpc.tee.platform`**:`tee plan` 现在告诉 guest 用哪个平台采证明。 - **KBS 补独立 `--pin`**:`MPC_KBS_PIN` 与 `--measurement` 解耦,缺省回落, 既有部署行为不变 —— 这是「度量 pin 那一关」唯一能被单独测到的姿势。 - **guest stdout 修复**:init 开头 mknod 真 `/dev/console` + `exec > ... 2>&1`; `run-guest.py` 加 `MPC_TEE_SERIAL_LOG` 换 chardev file 落盘。 - **负向矩阵**:新增 `snp-attest-negative.sh`(6 条),判据全部收紧到该关独有文案。 - **KBS 就绪判据**:`kbs-net.sh` 从「进程存活」改成「端口进 LISTEN」。 - **文档**:`TEE_DIRECT_LAUNCH.md` 新增 SNP 整节 + bug 1~9; `TEE_OCI_PATH.md` 补 SNP 侧与负向判据唯一性;新增 `INTEGRATION_ANALYSIS.md` 与 `OPTEE_VERIF_PLAN.md`;`ci.sh` 加 no_std 双守、TA UUID 对拍、SNP 自测。 ## 什么影响 - 真机(海光 CSV `192.168.1.102` + AMD SNP `192.168.1.7`)**双向跑通**, 两端用同一份 Rust 判定代码。 - SNP 正向 e2e 7/7、负向 6/6 全部真拒在各自关卡;`tools/ci.sh` 十条全绿。 - 三处真 bug 已修:guest stdout 全丢(`/dev/console` 是普通文件 + `-nographic`/`-serial stdio` 抢 stdio)、`MPC_KBS_PIN` 接口缺口、 负向判据不唯一(兜底分支导致假绿)。 - 边界不变:`attest-mkbundle` 仍是合成件,过不了芯片验签(仅自测用)。
220 lines
10 KiB
Python
Executable File
220 lines
10 KiB
Python
Executable File
#!/usr/bin/env python3
|
||
"""真机侧启动器:消费框架原生 qemu argv,只补部署层参数。
|
||
|
||
框架(`mpc tee plan --argv`)负责平台中立且已被真机校正过的启动规格;
|
||
这里只补宿主相关的东西:串口、guest 角色、会话/镜像度量/KBC 参数、
|
||
socket 网卡、NUMA 内存后端。**不覆盖 -machine / -object / -bios / -cpu / -smp**
|
||
—— 那些都是框架能力表的职责,真机差异已经在 2026-11-06 校正过。
|
||
|
||
环境变量(全部由调用方注入,仓库内不落任何凭据或密钥):
|
||
MPC_TEE_MPC_BIN guest 内静态 mpc 二进制在宿主上的路径(默认 mpc)
|
||
MPC_TEE_MANIFEST OCI manifest digest,64 位十六进制(必填)
|
||
MPC_TEE_KBC guest 内 KBC 模式(默认 offline_fs_kbc::null)
|
||
MPC_TEE_MIN_TCB TCB 门槛(默认 3)
|
||
MPC_NETDEV_ARGS role != none 时必填,qemu 网卡参数(socket netdev)
|
||
MPC_TEE_GUEST_IP guest 网卡静态地址(如 10.99.0.2/24),tap/bridge 场景必填
|
||
MPC_TEE_KBS_REPO KBS 资源仓库名(默认 mpc)
|
||
MPC_TEE_SERIAL_LOG 串口输出落盘路径(可选但**强烈建议**)
|
||
|
||
★ 为什么建议 MPC_TEE_SERIAL_LOG(串口 stdout 会丢的坑):
|
||
|
||
框架的 qemu argv 里同时有 `-nographic` 和 `-serial stdio`
|
||
(见 crates/mpc-tee/src/schedule.rs::qemu_argv)。`-nographic` 自己
|
||
就会把默认串口接到 stdio(mon:stdio),于是**两个前端抢同一个 stdio**。
|
||
AMD 真机的 qemu(/opt/kata/bin/qemu-system-x86_64)在这条组合下
|
||
会出现「init 的 stdout 一行都收不到」的现象 —— guest 明明把
|
||
attestation_collect / attestation_post / key_source 全打出来了,
|
||
但脚本 grep 不到,表现为「链路没走通」的假象。
|
||
|
||
实际上 guest 是**成功**的:KBS 日志里能看到
|
||
POST /kbs/v0/attestation 200
|
||
GET /kbs/v0/resource/mpc/{psk,seed,root-key} 200
|
||
—— 只是 stdout 没落到采集端。
|
||
|
||
规避方式(不改框架 argv —— 框架的 `-nographic`+`-serial stdio`
|
||
是对的,那是给交互式/管道场景的标准写法):
|
||
把串口换成 chardev file 后端,输出**落文件**,采集端读文件。
|
||
|
||
用法:run-guest.py NODE_FILE SESSION_ID PUBKEY ROLE [VARIANT]
|
||
兼容 Python 3.6(海光 Anolis 8.10)。
|
||
"""
|
||
import json
|
||
import os
|
||
import shlex
|
||
import subprocess
|
||
import sys
|
||
|
||
HEX = set("0123456789abcdef")
|
||
|
||
|
||
def die(msg):
|
||
sys.stderr.write("run-guest: %s\n" % msg)
|
||
sys.exit(2)
|
||
|
||
|
||
def drop_pair(argv, flag, pred):
|
||
while True:
|
||
for i, a in enumerate(argv):
|
||
if a == flag and i + 1 < len(argv) and pred(argv[i + 1]):
|
||
del argv[i:i + 2]
|
||
break
|
||
else:
|
||
return
|
||
|
||
|
||
def main():
|
||
if len(sys.argv) < 5:
|
||
die("用法: run-guest.py NODE SESSION PUBKEY ROLE [VARIANT]")
|
||
mpc = os.environ.get("MPC_TEE_MPC_BIN", "mpc")
|
||
node_path, sid, pk, role = sys.argv[1:5]
|
||
variant = sys.argv[5] if len(sys.argv) > 5 else None
|
||
manifest = os.environ.get("MPC_TEE_MANIFEST", "").strip().lower()
|
||
kbc = os.environ.get("MPC_TEE_KBC", "offline_fs_kbc::null").strip()
|
||
kbs_repo = os.environ.get("MPC_TEE_KBS_REPO", "mpc").strip()
|
||
guest_ip = os.environ.get("MPC_TEE_GUEST_IP", "").strip()
|
||
attest_token = os.environ.get("MPC_TEE_ATTEST_TOKEN", "").strip()
|
||
min_tcb = os.environ.get("MPC_TEE_MIN_TCB", "3")
|
||
|
||
if len(manifest) != 64 or not set(manifest) <= HEX:
|
||
die("MPC_TEE_MANIFEST 必须是 64 位十六进制(由 oci-image.py build 输出)")
|
||
if len(sid) != 64 or not set(sid.lower()) <= HEX:
|
||
die("SESSION_ID 必须是 64 位十六进制")
|
||
if len(pk) != 64 or not set(pk.lower()) <= HEX:
|
||
die("PUBKEY 必须是 64 位十六进制")
|
||
if " " in kbc or not kbc:
|
||
die("MPC_TEE_KBC 不能含空格或为空")
|
||
if " " in kbs_repo or not kbs_repo:
|
||
die("MPC_TEE_KBS_REPO 不能含空格或为空")
|
||
if guest_ip and "/" not in guest_ip:
|
||
die("MPC_TEE_GUEST_IP 需要带掩码(如 10.99.0.2/24)")
|
||
if role not in ("alice", "bob", "none"):
|
||
die("ROLE 只能是 alice / bob / none")
|
||
|
||
cmd = [mpc, "--report", "json", "tee", "plan", "--node", node_path,
|
||
"--session-id", sid, "--pubkey", pk,
|
||
"--min-tcb", min_tcb, "--argv"]
|
||
if variant:
|
||
cmd += ["--variant", variant]
|
||
# KBC 模式与 KBS 端点要告诉框架:CSV 的在线 KBC 没有内置缺省端点,
|
||
# 端点只能来自节点描述或命令行,否则准入会以「缺 KBS 端点」拒绝。
|
||
#
|
||
# `mpc.tee.kbs=cc_kbc::<url>` 里的 <url> 已经带 scheme(cc_kbc::http://…),
|
||
# 这里**不能**再补 "http://" —— 早先补了,真机上就成了
|
||
# --kbs-endpoint http://http://10.99.0.1:18080。
|
||
if kbc.startswith("cc_kbc::"):
|
||
cmd += ["--kbc", "online"]
|
||
ep = kbc[len("cc_kbc::"):].strip().rstrip("/")
|
||
if ep:
|
||
if not (ep.startswith("http://") or ep.startswith("https://")):
|
||
ep = "http://" + ep
|
||
cmd += ["--kbs-endpoint", ep]
|
||
else:
|
||
cmd += ["--kbc", "offline"]
|
||
p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
|
||
universal_newlines=True)
|
||
plan_out, plan_err = p.communicate()
|
||
if p.returncode != 0:
|
||
sys.stderr.write("tee plan 失败 rc=%d\n%s\n%s\n" %
|
||
(p.returncode, plan_out, plan_err))
|
||
sys.exit(2)
|
||
|
||
argv = None
|
||
for line in plan_out.splitlines():
|
||
try:
|
||
obj = json.loads(line)
|
||
except ValueError:
|
||
continue
|
||
for k, v in obj.get("rows", []):
|
||
if k == "argv_json":
|
||
argv = json.loads(v)
|
||
if not argv:
|
||
sys.stderr.write("没拿到 argv_json\n%s" % plan_out)
|
||
sys.exit(2)
|
||
|
||
print("=== framework argv (%d args) ===" % len(argv))
|
||
print(" ".join(argv))
|
||
sys.stdout.flush()
|
||
|
||
# 1) 部署层追加的内核参数:镜像度量与 KBC 由调度侧钉进 guest。
|
||
# framework 原有的 mpc.tee.user_data / site / aa_kbc_params 不动。
|
||
# mpc.tee.kbs_repo 是 KBS 资源仓库名(默认 mpc),guest init 用它拼
|
||
# KBS 取料路径;不给就用 init 里的缺省值。
|
||
i = argv.index("-append") + 1
|
||
argv[i] += (" console=ttyS0 earlyprintk=serial"
|
||
" mpc.role=%s mpc.tee.session=%s"
|
||
" mpc.tee.manifest=%s mpc.tee.kbs=%s"
|
||
" mpc.tee.kbs_repo=%s" %
|
||
(role, sid, manifest, kbc, kbs_repo))
|
||
# guest 网卡静态地址(tap/bridge 场景):CSV 真机的静态 qemu 没编 slirp,
|
||
# 没有 NAT 网关,guest 要访问宿主 KBS 就得自己落在宿主网段里。
|
||
if guest_ip:
|
||
argv[i] += " mpc.tee.ip=%s" % guest_ip
|
||
# 证明代理 token(演练 / 负向矩阵用;生产由 guest 内证明代理写
|
||
# /run/mpc-tee/attestation.token,优先级更高)。token 不能含空格,
|
||
# 内核参数是空格分隔的。
|
||
if attest_token:
|
||
if any(c.isspace() for c in attest_token):
|
||
die("MPC_TEE_ATTEST_TOKEN 不能含空白")
|
||
argv[i] += " mpc.tee.token=%s" % attest_token
|
||
|
||
# 2) 网络后端由部署层决定,核心 crate 不写死。
|
||
# 框架按 KBC 模式决定「要不要网卡」(在线 KBS 要、离线不要),但给的是
|
||
# 通用 `user` 后端 —— 海光真机的静态 qemu 是 kata-static 裁剪版,**没有编
|
||
# slirp**(`-netdev user` 直接报 "Parameter 'type' expects a netdev backend
|
||
# type"),所以必须换成宿主侧注入的真实网卡:
|
||
# * socket —— 跨 guest 直连(AMD alice / 海光 bob 之间的密文会话)
|
||
# * tap —— guest 进宿主网段,用于访问宿主上的 KBS(在线 KBC)
|
||
# 两种后端都带同一个 netdev id(mpcnet0),guest 里看到的是同一张网卡。
|
||
needs_net = role != "none" or kbc.startswith("cc_kbc::")
|
||
drop_pair(argv, "-netdev", lambda v: v.startswith("user,"))
|
||
drop_pair(argv, "-device",
|
||
lambda v: v.startswith("virtio-net-pci,netdev=mpcnet0"))
|
||
if needs_net:
|
||
extra = os.environ.get("MPC_NETDEV_ARGS")
|
||
if not extra:
|
||
die("需要网卡(跨 guest 会话或在线 KBC),但没给 MPC_NETDEV_ARGS")
|
||
argv += shlex.split(extra)
|
||
print("=== deploy netdev: %s ===" % extra)
|
||
else:
|
||
print("=== role=none 且离线 KBC:不挂网卡 ===")
|
||
|
||
# 3) 机密 guest 需要显式 NUMA 内存后端;关机即退出 qemu。
|
||
argv += ["-object", "memory-backend-ram,id=dimm1,size=2048M",
|
||
"-numa", "node,memdev=dimm1", "-no-reboot"]
|
||
|
||
# 4) 串口输出落盘(可选,但真机脚本必须用)。
|
||
#
|
||
# 框架 argv 里是 `-nographic` + `-serial stdio`。这两个前端会**抢同一个
|
||
# stdio**:`-nographic` 本身就把默认串口接到 stdio(mon:stdio),
|
||
# 于是 guest init 的 stdout 在 AMD 真机上**一行都收不到**。
|
||
#
|
||
# 症状极具迷惑性:guest 侧其实完全成功(KBS 日志里能看到
|
||
# attestation 200 + psk/seed/root-key 三个 200),但采集脚本
|
||
# grep 不到 attestation_collect / key_source,于是判「链路没走通」。
|
||
#
|
||
# 这里改成 chardev file 后端:串口内容直接落文件,采集端读文件。
|
||
# 只动部署层的 stdio 形态,不动框架的启动规格(`-nographic`
|
||
# + `-serial stdio` 本身是标准写法,交互式场景仍然适用)。
|
||
serial_log = os.environ.get("MPC_TEE_SERIAL_LOG", "").strip()
|
||
if serial_log:
|
||
# 去掉框架的 stdio 串口组合,换成 chardev file。
|
||
for flag in ("-nographic", "-serial"):
|
||
while flag in argv:
|
||
i = argv.index(flag)
|
||
# -serial 后面跟一个值(stdio),-nographic 是单独 flag。
|
||
n = 2 if flag == "-serial" else 1
|
||
del argv[i:i + n]
|
||
argv += ["-display", "none",
|
||
"-chardev", "file,id=mpcser,path=%s" % serial_log,
|
||
"-serial", "chardev:mpcser"]
|
||
print("=== serial: chardev file -> %s ===" % serial_log)
|
||
|
||
print("=== deployed argv (%d args) ===" % len(argv))
|
||
print(" ".join(argv))
|
||
sys.stdout.flush()
|
||
os.execvp(argv[0], argv)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|