diff --git a/CLAUDE.md b/CLAUDE.md
index 9105e2c..d3c8419 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -76,10 +76,13 @@ hostd / 链路层 / 链上层端到端桩自测、国密签名与治理形状自
**零种子守卫端到端自测**(第 24 条;`tools/selftest-seed-guard.py`;
全零主种子是本项目最隐蔽的一类失败 —— 守卫必须在 CLI **入口**且**在连网之前**,
覆盖全部 8 个吃种子的命令)、
-**集群自报判据自测 + 破坏实验**(第 25 条;`tools/selftest-cluster-selfreport.py` / `-break.py`;
+**集群自报 + 端点公布判据自测 + 破坏实验**(第 25 条;`tools/selftest-cluster-selfreport.py` / `-break.py` 与 `tools/selftest-cluster-endpoint-gate.py` / `-break.py`,**两份真机脚本成对覆盖**;
10 组判据 / 11 项检查覆盖「密钥不进 argv / 否定式判据配正向锚点 / 鉴权口径只有一份 / 密钥送达校验 / stdin 不丢 / 凭据经 xop 子进程 / fd3 **只收 stdout**、ssh 客户端 stderr 不进采集流 / **真跑 `remote()` 验证返回值纯度**」,
13 条破坏实验逐条证明判据非恒绿;探针用**假 xop + 假 sshpass**,
不依赖真机、不解密真口令、不需要 Touch ID)。
+★ 端点侧另 **25 条判据 + 14 条破坏实验**,钉死「正向守卫先于负向 / 正向端点内容
+判据 / 负向 `/report` 正向锚点 + reason / `000` 不判假绿 / KBS 本轮实例归属 /
+结论收口 / 收尾端点收回」,见 `tools/selftest-cluster-endpoint-gate*.py`。
★ 按名字定位代码的判据**必须先剥注释**:2026-11-09 给 `remote()` 补注释时写了
`` `got_len` 又不是纯数字``,判据先命中注释 ⇒ 凭空转红(自指型假红,同类问题第二次踩到)。
明细以脚本自身为准(**闸门不扫自己就是盲区**)。
diff --git a/README.md b/README.md
index 6fbf062..b5dd62f 100644
--- a/README.md
+++ b/README.md
@@ -69,11 +69,12 @@ ssw-mpc 解决的是**互不信任的多方如何一起算**:数据留在各
|---|---|---|
| 真 TEE 跨物理机双 guest 密文会话 | ✅ 跑通 | 海光 CSV + AMD SNP 两侧还原 `35.000000`;`deploy/tee/real-machine/tee-pair-attest-e2e.sh`,判据 `TEE_PAIR_OK` |
| 芯片证明链与密文会话**同一次运行**合流 | ✅ 跑通 | `attest-collect → attest-post(KBS 芯片验签放行)→ key_source=kbs → 跨物理密文会话`;判据 `TEE_ATTEST_GATE_OK`,负向也真绿;见 `docs/REAL_MACHINE_FINDINGS.md` 第 10 节 |
+| 集群端点公布门禁(真 KBS 验签后才公布) | ✅ 跑通 | AMD SNP + 海光 CSV 双节点自报 → 非回环暴露(共享密钥 + `--allow-remote`)→ 真 KBS 芯片验签 → 9p 手牌回传证明包 → hostd 独立判定 → `GET /sessions` 公布 `192.168.1.7:3010`;负向 `epg-bad` 零外泄 + `/report` 带原因,收尾端点收回;判据 `CLUSTER_ENDPOINT_GATE_OK`(20/0),见 `docs/REAL_MACHINE_FINDINGS.md` 第 11 节 |
| FISCO 国密链**真交易**(TARS 编码 + SM2 `ZA‖dataHash` 签名) | ✅ 跑通 | 提交走自有 `sendTransaction`(4 参);签名为 `r‖s‖pub` 128B;真相源 `docs/FISCO_UPSTREAM_TRUTH.md` |
| 智能合约真链**部署 / 调用 / 读回** | ✅ 跑通 | `contracts/MpcHardRule.sol`;`tools/selftest-fisco-contract.py` 部署→`recordHardRule`→读回→负向矩阵,**22 项判据全绿**(主门禁第 22 条;零依赖 `--self-test` 每次必跑) |
| 链节点与管理节点**持久化** | ✅ 已迁 k8s | FISCO 链连同现有账本迁入 wuguirong,`nfs-wuguirong` PVC;历史区块哈希逐个一致、删 Pod 重建后高度不变;见 `deploy/k8s/fisco/README.md` |
| MPC 站点 `mpc-demo` | ✅ 已在 k8s | NodePort `30082`,`/tmp` 挂 NFS PVC;见 `demo/k8s/README.md` |
-| 主门禁 | **25 条** | `./tools/ci.sh`;第 21 条真交易编码判据、第 22 条真链合约判据、第 23 条 SA 扩展模式、第 24 条零种子守卫、第 25 条集群自报判据自测(11 项)+ 破坏实验(13 项);缺环境一律显式 `*_SKIPPED`,绝不静默通过 |
+| 主门禁 | **25 条** | `./tools/ci.sh`;第 21 条真交易编码判据、第 22 条真链合约判据、第 23 条 SA 扩展模式、第 24 条零种子守卫、第 25 条集群自报判据自测 + 破坏实验**和**端点公布门禁判据自测(25 项)+ 破坏实验(14 项);缺环境一律显式 `*_SKIPPED`,绝不静默通过 |
**仍然不宣称的边界**(别被上面「跑通」冲掉):软件 OpenSSL 签名器私钥可导出 ⇒
**密评不可过**,生产必须换硬件模组签名器;真实 `bcos-rpc` 的 **TLCP 通道未通**(第 18 条服务端是环回 echo);
diff --git a/deploy/tee/real-machine/README.md b/deploy/tee/real-machine/README.md
index e410d33..4c895d9 100644
--- a/deploy/tee/real-machine/README.md
+++ b/deploy/tee/real-machine/README.md
@@ -38,6 +38,30 @@ set -a; . ./real-machines.env; set +a
- 编排层生成的变量(`MPC_TEE_MPC_BIN` / `MPC_TEE_MANIFEST` / `MPC_KBS_PLATFORM` /
`MPC_KBS_TOKEN_KEY_FILE` …)**不要手填**,见 env 样例 H 段。
+### 集群面:端点公布门禁(2026-11-09 真机实证)
+
+`cluster-endpoint-gate-e2e.sh` 是**第二条一键脚本**,管的是「端点能不能给计算面
+消费」,不是「两台 guest 能不能通会话」(那条是 `tee-pair-attest-e2e.sh`)。
+
+```bash
+cd deploy/tee/real-machine
+set -a; . ./real-machines.env; set +a
+# 前置:tee-pair-attest-e2e.sh 已把 initrd / 验签器 / KBS 脚本铺到两台真机,
+# 且两侧 /tmp/mpc-cluster/mpc 是 host-only musl 产物
+./cluster-endpoint-gate-e2e.sh # 判据 CLUSTER_ENDPOINT_GATE_OK(20 判据)
+```
+
+链路:双节点 hostd 自报 → 控制面非回环监听(共享密钥 + `--allow-remote`)→
+`/desired` per-session 绑定 → 选址下发 → 真 guest 采证明 → KBS 芯片验签 →
+9p 手牌回传原始证明包 → hostd 独立判定 → 对账 → `GET /sessions` 公布端点。
+负向 `epg-bad` 零外泄 + `/report` 带原因;收尾清空期望态后端点收回。
+**两道门都在服务端**(脚本只观察,不替它们下结论):`is_verified()` 管实例去留,
+`publishable(require_chip_sig)` 管端点是否外泄(默认要求芯片验签)。
+
+★ 参数见 env 样例 **I 段**;判据自测 + 破坏实验在主门禁第 25 条
+(`tools/selftest-cluster-endpoint-gate.py` / `-break.py`)。
+完整结论见 `docs/REAL_MACHINE_FINDINGS.md` §11。
+
### 症状 → 根因 → 处置(速查)
调环境时按「症状」查这张表,不用通读 `docs/REAL_MACHINE_FINDINGS.md`:
@@ -63,6 +87,12 @@ set -a; . ./real-machines.env; set +a
| 绑定值对不上,报错像「重放攻击」 | 手工抄 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 自动重算,别手抄 |
+| `create 失败: 启动参数覆盖失败: 额外内核参数含空白或控制字符` | CLI 把多个 `--guest-kernel-param` 用空格 join,服务端旧实现对整串判空白 | `runtime.rs::apply_launch_override()` 改 `split_whitespace()`;CLI↔服务端跨端守卫测试 |
+| KBS 判定用的是**上一轮**参数 / 起了新实例却没生效 | 旧 pidfile 的 KBS 占着端口,端口 LISTEN ≠ 本轮实例在跑 | `kbs-net.sh` 按端口清旧 + 硬等端口释放;`start_kbs` 验 `EPG_KBS_OWNED_OK`(pid cmdline 含本轮 `--session`/`--mpc`) |
+| guest 没回传证明包(`section5_hits=0`) | 主链路 `initrd.img` 是旧版,不含 `init.sh` 第 5 节 | `oci-image.py build/verify/pack` 重建;节点描述 `measurement` 同步新 manifest digest |
+| `can't bind ... 19777: Address already in use` | guest halt 后 qemu 不退出,遗留进程占 socket 端口 | 按 `ss -ltnp` 的 pid 清;**禁 `pkill -f`**(远端 cmdline 含该串会自杀) |
+| `000` 被当成「错密钥被拒」 | 控制面没起来时 curl 返回 `000`,`000 != 200` 假绿 | 先精确判正确密钥 `200`,失败即 `exit 1` |
+| `--node-measurement AMD1`(度量只剩 4 位) | bash `$10` 是 `${1}0`,参数从第 10 个起全错位 | 一律 `${10}`..`${18}`;远端脚本本地重建后 `bash -n` |
### `/tmp` 里那 60+ 个探索脚本怎么办
diff --git a/deploy/tee/real-machine/real-machines.env.example b/deploy/tee/real-machine/real-machines.env.example
index 04b3918..2b126a9 100644
--- a/deploy/tee/real-machine/real-machines.env.example
+++ b/deploy/tee/real-machine/real-machines.env.example
@@ -88,3 +88,23 @@ export MPC_TEE_PUBKEY=cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd
# ★ 区分「组级」与「实例级」:上面 D/E 段的 MPC_AMD_* / MPC_HY_* 是两组配置,
# pair-attest-run.sh 会按当前 guest 角色挑一组,转成 MPC_TEE_* / MPC_KBS_*
# 注入远端。别在 env 里同时写实例级变量,会覆盖编排层的分派。
+
+# ── I. 集群面:端点公布门禁(cluster-endpoint-gate-e2e.sh)──────────────
+# ★ 这一组全部**可选**,不设就按脚本默认值跑。共享密钥默认**本次运行随机生成**、
+# 用完即弃,不落盘 / 不入库 / 不进 xop;别在这里写死生产密钥。
+# export MPC_CLUSTER_SECRET=... # 仅调试时固定;默认随机
+export MPC_EPG_WORK=/tmp/mpc-cluster-epg
+export MPC_EPG_CLUSTER_DIR=/tmp/mpc-cluster
+export MPC_EPG_TIMEOUT=420 # SNP 验签首次要联网拉 KDS 证书链
+export MPC_EPG_POLL=5
+# export MPC_EPG_SESSION_ID=... # 默认复用 MPC_TEE_SESSION_ID(abab…)
+# export MPC_EPG_PUBKEY=... # 默认复用 MPC_TEE_PUBKEY(cdcd…)
+export MPC_EPG_SITE=alice # 绑定方 site,与节点自己的 site 可以不同
+#
+# ★ 下列由脚本从节点描述 / 拓扑自动推导,**不要手填**:
+# EPG_MEASUREMENT(节点描述 measurement=,即 OCI manifest digest)
+# AMD_TCB / HY_TCB(节点描述 tcb=)
+# guest endpoint(tap/bridge 宿主地址,**不是**管理网 IP)
+# MPC_KBS_*(platform / site / pubkey / measurement / pin / tcb / mpc 二进制)
+# ★ 复用 A / D / E 段的主机、凭据键名、MAC、bridge IP、KBS 端口与
+# MPC_TEE_LINK_PORT(19777,socket 二层链路);别在 I 段另起一套拓扑。
diff --git a/docs/ARCHITECTURE_SYSTEM.html b/docs/ARCHITECTURE_SYSTEM.html
index e1e4f60..298d8d9 100644
--- a/docs/ARCHITECTURE_SYSTEM.html
+++ b/docs/ARCHITECTURE_SYSTEM.html
@@ -206,7 +206,7 @@ footer{max-width:760px;margin:26px auto 0;color:var(--muted);font-size:12.5px;te
└───────────────────────────┬──────────────────────────────────────────────────────┘
│ 站点端编排 / 会话登记([设计] 尚未具象为独立服务)
┌───────────────────────────▼── TEE 真机(编排层之外)─────────────────────────────┐
-│ 集群控制面 mpc control-plane :3020 [桩验] 收自报 / 选址 / 对账 / 公布端点 │
+│ 集群控制面 mpc control-plane :3020 [实证] 收自报 / 选址 / 对账 / 公布端点 │
│ 宿主机控制面 mpc-hostd :3010/:3011 e2b 兼容 API + /attestation │
│ TeeRuntime:qemu spawn / 状态表 / reaper / 孤儿校验(pid + 启动时间) │
│ 证明采集 → KBS 验签 → 放密钥 → tap(宿主) + socket(跨 guest) │
@@ -525,10 +525,23 @@ fail-closed 口径,解析失败拒收、不写半条记录)→ 每会话专属绑定: 状态:[桩验] 真 socket 端到端门禁已跑通完整闭环,且用假 hostd 给
-「端点不外泄」补了正向对照(证明通过 ⇒ 端点真的出现;证明不齐 ⇒ 端点被收回),
-避免否定式判据因 状态:[真机实证] 2026-11-09 完整闭环已在两台真机上跑通,入口
+ 这是第四种平台形态,与 §6 矩阵里的 CSV/SNP、OP-TEE 都不同:算力不在安全世界里,
安全世界只供能力。NodeReg
+DesiredSession.binding: Option<SessionBinding> 优先于
控制面全局绑定。绑定值写进芯片报告 user_data,两个会话共用一份绑定等于
两份报告可互相冒用(重放)。create 恒失败而恒真(空集通过)。但节点是本机假 hostd /
-不可达节点,不等于真机集群调度已跑通 —— 见 §8。deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh(判据
+CLUSTER_ENDPOINT_GATE_OK,20 通过 / 0 失败)。链路:两台 hostd 自报 →
+控制面非回环监听(共享密钥 + 显式 --allow-remote)→ 期望态 per-session
+绑定 → 选址下发 create → 真机双网卡 guest → KBS 芯片验签 →
+guest 经 9p 手牌回传原始证明包 → hostd 独立判定(四布尔 + 三态)→
+对账器 proven_endpoints() → GET /sessions 公布
+{"endpoint":"192.168.1.7:3010","session_id":"epg1"}。
+负向:绑定度量对不上的 epg-bad 零外泄,且 /report 有带原因的失败记录;
+清空期望态后端点收回。★ 端点公布有两道门:is_verified() 决定实例去留,
+publishable(require_chip_sig) 决定端点是否外泄(默认要求芯片验签)。
+此前「真 socket + 假 hostd」的桩验仍保留为正向对照,但已不是唯一证据。
+★ 联调脚本的 4 个必挂缺陷(xop WARN 走 stdout 污染返回值、printf 前导
+--- 被当选项、remote() 里被覆盖的 < /dev/null 假防护、以及 2>&3
+把 ssh 客户端 Warning 又收回 fd3)由 cluster-endpoint-gate-e2e.sh 同套
+remote()/fd3 范式在真机完整复跑覆盖;cluster-selfreport-e2e.sh 自身
+仍未单独复跑,别把两份脚本混为一谈。1.7 SA 扩展模式(安全锚点供能力、算力挂外部 VM)
集群面是第三条同一次运行的实证链路(2026-11-09,
+deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh):
双节点 hostd 自报 → /desired(per-session 绑定)→ 选址下发 create
+ → 真 guest 采证明 → KBS 芯片验签 → 9p 手牌回传原始证明包
+ → hostd 独立判定(四布尔)→ 对账 → proven_endpoints() → GET /sessions
+ 判据 CLUSTER_ENDPOINT_GATE_OK(20/0;负向 epg-bad 零外泄 + 带原因)
+
链侧对应的是另一条独立实证链路(tools/selftest-fisco-contract.py,主门禁第 22 条):
dataHash → TARS 编码已签名交易 → sendTransaction(4 参)→ receipt(status==0)
→ 部署 MpcHardRule.sol → recordHardRule → call 读回 → 负向矩阵
-两条链路目前没有合流:TEE 证明未上链、未绑定链上状态位; +
三条链路目前没有合流:TEE 证明未上链、未绑定链上状态位; 链上撤销状态位读取后端未接入(声明 chain 即 fail-closed 拒)。这是当前最重要的架构缺口, 不是「已经打通的端到端」。
组网事实(踩过坑,别重犯):跨 guest 走 qemu socket(二层),访问宿主 KBS 走 tap
@@ -697,6 +717,12 @@ guest([实证]) 只做计算与出证明,不持链
127.0.0.1:3010mpc control-plane(集群面)192.168.1.102 海光 CSV(与 hostd 同机,演练)0.0.0.0:3020(非回环;共享密钥 + --allow-remote 才放行)fisco-gmtools/ci.sh,24 条tools/ci.sh,25 条*_SKIPPED;闸门不扫自己 = 盲区,lint 含 tools/docs/OPTEE_VERIF_PLAN.md 有完整证据表):全流程 selftest、第 5 条跨设备解封被拒、第 4 条跨重启 unseal 成功三条都真跑通了。但那是 QEMU 模拟(dna = 编译期 sha256 种子,HUK = 模拟值)⇒ 不是真板的设备绑定证据,不能替代真板一次性验收;CryptoPrecompiled.sm2Verify 真机对拍未做;tools/fisco-realnode-probe.py 的 4 处 IMPL_GAPS 未销账。create secret 权限;链客户端私钥 MPC_FISCO_KEY 保持仓库外,不进镜像 / ConfigMap / git。mpc control-plane
-的「收自报 → 注册表 → 期望态 → 选址 → 下发 → 证明门控 → 公布端点」闭环
-在真 socket 门禁里全绿,但节点是本机假 hostd(证明结论可控)或不可达节点;
-真机多节点自报、跨网段暴露、真 KBS 验签后的会话端点交付未做。
-别把 §1.6 当成已部署的集群清单。cluster-endpoint-gate-e2e.sh 在 AMD SNP + 海光 CSV 上跑通
+「自报 → 非回环暴露 → 真 KBS 芯片验签 → 独立判定 → 端点公布」
+(CLUSTER_ENDPOINT_GATE_OK,20 判据)。但共享密钥是本次运行随机生成、
+控制面非回环监听只在演练里开过 ⇒ 不宣称生产级鉴权/密钥轮转、
+跨公网暴露、控制面 HA 与持久化已验证。§1.6 现在可以当已实证清单读,
+但只到这一条链路为止。cluster-selfreport-e2e.sh 自身未单独复跑,
+只被同套 remote()/fd3 范式覆盖。pending 会话目前不会
+因超时被回收(只等证据或期望态清空)。这是已知设计缺口,不是已实现能力。K_root 硬件隔离成立」(§1.7):
板端 SA 的 K_root 是软件生成与持有的(板子无硬件密钥槽),SA 自曝
platform=none / hardware_protected=false。⇒ 阶段一不能进密评。
@@ -874,7 +908,8 @@ TA 是所有 CA 共享的,没有「这个 TA 属于哪个租户」的进程语
想搞懂「计算层为什么这样分」 → ARCHITECTURE.md
想看「当时为什么这么决策」 → INTEGRATION_ANALYSIS.md(先看文首状态提示)
想核对「链上逐字节事实」 → FISCO_UPSTREAM_TRUTH.md
-想真跑一遍 → tools/ci.sh(24 条)/ deploy/k8s/fisco/README.md
+想复现集群端点门禁 → deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh
+想真跑一遍 → tools/ci.sh(25 条)/ deploy/k8s/fisco/README.md
/ deploy/tee/real-machine/README.md
更新纪律:本文是 A 类活文档,事实变了就改;但不得复制判据逻辑、不得写死门禁条数 diff --git a/docs/ARCHITECTURE_SYSTEM.md b/docs/ARCHITECTURE_SYSTEM.md index 393469c..8f05964 100644 --- a/docs/ARCHITECTURE_SYSTEM.md +++ b/docs/ARCHITECTURE_SYSTEM.md @@ -45,7 +45,7 @@ └───────────────────────────┬──────────────────────────────────────────────────────┘ │ 站点端编排 / 会话登记([设计] 尚未具象为独立服务) ┌───────────────────────────▼── TEE 真机(编排层之外)─────────────────────────────┐ -│ 集群控制面 mpc control-plane :3020 [桩验] 收自报 / 选址 / 对账 / 公布端点 │ +│ 集群控制面 mpc control-plane :3020 [实证] 收自报 / 选址 / 对账 / 公布端点 │ │ 宿主机控制面 mpc-hostd :3010/:3011 e2b 兼容 API + /attestation │ │ TeeRuntime:qemu spawn / 状态表 / reaper / 孤儿校验(pid + 启动时间) │ │ 证明采集 → KBS 验签 → 放密钥 → tap(宿主) + socket(跨 guest) │ @@ -170,19 +170,23 @@ fail-closed 口径,解析失败拒收、不写半条记录)→ `NodeRegistry 控制面全局绑定。绑定值写进芯片报告 `user_data`,两个会话共用一份绑定等于 两份报告可互相冒用(重放)。 -**状态**:[桩验 + 真机自报] 真 socket 端到端门禁已跑通完整闭环,且用**假 hostd** 给 -「端点不外泄」补了正向对照(证明通过 ⇒ 端点真的出现;证明不齐 ⇒ 端点被收回), -避免否定式判据因 `create` 恒失败而恒真(空集通过)。 -**真机两节点自报已实证**(2026-11-09):AMD SNP(`192.168.1.7`,site=alice) -与海光 CSV(`192.168.1.102`,site=bob)各起 hostd 向真机控制面自报, -`/nodes` 注册表里确实有两个节点、`measurement` 非全零。 -但**选址 → 下发 → 证明门控 → 公布端点**的真机闭环仍未做完 —— 见 §8。 -★ 本轮又用离线探针查出联调脚本里 4 个会让真机必挂的缺陷(xop 把 WARN 打在 -**stdout** 污染返回值、`printf` 前导 `---` 被当选项、`remote()` 里被覆盖的 -`< /dev/null` 假防护、以及为修第一个缺陷写成 `2>&3` 后 ssh 客户端 -`Warning: Permanently added …` 从 stderr 又混进 fd3)。修完后**只过了离线判据门禁 -+ 真机只读链路复验**(真跑 `remote()`:返回值只剩标记与纯数字, -xop WARN 与 ssh Warning 都没混进来、临时文件无残留);**完整真机 e2e 尚未复跑**。 +**状态**:[真机实证] 2026-11-09 完整闭环已在两台真机上跑通,入口 +`deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh`(判据 +`CLUSTER_ENDPOINT_GATE_OK`,20 通过 / 0 失败)。链路:两台 hostd 自报 → +控制面非回环监听(共享密钥 + 显式 `--allow-remote`)→ 期望态 per-session +绑定 → 选址下发 `create` → 真机双网卡 guest → KBS **芯片验签** → +guest 经 9p 手牌回传原始证明包 → hostd 独立判定(四布尔 + 三态)→ +对账器 `proven_endpoints()` → `GET /sessions` 公布 +`{"endpoint":"192.168.1.7:3010","session_id":"epg1"}`。 +负向:绑定度量对不上的 `epg-bad` 零外泄,且 `/report` 有带原因的失败记录; +清空期望态后端点收回。★ 端点公布有**两道门**:`is_verified()` 决定实例去留, +`publishable(require_chip_sig)` 决定端点是否外泄(默认要求芯片验签)。 +此前「真 socket + 假 hostd」的桩验仍保留为正向对照,但已不是唯一证据。 +★ 联调脚本的 4 个必挂缺陷(xop WARN 走 stdout 污染返回值、`printf` 前导 +`---` 被当选项、`remote()` 里被覆盖的 `< /dev/null` 假防护、以及 `2>&3` +把 ssh 客户端 Warning 又收回 fd3)由 `cluster-endpoint-gate-e2e.sh` 同套 +`remote()`/fd3 范式在真机完整复跑覆盖;`cluster-selfreport-e2e.sh` 自身 +仍未单独复跑,别把两份脚本混为一谈。 ### 1.7 SA 扩展模式(安全锚点供能力、算力挂外部 VM) @@ -294,6 +298,16 @@ attest-collect → attest-post(KBS 芯片验签放行) → key_source=kb 判据 TEE_ATTEST_GATE_OK 判据 TEE_PAIR_OK ``` +集群面是第三条**同一次运行**的实证链路(2026-11-09, +`deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh`): + +```text +双节点 hostd 自报 → /desired(per-session 绑定)→ 选址下发 create + → 真 guest 采证明 → KBS 芯片验签 → 9p 手牌回传原始证明包 + → hostd 独立判定(四布尔)→ 对账 → proven_endpoints() → GET /sessions + 判据 CLUSTER_ENDPOINT_GATE_OK(20/0;负向 epg-bad 零外泄 + 带原因) +``` + 链侧对应的是另一条独立实证链路(`tools/selftest-fisco-contract.py`,主门禁第 22 条): ```text @@ -301,7 +315,7 @@ dataHash → TARS 编码已签名交易 → sendTransaction(4 参)→ receip → 部署 MpcHardRule.sol → recordHardRule → call 读回 → 负向矩阵 ``` -**两条链路目前没有合流**:TEE 证明未上链、未绑定链上状态位; +**三条链路目前没有合流**:TEE 证明未上链、未绑定链上状态位; 链上撤销状态位读取后端未接入(声明 chain 即 fail-closed 拒)。这是当前最重要的架构缺口, 不是「已经打通的端到端」。 @@ -319,6 +333,7 @@ dataHash → TARS 编码已签名交易 → sendTransaction(4 参)→ receip | `mpc-demo` 站点 | wuguirong k8s,Pod + NFS PVC | ❌ 容器 | `192.168.1.26\|27\|29:30082` | | `fisco-verify` 守卫 | wuguirong k8s | ❌ 容器 | 常驻,无对外端口 | | `mpc-hostd` / guest / KBS | `192.168.1.102` 海光 CSV、`192.168.1.7` AMD SNP | `.7` 本身是 SNP guest 虚机,`.102` 裸机 / hypervisor | 本机 `127.0.0.1:3010` | +| `mpc control-plane`(集群面) | `192.168.1.102` 海光 CSV(与 hostd 同机,演练) | ❌ 宿主进程 | `0.0.0.0:3020`(非回环;共享密钥 + `--allow-remote` 才放行) | | 本机 `fisco-gm` | macOS Docker 容器(**已 stop 未删**,可回滚) | ❌ 容器 | 旧 `:20200`,**不要再启动** | > ⚠️ 本机 `fisco-gm` 与 k8s 链是**同账本两份拷贝**,同时对外服务会分叉。 @@ -398,18 +413,19 @@ TA 是所有 CA 共享的,没有「这个 TA 属于哪个租户」的进程语 - OP-TEE **QEMU 实跑已做**(2026-11-09,`docs/OPTEE_VERIF_PLAN.md` 有完整证据表):全流程 selftest、第 5 条跨设备解封被拒、第 4 条跨重启 unseal 成功三条**都真跑通了**。但那是 **QEMU 模拟**(`dna` = 编译期 sha256 种子,HUK = 模拟值)⇒ **不是**真板的设备绑定证据,**不能**替代真板一次性验收;`CryptoPrecompiled.sm2Verify` 真机对拍未做;`tools/fisco-realnode-probe.py` 的 4 处 `IMPL_GAPS` 未销账。 - 本租户 SA 无 `create secret` 权限;链客户端私钥 `MPC_FISCO_KEY` 保持仓库外,不进镜像 / ConfigMap / git。 - 站点端控制面是 [设计] 决策角色,不是已实现的独立服务;别把 §2 的职责矩阵当成已部署清单。 -- **真机多节点自报已实证,但「调度闭环」仍未做完**:`mpc control-plane` 的 - 「收自报 → 注册表」这一步 2026-11-09 已在 AMD SNP + 海光 CSV 两台真机上跑通 - (`/nodes` 里两个节点、度量非全零)。但「期望态 → 选址 → 下发 → 证明门控 → - 公布端点」仍只在真 socket 门禁里用**假 hostd**(结论可控)或不可达节点验过; - 跨网段暴露、真 KBS 验签后的会话端点交付**未做**。别把 §1.6 当成已部署清单。 -- ★ **本轮修完的联调脚本尚未在真机完整复跑**:`deploy/tee/real-machine/cluster-selfreport-e2e.sh` - 的 4 个必挂缺陷(xop WARN 走 stdout ⇒ `wc -c` / `sha256sum` 返回值被污染、 - `printf '--- …'` 前导破折号被当选项、`remote()` 的 `< /dev/null` 被 here-string - 覆盖成假防护、以及 `2>&3` 把 ssh 客户端 Warning 又收回采集流)是**离线探针** - 发现并修掉的;第 25 条门禁证明的是「判据本身不是恒绿」, - **不是**「真机端到端已复跑通过」。已做的真机验证只是**只读**调用 `remote()` - (返回值纯净、无临时文件残留),复跑前别把脚本标成 [实证]。 +- **集群面闭环已真机实证,但仍是演练级**:2026-11-09 + `cluster-endpoint-gate-e2e.sh` 在 AMD SNP + 海光 CSV 上跑通 + 「自报 → 非回环暴露 → 真 KBS 芯片验签 → 独立判定 → 端点公布」 + (`CLUSTER_ENDPOINT_GATE_OK`,20 判据)。但共享密钥是**本次运行随机生成**、 + 控制面非回环监听只在演练里开过 ⇒ **不宣称**生产级鉴权/密钥轮转、 + 跨公网暴露、控制面 HA 与持久化已验证。§1.6 现在可以当已实证清单读, + 但只到这一条链路为止。 +- **判据自测不是真机证据**:端点门禁的 25 条判据自测 + 14 条破坏实验 + (主门禁第 25 条)证明的是「判据不恒绿」,**不是**「真机再跑一次必过」。 + 真机结论只来自那一次完整运行;`cluster-selfreport-e2e.sh` 自身未单独复跑, + 只被同套 `remote()`/fd3 范式覆盖。 +- **pending 超时回收策略未做**:证明长时间不落的 `pending` 会话目前不会 + 因超时被回收(只等证据或期望态清空)。这是已知设计缺口,不是已实现能力。 - **SA 扩展模式只证明了「接口与边界形状成立」,不是「`K_root` 硬件隔离成立」**(§1.7): 板端 SA 的 `K_root` 是**软件**生成与持有的(板子无硬件密钥槽),SA 自曝 `platform=none` / `hardware_protected=false`。⇒ **阶段一不能进密评**。 @@ -429,6 +445,7 @@ TA 是所有 CA 共享的,没有「这个 TA 属于哪个租户」的进程语 想搞懂「计算层为什么这样分」 → ARCHITECTURE.md 想看「当时为什么这么决策」 → INTEGRATION_ANALYSIS.md(先看文首状态提示) 想核对「链上逐字节事实」 → FISCO_UPSTREAM_TRUTH.md +想复现集群端点门禁 → deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh 想真跑一遍 → tools/ci.sh(25 条)/ deploy/k8s/fisco/README.md / deploy/tee/real-machine/README.md ``` diff --git a/docs/INDEX.md b/docs/INDEX.md index 6375350..a625cfc 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -30,6 +30,7 @@ | TEE 直接调度 | [实证] 框架直出 qemu argv,**不走编排层 / Kata** | `TEE_DIRECT_LAUNCH.md`、`deploy/tee/README.md` | | 真 TEE 双 guest 密文会话 | [实证] 海光 CSV + AMD SNP 跨物理机,两侧还原 `35.000000` | `deploy/tee/real-machine/tee-pair-attest-e2e.sh`,判据 `TEE_PAIR_OK` | | 芯片证明链合流 | [实证] **同一次运行**:`attest-collect → attest-post(KBS 验签放行)→ key_source=kbs → 密文会话` | `REAL_MACHINE_FINDINGS.md` 第 10 节,判据 `TEE_ATTEST_GATE_OK`;负向逐条破坏过 | +| ★ 集群端点公布门禁 | [实证] 双节点自报 → 非回环暴露(共享密钥 + `--allow-remote`)→ 真 KBS 芯片验签 → 9p 手牌回传证明包 → hostd 独立判定 → `proven_endpoints()` → `GET /sessions`;判据 `CLUSTER_ENDPOINT_GATE_OK` 20/0,负向零外泄 + 带原因、收尾端点收回 | `deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh`、`REAL_MACHINE_FINDINGS.md` 第 11 节;主门禁第 25 条含端点判据自测 25 项 + 破坏实验 14 项 | | FISCO 国密链真交易 | [实证] TARS 编码(非 RLP)、`sendTransaction` 4 参、`r‖s‖pub` 128B 签名 | `FISCO_UPSTREAM_TRUTH.md`、`crates/mpc-chain/src/fisco_tx.rs` | | ★ SM2 签名口径 | [实证] **`e = SM3(ZA‖dataHash)`**,distid `1234567812345678`;**不是**签裸 `dataHash` | `FISCO_UPSTREAM_TRUTH.md` §3.1、`tools/sm2_verify.py`;这是 `10008 InvalidSignature` 的真根因 | | 智能合约真链部署 / 调用 / 读回 | [实证] `MpcHardRule.sol` 部署 → `recordHardRule` → 读回 → 负向矩阵,**22 项判据全绿** | `tools/selftest-fisco-contract.py`(主门禁第 22 条;零依赖 `--self-test` 每次必跑,真链批缺环境显式 `FISCO_REALNODE_SKIPPED`) | diff --git a/docs/REAL_MACHINE_FINDINGS.md b/docs/REAL_MACHINE_FINDINGS.md index d0140e7..d83bdfd 100644 --- a/docs/REAL_MACHINE_FINDINGS.md +++ b/docs/REAL_MACHINE_FINDINGS.md @@ -1,4 +1,4 @@ -# 真机探索结论(2026-11-07) +# 真机探索结论(2026-11-07 起,最后更新 2026-11-09) 本文记录**在两台真机上实测得到的硬事实**。它们与仓库里的桩测试是两类东西: 桩测试证明「判据逻辑自洽」,真机结论证明「厂商实现的行为是什么」。 @@ -627,3 +627,138 @@ TEE_ATTEST_NEGATIVE_OK `deploy/tee/real-machine/tee-pair-attest-negative.sh` - 证明门控判据:`deploy/tee/real-machine/check-attest-verdict.py` (自测 `tools/selftest-tee-attest-verdict.py`,主门禁第 20 条) + +--- + +## 11. ★★ 集群端点公布门禁:真 KBS 验签后才公布会话端点(2026-11-09 真机实证) + +入口 `deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh`,判据 +`CLUSTER_ENDPOINT_GATE_OK`。真机结果 **20 通过 / 0 失败**(rc=0)。 +这一节是 §10「证明门控 + 跨物理密文会话」之后,**集群面**的第三条实证链路: +把「端点能不能给计算面消费」也纳入门控。 + +### 11.1 同一次运行跑通了什么 + +```text +AMD SNP 192.168.1.7 + 海光 CSV 192.168.1.102 两台 hostd 周期自报 + → 控制面非回环监听(共享密钥 + 显式 --allow-remote) + → POST /desired(per-session 绑定:session_id / pubkey / code_measurement / site) + → 选址 → 下发 create(真机双网卡 + 9p 手牌 + 部署层内核参数) + → guest 采芯片报告 → 本机 KBS 芯片验签放行 → attest-post ok / key_source=kbs + → guest 经 9p 手牌用实例级令牌回传原始证明包 + → 节点 hostd 独立判定(四布尔 + 三态)→ 控制面对账 + → proven_endpoints() → GET /sessions +``` + +正向真机输出: + +```json +{"sessions":[{"endpoint":"192.168.1.7:3010","session_id":"epg1"}]} +``` + +KBS 日志里的芯片验签结论: + +```text +[kbs] 判定结论: ok=True structure_ok=True bound_ok=True + chip=verified-by:/tmp/mpc-tee-run-attestpair/snp-verify-attestation.sh + verdict=结构、会话绑定与芯片签名全部通过 +``` + +负向(换一个绑定度量与所有节点都不匹配的 `epg-bad` 期望态): + +```text +report : {"failed":[{"id":"epg-bad","reason":"无合格节点: 候选节点中没有一台满足 TEE 需求"}],"healthy":[]} +sessions : {"sessions":[]} +``` + +三条负向全绿:坏会话**零外泄**、`/report` **有失败记录**、失败记录**带原因**。 +收尾清空期望态后 `/sessions` 无 endpoint(实例真回收)。 + +### 11.2 端点公布的两道门(契约在服务端,脚本只观察) + +| 门 | 实现 | 作用 | +|---|---|---| +| `is_verified()` | `mpc-tee/reconciler.rs` | 决定**实例去留**:证据不成立 ⇒ 撤回端点 + 回收实例 | +| `publishable(require_chip_sig)` | 同上 | 决定**端点是否外泄**:默认要求芯片验签,没做 ⇒ 不公布 | + +三态 `pending` / `verified` / `rejected`;`proven_endpoints()` 只列 +`publishable` 的会话,`pending` 不在其中,`ControlPlane` 锁中毒返回空数组(fail-closed)。 +`/desired` 的 per-session binding **覆盖**控制面全局 binding +(`reconciler.rs`:`d.binding.clone().unwrap_or(self.binding)`)—— 所以控制面 +启动时不给全局绑定不是缺陷,但每条期望态必须自带完整绑定。 + +### 11.3 本轮挖出并修掉的 5 类真 bug + +1. **`runtime.rs` 额外内核参数整串判空白**:CLI 把多个 + `--guest-kernel-param` 逐个校验后**用单空格 join**,服务端却对整串判 + 「含空白即拒」⇒ ≥2 个参数时 `create` 恒 500。改成 + `split_whitespace()` 切 token、只拒控制字符、规范化后追加; + 改掉把错误行为钉死的旧测试,并补 CLI↔服务端跨端守卫。 +2. **`kbs-net.sh` 旧实例假就绪**:只按 pidfile 停旧实例不够;旧实例用别的 + pidfile 占端口时,新实例 bind 失败退出,端口仍 LISTEN ⇒ 判绿但用的是 + **上一轮参数**的 KBS。改成按端口找 `pid=` 并 kill、硬等端口释放; + `start_kbs` 再验 pidfile 进程的 cmdline 含本轮 `--session` 与 `--mpc`, + 输出 `EPG_KBS_OWNED_OK`。★ 端口 LISTEN ≠ 本轮实例在跑。 +3. **主链路 `initrd.img` 不含 `init.sh` 第 5 节**:真机上 + `section5_hits=0`,而 9p 探针目录里的 initrd 是 14 ⇒ 证明包根本没回传。 + 用 `oci-image.py build/verify/pack` 重建 OCI 镜像,新 initrd + `238f2deb…` 在真机 `SECTION5_HITS=18`,节点描述 `measurement` 同步到 + 新 manifest digest `25d06a32…`。★ 度量唯一真相源是**节点描述的 + `measurement=`(OCI manifest digest)**,不是 `sha256sum initrd.img`。 +4. **`19777` 遗留 qemu**:guest halt 后 qemu 不退出,第二轮 + `can't bind ip=0.0.0.0 to socket: Address already in use`。 + `start_hostd` 按端口定位并清掉遗留 qemu(禁用 `pkill -f`,会自杀)。 +5. **shell 转义与参数错位**:`$10`..`$17` 写成 `$10` 其实是 `${1}0` + ⇒ `--node-measurement AMD1`;双引号串里的反引号触发本地命令替换; + 归属检查第一版 `case` 模式里的引号提前结束本地字符串;`printf '%s' $CMD` + 引号丢失。全部改成 `${10}`..`${18}`、`grep -qF` 单引号模式、 + 本地重建远端脚本后 `bash -n` 校验。 + +### 11.4 判据纪律(否定式判据天然可能恒真) + +- **负向必须先跑正向**:正向端点没出现就直接 `exit 1`,不判负向 —— + 「sessions 数组为空」在控制面没起 / 没节点 / 没会话时**恒为真**。 +- **正向要有内容判据**:不只判数组非空,还要验 `endpoint` 指向真实节点 + `192.168.1.7:3010`、`session_id=epg1`。 +- **负向要有正向锚点**:`/report` 里必须有 `epg-bad` 的**失败记录且带原因**, + 否则「坏会话不在 sessions 里」可能只是期望态压根没收到。 +- **`000` 判假绿**:控制面没起来时 curl 返回 `000`, + `000 != 200` 会被当成「错密钥被拒」⇒ 先精确判正确密钥 `200`,失败即退出。 +- **每条负向带期望拒绝特征**:`neg_gate` 用 `grep -q "$want"`, + 不是只判 rc≠0(那会把「探针自己的 bug」当拒绝成功)。 +- **共享密钥不进 argv**:本地随机生成 → stdin → 远端 0600 文件 → + `MPC_HOSTD_SHARED_SECRET`,且**校验送达字节数**;服务端口径是 + `sha256(密钥原文)`,送来的必须就是原文(送 hex 会全部 401,真机踩过)。 +- 门禁侧:`tools/selftest-cluster-endpoint-gate.py`(25 条判据)+ + `-break.py`(14 条破坏实验,每条判据破坏一次都必须转红),并入主门禁第 25 条。 + ★ 判据自测证明的是「判据不恒绿」,**不是**「真机再跑一次必过」。 + +### 11.5 诚实边界(本节的不宣称项) + +- 共享密钥是**本次运行随机生成**、用完即弃;控制面非回环监听只在演练里开过 + ⇒ **不宣称**生产级鉴权 / 密钥轮转 / 跨公网暴露 / 控制面 HA 与持久化。 +- **不宣称**两端互验了对方的芯片报告:两侧 KBS 各验本机 guest。 +- 海光 CSV 的 MAC 完整性仍无保护(官方 SM2 签名不覆盖 MAC,见 §1)。 +- AMD SNP 验签依赖联网拉 KDS 证书链;离线需预置 `--chain-dir`。 +- **pending 超时回收策略未做**:证明长时间不落的会话目前只等证据或 + 期望态清空,不会因超时被回收。这是已知设计缺口。 +- `cluster-selfreport-e2e.sh` 自身未单独复跑,只被本脚本同套 + `remote()`/fd3 范式在真机覆盖;别把两份脚本混为一谈。 + +### 11.6 产物与复现入口 + +| 产物 | sha256 前缀 | 说明 | +|---|---|---| +| host-only musl `mpc` | `2ffa7bb6…` | `--no-default-features --features host-only`,分发到两侧 `/tmp/mpc-cluster/mpc` | +| 新 OCI manifest digest | `25d06a32…` | 节点描述 `measurement=` 同步此值 | +| 新 initrd | `238f2deb…` | 含 `init.sh` 第 5 节,真机 `SECTION5_HITS=18` | + +```bash +cd deploy/tee/real-machine +set -a; . ./real-machines.env; set +a # 前置:tee-pair-attest-e2e.sh 已铺好远端物料 +./cluster-endpoint-gate-e2e.sh # 判据 CLUSTER_ENDPOINT_GATE_OK +``` + +前置物料:`/tmp/mpc-tee-run-attestpair`(initrd / 验签器 / KBS 脚本 / 证书链) +与两侧 `/tmp/mpc-cluster/mpc`(host-only musl)。控制面跑在海光机上, +两台 hostd 各自起 guest;`MPC_EPG_TIMEOUT` 默认 420 秒(SNP 验签首次要联网)。 diff --git a/tools/ci.sh b/tools/ci.sh index da82ae2..0fdaa05 100755 --- a/tools/ci.sh +++ b/tools/ci.sh @@ -65,10 +65,15 @@ # set -euo pipefail cd "$(dirname "$0")/.." -# 25. 集群自报(控制面 + 多节点 hostd)判据自测 + 破坏实验 -# —— ★ 真机脚本的判据逻辑**永远不会被门禁执行**(真机不在门禁里), -# 而它有三种静默失效:密钥进 argv / 否定式判据恒真 / 鉴权口径分叉。 +# 25. 集群自报 + 端点公布(控制面 + 多节点 hostd + 真 KBS)判据自测 + 破坏实验 +# —— ★ 两份真机脚本的判据逻辑**永远不会被门禁执行**(真机不在门禁里): +# cluster-selfreport-e2e.sh(多节点自报)与 +# cluster-endpoint-gate-e2e.sh(真 KBS 验签后端点公布)。 +# —— ★ 自报侧三种静默失效:密钥进 argv / 否定式判据恒真 / 鉴权口径分叉。 # ③ 已真机踩过:控制面送 hex、节点比明文 ⇒ 全部 401。 +# —— ★ 端点侧另有三类:正向没过就判负向(空集恒真)、只判数组非空不验 +# 端点内容、负向缺 /report 正向锚点;以及 KBS 假就绪 +# (端口 LISTEN ≠ 本轮参数的实例在跑)与最终结论不收口。 # —— ★ 破坏实验与判据**一起跑**:正向通过不能证明判据在起作用; # 恒绿判据和真判据在正向路径上表现完全一样。 @@ -578,9 +583,13 @@ if [ "$FAST" -eq 0 ]; then # ★ 判据 10 是**行为判据**:真跑一遍 remote()(假 xop 打 WARN、 # 假 sshpass 打 Warning),断言返回值只剩远端 stdout —— # 静态查形态挡不住「换个写法又污染」。 - step "25/25 集群自报判据自测 + 破坏实验" + step "25/25 集群自报 + 端点公布判据自测 + 破坏实验" python3 tools/selftest-cluster-selfreport.py python3 tools/selftest-cluster-selfreport-break.py + # ★ 端点公布门禁(真 KBS 验签后才公布会话端点)—— 与自报是**两份**脚本, + # 两份的判据都不能被真机门禁执行 ⇒ 各自都要「自测 + 破坏实验」成对覆盖。 + python3 tools/selftest-cluster-endpoint-gate.py + python3 tools/selftest-cluster-endpoint-gate-break.py ok fi diff --git a/tools/selftest-cluster-endpoint-gate-break.py b/tools/selftest-cluster-endpoint-gate-break.py new file mode 100644 index 0000000..9a70f42 --- /dev/null +++ b/tools/selftest-cluster-endpoint-gate-break.py @@ -0,0 +1,247 @@ +#!/usr/bin/env python3 +"""真机端点公布门禁 · 判据**破坏实验**。 + +对 `cluster-endpoint-gate-e2e.sh` 的每条判据做一次变异, +要求 `selftest-cluster-endpoint-gate.py` **必须转红**。 +正向路径通过证明不了判据在起作用 —— 恒绿判据和真判据在正向路径上 +表现完全一样。 + +★ 每条变异都**双向确认生效**(证据串消失 / 新增): + 2026-11-09 实测踩过「变异函数删错行 ⇒ 破坏实验没抓到 ⇒ 差点被误判成 + 判据恒绿」。SKIP 一律不许当成通过。 + +全程只改临时副本,仓库文件一个都不动;不碰真机、不解密任何真口令。 + +用法: + python3 tools/selftest-cluster-endpoint-gate-break.py +""" + +import os +import shutil +import subprocess +import sys +import tempfile + +HERE = os.path.dirname(os.path.abspath(__file__)) +ROOT = os.path.dirname(HERE) +SCRIPT_REL = os.path.join('deploy', 'tee', 'real-machine', + 'cluster-endpoint-gate-e2e.sh') +SELFTEST_REL = os.path.join('tools', 'selftest-cluster-endpoint-gate.py') + +OK_N = 0 +FAIL_N = 0 + + +def ok(msg): + global OK_N + OK_N += 1 + print('ok %s' % msg) + + +def fail(msg): + global FAIL_N + FAIL_N += 1 + print('FAIL %s' % msg, file=sys.stderr) + + +def _prep(): + work = tempfile.mkdtemp(prefix='epg-break-') + for rel in (SCRIPT_REL, SELFTEST_REL): + dst = os.path.join(work, rel) + os.makedirs(os.path.dirname(dst), exist_ok=True) + shutil.copy(os.path.join(ROOT, rel), dst) + return work + + +def _read(work, rel): + with open(os.path.join(work, rel), encoding='utf-8') as f: + return f.read() + + +def _write(work, rel, text): + with open(os.path.join(work, rel), 'w', encoding='utf-8') as f: + f.write(text) + + +def _run_selftest(work): + p = subprocess.run( + [sys.executable, os.path.join(work, SELFTEST_REL)], + capture_output=True, text=True, cwd=work, timeout=120) + return p.returncode, p.stdout + p.stderr + + +def _variant(name, mutate, mode, expect): + """在临时副本上做一次变异 + 跑自测;要求自测转红且命中 expect。""" + work = _prep() + try: + src = _read(work, SCRIPT_REL) + new, evidence = mutate(src) + if new is None or new == src: + fail('破坏·%s:变异未生效' % name) + return False + present = evidence in new + if mode == 'gone': + good = (not present) and (evidence in src) + else: + good = present and (evidence not in src) + if not good: + fail('破坏·%s:证据串校验失败(present=%s, 证据 %r)' + % (name, present, evidence[:70])) + return False + _write(work, SCRIPT_REL, new) + rc, out = _run_selftest(work) + if rc != 0 and ('FAIL' in out) and (expect in out): + ok('破坏·%s:判据如预期转红(证明它不是恒绿)' % name) + return True + fail('破坏·%s:判据**没有**转红 ⇒ 它是恒绿' % name) + for ln in out.splitlines()[:22]: + print(' | %s' % ln, file=sys.stderr) + return False + finally: + shutil.rmtree(work, ignore_errors=True) + + +def _replace(src, old, new, evidence=None): + if old not in src: + return None, evidence or old + return src.replace(old, new, 1), (evidence or old) + + +def _drop_line(src, needle, evidence=None): + lines = src.splitlines(keepends=True) + kept = [ln for ln in lines if needle not in ln] + if len(kept) == len(lines): + return None, (evidence or needle) + return ''.join(kept), (evidence or needle) + + +# ── 变异函数 ──────────────────────────────────────────────────────────── +def m_break_positive_guard(src): + """把正向守卫换成恒假条件 ⇒ 「正向不过就退出」这道门没了。""" + return _replace(src, 'if [ "$epg_ok" -ne 1 ]; then', 'if false; then') + + +def m_break_positive_exit(src): + """正向没过却继续跑(exit 1 → exit 0)⇒ 负向恒真。""" + old = 'exit 1\nfi\nok "正向·控制面公布了' + return _replace(src, old, 'exit 0\nfi\nok "正向·控制面公布了') + + +def m_remove_endpoint_content(src): + """只判数组非空、不验端点地址 ⇒ 空壳端点也算通过。""" + return _drop_line(src, '\\"endpoint\\":\\"$AMD_HOST:3010\\"') + + +def m_remove_session_id_content(src): + """不验 session_id ⇒ 端点可以是别的会话。""" + return _drop_line(src, '\'"session_id":"epg1"\'') + + +def m_remove_negative_anchor(src): + """去掉 /report 的 epg-bad 锚点 ⇒ 「不在 sessions 里」可能恒真。""" + return _drop_line(src, "printf '%s' \"$report\" | grep -q 'epg-bad'") + + +def m_remove_reason(src): + """不提取 reason ⇒ 失败记录没有原因也判绿。""" + return _drop_line(src, 'reason=$(printf') + + +def m_break_204(src): + """坏期望态「不是 000」就算提交成功 ⇒ 期望态没收到也判绿。""" + return _replace(src, 'if [ "$code_bad" = "204" ]; then', + 'if [ "$code_bad" != "000" ]; then') + + +def m_break_000(src): + """正确密钥「不是 000」就算 200 ⇒ 控制面没起来时假绿。""" + return _replace(src, 'if [ "$code_ok" = "200" ]; then', + 'if [ "$code_ok" != "000" ]; then') + + +def m_break_neg_gate(src): + """neg_gate 退化成「有输出就算拒」 ⇒ 丢掉期望拒绝特征。""" + return _replace(src, + 'if printf \'%s\' "$o" | grep -q "$want"; then', + 'if [ -n "$o" ]; then') + + +def m_remove_kbs_owned(src): + """KBS 归属标记退化成「端口起来了」 ⇒ 旧实例假就绪。""" + return _replace(src, 'echo EPG_KBS_OWNED_OK', 'echo EPG_KBS_PORT_UP') + + +def m_break_key_delivery(src): + """不校验密钥真送达 ⇒ remote_put 丢 stdin 也发现不了。""" + return _drop_line(src, 'got_len=$(remote') + + +def m_break_final_gate(src): + """FAIL_N 非 0 也照样打印成功结论。""" + return _replace(src, '[ "$FAIL_N" -eq 0 ] || exit 1', + '[ "$FAIL_N" -eq 0 ] || true') + + +def m_remove_cleanup(src): + """收尾不判端点是否收回 ⇒ 实例留在真机上也没人知道。""" + return _drop_line(src, 'ok "期望态清空后端点已收回') + + +def m_break_order(src): + """在文件头注入早期负向锚点 ⇒ 顺序判据必须抓到「负向先于正向守卫」。""" + needle = 'set -u\n' + if needle not in src: + return None, 'BAD_SESSION_ID=early' + return src.replace(needle, needle + 'BAD_SESSION_ID=early\n', 1), \ + 'BAD_SESSION_ID=early' + + +VARIANTS = [ + (m_break_positive_guard, 'gone', '正向守卫(epg_ok)位于负向期望态之前', + '正向守卫被换成恒假条件'), + (m_break_positive_exit, 'gone', '正向失败分支里真的 exit 1', + '正向失败后继续跑(负向恒真)'), + (m_remove_endpoint_content, 'gone', '正向:端点必须指向真实节点地址', + '正向不验端点地址'), + (m_remove_session_id_content, 'gone', '正向:端点必须带正确的 session_id', + '正向不验 session_id'), + (m_remove_negative_anchor, 'gone', '负向:/report 里有 epg-bad 失败记录', + '负向缺 /report 正向锚点'), + (m_remove_reason, 'gone', '负向:从 /report 里提取 reason 字段', + '负向不判失败原因'), + (m_break_204, 'gone', '负向:坏期望态提交须判 204', + '坏期望态提交判据放宽成「不是 000」'), + (m_break_000, 'gone', '鉴权:正确密钥须精确判 200', + '鉴权正向判据放宽成「不是 000」'), + (m_break_neg_gate, 'gone', 'neg_gate:按期望拒绝特征 grep 判定', + 'neg_gate 退化成「有输出就算拒」'), + (m_remove_kbs_owned, 'gone', 'KBS:输出本轮实例归属标记', + 'KBS 归属标记退化成端口就绪'), + (m_break_key_delivery, 'gone', '密钥:校验远端收到的字节数', + '不校验共享密钥真送达'), + (m_break_final_gate, 'gone', '结论:FAIL_N 非 0 时真的 exit 1', + '最终结论不收口'), + (m_remove_cleanup, 'gone', '收尾:端点收回是显式通过判据', + '收尾不判端点收回'), + (m_break_order, 'added', '正向守卫(epg_ok)位于负向期望态之前', + '文件头注入早期负向锚点(顺序反转)'), +] + + +def main(): + print('=== 真机端点公布门禁 · 破坏实验 ===') + print('(每条判据都破坏一次,要求自测脚本必须转红)') + print('') + for mutate, mode, expect, label in VARIANTS: + print(' · %s' % label) + _variant(label, mutate, mode, expect) + print('') + print('=== 结果:%d 通过 / %d 失败 ===' % (OK_N, FAIL_N)) + if FAIL_N: + sys.exit(1) + print('CLUSTER_ENDPOINT_GATE_BREAK_OK: 全部破坏实验都被抓到(判据非恒绿)') + sys.exit(0) + + +if __name__ == '__main__': + main() diff --git a/tools/selftest-cluster-endpoint-gate.py b/tools/selftest-cluster-endpoint-gate.py new file mode 100644 index 0000000..88afb94 --- /dev/null +++ b/tools/selftest-cluster-endpoint-gate.py @@ -0,0 +1,231 @@ +#!/usr/bin/env python3 +"""真机端点公布门禁(cluster-endpoint-gate-e2e.sh)的判据自测。 + +# 这条判据守的是什么 + +`deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh` 是**真机**脚本 +(AMD SNP + 海光 CSV 双节点 + 真 KBS 芯片验签)。真机不在门禁环境里 +⇒ 它的判据逻辑**永远不会被执行**。而它有几类典型的**静默失效**: + +1. **正向没过就判负向** —— 「sessions 数组为空」在控制面没起、没节点、 + 没会话时**恒为真** ⇒ 负向「零外泄」毫无意义; +2. **正向只判数组非空** —— 一个空壳端点也能让数组非空,必须验 + `endpoint` 指向真实节点 + `session_id` 正确; +3. **负向缺正向锚点** —— 「坏会话不在 sessions 里」若没有 + `/report` 的 `epg-bad` 失败记录做锚点,可能只是「期望态没被收到」; +4. **失败记录不带原因** —— 排障价值归零,且容易与「泛泛失败」混淆; +5. **`000` 判假绿** —— 控制面没起来时 curl 返回 `000`, + `000 != 200` 被当成「错密钥被拒」; +6. **KBS 假就绪** —— 端口 LISTEN 不等于**本轮参数**的实例在跑, + 旧实例占端口时新实例 bind 失败但脚本照样判绿; +7. **最终结论不收口** —— `FAIL_N` 非 0 仍打印 `CLUSTER_ENDPOINT_GATE_OK`。 + +# 纪律 + +- 判据只查**代码形态**,不查注释里的字样 ⇒ 先 `_strip_comments()`; + 查注释会「自指型假绿」(删了代码注释还在照样绿), + 查裸字符串会「自指型假红」(注释里的历史说明把自己判红)。 +- 每条判据都由 `selftest-cluster-endpoint-gate-break.py` **破坏一次**, + 要求本脚本必须转红,并且**双向确认变异真的生效**(证据串消失/新增)。 +- 全程不碰真机、不解密任何真口令。 + +用法: + python3 tools/selftest-cluster-endpoint-gate.py +""" + +import os +import re +import sys + +HERE = os.path.dirname(os.path.abspath(__file__)) +ROOT = os.path.dirname(HERE) +SCRIPT_REL = os.path.join('deploy', 'tee', 'real-machine', + 'cluster-endpoint-gate-e2e.sh') +SCRIPT = os.path.join(ROOT, SCRIPT_REL) + +OK_N = 0 +FAIL_N = 0 + + +def ok(msg): + global OK_N + OK_N += 1 + print('ok %s' % msg) + + +def fail(msg): + global FAIL_N + FAIL_N += 1 + print('FAIL %s' % msg, file=sys.stderr) + + +def _read_script(): + with open(SCRIPT, encoding='utf-8') as f: + return f.read() + + +def _strip_comments(src): + """剥掉整行注释 + 行内注释 ⇒ 只看**代码**。""" + return '\n'.join(ln.split(' #')[0] for ln in src.splitlines() + if not ln.strip().startswith('#')) + + +def _require(cond, msg): + if cond: + ok(msg) + else: + fail(msg) + + +# ── 判据 ──────────────────────────────────────────────────────────────── +def check_positive_guard_before_negative(code): + """① 正向守卫必须**先于**负向段:否则空集通过。""" + pos_guard = code.find('if [ "$epg_ok" -ne 1 ]; then') + pos_neg = code.find('BAD_SESSION_ID=') + _require(pos_guard >= 0 and pos_neg > pos_guard >= 0, + '正向守卫(epg_ok)位于负向期望态之前') + + +def check_positive_guard_really_exits(code): + """② 正向没过必须 `exit 1` —— 不能继续判负向。""" + m = re.search(r'if \[ "\$epg_ok" -ne 1 \]; then([\s\S]{0,3000}?)\nfi', code) + _require(m is not None and 'exit 1' in m.group(1), + '正向失败分支里真的 exit 1(不继续判负向)') + + +def check_positive_content_verdicts(code): + """③ 正向除「数组非空」外,必须验端点地址 + session_id。 + + ★ 这里必须匹配**整条 grep 判据**,不能只查 `endpoint` / `$AMD_HOST:3010` + 字样:脚本里 `ok` / `fail` 的提示文本、收尾的 `grep -q '"endpoint"'` + 都含这些字样,宽泛匹配会让「删掉内容判据」的变异照样绿 + (2026-11-09 破坏实验实测抓到过这个自测自身的恒绿)。 + """ + _require('grep -o \'"session_id"\' | wc -l' in code, + '正向:按 session_id 计数判数组非空') + _require('grep -q "\\"endpoint\\":\\"$AMD_HOST:3010\\""' in code, + '正向:端点必须指向真实节点地址(不是空壳)') + _require("grep -q '\"session_id\":\"epg1\"'" in code, + '正向:端点必须带正确的 session_id') + + +def check_negative_positive_anchor(code): + """④ 负向必须有 `/report` 的 epg-bad 失败记录做正向锚点。""" + _require("printf '%s' \"$report\" | grep -q 'epg-bad'" in code, + '负向:/report 里有 epg-bad 失败记录(否定式判据的正向锚点)') + + +def check_negative_reason(code): + """⑤ 失败记录必须带 reason 字段且判非空。""" + _require('reason=$(printf' in code and '"reason"' in code, + '负向:从 /report 里提取 reason 字段') + _require('if [ -n "$reason" ]' in code, + '负向:reason 非空才算通过') + + +def check_bad_desired_submission_checked(code): + """⑥ 坏期望态提交必须判 204(否则期望态没收到也判绿)。""" + _require('if [ "$code_bad" = "204" ]; then' in code, + '负向:坏期望态提交须判 204,失败即退出') + + +def check_bad_session_not_in_sessions(code): + """⑦ 负向必须精确查坏会话 id 不在 sessions_bad 里。""" + _require("printf '%s' \"$sessions_bad\" | grep -q 'epg-bad'" in code, + '负向:按 session_id 精确查坏会话未出现在已公布端点里') + + +def check_auth_no_false_green_on_000(code): + """⑧ 正确密钥必须判 200 且失败即退出;错密钥必须带 401 特征。""" + _require('if [ "$code_ok" = "200" ]; then' in code, + '鉴权:正确密钥须精确判 200(不是「不是 000」)') + idx = code.find('if [ "$code_ok" = "200" ]; then') + tail = code[idx:idx + 1200] if idx >= 0 else '' + _require('exit 1' in tail, + '鉴权:正确密钥 200 失败时真的 exit 1') + _require("neg_gate '错密钥 401'" in code and "'401'" in code, + '鉴权:错密钥负向带期望拒绝特征 401') + + +def check_neg_gate_uses_expected_feature(code): + """⑨ 启动期负向必须按期望拒绝特征判定,不是只判「有输出/非 0」。""" + _require('if printf \'%s\' "$o" | grep -q "$want"; then' in code, + 'neg_gate:按期望拒绝特征 grep 判定(不只判失败)') + + +def check_kbs_owned_positive_anchor(code): + """⑩ KBS 必须有「本轮实例」正向证据,不能只判端口 LISTEN。""" + _require('echo EPG_KBS_OWNED_OK' in code, + 'KBS:输出本轮实例归属标记 EPG_KBS_OWNED_OK') + _require("grep -q 'EPG_KBS_OWNED_OK'" in code, + 'KBS:判据只认本轮归属标记(不是端口有响应)') + _require('tr \'\\0\' \' \' < /proc/$PID/cmdline' in code + or 'tr \'\\0\' \' \' < /proc/' in code, + 'KBS:归属证据来自本轮进程 cmdline') + + +def check_key_delivery_verified(code): + """⑪ 共享密钥必须校验真的送达(长度),不进 argv。""" + _require('got_len=$(remote' in code and 'want_len' in code, + '密钥:校验远端收到的字节数(remote_put 的 stdin 没被丢)') + _require('printf \'%s\' "$CLUSTER_SECRET" | remote_put' in code, + '密钥:经 stdin 通道送达,不进远端命令行 argv') + + +def check_final_gate(code): + """⑫ 只有 FAIL_N==0 才允许打印成功结论。""" + _require('[ "$FAIL_N" -eq 0 ] || exit 1' in code, + '结论:FAIL_N 非 0 时真的 exit 1') + _require('CLUSTER_ENDPOINT_GATE_OK' in code, + '结论:成功后输出 CLUSTER_ENDPOINT_GATE_OK') + idx_fail = code.rfind('[ "$FAIL_N" -eq 0 ] || exit 1') + idx_ok = code.rfind('CLUSTER_ENDPOINT_GATE_OK') + _require(idx_fail >= 0 and idx_ok > idx_fail, + '结论:成功标记在收口判据之后(不可提前外泄)') + + +def check_cleanup_reclaims_endpoint(code): + """⑬ 收尾清空期望态后必须判端点已收回。""" + _require("'{\\\"sessions\\\":[]}'" in code, + '收尾:提交空期望态') + _require("printf '%s' \"$rest\" | grep -q '\"endpoint\"'" in code, + '收尾:清空后必须判无 endpoint(实例真回收)') + _require('ok "期望态清空后端点已收回' in code, + '收尾:端点收回是显式通过判据') + + +CHECKS = [ + check_positive_guard_before_negative, + check_positive_guard_really_exits, + check_positive_content_verdicts, + check_negative_positive_anchor, + check_negative_reason, + check_bad_desired_submission_checked, + check_bad_session_not_in_sessions, + check_auth_no_false_green_on_000, + check_neg_gate_uses_expected_feature, + check_kbs_owned_positive_anchor, + check_key_delivery_verified, + check_final_gate, + check_cleanup_reclaims_endpoint, +] + + +def main(): + print('=== 真机端点公布门禁 · 判据自测 ===') + if not os.path.isfile(SCRIPT): + fail('找不到脚本:%s' % SCRIPT) + sys.exit(1) + code = _strip_comments(_read_script()) + for chk in CHECKS: + chk(code) + print('') + print('=== 结果:%d 通过 / %d 失败 ===' % (OK_N, FAIL_N)) + if FAIL_N: + sys.exit(1) + print('CLUSTER_ENDPOINT_GATE_SELFTEST_OK: 端点公布判据自测全绿') + sys.exit(0) + + +if __name__ == '__main__': + main()