Files
ssw-mpc/deploy/tee/real-machine/run-guest.py
T
admin e839a972c0 feat(tee): 接入 AMD SEV-SNP 芯片验签,双平台「先验证明才给密钥」全部真机跑通
## 改了什么

- **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` 仍是合成件,过不了芯片验签(仅自测用)。
2026-11-07 12:47:22 +08:00

220 lines
10 KiB
Python
Executable File
Raw 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
"""真机侧启动器:消费框架原生 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()