Files
admin 660e5712c3 feat(tee): 真机双机实跑复验,固化 /opt 物料基线与本机重建条件
用户要求「跑一遍,确保本地资源能用,别两台机器重启就找不到了」。
按固化的三步重跑(env 样例 → 预检 → e2e)在两台真机上实跑:

- 正向 e2e 全绿:从源码重编 musl mpc → 重新导出 alpine rootfs → 重新打
  initrd → 分发 → 双 KBS → 双 guest,TEE_PAIR_OK + TEE_ATTEST_GATE_OK
  + TEE_PAIR_ATTEST_OK,两侧还原 35.000000(2m05s)。
- 负向矩阵全绿:篡改度量 pin ⇒ 403 拒证明、guest fail-closed 拿不到密钥;
  恢复 pin ⇒ 又拿到(TEE_ATTEST_NEGATIVE_OK,exit=0)。
  ★ 修掉旧版单独跑报「缺少 MPC_TEE_MANIFEST」:负向脚本现在自动从
    ${MPC_TEE_WORK}/image 用同一份 oci-image.py verify 重算并断言 64 hex,
    不手抄;两个构造样例验证非法值 / 无产物都 exit=2。

持久化保障(回答「重启就找不到」):
- 实测两台真机 / 是 ext4 / xfs 持久根盘、无独立 /tmp tmpfs;远端三个
  /tmp 运行时目录本来全为空,e2e 每次重铺 ⇒ 丢了不影响重跑。
- 新增 host-materials.sh + nodes/host-materials.sha256(入仓基线 18 条:
  AMD 3 / 海光 15,sha256 + size):--verify 逐台比对,缺文件/被替换/
  被升级一律 FAIL 并打印 diff;--self-test 6 个构造样例证明非恒绿;
  另用「篡改清单一条 hash」端到端破坏验证(精确判红 exit=1)。
  ★ 清单只记路径/大小/哈希,不搬 69MB qemu / 78MB initrd 进仓库;
  清单本身由 git 保护。换机/升级后 --collect 重采。
- 预检新增「本机重建条件」检查:alpine:3.18 镜像、musl target、
  oci-image.py、guest/init.sh、fixtures、物料基线;缺一项即 FAIL。
  完整预检 29/0(含远端),离线 25/0 SKIP=1,自测 7/0,
  lint-shell-vars 34 脚本无隐患。

文档:真机 README 增「机器重启 / 换机后怎么办」分工表与症状速查一条;
INDEX §2/§3/§6 登记新资产与第 11 条纪律;CLAUDE.md 部署段加指针;
env 样例 H 段写明 manifest 两处都不许手抄。
校验:ci.sh 语法、判据零依赖自测 22/0、diff --check、密钥扫描全过。
门禁条数仍为 22(未改 ci.sh)。
2026-11-08 20:01:22 +08:00

216 lines
9.3 KiB
Bash
Executable File
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 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 <<EOS
while IFS= read -r p; do
[ -z "\$p" ] && continue
if [ -f "\$p" ]; then
printf 'MAT %s %s %s\\n' "\$(sha256sum "\$p" | cut -d' ' -f1)" "\$(stat -c %s "\$p")" "\$p"
else
printf 'MISS %s\\n' "\$p"
fi
done <<'PATHS'
${paths}
PATHS
EOS
}
remote_run() {
local host=$1 uk=$2 pk=$3 script=$4 b64
b64=$(printf '%s' "$script" | base64 | tr -d '\n')
xop run --secret "SSHPASS=${pk}" --secret "TEE_USER=${uk}" -- \
sh -c "sshpass -e ssh ${SSHO} \"\$TEE_USER@${host}\" \"echo ${b64} | base64 -d | sh\"" \
< /dev/null 2>&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 <<EOF
${out}
EOF
return 0
}
do_collect() {
local tmp="${MANIFEST}.tmp" rc=0
{
printf '# 两台真机不可再生物料基线(sha256 + size)\n'
printf '# 采集:%s\n' "$(date '+%Y-%m-%d %H:%M:%S %z')"
printf '# 格式:host sha256 size path\n'
printf '# 重新采集:./host-materials.sh --collect ;核对:--verify\n'
} > "$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 "$@"