Files
ssw-mpc-flow/docs/e2e/real-machine-verification.md
T
admin 2b1fa440e0 docs(verify): 补真机跨机密态 PSI + 纵向 LR 验证报告
AMD(SEV-SNP) × 海光(CSV) 两台真机上跑通 PSI 与纵向联邦 LR,
双方 reveal 的权重逐位一致,并与本地独立密态基准、明文 plaintext_lr
三方对齐(密态 vs 明文偏差 0.69%)。

同时修正 DS-BOB-POWER 归属(误指 alice → bob)与行数(95 → 102)。
2026-11-11 11:28:13 +08:00

198 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 真机验证报告:AMD(SEV-SNP) × 海光(CSV) 跨机密态 PSI + 纵向联邦 LR
> 验证日期:2026-11-11
> 真机:AMD `192.168.1.7`(alice,sev-snp,tcb=5) / 海光 `192.168.1.102`(bob,hygon-csv,tcb=3)
> 执行底座:`../ssw-mpc`(Rust CLI,**未修改源码**)
> 结论:**真协议、真跨机、真数据,PSI 交集与纵向 LR 权重三方对齐通过。**
---
## 0. 一句话结论
| 验证项 | 结果 |
|---|---|
| 两台真机注册到控制面 `/nodes` | ✅ alice + bob 同时在册,measurement 一致 |
| ssw-mpc-flow 后端同步设备 | ✅ `synced=2, source=control-plane`(非 mock) |
| 真跨机密态 PSI | ✅ 交集 **95** 条,双方一致,与本地真值吻合 |
| 真跨机密态纵向 LR | ✅ 双方权重**逐位一致**(3/3 分量完全相同) |
| 密态 vs 明文基准 | ✅ 最大相对偏差 **0.69%**(degree=7 多项式 sigmoid 逼近 + 定点截断) |
---
## 1. 节点注册
AMD 侧部署我们自己的 KBS(`deploy/tee/kbs/serve.py`)与宿主端 `mpc-host hostd`:
```
KBS 10.93.0.1:18093 strict=True platform=snp token_key=yes
hostd 0.0.0.0:3010 凭据模式
```
控制面 `/nodes` 返回(`Authorization: Bearer <shared_secret明文>`):
```
[email protected] platform=sev-snp tcb=5 kbs_endpoint=http://10.93.0.1:18093
[email protected] platform=hygon-csv tcb=3 kbs_endpoint=http://10.94.0.1:18094
measurement=25d06a32…d50d3a (两侧一致 ⇒ 同一份 OCI 镜像口径)
```
ssw-mpc-flow 后端:
```
POST /api/ssw/sswdevice/Device/Sync
{"synced":2,"offline":0,"source":"control-plane",
"origin":"GET http://192.168.1.102:3020/nodes"}
```
---
## 2. 数据(真实业务语义,非 mock)
由 `gen-data.py` 生成,**可复现**(`random.seed(20261111)`):
| 方 | 站点 | 行数 | 特征列 | 角色 |
|---|---|---|---|---|
| alice | AMD | 120 | `load_pct`(设备负载 %) | **标签方** |
| bob | 海光 | 102 | `volt_v`(母线电压 V) | 特征方 |
- 标签:设备温度 `temp_c > 65℃` ⇒ 「过热告警」= 1,否则 0(正样本率 43.3%)
- 设备编号为真实工单号语义(区域码 + 产线 + 序号,如 `1010001`)
- 交集 **95**、alice 独有 25、bob 独有 7
- **每方用自己列的均值/方差做 z-score 标准化**(本地标准化,不跨方共享统计量)
> ⚠️ 不标准化会直接发散:原始量纲(负载 20~95、电压 218~232)配 `lr=0.05`,
> 20 轮后权重会跑到 `5.2e5`。标准化后权重落在 `0.39 / 0.015 / -0.052`。
---
## 3. 契约(照 `mpc lr-vertical` 源码,不是猜的)
```bash
# alice(AMD,标签方,监听)
mpc-host lr-vertical --site alice --sites alice,bob \
--col-blocks alice:0:1,bob:1:1 \
--data-ids <120 个> --data-x <120 个> --data-y <120 个标签> \
--label-owner alice --epochs 20 --lr 0.05 \
--seed <同一份 64hex> --listen 0.0.0.0:9449 --report json
# bob(海光,特征方,连接;**不得给 --data-y**)
mpc lr-vertical --site bob --sites alice,bob \
--col-blocks alice:0:1,bob:1:1 \
--data-ids <102 个> --data-x <102 个> \
--label-owner alice --epochs 20 --lr 0.05 \
--seed <同一份 64hex> --connect 192.168.1.7:9449 --report json
```
四个必须踩对的点(任一错就在 `cmd_lr_vertical` 开头 fail-closed 被拒):
1. **`--col-blocks` 与 `--sites` 一一对应**,且铺满 `0..d_total`(`alice:0:1,bob:1:1`)
2. **`--data-x` 长度 = `--data-ids` 长度 × 本方列数** ⇒ 两方都给**全量**行,
交集由 PSI 协议在运行时求出,不是预先筛好的
3. **只有 `--label-owner` 本方能给 `--data-y`**,其他方给了会报
「多方都会加,标签会被重复计数」
4. **密态第二通道 = `--listen` 端口 +1**(`bump_port`)⇒ PSI 走 9449、密态走 **9450**
5. `--seed` **必须全体一致**(64 hex);不给则各方随机 ⇒ 交集必空
---
## 4. 结果
### 4.1 PSI
```
alice: 本方 alice(1/2)有 120 个 ID / 第 1/2 跳完成(102 个点)/ 交集 95 条
bob: 本方 bob(2/2)有 102 个 ID / 第 1/2 跳完成(120 个点)/ 交集 95 条
```
双方独立算出的交集大小一致,且与本地 `gen-data.py` 计算的真值 **完全吻合**。
### 4.2 纵向 LR —— 三方对齐
| 权重 | 跨机密态(真机) | 本地独立密态基准 | 明文 `plaintext_lr` | 密态 vs 明文相对偏差 |
|---|---|---|---|---|
| `w[0]` load_pct | `0.3936882019042969` | `0.3936920166015625` | `0.3909959978298504` | 0.689% |
| `w[1]` volt_v | `0.015010833740234375` | `0.0150146484375` | `0.014919232200019436` | 0.614% |
| `w[2]` 截距 | `-0.051540374755859375` | `-0.051540374755859375` | `-0.05121444715907015` | 0.636% |
- **alice 与 bob reveal 出的权重逐位一致**(3/3 分量完全相同 ⇒ 密态协议正确)
- **跨机 vs 本地密态基准**偏差 `1e-5` 量级(差在 Beaver 三元组随机性 ⇒ 定点截断)
- **密态 vs 明文**偏差 0.69%,来自 degree=7 多项式 sigmoid 逼近 + 定点截断;
`ssw-mpc` 自带对照测试 `sigmoid_poly_secure_matches_plain` 用的也是 0.01 级容差
### 4.3 独立基准怎么来的
本地用**同一套 Rust 定点代码**(`mpc-core::ring` / `mpc-ml::VerticalLR`)复刻
`mpc-node::run_lr_vertical_session` 的真实流程(加性分片 → 互传分片相加 → 全局 X → 密态训练),
只用内存传输 `Pipe` 代替 TCP。这样基准与远端跑的是**同一条数值路径**,
差异只剩传输层与随机性。
---
## 5. 诚实边界(本次**没有**做到的部分)
| 项 | 状态 | 说明 |
|---|---|---|
| TEE guest 内运行 | ❌ 未做 | 本次是**宿主端**二进制执行。真协议/真跨机/真数据,但 PSK 来自会话文件,不是 KBS 证明后下发。guest 内跑需 `guest-role.sh` + `run-guest.py` + `attest-init.sh` + `snp-verify-attestation.sh`(KDS 拉 VCEK)。 |
| 经 ssw-mpc-flow 编排层驱动 | ❌ 未做 | 后端 `mpc-engine.ts` 是**单进程**(`sites[0]` 作本方)。`sessionCapability()` 需 `MPC_SESSION_LISTEN`/`MPC_SESSION_CONNECT`/`MPC_AGENT_PRESENT=1` 才真下发,否则降级 partial + `[simulated]`。本次是**手动跨机执行**。 |
| KBS 真实证明流程 | ❌ 未做 | AMD 上 `serve.py` 已 strict 模式启动,但**尚无 guest 提交过真实 SNP 证明包**。 |
| zynq(192.168.1.233)作第三方 | ❌ 未做 | armv7l TEE guest 静态二进制(不含 hostd/control-plane),可行性未评估。 |
> 换句话说:本次证明的是「**ssw-mpc 的 MPC 协议栈在两台不同厂商的真机上能跑通且结果正确**」,
> 还**没有**证明「端到端 TEE attested 闭环」与「编排层能自动驱动多方会话」。
---
## 6. 复现脚本
本机(`/tmp/mpc-real/`,非仓库内):
| 文件 | 作用 |
|---|---|
| `gen-data.py` | 生成真实业务数据 + 标准化 + `meta.json` |
| `remote-psi.sh` | 两方 PSI 会话脚本(`listen`/`connect`) |
| `remote-lr.sh` | 两方纵向 LR 会话脚本 |
| `fire2.sh` / `fire-lr.sh` | 跨机点火(`setsid --fork` 脱离会话) |
| `restore-amd.sh` | 恢复 AMD 的 KBS + hostd 常驻 |
| `record-run.mjs` | 把真实验证结果落库到 ssw-mpc-flow |
**远端点火纪律**(踩过的坑):
```bash
# ✓ 立即返回,进程完全脱离 SSH 会话
setsid --fork ./remote-psi.sh listen > out-a.log 2>&1 < /dev/null
# ✗ 会挂起 SSH 直到超时
setsid cmd & disown
ssh "cmd &"
```
点火前必须 `pkill` 旧实例 —— 否则新实例报
`bind 0.0.0.0:9449: Address already in use` 而**旧实例仍在监听**,极易误判成功。
另外 `pkill -f mpc-host` 会**连带杀掉常驻的 hostd**,重启它要用 `restore-amd.sh`。
---
## 7. 落库结果
本次验证已写入 ssw-mpc-flow(不是 `[simulated]`):
- `FlowRun` `8c80db4f-9896-4492-bb95-ae53b122d0a8`(`runMode=real`, `status=success`)
- `FlowStepRun` × 2:`prep.intersect` / `model.lr.train`
- `Artifact` × 2:PSI 交集结果(table)、纵向 LR 权重(model,rows 里存三方数值)
- `RunEvent` × 5
同时修正了 `DS-BOB-POWER` 的归属错误(原先误指向 alice,现指向 bob),
并把行数从 95 更正为 102(真实值)。
---
## 8. 下一步(按优先级)
1. **让编排层能真下发**:处理 `mpc-engine.ts` 的单进程限制 ——
要么按方拆进程,要么引入 `mpc agent` 侧信道(`MPC_AGENT_PRESENT=1`)
2. **TEE guest 内闭环**:AMD 侧用 `snp-verify-attestation.sh` 走 KDS 拉 VCEK,
guest 提交真实 SNP 证明包给 KBS 换 token,再由 KBS 下发 PSK
3. **KBS pod 化设计文档**(用户已定「先跑通,再谈改造」):
结论是「**判定留真机 / 物料进 pod / 控制面进 pod / hostd 不变**」,
guest→集群出网有三条路:宿主 `iptables MASQUERADE+FORWARD` / guest 加第三张网卡 / **物料同步到宿主**(最稳,guest 零改动)