#!/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. 12 个示例必须跑得通且断言全绿(否则三个月后就是一批编译不过的摆设) # 4b. 跨目标(x86_64-linux-musl)必须零告警 —— Linux 专属代码在宿主 # 目标下整段被排除,宿主编译发现不了它的 unused 之类的问题; # 同时 guest 静态产物不许链接宿主控制面(openssl/axum/reqwest), # 必须 --no-default-features,并由产物探针验标识串 # 5. shell 脚本里不能有「变量后紧跟非 ASCII 字符」/「双引号串里的反引号」 # /「双引号串里未转义的双引号」三类引号与变量陷阱 # 6. OCI 运行期完整性链自测必须全过(篡改活文件必须能被发现) # 7. KBS「先验证明才下发」必须自证:正向路径能走通,拒绝路径必须拒 # (判定器被顶替 / 输出不是判定结论时必须拒,防假绿) # 8. guest 脚本必须在 ash 上语法正确(bash -n 通过 ≠ ash 能解析) # 9. 芯片验签器必须正负向都对(假绿 = 密钥发给不该拿的人) # SNP 与 CSV 两个平台各一份:CSV 侧 2026-11-07 真机探索补上, # 并因此挖出两个真 bug(官方 SM2 签名不覆盖 MAC; # 官方验签器缺证书会联网下载 ⇒ 链验证信任材料形同虚设)。 # 10. OP-TEE 判据逻辑必须正负向都对(判据错了 = 验证结论是错的; # 而那两条验证只能在有 SDK 的机器上跑,判据不进主门禁就永远没被执行过) # 11. 宿主控制面 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。 # # 用法:tools/ci.sh 正常跑 # tools/ci.sh --fast 跳过测试与示例,只编译(改完想快速确认能编过时用) # set -euo pipefail cd "$(dirname "$0")/.." 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/22 全量测试(含 secure 特性)" cargo test --workspace --features secure ok fi step "2/22 零告警构建(所有目标)" # -Dwarnings 同时作用于本地 crate 的 test / bench / example 目标, # 所以「测试代码里有 unused」也会被拦下 —— 这正是想要的。 RUSTFLAGS="${RUSTFLAGS:+${RUSTFLAGS} }-Dwarnings" \ cargo build --workspace --all-targets --features secure ok step "3/22 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/22 跨目标编译(${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/22 示例冒烟(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/22 shell 引号 / 变量名卫生" python3 deploy/tee/real-machine/lint-shell-vars.py deploy/tee tools ok # 第 6 条:OCI 运行期完整性链自测。 # 这条链是「代码度量 → 活文件内容」的闭链,断了不会有编译错误, # 只会在真机上表现为篡改活文件照样通过 —— 必须有本地闸门兜住。 step "7/22 OCI 运行期完整性链自测" python3 deploy/tee/oci/selftest-chain.py ok # 第 7 条:KBS「先验证明才下发」自测。 # 这条链是「先出芯片证明 → KBS 校验 → 才签 token → 才给密钥」。 # 它的两端一旦断了不会有编译错误: # · 顺序断(不验证明就给密钥)→ 密钥服务退化成文件服务器; # · 判定断(判定器被顶替 / 输出不是判定结论)→ **假绿**, # 「通过之后真的会签发 token 并下发密钥」这条路从未被验证过。 # 所以这里必须同时覆盖正向路径与全部拒绝路径。 step "8/22 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/22 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/22 芯片验签器自测(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/22 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/22 宿主控制面 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/22 会话级链路层 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/22 链上层 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/22 国密签名 / 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/22 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/17 阶段 3 OPA bundle 签发 / 真判定 / decision 存证自测" python3 tools/selftest-chain-opa.py --self-test python3 tools/selftest-chain-opa.py ok fi printf '\n\033[32m\033[1m全部通过\033[0m\n'