docs(cluster): 端点公布门禁沉淀为文档与门禁资产

- 新增 cluster-endpoint-gate 判据自测 25 条 + 破坏实验 14 条,并入主门禁第 25 条(总数仍 25)

- README / INDEX / CLAUDE / 真机 README 与 env 样例补齐集群端点门禁入口、参数与速查

- 架构文档 §0/§1.6/§4/§5/§8/§9 由 [桩验] 改为 [实证],保留演练级、pending 超时回收等诚实边界

- FINDINGS 新增 §11:链路、两道门、5 类真 bug、判据纪律、产物与复现入口

- ARCHITECTURE_SYSTEM.html 由 md 重新生成并校验同步
This commit is contained in:
admin committed 2026-11-09 20:43:31 +08:00
1 parent 32419efc27
commit 0c4bad6718
11 files changed
+776 -47

No files matched your search

+4 -1
View File
@@ -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` 又不是纯数字``,判据先命中注释 ⇒ 凭空转红(自指型假红,同类问题第二次踩到)。
明细以脚本自身为准(**闸门不扫自己就是盲区**)。
+2 -1
View File
@@ -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);
+30
View File
@@ -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+ 个探索脚本怎么办
@@ -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 段另起一套拓扑。
+48 -13
View File
@@ -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 口径,解析失败拒收、不写半条记录)→ <code>NodeReg
<p><strong>每会话专属绑定</strong>:<code>DesiredSession.binding: Option&lt;SessionBinding&gt;</code> 优先于
控制面全局绑定。绑定值写进芯片报告 <code>user_data</code>,两个会话共用一份绑定等于
两份报告可互相冒用(重放)。</p>
<p><strong>状态</strong>:[桩验] 真 socket 端到端门禁已跑通完整闭环,且用<strong>假 hostd</strong> 给
「端点不外泄」补了正向对照(证明通过 ⇒ 端点真的出现;证明不齐 ⇒ 端点被收回),
避免否定式判据因 <code>create</code> 恒失败而恒真(空集通过)。但节点是本机假 hostd /
不可达节点,<strong>不等于真机集群调度已跑通</strong> —— 见 §8。</p>
<p><strong>状态</strong>:[真机实证] 2026-11-09 完整闭环已在两台真机上跑通,入口
<code>deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh</code>(判据
<code>CLUSTER_ENDPOINT_GATE_OK</code>,20 通过 / 0 失败)。链路:两台 hostd 自报 →
控制面非回环监听(共享密钥 + 显式 <code>--allow-remote</code>)→ 期望态 per-session
绑定 → 选址下发 <code>create</code> → 真机双网卡 guest → KBS <strong>芯片验签</strong> →
guest 经 9p 手牌回传原始证明包 → hostd 独立判定(四布尔 + 三态)→
对账器 <code>proven_endpoints()</code> → <code>GET /sessions</code> 公布
<code>{&quot;endpoint&quot;:&quot;192.168.1.7:3010&quot;,&quot;session_id&quot;:&quot;epg1&quot;}</code>。
负向:绑定度量对不上的 <code>epg-bad</code> 零外泄,且 <code>/report</code> 有带原因的失败记录;
清空期望态后端点收回。★ 端点公布有<strong>两道门</strong>:<code>is_verified()</code> 决定实例去留,
<code>publishable(require_chip_sig)</code> 决定端点是否外泄(默认要求芯片验签)。
此前「真 socket + 假 hostd」的桩验仍保留为正向对照,但已不是唯一证据。
★ 联调脚本的 4 个必挂缺陷(xop WARN 走 stdout 污染返回值、<code>printf</code> 前导
<code>---</code> 被当选项、<code>remote()</code> 里被覆盖的 <code>&lt; /dev/null</code> 假防护、以及 <code>2&gt;&amp;3</code>
把 ssh 客户端 Warning 又收回 fd3)由 <code>cluster-endpoint-gate-e2e.sh</code> 同套
<code>remote()</code>/fd3 范式在真机完整复跑覆盖;<code>cluster-selfreport-e2e.sh</code> 自身
仍未单独复跑,别把两份脚本混为一谈。</p>
<h3 id="sec-10">1.7 SA 扩展模式(安全锚点供能力、算力挂外部 VM)</h3>
<p>这是<strong>第四种平台形态</strong>,与 §6 矩阵里的 CSV/SNP、OP-TEE 都不同:算力<strong>不在</strong>安全世界里,
安全世界只<strong>供能力</strong>。</p>
@@ -650,11 +663,18 @@ guest([实证]) 只做计算与出证明,不持链
→ 跨物理机密文会话 → 两侧还原 35.000000
判据 TEE_ATTEST_GATE_OK 判据 TEE_PAIR_OK
</code></pre>
<p>集群面是第三条<strong>同一次运行</strong>的实证链路(2026-11-09,
<code>deploy/tee/real-machine/cluster-endpoint-gate-e2e.sh</code>):</p>
<pre><code class="language-text">双节点 hostd 自报 → /desired(per-session 绑定)→ 选址下发 create
→ 真 guest 采证明 → KBS 芯片验签 → 9p 手牌回传原始证明包
→ hostd 独立判定(四布尔)→ 对账 → proven_endpoints() → GET /sessions
判据 CLUSTER_ENDPOINT_GATE_OK(20/0;负向 epg-bad 零外泄 + 带原因)
</code></pre>
<p>链侧对应的是另一条独立实证链路(<code>tools/selftest-fisco-contract.py</code>,主门禁第 22 条):</p>
<pre><code class="language-text">dataHash → TARS 编码已签名交易 → sendTransaction(4 参)→ receipt(status==0)
→ 部署 MpcHardRule.sol → recordHardRule → call 读回 → 负向矩阵
</code></pre>
<p><strong>两条链路目前没有合流</strong>:TEE 证明未上链、未绑定链上状态位;
<p><strong>三条链路目前没有合流</strong>:TEE 证明未上链、未绑定链上状态位;
链上撤销状态位读取后端未接入(声明 chain 即 fail-closed 拒)。这是当前最重要的架构缺口,
不是「已经打通的端到端」。</p>
<p>组网事实(踩过坑,别重犯):跨 guest 走 qemu <code>socket</code>(二层),访问宿主 KBS 走 <code>tap</code>
@@ -697,6 +717,12 @@ guest([实证]) 只做计算与出证明,不持链
<td>本机 <code>127.0.0.1:3010</code></td>
</tr>
<tr>
<td><code>mpc control-plane</code>(集群面)</td>
<td><code>192.168.1.102</code> 海光 CSV(与 hostd 同机,演练)</td>
<td>❌ 宿主进程</td>
<td><code>0.0.0.0:3020</code>(非回环;共享密钥 + <code>--allow-remote</code> 才放行)</td>
</tr>
<tr>
<td>本机 <code>fisco-gm</code></td>
<td>macOS Docker 容器(<strong>已 stop 未删</strong>,可回滚)</td>
<td>❌ 容器</td>
@@ -800,7 +826,7 @@ TA 是所有 CA 共享的,没有「这个 TA 属于哪个租户」的进程语
<tbody>
<tr>
<td>主门禁</td>
<td><code>tools/ci.sh</code>,<strong>24 条</strong></td>
<td><code>tools/ci.sh</code>,<strong>25 条</strong></td>
<td>缺环境显式 <code>*_SKIPPED</code>;闸门不扫自己 = 盲区,lint 含 <code>tools/</code></td>
</tr>
<tr>
@@ -854,11 +880,19 @@ TA 是所有 CA 共享的,没有「这个 TA 属于哪个租户」的进程语
<li>OP-TEE <strong>QEMU 实跑已做</strong>(2026-11-09,<code>docs/OPTEE_VERIF_PLAN.md</code> 有完整证据表):全流程 selftest、第 5 条跨设备解封被拒、第 4 条跨重启 unseal 成功三条<strong>都真跑通了</strong>。但那是 <strong>QEMU 模拟</strong>(<code>dna</code> = 编译期 sha256 种子,HUK = 模拟值)⇒ <strong>不是</strong>真板的设备绑定证据,<strong>不能</strong>替代真板一次性验收;<code>CryptoPrecompiled.sm2Verify</code> 真机对拍未做;<code>tools/fisco-realnode-probe.py</code> 的 4 处 <code>IMPL_GAPS</code> 未销账。</li>
<li>本租户 SA 无 <code>create secret</code> 权限;链客户端私钥 <code>MPC_FISCO_KEY</code> 保持仓库外,不进镜像 / ConfigMap / git。</li>
<li>站点端控制面是 [设计] 决策角色,不是已实现的独立服务;别把 §2 的职责矩阵当成已部署清单。</li>
<li><strong>集群控制面只在假 hostd / 不可达节点上验过框架契约</strong>:<code>mpc control-plane</code>
的「收自报 → 注册表 → 期望态 → 选址 → 下发 → 证明门控 → 公布端点」闭环
在真 socket 门禁里全绿,但节点是本机假 hostd(证明结论可控)或不可达节点;
真机多节点自报、跨网段暴露、真 KBS 验签后的会话端点交付<strong>未做</strong>。
别把 §1.6 当成已部署的集群清单。</li>
<li><strong>集群面闭环已真机实证,但仍是演练级</strong>:2026-11-09
<code>cluster-endpoint-gate-e2e.sh</code> 在 AMD SNP + 海光 CSV 上跑通
「自报 → 非回环暴露 → 真 KBS 芯片验签 → 独立判定 → 端点公布」
(<code>CLUSTER_ENDPOINT_GATE_OK</code>,20 判据)。但共享密钥是<strong>本次运行随机生成</strong>、
控制面非回环监听只在演练里开过 ⇒ <strong>不宣称</strong>生产级鉴权/密钥轮转、
跨公网暴露、控制面 HA 与持久化已验证。§1.6 现在可以当已实证清单读,
但只到这一条链路为止。</li>
<li><strong>判据自测不是真机证据</strong>:端点门禁的 25 条判据自测 + 14 条破坏实验
(主门禁第 25 条)证明的是「判据不恒绿」,<strong>不是</strong>「真机再跑一次必过」。
真机结论只来自那一次完整运行;<code>cluster-selfreport-e2e.sh</code> 自身未单独复跑,
只被同套 <code>remote()</code>/fd3 范式覆盖。</li>
<li><strong>pending 超时回收策略未做</strong>:证明长时间不落的 <code>pending</code> 会话目前不会
因超时被回收(只等证据或期望态清空)。这是已知设计缺口,不是已实现能力。</li>
<li><strong>SA 扩展模式只证明了「接口与边界形状成立」,不是「<code>K_root</code> 硬件隔离成立」</strong>(§1.7):
板端 SA 的 <code>K_root</code> 是<strong>软件</strong>生成与持有的(板子无硬件密钥槽),SA 自曝
<code>platform=none</code> / <code>hardware_protected=false</code>。⇒ <strong>阶段一不能进密评</strong>。
@@ -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
</code></pre>
<p><strong>更新纪律</strong>:本文是 A 类活文档,事实变了就改;但不得复制判据逻辑、不得写死门禁条数
+44 -27
View File
@@ -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
```
+1
View File
@@ -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`) |
+136 -1
View File
@@ -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 验签首次要联网)。
+13 -4
View File
@@ -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
@@ -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()
+231
View File
@@ -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()