背景(Task #16「真 KBS 验签后的会话端点」的前置阻塞): 提交 27cbdc7(OP-TEE 那轮)把 deploy/tee/guest/init.sh 里的 die() 定义 与 attest-collect/attest-post 段一起删掉了,而**调用点还在**。 三个后果,每一个都会让「端点永不公布」且症状极具误导性: 1. die() 定义被删、调用点还在 ⇒ busybox sh 里 `die` 未定义 ⇒ 「command not found」返回非 0 但**脚本继续往下跑** ⇒ 网卡认不到、链路未就绪这些本该 fail-closed 的地方变成静默继续 ⇒ 安全门被拆。guest 照样打印后续日志、照样 halt, 看起来像「只是少了一条错误提示」。 2. attest-collect/attest-post 段被删 ⇒ guest **根本不产证明包** ⇒ 第 5 节的回传没有材料可传 ⇒ 宿主判定永远停在 pending ⇒ 控制面 proven_endpoints() 永远为空 ⇒ 端点永不公布。 症状是「guest 起来了、KBS 也通了、就是端点不出现」, 排查方向会被整个带到对账器/调度器/控制面上,而真因在 guest 里。 3. TOKEN 的兜底被改成 offline-demo ⇒ 4a 段用 `[ -z "$TOKEN" ]` 判断「要不要先去采证明」⇒ 该判断**永远不成立** ⇒ guest 永远不去采证明 ⇒ 同 2。 修法: - 恢复 die()(含 $RUN/fatal.log 落盘:直接 halt -f 是立刻断电不刷 stdout, 串口只剩内核一句 "Attempted to kill init!",而「哪个文件对不上」才是关键); - 恢复 4a 段(采集 → 提交 → 取料,采集失败一律 die); - TOKEN 无来源时**留空**(不兜底占位值),占位值只留在离线分支; - 第 2/3 节的 halt 统一走 die,口径一致。 守卫(3 条新测试 + 破坏实验逐条验证会红): - guest_init_die_is_defined_and_used:定义与调用点必须同时存在; - guest_init_collects_and_posts_attestation:采集/提交必须在取料之前; - guest_init_online_branch_does_not_fallback_to_offline_demo:在线分支禁占位 token。 ★ 判据本身也修了一个 bug:顺序类判据原先全文 find,被第 5 节**注释**里 出现的 "tee kbs-get" 骗到 ⇒ 改为只认真正执行的命令行(跳过注释行)。 判据自己有 bug 比没判据更坏:它会把正确实现判成错的。 ★ 三个构造样例(删 die 定义 / 删 attest-collect 调用 / 加回 offline-demo 兜底) 各自精确命中对应守卫,无交叉误伤。 顺带:入仓集群自报判据自测(tools/selftest-cluster-selfreport.py + break), 门禁加第 25 条;并修掉 cluster-selfreport-e2e.sh 的 remote() 回归 (脚本正文曾回到 argv 传密钥 ⇒ 密钥进远端 ps)。 验证:mpc-hostd 179 passed / 0 failed;guest ash 语法检查通过; 门禁第 25 条 6+5 条自测全绿。
583 lines
37 KiB
Bash
Executable File
583 lines
37 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
#
|
||
# 回归闸门:CI 与本地跑的是**同一份**,避免「CI 挂了、本地不知道怎么复现」。
|
||
#
|
||
# 守的四条就是 CLAUDE.md 里的铁律:
|
||
# 1. 全量测试必须带 --features secure(不带会漏掉 36 条,其中曾有坏的)
|
||
# 2. 零 rustc 告警(-Dwarnings,warning 直接变 error)
|
||
# 3. mpc-core 与 mpc-tee 都必须能 no_std 编译(TEE / armv7 那条路;
|
||
# OP-TEE 的 TA 就是按 default-features = false 构建的)
|
||
# 3b. TA UUID 的五处硬编码必须一致(三处 Rust + 两个 shell 脚本)
|
||
# (漂移的症状是 TA 找不到,且在独立通道里才暴露 —— 太晚)
|
||
# 4. 跨目标(x86_64-linux-musl)必须零告警 —— Linux 专属代码在宿主
|
||
# 目标下整段被排除,宿主编译发现不了它的 unused 之类的问题;
|
||
# 同时 guest 静态产物不许链接宿主控制面(openssl/axum/reqwest),
|
||
# 必须 --no-default-features,并由产物探针验标识串
|
||
# 5. 12 个示例必须跑得通且断言全绿(否则三个月后就是一批编译不过的摆设)
|
||
# 6. shell 脚本里不能有「变量后紧跟非 ASCII 字符」/「双引号串里的反引号」
|
||
# /「双引号串里未转义的双引号」三类引号与变量陷阱
|
||
# 7. OCI 运行期完整性链自测必须全过(篡改活文件必须能被发现)
|
||
# 8. KBS「先验证明才下发」必须自证:正向路径能走通,拒绝路径必须拒
|
||
# (判定器被顶替 / 输出不是判定结论时必须拒,防假绿)
|
||
# 9. guest 脚本必须在 ash 上语法正确(bash -n 通过 ≠ ash 能解析)
|
||
# 10. 芯片验签器必须正负向都对(假绿 = 密钥发给不该拿的人)
|
||
# SNP 与 CSV 两个平台各一份:CSV 侧 2026-11-07 真机探索补上,
|
||
# 并因此挖出两个真 bug(官方 SM2 签名不覆盖 MAC;
|
||
# 官方验签器缺证书会联网下载 ⇒ 链验证信任材料形同虚设)。
|
||
# 11. OP-TEE 判据逻辑必须正负向都对(判据错了 = 验证结论是错的;
|
||
# 而那两条验证只能在有 SDK 的机器上跑,判据不进主门禁就永远没被执行过)
|
||
# 12. 宿主控制面 mpc-hostd 必须端到端自测(e2b 兼容面 + /attestation 四布尔
|
||
# + 实例真回收 —— 这三条失效都是静默的:形状不对 SDK 才炸,
|
||
# 四布尔合并成 ok 会把「没验签」说成「验证通过」,
|
||
# 「状态改了但进程还在」是假回收。
|
||
# 协议层由 axum/hyper 承担,判据验的是**我们的契约**:
|
||
# 重复 Content-Length 带期望特征、chunked 拒绝、连续 20 次响应体完整)
|
||
# ★ 另:mpc-tee 会被拷进 OP-TEE SDK 离线交叉编译,第 3 条 no_std 双守
|
||
# 之外还要保证它零 crates.io 依赖;HTTP 依赖只许待在 mpc-hostd。
|
||
# 13. 会话级链路层(EasyTier)端到端自测(argv 漏 --secure-mode 之类全静默)
|
||
# 14. 链上层 mpc-chain 端到端自测(幂等 / fail-open / JSON-RPC 200≠成功)
|
||
# 15. 国密签名 / distid 对齐 / TLCP 准入 / 治理形状自测
|
||
# (★ 系统 openssl 独立验签,不许 Rust 自签自验)
|
||
# 16. GmSSL 真 TLCP 握手 / TA 密钥分级 / FISCO 真机对拍契约
|
||
# 17. 阶段 3 OPA bundle 签发 / 真判定 / decision 存证(undefined 当拒绝)
|
||
# 18. TLCP 进程通道环回实证(只到 LoopbackReachable,绝不宣称链上通道已通)
|
||
# 19. 真 TEE 双 guest 会话判据自测(★ 测判据逻辑,不是真机)
|
||
# 20. 真 TEE 证明门控判据自测(★ 必须与 19 分开:两者互不蕴含)
|
||
# 21. 国密链真交易编码 / sendTransaction 判据自测(TARS + r||s||pub + 幂等)
|
||
# 22. 国密链真合约部署 / 调用 / 读回 / 负向矩阵自测(缺环境显式 SKIPPED)
|
||
# 23. SA 扩展模式端到端自测 —— ★ VM 拿不到 K_root 这条边界必须被钉死:
|
||
# 破了它,Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
|
||
# 而症状是「不报错、不崩溃、结果数值也对」。每条否定判据都带期望特征,
|
||
# 每条否定都配正向对照(防假绿)。
|
||
# 24. 零种子守卫端到端自测 —— ★ 全零主种子是本项目最隐蔽的一类失败:
|
||
# 它不报错、不崩溃、结果数值照样对,但 Beaver 三元组全部可预测。
|
||
# 守卫必须在 CLI **入口**(含连网之前),覆盖全部 8 个吃种子的命令。
|
||
#
|
||
# ★ 第 18–22 条曾于 27cbdc7 被误删(脚本都还在,只是不再被调用 ⇒ 门禁静默削弱)。
|
||
# 已在 2026-11-XX 原样恢复,步骤号顺延后总数回到 24 条(2026-11-09 再加第 25 条 ⇒ 25 条)。
|
||
# 教训:**判据脚本在仓库里 ≠ 判据在门禁里** —— 每次改 ci.sh 必须核对
|
||
# 本文件的 step 条数与本文档分母一致,且逐条确认被调用的脚本存在。
|
||
# ★ 注意:本注释里刻意不写带引号的 step 字面样例 —— 那会让
|
||
# 「数 step 的 grep」把注释也算进去,计数永远多 1。
|
||
#
|
||
# 用法:tools/ci.sh 正常跑
|
||
# tools/ci.sh --fast 跳过测试与示例,只编译(改完想快速确认能编过时用)
|
||
#
|
||
set -euo pipefail
|
||
cd "$(dirname "$0")/.."
|
||
# 25. 集群自报(控制面 + 多节点 hostd)判据自测 + 破坏实验
|
||
# —— ★ 真机脚本的判据逻辑**永远不会被门禁执行**(真机不在门禁里),
|
||
# 而它有三种静默失效:密钥进 argv / 否定式判据恒真 / 鉴权口径分叉。
|
||
# ③ 已真机踩过:控制面送 hex、节点比明文 ⇒ 全部 401。
|
||
# —— ★ 破坏实验与判据**一起跑**:正向通过不能证明判据在起作用;
|
||
# 恒绿判据和真判据在正向路径上表现完全一样。
|
||
|
||
FAST=0
|
||
for a in "$@"; do
|
||
case "$a" in
|
||
--fast) FAST=1 ;;
|
||
-h|--help) sed -n '2,12p' "$0"; exit 0 ;;
|
||
*) echo "不认识的参数: $a" >&2; exit 2 ;;
|
||
esac
|
||
done
|
||
|
||
step() { printf '\n\033[1m== %s ==\033[0m\n' "$1"; }
|
||
ok() { printf '\033[32m ok\033[0m\n'; }
|
||
|
||
if [ "$FAST" -eq 0 ]; then
|
||
step "1/25 全量测试(含 secure 特性)"
|
||
cargo test --workspace --features secure
|
||
ok
|
||
fi
|
||
|
||
step "2/25 零告警构建(所有目标)"
|
||
# -Dwarnings 同时作用于本地 crate 的 test / bench / example 目标,
|
||
# 所以「测试代码里有 unused」也会被拦下 —— 这正是想要的。
|
||
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
|
||
cargo build --workspace --all-targets --features secure
|
||
ok
|
||
|
||
step "3/25 no_std 守线 + TA 常量对拍(mpc-core + mpc-tee)"
|
||
# 两条 no_std 都要守:
|
||
# mpc-core —— TEE / armv7 那条路的底座
|
||
# mpc-tee —— OP-TEE 的 TA 就是 default-features = false 构建的
|
||
# (见 crates/mpc-tee/Cargo.toml 与 build/build_optee.sh)。
|
||
# 只守 mpc-core 会漏掉它:TA 构建在独立通道里(见 docs 1.7),
|
||
# 主门禁不编 TA,就没人发现「mpc-tee 直接 use std」这种破坏。
|
||
cargo build -p mpc-core --no-default-features
|
||
cargo build -p mpc-tee --no-default-features
|
||
# TA UUID 在仓库里有五处硬编码,任何一处漂移的症状都是
|
||
# TEEC_ERROR_ITEM_NOT_FOUND(TA 找不到),而在独立通道里跑才暴露 —— 太晚。
|
||
# 这条零依赖,所以放主门禁,不放 ci-optee.sh。
|
||
python3 tools/check-optee-uuid.py
|
||
ok
|
||
|
||
# ★ 跨目标编译守线(Linux musl 目标)+ guest 产物边界。
|
||
#
|
||
# 为什么必须单独有一条:CI 平时在宿主(macOS / Linux glibc)上编译,
|
||
# 而 guest 用的二进制是 **x86_64-unknown-linux-musl** 静态产物。
|
||
# `collect.rs` 里的 CSV ioctl 采集代码是 `#[cfg(target_os = "linux")]`
|
||
# **专属**的 —— 宿主目标下**整段被排除**,宿主编译再干净也发现不了
|
||
# 它的 unused import / unused mut 之类的问题。
|
||
#
|
||
# 本轮就踩到:宿主零告警,但交叉编译出 3 个告警(Read/Write 未用、
|
||
# file 多余 mut),而 CI 第 2 条是 -Dwarnings —— 真机上直接编不过。
|
||
#
|
||
# 交叉编译不依赖外部 gcc(rustc 自带 rust-lld + musl crt)。
|
||
#
|
||
# ★ 本轮又踩到一条更根本的:mpc-chain 引入 openssl crate 后,
|
||
# `cargo build -p mpc-cli --target musl` 直接挂在 openssl-sys 找不到
|
||
# musl 版 libcrypto。这不是「装个交叉 OpenSSL 就好」——guest 静态产物
|
||
# 本来就不该链接 OpenSSL / axum / reqwest,那是宿主控制面。
|
||
# 修法:mpc-cli 按 feature + target 切分(见 Cargo.toml / build.rs),
|
||
# 交叉编译必须显式 --no-default-features;main.rs 的 compile_error!
|
||
# 在 musl + 默认 feature 时硬拒绝,给出可执行的指引。
|
||
# 三层判据都在 tools/check-guest-artifact.py:依赖树(必跑)、
|
||
# 编译期守卫负向、ELF 产物标识(后两条需已装 musl target)。
|
||
CROSS_TARGET=x86_64-unknown-linux-musl
|
||
step "4/25 跨目标编译(${CROSS_TARGET},guest 静态产物)+ guest 边界探针"
|
||
# 依赖树与标识串自检不依赖 musl target 是否安装 —— 目标没装也必须跑,
|
||
# 否则「跳过」会把最重要的边界判据一起跳掉(闸门不扫自己 = 假安全感)。
|
||
python3 tools/check-guest-artifact.py deps --target "$CROSS_TARGET"
|
||
if rustup target list --installed 2>/dev/null | grep -qx "$CROSS_TARGET"; then
|
||
# 负向:忘了 --no-default-features 必须被 compile_error! 明确拒绝,
|
||
# 而不是先撞上 openssl-sys 那句含混的 pkg-config 报错。
|
||
python3 tools/check-guest-artifact.py guard --target "$CROSS_TARGET"
|
||
# ★ 两份 musl 产物(2026-11-07 真机联调):
|
||
# guest —— 跑在 TEE enclave 里,不含任何宿主控制面。
|
||
# host —— 跑在 TEE 真机上的 hostd(真机没 Rust 工具链,要自包含静态二进制),
|
||
# 含 mpc-hostd、不含 mpc-chain(后者要系统 OpenSSL)。
|
||
# 两份产物**输出路径相同**(cargo 只按 target+profile 命名),所以先各自
|
||
# build 完立刻拷走,再做交叉对照 —— 顺序反了会拿错文件。
|
||
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
|
||
cargo build -p mpc-cli --target "$CROSS_TARGET" --release --no-default-features
|
||
cp "target/${CROSS_TARGET}/release/mpc" "target/${CROSS_TARGET}/release/mpc.guest"
|
||
RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \
|
||
cargo build -p mpc-cli --target "$CROSS_TARGET" --release \
|
||
--no-default-features --features host-only
|
||
cp "target/${CROSS_TARGET}/release/mpc" "target/${CROSS_TARGET}/release/mpc.host"
|
||
# ★ --host-path 是**否定判据的正向对照基准**:没有它,
|
||
# 「guest 里找不到 X」这类判据可能恒为真(探针失效也照样绿)。
|
||
python3 tools/check-guest-artifact.py binary \
|
||
"target/${CROSS_TARGET}/release/mpc.guest" \
|
||
--host-path "target/${CROSS_TARGET}/release/mpc.host"
|
||
ok
|
||
else
|
||
echo " GUEST_BINARY_SKIPPED:目标未安装,guard / binary 两条判据本轮未执行"
|
||
echo " 依赖树与标识串判据已在上面跑过;装好目标后本条才算完整通过"
|
||
echo " rustup target add ${CROSS_TARGET}"
|
||
fi
|
||
|
||
if [ "$FAST" -eq 0 ]; then
|
||
step "5/25 示例冒烟(12 个场景)"
|
||
tools/examples.sh
|
||
ok
|
||
|
||
# 第 5 条:shell 引号 / 变量名卫生。
|
||
# 三类陷阱都会「静默」破坏语义,编译器看不见、bash -n 也未必报错:
|
||
# ① `echo "值($VAR)"` 在 bash / ash 里把全角括号并进变量名 →
|
||
# unbound variable。踩过两次:guest init 的符号链接校验路径直接崩,
|
||
# 症状是「校验莫名失败」,排查方向被完全带偏。
|
||
# ② 双引号串里的反引号仍会被当命令替换执行(注释里也不行)。
|
||
# ③ 双引号串里未转义的双引号会提前闭合外层串 → body 被切成多个参数,
|
||
# 远端跑的是完全不同的脚本。
|
||
#
|
||
# ★ 扫描范围必须含 tools/ —— 闸门脚本自己也在 shell 生态里,
|
||
# 而且 tools/ci.sh 就是 CI 自身的实现。本轮就出现过:
|
||
# tools/ci.sh 里写了 "$CROSS_TARGET,guest 用的静态产物"(全角逗号),
|
||
# bash 把逗号并进变量名 → CI 第 4 条直接 `CROSS_TARGET,: unbound variable`
|
||
# 中途挂掉;而 lint 闸门只扫 deploy/tee,**对自己的盲区完全无感**。
|
||
# 闸门不扫闸门自己 = 闸门有盲区 = 假安全感。
|
||
step "6/25 shell 引号 / 变量名卫生"
|
||
# ★ deploy/arm 必须一起扫 —— 2026-11-XX 补:此前只扫 deploy/tee + tools,
|
||
# 而 arm 目录下的板端脚本是**真机上跑的**(变量名吞字会让板端输出错乱
|
||
# 且症状难查)。实跑板端脚本就抓到 4 处 var-ascii 命中。
|
||
python3 deploy/tee/real-machine/lint-shell-vars.py deploy/tee deploy/arm tools
|
||
ok
|
||
|
||
# 第 6 条:OCI 运行期完整性链自测。
|
||
# 这条链是「代码度量 → 活文件内容」的闭链,断了不会有编译错误,
|
||
# 只会在真机上表现为篡改活文件照样通过 —— 必须有本地闸门兜住。
|
||
step "7/25 OCI 运行期完整性链自测"
|
||
python3 deploy/tee/oci/selftest-chain.py
|
||
ok
|
||
|
||
# 第 7 条:KBS「先验证明才下发」自测。
|
||
# 这条链是「先出芯片证明 → KBS 校验 → 才签 token → 才给密钥」。
|
||
# 它的两端一旦断了不会有编译错误:
|
||
# · 顺序断(不验证明就给密钥)→ 密钥服务退化成文件服务器;
|
||
# · 判定断(判定器被顶替 / 输出不是判定结论)→ **假绿**,
|
||
# 「通过之后真的会签发 token 并下发密钥」这条路从未被验证过。
|
||
# 所以这里必须同时覆盖正向路径与全部拒绝路径。
|
||
step "8/25 KBS 先验证明才下发自测"
|
||
python3 deploy/tee/kbs/selftest-kbs.py
|
||
ok
|
||
|
||
# 第 8 条:guest 脚本在 ash 上的语法。
|
||
# guest 的 /init 由 busybox ash 解析,`bash -n` 通过 ≠ ash 能解析。
|
||
# 真机上这类错误要等 guest 起来才暴露,排查一轮几分钟;
|
||
# 本地闸门用 alpine 的 busybox ash(与 guest 同款解析器)秒级拦住。
|
||
step "9/25 guest 脚本 ash 语法"
|
||
deploy/tee/guest/syntax-check.sh
|
||
ok
|
||
|
||
# 第 9 条:芯片验签器自测(正负向)。
|
||
# 验签器是「先验证明才给密钥」链条的最后一关。这一关一旦假绿
|
||
# (把没验过的报告判成通过),密钥就发给了不该拿的人 —— 而且
|
||
# 不会有任何编译错误或运行时异常,只会安静地放行。
|
||
# 用的是真机采集的真报告 + 真 KDS 证书链(公开信任材料,无私钥),
|
||
# 所以本地无网也能验证「验签逻辑对真报告成立」。
|
||
#
|
||
# ★ SNP 与 CSV 两个平台各一份自测(两个平台的官方验签器行为不同):
|
||
# SNP:selftest-snp-verify.py
|
||
# CSV:selftest-csv-verify.py(2026-11-07 真机探索补上 —— CSV 侧此前
|
||
# 一直没有自测,与 SNP 不对称;而 CSV 侧真机实测挖出两个真 bug:
|
||
# ① 官方 SM2 签名**不覆盖 MAC 字段**(wrapper 曾声称验了 MAC);
|
||
# ② 官方验签器缺证书时会**联网**从 cert.hygon.cn 下载,
|
||
# 导致「我们提供的信任材料」根本没参与链验证。
|
||
# 两条都已在 wrapper 里修掉,并由自测把边界钉成判据。
|
||
# CSV 自测缺官方二进制时显式 CSV_VERIFY_SKIPPED,
|
||
# 但零依赖 --self-test 永远执行到 —— 不因跳过变成盲区。
|
||
# ★ 同一处还跑 kbs-up.sh 的参数自检:那份脚本的网段与 TCB 参数一旦被
|
||
# 硬编码覆盖,负向矩阵就会**假绿**(真踩过:外部设 min-tcb=99,
|
||
# 实际 KBS 收到 3,TCB 负向直接被放行)。
|
||
step "10/25 芯片验签器自测(SNP + CSV)+ KBS 启动参数自检"
|
||
python3 deploy/tee/real-machine/selftest-snp-verify.py
|
||
python3 deploy/tee/real-machine/selftest-csv-verify.py --self-test
|
||
python3 deploy/tee/real-machine/selftest-kbs-up.py
|
||
ok
|
||
|
||
# 第 10 条:OP-TEE 判据逻辑自测。
|
||
#
|
||
# 为什么这条必须进**主**门禁(而不是留在 ci-optee.sh 里):
|
||
# 跨设备(第 5 条)与跨重启(第 4 条)两条验证都只能在
|
||
# **有 OP-TEE SDK + QEMU** 的机器上跑。绝大多数开发机上
|
||
# ci-optee.sh 的输出是 OPTEE_SKIPPED。
|
||
# 于是判据逻辑(build/optee-verdict.py)就长期处于
|
||
# 「写完了,但从来没被执行过」的状态 ——
|
||
# 而判据恰恰是这类验证里最容易写错、错了最难发现的部分:
|
||
# 只判「失败」不判失败原因 → blob 没打进去也算通过;
|
||
# 只判「成功」不判 provisioned → 又 provision 一次的伪成功。
|
||
# 这两类错误在真机上都表现为「验证通过」,没有任何异常。
|
||
#
|
||
# 所以用**构造的串口日志**把判据的每条分支都跑一遍 ——
|
||
# 不需要 SDK、不需要 QEMU,秒级完成。
|
||
# 它证明的是「给定一份日志,判定器的结论正确」,
|
||
# **不**证明 OP-TEE 的 seal/unseal 行为正确(那要跑 QEMU)。
|
||
step "11/25 OP-TEE 判据逻辑自测"
|
||
python3 tools/selftest-optee-verdict.py
|
||
ok
|
||
|
||
# 第 12 条:宿主控制面 mpc-hostd 端到端自测。
|
||
#
|
||
# 为什么这条必须进主门禁:它的三条失效方式**全是静默的**。
|
||
# · e2b 兼容面形状不对 —— 只有真 client 才炸,单元测试看不出;
|
||
# · /attestation 四个布尔被合并成 ok —— 运维看到 ok=1 就以为安全,
|
||
# 而实际是「没做芯片验签」,这是最贵的一种错;
|
||
# · 「状态改了但进程还在」—— 站点端以为 TEE 已停,实际还在跑。
|
||
#
|
||
# 单元测试测的是「函数返回值对不对」,这里测的是**整条链路**在真 socket 上
|
||
# 跑不跑得通。实例回收那条用**心跳文件**判据(实例自己 touch 一个文件,
|
||
# 停掉后心跳停止)—— 不依赖 ps / /proc,因为受限环境里 ps 常被禁、
|
||
# macOS 也没有 /proc,那时这条判据会被跳过,而它恰恰是最重要的一条。
|
||
#
|
||
# ★ 2026-11-09 并入「guest → hostd 的证明材料回传闭环」子测试
|
||
# (判据数从 20 涨到 40+,但**门禁条数不变**仍是 22 条):
|
||
# · 正向:guest 侧**真实客户端**(`mpc tee attest-upload`,与 guest 里
|
||
# 同一个二进制)上传原始证明包 ⇒ 宿主**独立**判定 pending → verified;
|
||
# · 负向:错令牌 401 / 不带凭据 401(回环模式也不例外)/
|
||
# 绑定对不上 ⇒ rejected;
|
||
# · 集群面:用**假 hostd** 补「端点出现与收回」的正向对照
|
||
# (否则否定式判据会因 create 恒失败而恒真)。
|
||
#
|
||
# ★ 假 hostd 的正向场景必须返回 `chip_sig=true` ——
|
||
# 集群控制面默认 `require_chip_sig=true`(真 KBS 验签后才公布端点),
|
||
# 假 hostd 返回 chip_sig=false 时端点被**正确地**不公布,
|
||
# 那不是实现的错,是判据与策略对不上。
|
||
step "12/25 宿主控制面 mpc-hostd 端到端自测"
|
||
python3 tools/selftest-hostd.py
|
||
ok
|
||
|
||
# 第 13 条:会话级链路层(EasyTier)端到端自测。
|
||
#
|
||
# 链路层的失效全是静默的:argv 漏 --secure-mode 或混进 --network-secret,
|
||
# 网络照起但分级授权没了;easytier-cli peer 有多行时只判第一行,会把
|
||
# 第二行 relay 藏成 link=p2p(已经发生过一次,这里留了回归探针);
|
||
# allowlist 白名单为空却生成出等于 open 的配置。
|
||
#
|
||
# 本机没有 EasyTier 二进制,也没有联盟管理节点 —— 用桩跑完整链路,
|
||
# 判的是框架自己的契约,不是 EasyTier 的实现。进程真起真回收由
|
||
# LinkRuntime 单测判(持 Child + try_wait 收割),此处显式再跑一次,
|
||
# 保证这条判据真的进了主门禁的执行路径。
|
||
step "13/25 会话级链路层 EasyTier 端到端自测"
|
||
python3 tools/selftest-link.py
|
||
ok
|
||
|
||
# 第 14 条:链上层(mpc-chain)端到端自测。
|
||
#
|
||
# 这一层的失效也全是静默的:outbox 不幂等,补链会写出重复账;
|
||
# fail-open 写成 fail-closed,链一挂计算就停;反过来把成员准入写成
|
||
# 「读不到就放过」,就是准入被绕过。最隐蔽的是 JSON-RPC:HTTP 200
|
||
# 的响应体里带 error 字段是正常失败形态,只判 HTTP 状态会把「交易
|
||
# 被拒」当成「已上链」。
|
||
#
|
||
# 本机没有 FISCO BCOS 节点 —— 用 Python 假 bcos-rpc 跑完整链路,
|
||
# 判的是框架自己的契约。★ 诚实边界:flush 发出去的 payload 仍是
|
||
# 链上对象规范字节,不是已签名交易(国密交易 RLP 编码 / 真实
|
||
# bcos-rpc 的 TLCP 通道未落地;Rust 侧 TLCP 进程通道环回实证见
|
||
# gate 18,但那不是连真节点的通道),所以这条门禁不证明「能上链」。
|
||
# 另:--transport 必须显式给,stub 只供桩自测,tlcp 是生产路径
|
||
# (缺双证书配置即拒),传输形态不许有默认值 = 不许留明文后门。
|
||
step "14/25 链上层 mpc-chain 端到端自测"
|
||
python3 tools/selftest-chain.py
|
||
ok
|
||
|
||
# 第 15 条:国密签名与治理形状端到端自测。
|
||
#
|
||
# ★ 最关键的一条判据是「系统 openssl dgst -sm3 -verify 验过框架
|
||
# 签出的签名」:CLI 用 SM2 默认 user id,能验过才说明链下签名的
|
||
# distid 与 FISCO 上游 fast_sm2.cpp 的 c_userId 同值。只在 Rust 里
|
||
# 自签自验是循环自证,测不到 distid 漂移。
|
||
# 软件签名器私钥可导出、密评不可过 —— 生产策略必须拒绝它;
|
||
# profile 与「私钥不可导出」交叉校验,防止软件谎报硬件模组。
|
||
# 本机无 Tongsuo,但 GmSSL 3.2.0 可用:通道准入依旧 fail-closed
|
||
# (发真交易只对 Ready 放行);Rust 侧 TLCP **进程通道**已落地
|
||
# (gate 18),就绪状态从 NeedsFfi 推进到 LoopbackReachable ——
|
||
# 环回可达,但不是 bcos-rpc 真机通道。
|
||
# TLCP 双证书正向校验 / 真交易编码仍待真机对拍,
|
||
# 见 tools/selftest-chain-gm.py、tools/selftest-tlcp-tunnel.py
|
||
# 与 tools/fisco-realnode-probe.py。
|
||
step "15/25 国密签名 / distid 对齐 / TLCP 准入 / 治理形状自测"
|
||
python3 tools/selftest-chain-gm.py
|
||
ok
|
||
|
||
# 第 16 条:GmSSL 真 TLCP 握手 / TA 密钥分级 / FISCO 真机对拍契约。
|
||
#
|
||
# ★ 两个 --self-test 与 TA 探针都是**零外部依赖**,本机没装 GmSSL
|
||
# 也必须跑:判据逻辑永远测不到 = 假安全感。
|
||
# ★ 真握手缺 GmSSL 时打印 GMSSL_TLCP_SKIPPED + 逐项缺失(不算通过);
|
||
# 装了就真起 tlcp_server/tlcp_client,成功也只打印 GMSSL_TLCP_OK +
|
||
# BCOS_RPC_NOT_VERIFIED,绝不宣称 bcos-rpc 通道已通。
|
||
# ★ fisco-realnode-probe.py 环境齐备也只报 NEEDS_IMPL:FISCO 自有
|
||
# 交易编码 / Rust 侧 TLCP 通道 / sm2Verify 真机对拍 / 已签名交易
|
||
# 都还没落地,凑齐环境变量不等于能上链。
|
||
step "16/25 GmSSL TLCP 真握手 / TA 密钥分级 / FISCO 真机对拍契约"
|
||
python3 tools/selftest-tlcp-gmssl.py --self-test
|
||
python3 tools/fisco-realnode-probe.py --self-test
|
||
python3 tools/selftest-ta-key-tier.py
|
||
python3 tools/selftest-tlcp-gmssl.py
|
||
python3 tools/fisco-realnode-probe.py
|
||
ok
|
||
|
||
# 第 17 条:阶段 3 第一段 OPA bundle 签发 / 真判定 / decision 存证。
|
||
#
|
||
# ★ --self-test 是零依赖判据逻辑,没装 OPA 也必须跑;真闭环缺环境
|
||
# 打印 OPA_DECISION_SKIPPED + 逐项缺失(不算通过)。
|
||
# ★ 真闭环用的是真 opa build / opa eval 与系统 openssl 独立验签,
|
||
# 不是 Python 复刻的策略判定。undefined 输出当拒绝,不当默认 deny。
|
||
# ★ 成功也只打印 OPA_DECISION_OK + OPA_GUEST_NOT_VERIFIED +
|
||
# CHAIN_NOT_VERIFIED,绝不宣称「阶段 3 已完成」。
|
||
step "17/25 阶段 3 OPA bundle 签发 / 真判定 / decision 存证自测"
|
||
python3 tools/selftest-chain-opa.py --self-test
|
||
python3 tools/selftest-chain-opa.py
|
||
ok
|
||
|
||
# 第 18 条:TLCP **进程通道**环回实证。
|
||
#
|
||
# ★ 这条把「Rust 侧 TLCP 通道未落地」这一长期诚实边界项,在不突破
|
||
# 「≠ bcos-rpc 通道已通、不假装能发真交易」前提下,推进到「环回可达」
|
||
# 实证:Rust `TlcpTunnel` spawn `gmssl tlcp_client -in`(响应走 stdout,
|
||
# 注意 `tlcp_client` 没有 `-out`),把一段真实 JSON-RPC 经 TLCP 发给环回
|
||
# `gmssl tlcp_server` echo,读回响应,断言应用数据往返一致、sentBytes ==
|
||
# receivedBytes、channelLayerReachable=true、realChainVerified=false。
|
||
# ★ 诚实边界(沿用 gate 15 口径,且更进一层):环回服务端是
|
||
# `gmssl tlcp_server` echo,不是 FISCO 节点;未验证 bcos-rpc 是否启用
|
||
# TLCP;GmSSL 软件实现私钥可导出、不能过密评。所以成功只打印
|
||
# GMSSL_TLCP_TUNNEL_OK + BCOS_RPC_NOT_VERIFIED,绝不宣称「链上通道已通」
|
||
# 或「能发真交易」。发真国密交易仍由 require_transport 只对 Ready 放行,
|
||
# 本通道只到 LoopbackReachable。
|
||
# ★ 缺 GmSSL / 缺 mpc 二进制打印 GMSSL_TLCP_TUNNEL_SKIPPED + 逐项缺失;
|
||
# --self-test 零依赖判据逻辑永远被执行到(防盲区)。
|
||
step "18/25 TLCP 进程通道环回实证自测"
|
||
python3 tools/selftest-tlcp-tunnel.py --self-test
|
||
python3 tools/selftest-tlcp-tunnel.py
|
||
ok
|
||
|
||
# 第 19 条:真 TEE 双 guest 跨物理机会话的**判据**自测。
|
||
#
|
||
# ★ 这条测的是「判定逻辑」,不是「真机」。真机实跑见
|
||
# deploy/tee/real-machine/pair-run.sh(2026-11-07 两台真机实测通过:
|
||
# AMD SEV-SNP + 海光 CSV,双方都还原出 value | 35.000000)。
|
||
# 本条零依赖、每次 CI 都跑,保证「判定逻辑没写错」——
|
||
# 真机跑一次的成本高且不连续,判据写错了真机也测不出来。
|
||
#
|
||
# ★ 判据自指必须被证伪:负向判据天然有「恒为真 / 恒为假」的风险。
|
||
# 实测踩过两个真坑:
|
||
# ① 判据字符串写错("mpc selftest 全部通过" vs 真实的 "全部通过")
|
||
# → 恒为假 → 真机跑通了却报失败(假红);
|
||
# ② 只判 qemu 退出码 → guest 里 halt 之后的退出码与成功无关
|
||
# → 恒为真 → 什么都没发生也报成功(假绿)。
|
||
# 所以每条判据都要用构造样例逐条破坏,验证它能真的把结论推翻。
|
||
#
|
||
# ★ 测的是真机上**实际调用的那一份** check-pair-verdict.py,
|
||
# 不是另写一份模拟 —— 两份实现等于没有门禁。
|
||
step "19/25 真 TEE 双 guest 会话判据自测"
|
||
python3 tools/selftest-tee-pair-verdict.py
|
||
ok
|
||
|
||
# 第 20 条:真 TEE **证明门控**判据自测。
|
||
#
|
||
# ★ 为什么必须和第 19 条**分开**(合成一份就会出现「一项过掩盖另一项不过」):
|
||
# 第 19 条判的是「密文会话 + 运行期完整性链 + 数据面 MAC 唯一性」;
|
||
# 第 20 条判的是「密钥是不是**经过芯片证明**才发下来的」。
|
||
# 这两件事**互不蕴含**:
|
||
# · 会话跑成了 ≠ 密钥是证明后给的(上一版就是拿离线演练密钥跑通会话的)
|
||
# · 密钥是证明后给的 ≠ 会话跑成了(会话层另有一套判据)
|
||
#
|
||
# ★ 判据自指必须被证伪:
|
||
# 「证明门控判据」天然有「恒为真」的风险 —— 如果它只检查
|
||
# 「日志里没有 key_source=offline-demo」,那**空日志**也判通过,
|
||
# 等于什么都没验证。自测里必须包含「日志为空 / 日志缺失 / 只有一侧」
|
||
# 这些**不该通过**的样例,确保判据真的在读日志。
|
||
#
|
||
# ★ 测的是真机上**实际调用的那一份** check-attest-verdict.py,
|
||
# 不是另写一份模拟 —— 两份实现等于没有门禁。
|
||
step "20/25 真 TEE 证明门控判据自测"
|
||
python3 tools/selftest-tee-attest-verdict.py
|
||
ok
|
||
|
||
# 第 21 条:国密链**真交易编码**路径自测(`--mode signed-tx`)。
|
||
#
|
||
# ★ 这条测的是「真交易」那条路径,不是第 14 条的 stub 路径:
|
||
# stub 发的还是链上对象规范字节;signed-tx 发的才是
|
||
# **完整已签名 FISCO 交易**(TARS 字节),
|
||
# 走国密链自有 `sendTransaction`(4 参),
|
||
# 不是 web3 的 `eth_sendRawTransaction`(那个固定 secp256k1+keccak256)。
|
||
#
|
||
# ★ 判据要点(每条都必须可测、不得恒真):
|
||
# ① data 能被 TARS 解析成 Transaction 结构(dataHash 32B + signature 128B);
|
||
# ② signature 是 `r||s||pub`(128 字节)—— 上游 `signTransactionDataHash()`
|
||
# 传 `_signatureWithPub=true`,只签 64 字节 r||s 的交易节点会拒;
|
||
# ③ 成功判据三件套:status==0(TransactionStatus::None,**与 web3 相反**)
|
||
# 且 transactionHash 非空 且 blockNumber>0,缺一不算成功;
|
||
# ④ 幂等:已确认条目二次 flush 的 attempted 必须为 0
|
||
# (signed-tx 路径必须走 outbox 状态机,否则同一笔会再发一次);
|
||
# ⑤ 8 类负向:status!=0 / blockNumber=0 / 缺 transactionHash / 缺 status /
|
||
# RPC error / result=null / 合约地址不是 20 字节 / 缺 --key 或 --contract
|
||
# —— 每条都必须判失败**并带出期望特征**。
|
||
#
|
||
# ★ 诚实边界:本条用 Python 假 bcos-rpc,验证的是**框架自己的契约**
|
||
# (编码、判据、幂等、失败语义),**不证明**真链上能上链。
|
||
# 真链部署与调用见 tools/fisco-realnode-probe.py(目前报 NEEDS_IMPL)。
|
||
step "21/25 国密链真交易编码 / sendTransaction 判据自测"
|
||
python3 tools/selftest-chain-tx.py
|
||
ok
|
||
|
||
# 第 22 条:FISCO 国密链**真链合约**部署 + 调用 + 读回 + 负向矩阵。
|
||
#
|
||
# ★ 这是把「智能合约能上真链」从 NEEDS_IMPL 推进到实证的门禁:
|
||
# 连本机真节点(127.0.0.1:20200,sm_crypto=true,3.17.1),完整跑
|
||
# 部署 MpcHardRule → recordHardRule → call 读回 isRecorded/hardRuleSummary
|
||
# → 负向矩阵(零摘要 revert / 未登记读回 0 / 幂等不覆盖)。
|
||
# 成功三件套 = status==0 且 transactionHash 非空 且 blockNumber>0。
|
||
#
|
||
# ★ --self-test 是零依赖判据逻辑(22 项),每次 CI 必跑,防盲区:
|
||
# 真链环境不在时,真链批必须显式打印 FISCO_REALNODE_SKIPPED +
|
||
# 逐项缺失,绝不打印通过。凑齐 env 也不等于能上链 —— 但本机环境齐备
|
||
# 时这条会真上链并核对状态。
|
||
#
|
||
# ★ 诚实边界:软件 OpenSSL 签名器真能签、真链能上链,但私钥可导出
|
||
# ⇒ 密评不可过;生产必须换硬件模组签名器。真实 bcos-rpc 的 TLCP
|
||
# 通道仍未通(gate 18 服务端是环回 echo,不是真节点)。
|
||
step "22/25 国密链真合约部署 / 调用 / 读回 / 负向矩阵自测"
|
||
python3 tools/selftest-fisco-contract.py --self-test
|
||
python3 tools/selftest-fisco-contract.py
|
||
ok
|
||
|
||
# 第 23 条:SA 扩展模式(安全锚点供能力、算力挂外部 VM)端到端自测。
|
||
#
|
||
# 这条守的是**整个形态的信任基础**:
|
||
# VM(算力侧)能调用安全世界的能力,但**永远拿不到 K_root**。
|
||
# 一旦这条破了,Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
|
||
# 而症状是「不报错、不崩溃、结果数值也对」—— 最难发现的一类失败。
|
||
#
|
||
# ★ 每条否定判据都带**期望特征**("凭据不匹配" / "解封失败" /
|
||
# "未知操作" …),不是「退出码非 0」—— 否则 "Connection refused"
|
||
# 也会让「必须拒绝」因为**错误的原因**通过(假绿)。
|
||
# ★ 每条否定都配一条**正向对照**(同样的命令在正确参数下必须成功),
|
||
# 证明「拒绝」不是因为环境坏了。
|
||
# ★ 判据层次:端到端这条覆盖**整体**行为;分层责任
|
||
# (例:服务端层的全零守卫)由 mpc-tee 的 Rust 单测覆盖 ——
|
||
# 端到端脚本**无法区分**是哪一层拒的(CLI 层会遮蔽服务端层),
|
||
# 这一点必须写清楚,否则会误以为「服务端层也验过了」。
|
||
#
|
||
# 负向实验已逐条跑过(证明判据非恒绿):
|
||
# · 鉴权恒真(ct_eq 换成 true) ⇒ "错凭据被拒" 变红
|
||
# · unseal 不校验 AAD ⇒ "unseal 成功" 变红
|
||
# · 协议里加 root-key 导出端点 ⇒ "没有 root-key 端点" 变红
|
||
# · CLI + 服务端同时去全零守卫 ⇒ "全零根密钥拒绝启动" 变红
|
||
# · 回环模式接受任意 token ⇒ "回环模式带凭据被拒" 变红
|
||
step "23/25 SA 扩展模式端到端自测"
|
||
python3 tools/selftest-sa.py
|
||
ok
|
||
|
||
# 第 24 条:零种子守卫(fail-closed)端到端自测。
|
||
#
|
||
# ★ 为什么单独一条,而不是塞进 SA 那条:
|
||
# 零种子不是 SA 形态特有的问题,它是**整个项目**的会话物料问题 ——
|
||
# node / cluster / orch run / psi / lr / lr-vertical / fl / sql-join
|
||
# 这八个命令都吃会话种子,任何一个漏了守卫,整条链就漏了。
|
||
# 混进 SA 那条会让「哪条判据守什么」变得不可读。
|
||
#
|
||
# ★ 为什么必须单独有守卫:
|
||
# 全零主种子 ⇒ Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,
|
||
# 而症状是「不报错、不崩溃、结果数值也对」——
|
||
# 这跟「服务起不来」「签名验不过」这类会自己叫出来的失败完全不是一回事。
|
||
#
|
||
# ★ 守卫的位置有硬要求:**CLI 入口,且在连网之前**。
|
||
# `mpc node` 原本的种子校验在连网(甚至 Ray 注册)之后 ——
|
||
# 那样全零种子会先让本进程连上网、注册进集群,然后才失败,
|
||
# 症状伪装成「网络问题」,而且对端已经在等你了。本轮已前移。
|
||
#
|
||
# 负向实验已逐条跑过(证明判据非恒绿):
|
||
# · parse_seed 去掉全零检查 ⇒ 6 条「零种子被拒」全部变红(18→12)
|
||
# · Vault::new 去掉全零守卫 ⇒ Rust 单测 zero_master_seed_is_rejected FAILED
|
||
#
|
||
# ★ 分层事实(与 SA 那条同一性质):CLI 入口的守卫会**遮蔽**下游的守卫。
|
||
# 本脚本覆盖**整体**行为(零种子 ⇒ 起不来);
|
||
# 分层责任(下游库自己拒不拒)由各自 crate 的 Rust 单测承担。
|
||
step "24/25 零种子守卫端到端自测"
|
||
python3 tools/selftest-seed-guard.py
|
||
ok
|
||
|
||
# 第 25 条:集群自报(控制面 + 多节点 hostd)判据自测 + 破坏实验。
|
||
#
|
||
# ★ 为什么必须单独一条:
|
||
# `cluster-selfreport-e2e.sh` 是**真机**脚本(两台真机:AMD SNP +
|
||
# 海光 CSV),真机不在门禁环境里 ⇒ 它的判据逻辑**永远不会被执行**。
|
||
# 而这个脚本的判据有三种典型的**静默失效**:
|
||
# ① 密钥进 argv ⇒ 密钥出现在远端 ps 里(脚本照样跑通);
|
||
# ② 否定式判据恒真 ⇒ 控制面根本没起来,脚本却报「度量非全零」;
|
||
# ③ 鉴权口径分叉 ⇒ 控制面送 hex、节点比明文 ⇒ 全部 401。
|
||
# ③ 已经**真机踩过**(2026-11-09):症状是「节点活着、自报收到了,
|
||
# 就是下发不进去」——看起来像网络问题、像节点问题、像控制面没起。
|
||
#
|
||
# ★ 破坏实验为什么必须一起跑:
|
||
# 判据在正向路径上通过,**不能**证明它在起作用 ——
|
||
# 恒绿判据和真判据在正向路径上表现完全一样。
|
||
# ⇒ 每个判据都破坏一次,要求自测脚本**必须转红**。
|
||
# ★ 破坏实验必须**双向确认变异生效**(证据串消失/新增):
|
||
# 2026-11-09 实测踩过:变异函数删错了行 ⇒ 破坏实验「没抓到」
|
||
# ⇒ 差点被误判成「判据恒绿」。SKIP 不许当成通过。
|
||
#
|
||
# ★ 判据只查**代码形态**,不查注释里的字样 ——
|
||
# 查注释 ⇒ 注释删了代码还在也会绿(自指型假绿);
|
||
# 查裸字符串 ⇒ 注释里自己写着的历史说明会把自己判红(自指型假红)。
|
||
step "25/25 集群自报判据自测 + 破坏实验"
|
||
python3 tools/selftest-cluster-selfreport.py
|
||
python3 tools/selftest-cluster-selfreport-break.py
|
||
ok
|
||
fi
|
||
|
||
printf '\n\033[32m\033[1m全部通过\033[0m\n'
|