diff --git a/CLAUDE.md b/CLAUDE.md index c041eb9..246b535 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -496,7 +496,12 @@ AMD SNP(alice)+ 海光 CSV(bob)两侧**各自**完成 (IP / xop 键名 / MAC / 网段 / 端口 / 超时),脱敏可 source;换机器改这一份, 别逐个脚本 export。`real-machines.env` 是本地实际配置,已 gitignore - `deploy/tee/real-machine/preflight-real-machine.sh` — 重跑前一次性报缺 - (工具 / xop 键 / 参数一致性 / 远端物料);`--self-test` 负向矩阵,缺环境显式 SKIP/FAIL + (工具 / xop 键 / 本机重建条件 / 参数一致性 / 远端物料);`--self-test` 负向矩阵, + 缺环境显式 SKIP/FAIL +- `deploy/tee/real-machine/host-materials.sh` + `nodes/host-materials.sha256` — + **两台真机 `/opt` 不可再生物料的入仓基线**(18 条 sha256);重启后 `--verify` + 逐台比对,换机 / 升级后 `--collect` 重采。远端 `/tmp` 是每次 e2e 重铺的运行时目录, + 丢了不用管;README「机器重启 / 换机后怎么办」有完整分工表 - `demo/k8s/README.md` — 站点部署与 PVC 持久化 - `tools/fisco-realnode/README.md` — 真链复现工具索引、环境变量、审计轨迹、密钥边界 diff --git a/deploy/tee/real-machine/README.md b/deploy/tee/real-machine/README.md index a2b2b91..e410d33 100644 --- a/deploy/tee/real-machine/README.md +++ b/deploy/tee/real-machine/README.md @@ -20,9 +20,14 @@ cp real-machines.env.example real-machines.env # 已 gitignore,按现场 set -a; . ./real-machines.env; set +a ./preflight-real-machine.sh # 一次性报缺:工具 / xop 键 / 参数 / 远端物料 ./tee-pair-attest-e2e.sh # 一键:编译 → OCI → 双 KBS → 双 guest → 双判据 -./tee-pair-attest-negative.sh # 负向:证明被拒 ⇒ 拿不到密钥 +./tee-pair-attest-negative.sh # 负向:证明被拒 ⇒ 拿不到密钥(必须在 e2e 之后) ``` +- **负向脚本必须在 e2e 之后跑**:它复用 e2e 铺到远端 `/tmp` 的物料,且需要 OCI + manifest。2026-11-08 起 `MPC_TEE_MANIFEST` **自动从 `${MPC_TEE_WORK}/image` + 用同一份 `oci-image.py verify` 重算**并断言 64 hex,不用手抄; + 旧版单独跑会报「缺少 MPC_TEE_MANIFEST」,已修。 + - **`real-machines.env.example` 是参数的唯一集中入口**:IP / xop 键名 / MAC / 网段 / 端口 / 超时全在里面,变量名与脚本 `${VAR:-default}` 逐字一致。换机器改这一份, **不要逐个脚本 export**。凭据只放 xop 键名,不放明文口令。 @@ -57,6 +62,7 @@ set -a; . ./real-machines.env; set +a | 官方验签器悄悄联网 | 缺证书时会联网下载 | 链校验模式强制 `unshare -rn` 断网。同上、`docs/REAL_MACHINE_FINDINGS.md` §2 | | 绑定值对不上,报错像「重放攻击」 | 手工抄 site / measurement / tcb,或没还原 `anonce` 混淆 | 用采集时的 `session.env` 重算;`csv-report-restore.py --field all`。`fixtures/csv/session.env` | | `scp -r` 把目录铺平 / 真机冒出 `._*` | `scp -r` 语义 + macOS tar 注入 AppleDouble | 用 `tar` 传目录、`COPYFILE_DISABLE=1` | +| `缺少 MPC_TEE_MANIFEST` | 负向脚本单独跑,没有 e2e 产物 | 先跑 `./tee-pair-attest-e2e.sh`;2026-11-08 起 manifest 自动重算,别手抄 | ### `/tmp` 里那 60+ 个探索脚本怎么办 @@ -67,6 +73,38 @@ set -a; . ./real-machines.env; set +a **不要整批拷进仓库,也不要重跑一遍去「确认」** —— 那正是「从零探索」。 真机报告与证书链的可复现样本已在 `fixtures/`,可直接喂自测。 +### 机器重启 / 换机后怎么办(2026-11-08 实测核对) + +**结论先说**:远端 `/tmp` 丢了不影响重跑;`/opt` 物料在持久根盘,重启后仍在。 +真正要防的是「换机 / 重装 / 物料被升级」时**没基线可核对**。 + +| 资源 | 在哪 | 重启后 | 谁负责恢复 | +|---|---|---|---| +| 运行时物料(mpc / initrd / KBS 脚本 / 证书副本 / 串口日志) | 远端 `/tmp/mpc-tee-run-attestpair`、本机 `/tmp/mpc-tee-attest-e2e` | 可丢;实测 19:45 两台机三个 `/tmp` 目录**全为空** | `tee-pair-attest-e2e.sh` 每次从源码 + `alpine:3.18` 重新构建并分发 | +| 不可再生物料(qemu / OVMF / 内核 / 海光官方验签器 / GmSSL / CSV 证书链) | 远端 `/opt`:AMD `/opt/kata` 3.7G、海光 `/opt/confidential-containers` 1.2G + `/opt/hygon` | **在持久根盘**(实测 `/` 是 ext4 / xfs,无独立 `/tmp` tmpfs)⇒ 重启仍在 | 仓库**没有替代品**;机器自带,换机须重装厂商 SDK 并重采基线 | +| 本机重建条件 | `alpine:3.18` 镜像、musl target、`deploy/tee/oci/oci-image.py`、`guest/init.sh`、`fixtures/` | 随本机 Docker / Rust 工具链持久 | `preflight-real-machine.sh` 的「本机重建资源」逐项检查,缺一项就 FAIL | + +**重启后只需三步**: + +```bash +./host-materials.sh --verify # 核对两台真机 /opt 物料 vs 基线(18 条 sha256 + size) +./preflight-real-machine.sh # 含本机重建条件、xop 键、参数、远端可达 +./tee-pair-attest-e2e.sh # 重新铺远端 /tmp → 双 KBS / 双 guest → 双判据 +``` + +- `nodes/host-materials.sha256` 是**入仓基线**(AMD 3 条 / 海光 15 条)。 + `--verify` 逐台重算 sha256 比对,缺文件 / 被替换 / 被升级都 `FAIL` 并打印 diff; + `--self-test` 用 6 个构造样例逐条破坏比对判据(哈希 / 大小 / 缺失 / 多出 / 路径),非恒绿; + 还用「篡改清单里一条 hash」做过**端到端**破坏验证(精确判红,exit=1,diff 指出 AMD qemu)。 + ★ **清单本身由 git 保护**:改动会出现在 diff 里,不要在仓库外偷改基线。 +- 换机 / 物料升级后:`./host-materials.sh --collect` 重采基线并提交,同时按现场更新 + `nodes/*.node.example` 的 qemu / 固件 / 内核路径与 `real-machines.env.example`。 +- ⚠️ 别把 `/opt` 物料拷进仓库:qemu 单文件 69MB、海光 initrd 78MB,且是厂商 SDK 分发物。 + 清单只记录路径 / 大小 / 哈希,不搬运二进制。 +- 2026-11-08 19:47 实跑复验:从源码重编 musl mpc → 重新导出 alpine rootfs → 重新打 initrd + → 分发 → 双 KBS → 双 guest,`TEE_PAIR_OK` + `TEE_ATTEST_GATE_OK` + `TEE_PAIR_ATTEST_OK` + 全绿,两侧还原 `35.000000`。**这证明本机重建链路真的可用,不是只靠远端残留。** + --- ## 前置物料 @@ -138,7 +176,7 @@ MPC_TEE_DRY_RUN=1 ./tee-pair-e2e.sh # 只跑到 dry-run,不连机 ```bash ./tee-pair-attest-e2e.sh # 芯片证明链 + 密文会话合流(同一次运行) -./tee-pair-attest-negative.sh # 负向:证明被拒 ⇒ 拿不到密钥;恢复 ⇒ 又能拿到 +./tee-pair-attest-negative.sh # 负向:证明被拒 ⇒ 拿不到密钥;恢复 ⇒ 又能拿到(须在 e2e 之后) ``` 与 `tee-pair-e2e.sh` 的区别只有一处,但那一处是**安全性质的关键**: diff --git a/deploy/tee/real-machine/host-materials.sh b/deploy/tee/real-machine/host-materials.sh new file mode 100755 index 0000000..909832d --- /dev/null +++ b/deploy/tee/real-machine/host-materials.sh @@ -0,0 +1,215 @@ +#!/usr/bin/env bash +# 两台真机上**不可再生**物料的清单:采集 / 核对 / 判据自测。 +# +# 为什么需要它(2026-11-08): +# e2e 每次都会把运行时物料重新铺到远端 /tmp —— 那部分重启丢了没关系。 +# 但 /opt 下的 qemu / 固件 / 内核 / 海光官方验签器 / GmSSL 库 / CSV 证书链 +# 是机器自带的,仓库里没有替代品(fixtures/ 只有证书副本与报告样本)。 +# 机器重启后这些通常还在(根盘持久),但**换机、重装、物料被升级**时 +# 不能靠肉眼确认。这份带 sha256 的清单 + 核对脚本就是硬基线: +# 一条命令告诉你「哪台机器少了什么 / 哪个文件被换了」。 +# +# 用法: +# ./host-materials.sh --collect # 重新采集基线(换机 / 物料升级后) +# ./host-materials.sh --verify # 核对当前两台真机 vs 基线(默认) +# ./host-materials.sh --self-test # 零依赖:逐条破坏比对判据,证明非恒绿 +# +# ★ 只核对物料是否存在 / 是否被改,**不产生任何业务结论** +# (TEE_PAIR_OK / TEE_ATTEST_GATE_OK 仍有各自唯一判据)。 +# ★ 凭据只经 xop 键名注入,不取值、不打印口令。 +# ★ 远端不可达 / 文件缺失一律 FAIL,绝不静默跳过。 +set -u + +HERE=$(cd "$(dirname "$0")" && pwd) +MANIFEST=${MPC_TEE_MATERIALS_MANIFEST:-"${HERE}/nodes/host-materials.sha256"} +SSHO="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o PreferredAuthentications=password -o PubkeyAuthentication=no -o ConnectTimeout=20" + +# 主机与 xop 键名:优先用 real-machines.env.example 的默认值。 +AMD_HOST=${MPC_TEE_AMD_HOST:-192.168.1.7} +HYGON_HOST=${MPC_TEE_HYGON_HOST:-192.168.1.102} +AMD_UK=${MPC_TEE_AMD_USER_KEY:-tee_amd_7_user} +AMD_PK=${MPC_TEE_AMD_PASS_KEY:-tee_amd_7_pass} +HYGON_UK=${MPC_TEE_HYGON_USER_KEY:-tee_hg_102_user} +HYGON_PK=${MPC_TEE_HYGON_PASS_KEY:-tee_hg_102_pass} + +# ── 物料路径清单(改机器 / 升级物料后同步改这里,再 --collect)───────── +AMD_PATHS='/opt/kata/bin/qemu-system-x86_64 +/opt/kata/share/ovmf/AMDSEV.fd +/opt/kata/share/kata-containers/vmlinuz-6.12.36-160-confidential' + +HYGON_PATHS='/opt/confidential-containers/bin/qemu-system-x86_64 +/opt/confidential-containers/share/ovmf/HYGONCSV.fd +/opt/confidential-containers/share/kata-containers/vmlinuz-5.10.134-102cc-csv-hygon-gpu +/opt/confidential-containers/share/kata-containers/kata-containers-initrd-csv-hygon-gpu.img.offline_fs_kbc +/opt/hygon/csv/attestation/verify-attestation +/opt/hygon/csv/attestation/get-attestation +/opt/gmssl/lib/libcrypto.so.1.1 +/opt/gmssl/lib/libssl.so.1.1 +/opt/hygon/csv/confidential-containers/scripts/cek.cert +/opt/hygon/csv/confidential-containers/scripts/hrk.cert +/opt/hygon/csv/confidential-containers/scripts/hsk.cert +/opt/hygon/csv/confidential-containers/scripts/hsk_cek.cert +/opt/hygon/csv/confidential-containers/scripts/oca.cert +/opt/hygon/csv/confidential-containers/scripts/pdh.cert +/opt/hygon/csv/confidential-containers/scripts/pek.cert' + +# ── 纯判据:三元组逐字节比对(可被 --self-test 用构造样例逐条破坏)────── +# $1 = 期望文本(每行 "hash size path"),$2 = 实测文本;一致才返回 0。 +compare_triples() { + # 空清单不算通过:远端无响应时两边都可能为空,那会变成恒绿。 + [ "$(printf '%s\n' "$1" | grep -c .)" -gt 0 ] || return 1 + [ "$(printf '%s\n' "$1" | grep -c .)" -eq "$(printf '%s\n' "$2" | grep -c .)" ] || return 1 + [ "$(printf '%s\n' "$1" | sort)" = "$(printf '%s\n' "$2" | sort)" ] || return 1 + # MISS 行永远不可能出现在期望里 ⇒ 缺文件必判失败。 + case "$2" in *MISS*) return 1 ;; esac + return 0 +} + +selftest() { + local good bad_n=0 ok_n=0 + good='aaaa 100 /opt/a +bbbb 200 /opt/b' + # 正向对照 + if compare_triples "$good" "$good"; then ok_n=$((ok_n + 1)); else + printf 'FAIL 正向对照竟然失败\n'; bad_n=$((bad_n + 1)); fi + # 负向① 哈希被改一位 + if compare_triples "$good" 'aaab 100 /opt/a +bbbb 200 /opt/b'; then + printf 'FAIL 负向① 哈希改动:判据恒真\n'; bad_n=$((bad_n + 1)); + else ok_n=$((ok_n + 1)); fi + # 负向② 文件大小变了 + if compare_triples "$good" 'aaaa 101 /opt/a +bbbb 200 /opt/b'; then + printf 'FAIL 负向② 大小改动:判据恒真\n'; bad_n=$((bad_n + 1)); + else ok_n=$((ok_n + 1)); fi + # 负向③ 远端缺一个文件(MISS 行) + if compare_triples "$good" 'aaaa 100 /opt/a +MISS /opt/b'; then + printf 'FAIL 负向③ 文件缺失:判据恒真\n'; bad_n=$((bad_n + 1)); + else ok_n=$((ok_n + 1)); fi + # 负向④ 远端多出一个文件(只看部分匹配会恒绿) + if compare_triples "$good" 'aaaa 100 /opt/a +bbbb 200 /opt/b +cccc 300 /opt/c'; then + printf 'FAIL 负向④ 多出文件:判据恒真\n'; bad_n=$((bad_n + 1)); + else ok_n=$((ok_n + 1)); fi + # 负向⑤ 路径被换但哈希相同 + if compare_triples "$good" 'aaaa 100 /opt/x +bbbb 200 /opt/b'; then + printf 'FAIL 负向⑤ 路径改动:判据恒真\n'; bad_n=$((bad_n + 1)); + else ok_n=$((ok_n + 1)); fi + printf -- '---\n物料判据自测:%s 通过 / %s 失败\n' "$ok_n" "$bad_n" + [ "$bad_n" -eq 0 ] +} + +# ── 远端采集:把路径列表编码进脚本,避免引号/空格/注入问题 ────────────── +make_remote_script() { + local paths=$1 + cat <&1 | grep -E '^(MAT|MISS) ' || true +} + +host_label() { case "$1" in "$AMD_HOST") printf 'amd-snp' ;; *) printf 'hygon-csv' ;; esac; } + +collect_one() { + local host=$1 uk=$2 pk=$3 paths=$4 out line + out=$(remote_run "$host" "$uk" "$pk" "$(make_remote_script "$paths")") + if [ -z "$out" ]; then + printf 'FAIL %s (%s) 远端无响应:SSH 不可达或 sha256sum/stat 不可用\n' "$(host_label "$host")" "$host" >&2 + return 1 + fi + while IFS= read -r line; do + case "$line" in + 'MAT '*) printf '%s %s\n' "$host" "${line#MAT }" ;; + 'MISS '*) printf 'FAIL %s 远端缺文件 %s\n' "$host" "${line#MISS }" >&2; return 1 ;; + esac + done < "$tmp" + collect_one "$AMD_HOST" "$AMD_UK" "$AMD_PK" "$AMD_PATHS" >> "$tmp" || rc=1 + collect_one "$HYGON_HOST" "$HYGON_UK" "$HYGON_PK" "$HYGON_PATHS" >> "$tmp" || rc=1 + if [ "$rc" -ne 0 ]; then rm -f "$tmp"; return 1; fi + mv "$tmp" "$MANIFEST" + printf '基线已写入 %s(%s 条)\n' "$MANIFEST" "$(grep -cE '^[0-9]+\.[0-9]+' "$MANIFEST")" +} + +do_verify() { + local host uk pk paths expected actual raw miss rc=0 n spec + [ -f "$MANIFEST" ] || { printf 'FAIL 缺基线 %s(先跑 --collect)\n' "$MANIFEST" >&2; return 1; } + printf '=== 真机不可再生物料核对(%s) ===\n' "$MANIFEST" + # 路径从清单读,而不是从脚本里的常量读 ⇒ 换机后只要 --collect 重采即可。 + for spec in "${AMD_HOST} ${AMD_UK} ${AMD_PK}" "${HYGON_HOST} ${HYGON_UK} ${HYGON_PK}"; do + set -- $spec + host=$1 uk=$2 pk=$3 + paths=$(awk -v h="$host" '$1 == h && $1 !~ /^#/ { print $4 }' "$MANIFEST") + expected=$(awk -v h="$host" '$1 == h && $1 !~ /^#/ { print $2" "$3" "$4 }' "$MANIFEST") + n=$(printf '%s\n' "$expected" | grep -c .) + if [ "$n" -eq 0 ]; then + printf 'FAIL %s (%s) 清单里没有该主机的物料条目\n' "$(host_label "$host")" "$host" >&2 + rc=1; continue + fi + raw=$(remote_run "$host" "$uk" "$pk" "$(make_remote_script "$paths")") + if [ -z "$raw" ]; then + printf 'FAIL %s (%s) 远端无响应(SSH 不可达或 sha256sum/stat 不可用)\n' \ + "$(host_label "$host")" "$host" >&2 + rc=1; continue + fi + actual=$(printf '%s\n' "$raw" | sed -n 's/^MAT //p') + miss=$(printf '%s\n' "$raw" | sed -n 's/^MISS //p') + if [ -n "$miss" ]; then + actual=$(printf '%s\nMISS %s\n' "$actual" "$miss") + fi + if compare_triples "$expected" "$actual"; then + printf 'ok %s (%s) %s 个物料全部一致\n' "$(host_label "$host")" "$host" "$n" + else + printf 'FAIL %s (%s) 物料与基线不一致(缺失 / 被替换 / 被升级):\n' \ + "$(host_label "$host")" "$host" >&2 + diff <(printf '%s\n' "$expected" | sort) <(printf '%s\n' "$actual" | sort) >&2 || true + rc=1 + fi + done + if [ "$rc" -eq 0 ]; then printf '核对通过:两台真机 /opt 物料均与基线一致\n'; + else printf '核对未通过:按上面 diff 处置,别当成「重启后自动恢复」\n' >&2; fi + return "$rc" +} + +main() { + case "${1:---verify}" in + --collect) do_collect ;; + --verify) do_verify ;; + --self-test) selftest ;; + -h|--help) sed -n '2,20p' "$0"; return 0 ;; + *) printf '未知参数:%s\n' "$1" >&2; return 2 ;; + esac +} + +main "$@" diff --git a/deploy/tee/real-machine/nodes/host-materials.sha256 b/deploy/tee/real-machine/nodes/host-materials.sha256 new file mode 100644 index 0000000..23da220 --- /dev/null +++ b/deploy/tee/real-machine/nodes/host-materials.sha256 @@ -0,0 +1,22 @@ +# 两台真机不可再生物料基线(sha256 + size) +# 采集:2026-11-08 19:50:37 +0800 +# 格式:host sha256 size path +# 重新采集:./host-materials.sh --collect ;核对:--verify +192.168.1.7 87c9808dd43626bc5917f440e1f3b32b4d1f7ac9630b0eca22e65bff73a9491a 69338128 /opt/kata/bin/qemu-system-x86_64 +192.168.1.7 43a339ec9dedda7a8926239574e21a5d8803c8f50e787c2a53c2efa796a3acfa 4194304 /opt/kata/share/ovmf/AMDSEV.fd +192.168.1.7 0a0876e50bbc11382df7626d6f16d8351a2c75e411f16e1a1cde6df8661e9235 11194880 /opt/kata/share/kata-containers/vmlinuz-6.12.36-160-confidential +192.168.1.102 985d4e84eac008a1c07f5b81c4b6af87ac49f299adeb83f34f1b7b6c35dd91bc 18492824 /opt/confidential-containers/bin/qemu-system-x86_64 +192.168.1.102 c0a55c33859d4e6de165d49914bbe42111a1a1207c8da9dd1582b5aaf0eb7be2 4194304 /opt/confidential-containers/share/ovmf/HYGONCSV.fd +192.168.1.102 a98dd67b8469744f935e7d4918716d345b6c1b6513186b199c7972c15ca45347 7169664 /opt/confidential-containers/share/kata-containers/vmlinuz-5.10.134-102cc-csv-hygon-gpu +192.168.1.102 c2c46513d6dcbe4938f7369494625d6318dbcc1c53f2c620a6833ecf069c6300 78173256 /opt/confidential-containers/share/kata-containers/kata-containers-initrd-csv-hygon-gpu.img.offline_fs_kbc +192.168.1.102 6235bc23e15284351f843614f3bd6f71ed118e9815a0d31ad7bcec0b2e91fb3c 43264 /opt/hygon/csv/attestation/verify-attestation +192.168.1.102 44bc3e17fb3ba5f17c6643fe842bdf85f60c3fed9ffe47239ce163c6e5b6e119 2661848 /opt/hygon/csv/attestation/get-attestation +192.168.1.102 149389fb732001c424152bf238134826c80d82b2d8d8dd891ad79db3d8fbc589 3647256 /opt/gmssl/lib/libcrypto.so.1.1 +192.168.1.102 1842c7fa81d2e0fc0a4ef72e7934174d1a0cf3a5303d88091dfe145ffea9b9d3 554752 /opt/gmssl/lib/libssl.so.1.1 +192.168.1.102 db6a1a2fa4e9682dabfbe10cd5430bb62eb13f51239a2b0d1f831b50441c4861 2084 /opt/hygon/csv/confidential-containers/scripts/cek.cert +192.168.1.102 296efa97580464aca0ab5eefe42199ee05862182508d1629f29cf4dc175b10cd 832 /opt/hygon/csv/confidential-containers/scripts/hrk.cert +192.168.1.102 7cc9a3391c82f68d7def8c0db9e9b846f0ee223a00224a3551ec5be216895eb7 832 /opt/hygon/csv/confidential-containers/scripts/hsk.cert +192.168.1.102 de5470dc355f437670cafeba4e6c03b89d8cc0a12cd876eb64306f9514cee222 2916 /opt/hygon/csv/confidential-containers/scripts/hsk_cek.cert +192.168.1.102 44bcf2506f81f02f02a2dd2bb71162cbfb6c4b326f84d1d205cffd22610e9ba3 2084 /opt/hygon/csv/confidential-containers/scripts/oca.cert +192.168.1.102 d3ce443c8b603af215437864424be228b0cdf99a371a515f0868f944ef37e2e0 2084 /opt/hygon/csv/confidential-containers/scripts/pdh.cert +192.168.1.102 b03a340ebdb9fe399a9171a7e3c5465f96e31ef70261e831b90f21410ce9d610 2084 /opt/hygon/csv/confidential-containers/scripts/pek.cert diff --git a/deploy/tee/real-machine/preflight-real-machine.sh b/deploy/tee/real-machine/preflight-real-machine.sh index d864456..685b90e 100755 --- a/deploy/tee/real-machine/preflight-real-machine.sh +++ b/deploy/tee/real-machine/preflight-real-machine.sh @@ -122,6 +122,35 @@ check_local_tools() { else fail '真机脚本目录缺失'; fi } +# 本机「重建链路」是否齐备:e2e 不依赖远端 /tmp 残留,但依赖这些本机资源。 +# 缺任何一项都会在 e2e 跑到一半才炸 —— 所以预检一次性报出来。 +check_local_rebuild() { + local img=${MPC_TEE_ALPINE_IMAGE:-alpine:3.18} sysroot f + if docker image inspect "$img" >/dev/null 2>&1; then + ok "本机 alpine 镜像 ${img}(rootfs 可重建)" + else + fail "缺本机 alpine 镜像 ${img}(docker pull 或见 README 前置物料)" + fi + sysroot=$(rustc --print sysroot 2>/dev/null || true) + if [ -n "$sysroot" ] && [ -d "$sysroot/lib/rustlib/x86_64-unknown-linux-musl" ]; then + ok 'musl 交叉目标已安装(guest mpc 可重编)' + else + fail '缺 x86_64-unknown-linux-musl target(rustup target add x86_64-unknown-linux-musl)' + fi + for f in \ + "${REPO}/deploy/tee/oci/oci-image.py" \ + "${REPO}/deploy/tee/guest/init.sh" \ + "${REPO}/deploy/tee/real-machine/fixtures/snp/report.bin" \ + "${REPO}/deploy/tee/real-machine/fixtures/csv/report.cert" \ + "${REPO}/deploy/tee/real-machine/fixtures/csv/chain/hrk.cert" \ + "${REPO}/deploy/tee/real-machine/nodes/host-materials.sha256" \ + "${REPO}/deploy/tee/real-machine/host-materials.sh" + do + if [ -f "$f" ]; then ok "本机重建资源 ${f#"${REPO}/"}"; + else fail "缺本机重建资源 ${f#"${REPO}/"}"; fi + done +} + check_xop_keys() { local keys list k keys="${MPC_TEE_AMD_USER_KEY:-tee_amd_7_user} ${MPC_TEE_AMD_PASS_KEY:-tee_amd_7_pass} ${MPC_TEE_HYGON_USER_KEY:-tee_hg_102_user} ${MPC_TEE_HYGON_PASS_KEY:-tee_hg_102_pass}" @@ -195,6 +224,7 @@ main() { fi check_local_tools + check_local_rebuild check_xop_keys check_params \ "${MPC_AMD_DATA_MAC:-02:00:00:00:0a:01}" \ diff --git a/deploy/tee/real-machine/real-machines.env.example b/deploy/tee/real-machine/real-machines.env.example index e6740aa..04b3918 100644 --- a/deploy/tee/real-machine/real-machines.env.example +++ b/deploy/tee/real-machine/real-machines.env.example @@ -75,7 +75,8 @@ export MPC_TEE_PUBKEY=cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd # ── H. 运行时生成,**不要手填**(列出来只是为了避免误以为漏配)────────── # MPC_TEE_MPC_BIN / MPC_TEE_INITRD / MPC_TEE_AMD_NODE / MPC_TEE_HYGON_NODE -# MPC_TEE_MANIFEST ← 从 oci-image.py build 输出解析,不许手抄 +# MPC_TEE_MANIFEST ← e2e 从 oci-image.py build 解析;负向脚本会自动 +# 从 ${MPC_TEE_WORK}/image 重算,两处都不许手抄 # MPC_TEE_DATA_MAC / MPC_TEE_KBS_MAC / MPC_TEE_GUEST_IP / MPC_TEE_TAP # MPC_KBS_BRIDGE / MPC_KBS_BRIDGE_IP / MPC_KBS_PORT / MPC_KBS_SESSION # MPC_KBS_TOKEN_KEY_FILE ← 远端生成,值为 ${MPC_TEE_REMOTE_DIR}/kbs-token.key diff --git a/deploy/tee/real-machine/tee-pair-attest-negative.sh b/deploy/tee/real-machine/tee-pair-attest-negative.sh index 8012cd4..086c2fc 100755 --- a/deploy/tee/real-machine/tee-pair-attest-negative.sh +++ b/deploy/tee/real-machine/tee-pair-attest-negative.sh @@ -32,8 +32,14 @@ # 真踩过:shell 把整串参数当成一个 argv,CLI 回「未知参数」, # 只判 rc≠0 就把这个 bug 当成了「KBS 正确拒绝」。 # -# 用法: -# MPC_TEE_AMD_HOST=... MPC_TEE_HYGON_HOST=... ./tee-pair-attest-negative.sh +# 用法(**必须在 tee-pair-attest-e2e.sh 之后跑**:要用它铺好的远端物料): +# ./tee-pair-attest-negative.sh +# MPC_TEE_MANIFEST=<64hex> ./tee-pair-attest-negative.sh # 显式指定(一般不需要) +# +# ★ MPC_TEE_MANIFEST 不许手抄:未给时从 e2e 产物 ${MPC_TEE_WORK}/image +# 用**同一份** oci-image.py verify 重算,并断言 64 hex。 +# (2026-11-08 实测:旧版直接单独跑会报「缺少 MPC_TEE_MANIFEST」, +# 这正是「每次重跑要重新拼参数」的残留。) set -u HERE=$(cd "$(dirname "$0")" && pwd) @@ -47,7 +53,12 @@ HYGON_USER_KEY=${MPC_TEE_HYGON_USER_KEY:-tee_hg_102_user} HYGON_PASS_KEY=${MPC_TEE_HYGON_PASS_KEY:-tee_hg_102_pass} REMOTE_DIR=${MPC_TEE_REMOTE_DIR:-/tmp/mpc-tee-run-attestpair} LOG_DIR=${MPC_TEE_LOG_DIR:-/tmp/mpc-tee-attest-negative} +WORK=${MPC_TEE_WORK:-/tmp/mpc-tee-attest-e2e} MANIFEST=${MPC_TEE_MANIFEST:-} +if [ -z "$MANIFEST" ] && [ -d "${WORK}/image" ]; then + MANIFEST=$(python3 "${REPO}/deploy/tee/oci/oci-image.py" verify --image "${WORK}/image" 2>/dev/null \ + | sed -n 's/^manifest_digest=//p' | head -1) +fi SID=${MPC_TEE_SESSION_ID:-$(printf 'ab%.0s' $(seq 1 32))} PK=${MPC_TEE_PUBKEY:-$(printf 'cd%.0s' $(seq 1 32))} HY_KBS_PORT=${MPC_HY_KBS_PORT:-18094} @@ -85,7 +96,13 @@ remote_on() { } mkdir -p "$LOG_DIR" -[ -n "$MANIFEST" ] || { echo "缺少 MPC_TEE_MANIFEST" >&2; exit 2; } +case "$MANIFEST" in + ''|*[!0-9a-f]*) + printf '缺少或非法 MPC_TEE_MANIFEST(需 64 hex);先跑 ./tee-pair-attest-e2e.sh 生成 %s/image\n' "$WORK" >&2 + exit 2 ;; +esac +[ "${#MANIFEST}" -eq 64 ] || { + printf 'MPC_TEE_MANIFEST 长度 %s != 64(不许猜默认值)\n' "${#MANIFEST}" >&2; exit 2; } # 在海光机上重起 KBS,但把**度量 pin**换成别的值。 # ★ 只改 pin,不改 measurement —— measurement 参与绑定值重算, diff --git a/docs/INDEX.md b/docs/INDEX.md index 201e4c7..fa718dd 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -51,6 +51,7 @@ | 查链端点 / 链配置 | `tools/fisco-realnode/example.chain.json` + `deploy/k8s/fisco/README.md` | `127.0.0.1:20200`(旧本机容器,已停) | | 复现真机证明门控 | `deploy/tee/real-machine/README.md`(开头「重跑前先看」) | `docs/REAL_MACHINE_FINDINGS.md` 第 7/9 节的「当时边界」 | | 重跑真机双机 e2e:配置 / 预检 / 症状速查 | `deploy/tee/real-machine/real-machines.env.example` + `preflight-real-machine.sh` + 该 README 速查表 | 逐个脚本 export 参数;去 `/tmp` 翻 60+ 个探索脚本 | +| 核对两台真机 `/opt` 物料是否被换 / 丢失 | `deploy/tee/real-machine/host-materials.sh --verify` + `nodes/host-materials.sha256` | 只看预检「qemu/固件/内核存在」(不比 sha256);把 69MB qemu 拷进仓库 | | 部署 / 回滚链节点 | `deploy/k8s/fisco/`(含 `migrate-ledger.sh`、`README.md`) | 手动 `docker start fisco-gm`(会与 k8s 链分叉) | | 看真链实证期的审计轨迹 | `tools/fisco-realnode/README.md` | `/tmp`(会被清) | | 查两台真机硬事实 / 踩坑 | `docs/REAL_MACHINE_FINDINGS.md`(第 10 节最新) | 记忆或口头结论 | @@ -101,7 +102,11 @@ `deploy/k8s/fisco/README.md`(链迁移 SOP / 账本 / 回滚 / 边界)、 `deploy/tee/real-machine/README.md`(真机 e2e;**开头有重跑三步、参数真相源与症状速查表**)、 `deploy/tee/real-machine/real-machines.env.example`(**双机参数唯一集中入口**,脱敏、可 source)、 -`deploy/tee/real-machine/preflight-real-machine.sh`(重跑前环境预检,`--self-test` 负向矩阵)、 +`deploy/tee/real-machine/preflight-real-machine.sh`(重跑前环境预检,`--self-test` 负向矩阵; +含本机重建条件检查)、 +`deploy/tee/real-machine/host-materials.sh` + `nodes/host-materials.sha256` +(**两台真机 `/opt` 不可再生物料的入仓基线**:采集 / 核对 / 判据自测; +`--verify` 比 sha256,`--self-test` 用 6 个构造样例证明非恒绿)、 `deploy/tee/real-machine/nodes/*.node.example` + `fixtures/`(真机路径与真实报告 / 证书链样本)、 `deploy/tee/README.md`、 `deploy/tee/oci/README.md`、`deploy/ray/README.md`、 @@ -174,3 +179,9 @@ 改这一份,不要逐个脚本 export;重跑前先 `preflight-real-machine.sh`(`--self-test` 用构造样例钉死参数判据非恒绿)。`/tmp` 的 60+ 个探索脚本是过程产物,结论已 沉淀进验签器与 `REAL_MACHINE_FINDINGS.md`,**不许整批入库或重跑确认**。 +11. **两台真机 `/opt` 物料只认 `nodes/host-materials.sha256` 基线**:远端 `/tmp` 是运行时 + 目录(每次 e2e 重铺,丢了不用管),`/opt` 的 qemu / 固件 / 内核 / 海光官方验签器 / + GmSSL / CSV 证书链才是不可再生的。重启后先 `--verify`(缺文件 / 被替换 / 被升级 + 一律 FAIL 并打印 diff),换机或物料升级后 `--collect` 重采并提交。 + **清单本身由 git 保护**,不许在仓库外偷改;也不许把 69MB/78MB 二进制搬进仓库。 + 新增判据必须能用构造样例推翻(`--self-test` 6 条 + 端到端篡改 hash 判红)。