Files
ssw-mpc/docs/SA_EXTENDED_MODE.md
admin bcad01d697 feat(sa): SA 扩展模式真机端到端跑通 + 修掉主门禁被误删的 5 条
SA 扩展模式(安全锚点供能力、算力挂外部 VM):
- 板端 SA 服务端 ↔ OrbStack 外挂 VM 端到端跑通,判据 26/26
- seal/unseal/attest/sign + 会话物料全部可用;VM 侧拿不到 K_root
  (site 名骗不出、协议无导出端点、VM 侧无根密钥文件)
- 阶段一边界写死为 platform=none,不假装有硬件根

零种子守卫(fail-closed):
- CLI 入口(连网之前)+ Vault::new 双层拒绝全零主种子
- mpc node 的种子校验原本在连网 + Ray 注册之后,失败会伪装成「网络问题」,已前移
- 判据 18 条,两处破坏实验证明非恒绿

主门禁回归修复(本次最重要):
- 27cbdc7 删掉了 ci.sh 的第 18-22 条共 5 个 step,判据脚本都还在、
  只是不再被调用 ⇒ 门禁静默削弱(文件在、判据在、门禁不跑)
- 已从 237e646 原样恢复,SA 与零种子守卫顺延为第 23/24 条,总数回到 24
- 头部注释编号与 step 号重新一一对齐

新发现的真缺陷与盲区:
- help 文本与实现漂移:attest-upload 的 --upload-path-file 漏写(实现里必填),
  SA 客户端五个必填参数全没写进帮助 ⇒ 静默失败,代码照编译门禁照全绿
- 加两条守卫测试,并修掉判据的自指型假绿(查裸字符串恒为真,要查解析调用)
- shell lint 不扫 deploy/arm,而那里是板端真跑的脚本 ⇒ 抓到 4 处 var-ascii 命中,
  已修并把 deploy/arm 纳入扫描范围(35 → 38 个脚本)
- hostd 客户端补 .no_proxy():代理会把这一跳端点换掉,症状是 502 伪装成控制面没起来

门禁:tools/ci.sh 全量 EXIT=0,24 条全绿(第 22 条真链批缺环境显式 SKIPPED)。
2026-11-09 16:32:36 +08:00

12 KiB
Raw Permalink Blame History

SA 扩展模式 —— 安全锚点供能力,算力挂外部 VM

状态(2026-11-09):[实证] 板端 SA 服务端 ↔ OrbStack 外挂 VM 的端到端已真跑通, 判据 26/26 全绿。阶段一形态是「接口与边界形状成立」, 不是「K_root 硬件隔离成立」—— 详见 §6 诚实边界。

定位:B 类专题设计(结论稳定,不含进度)。 实现:协议与能力在 crates/mpc-tee/src/sa/;CLI 入口在 crates/mpc-cli/src/sa.rs。 判据:本机契约 tools/selftest-sa.py(主门禁第 23 条); 真机端到端 deploy/arm/zynq7015/sa-pair-e2e.sh(26 条)。


1. 为什么是这个形态

用户的方向(2026-11-09):

zynq7015 计算能力有限,能不能把它弄成扩展模式,外部挂 vm, 涉及安全/加解密/隐私部份在 sa,可通用计算在外挂 vm。

Zynq-7015 的实测能力(Cortex-A9 双核 @666MHz、497MB RAM、无 /dev/kvm、 busybox 1.24.1、glibc 2.26)决定了它跑不动通用计算。

但安全世界需要的能力很轻:密钥派生、真随机、签名、出域判定 —— 这些在 666MHz 上完全跑得动,而矩阵乘、训练、IO 在上面很吃力。

⇒ 把能力留在安全世界、把算力外挂,是让两者各跑在擅长的硬件上。


2. 形态

  ┌─────────────────────────────┐            ┌──────────────────────────────┐
  │ 外挂 VM(算力,x86_64)      │            │ Zynq-7015 板(armv7)        │
  │                             │            │                              │
  │  算法层                     │            │  ┌────────────────────────┐  │
  │   mpc-vault / mpc-fl / psi  │  只传分片  │  │ SA 服务端(sa-serve)   │  │
  │        ↓                   │ ─────────▶ │  │  持 K_root,永不导出    │  │
  │  SaClient(实现 Tee trait) │  HTTP/1.1  │  │                        │  │
  │        │                   │ ◀───────── │  │  只提供四个能力:       │  │
  │  mpс-vault / mpс-fl / psi  │  响应      │  │  seal/unseal/attest/sign│  │
  │                             │            │  │  + 下发会话物料         │  │
  └─────────────────────────────┘            │  └────────────────────────┘  │
                                               └──────────────────────────────┘

关键点:SA 不承载算法。 VM 与 SA 之间只传分片和密文, 不是「把矩阵乘搬进安全世界」。这条一旦破口,安全世界就变成「慢一点的普通机器」, 而信任模型(SA 不接触算法数据)就悄悄失效了。


3. 三条铁律

# 铁律 为什么 怎么守
1 SA 不承载算法 开了「在安全世界里执行计算」的口子,SA 就变成慢一点的普通机器,信任模型失效 MaterialProvider 只提供 master_seed/party_seed/fill_random,没有「执行计算」的方法
2 K_root 永不导出 破了它 ⇒ Beaver 三元组全部可预测 ⇒ 密态乘法隐私性归零,而症状是「不报错、不崩溃、结果数值也对」 协议里没有导出端点;sa-client 也没有导出命令;site 名 root-key/export/k-root/master-key 只能换出不同的派生种子
3 能力来源必须诚实自曝 阶段一跑在普通 Linux 上,不说清楚就等于吹牛 --platform 默认 none,服务端输出 hardware_protected=false、platform=none;attest 报告 cert_chain_len=0

4. 信任模型(方案 B:主种子信任模型)

4.1 物料流向

  SA 内部                          VM 侧(算法层)
  ──────                          ───────────────
  K_root  (永不导出)
    │
    ├─► master_seed(session_id)  ──────────▶  会话主种子(**共享**,不是秘密)
    │                                          │
    │                                          ├─► party_seed(site=alice)
    │                                          └─► party_seed(site=bob)
    └─► seal/unseal/attest/sign  ──────────▶  能力调用

4.2 ★ 主种子不是秘密

会话主种子由 SA 按会话下发 ⇒ 拿到它的 VM 能自己生成 Beaver 三元组。

⇒ 密态乘法的隐私性依赖「双方半诚实」这一协议假设, 而不是依赖主种子的保密。

这是 mpc_core::share::Dealer「共享主种子 → 双方本地生成相同三元组」设计的 固有前提,不是实现疏漏。

要彻底去掉这个假设,得换成 OLE 路线(无可信发牌方的三元组)—— 那是另一条路的工作量,不在阶段一范围。

4.3 ★★ 全零主种子必须拒绝

这是本项目最隐蔽的一类失败:

全零主种子 ⇒ 所有 Beaver 三元组由全零派生的 ChaCha20 流生成
           ⇒ 任何一方都能算出掩码
           ⇒ 密态乘法隐私性归零
症状:不报错 · 不崩溃 · 结果数值照样对

⇒ 守卫必须落在入口(CLI parse_seed)、在连网之前、 且下游库(mpc-vault::Vault::new)也要各守一道。

判据只有一份:mpc_core::material::seed_is_valid。

  • 本机判据:tools/selftest-seed-guard.py(主门禁第 24 条,18 条)
  • 分层责任:CLI 入口的守卫会遮蔽下游的守卫 ⇒ 端到端脚本覆盖整体行为, 分层责任由各 crate 的 Rust 单测承担。

5. 协议

5.1 形状

POST /sa/v1/<op> HTTP/1.1
Host: <host:port>
Authorization: Bearer <token>          ← 非回环必带
Content-Length: <n>

<n 字节 hex 编码的请求体>
HTTP/1.1 200 OK
Content-Length: <n>

<n 字节 hex 编码的响应体>

★ body 一律 hex 编码:不引入 JSON 解析器,也不依赖 base64 (hex 只要一张 16 项的表,实现只有 10 行)。 ★ 错误用非 200 状态码:200 + body 里带错误标记会让「HTTP 通了但操作失败」 和「HTTP 通了且操作成功」长得一样(mpc-chain 在「JSON-RPC 200 ≠ 成功」上踩过)。

5.2 操作

op 请求体(hex) 响应体(hex) 说明
seal plaintext ‖ aad nonce(12) ‖ ciphertext ‖ tag(16) AEAD,AAD 绑定平台标签与调用方 AAD
unseal blob ‖ aad plaintext AAD 不匹配 / 密文被篡改 ⇒ 解封失败
attest user_data(64B) user_data(64) ‖ tcb(4) ‖ sig(32) 自签报告,无证书链
sign message sig(32) HMAC-SHA256(阶段一)
master-seed session_id(32B) master_seed(32B) 共享会话主种子
party-seed session_id(32B) ‖ site party_seed(32B) 按 site 派生

协议里没有 root-key / export 端点,请求它们返回 404「未知操作」。

5.3 鉴权两模式

模式 条件 行为
回环信任 监听地址是回环 未配密钥 ⇒ 不带凭据放行;带了凭据一律拒
凭据模式 配了 --shared-secret-file 必须正确 Bearer token(ct_eq 常量时间比对),服务端只存 SHA-256 摘要

★ 非回环监听必须配 ≥32 字节共享密钥,否则拒绝启动 —— 回环信任模式在跨网段上等于零保护。

5.4 ★ 密钥走文件,不走命令行

--root-key-file(64 位 hex = 32 字节)、--shared-secret-file(单行文本,只去尾部换行)。

理由:命令行参数会进 ps 输出,任何本机用户都能看到。


6. ★ 阶段一的诚实边界(不许冲掉)

项 阶段一事实 意味着什么
平台 platform=none,hardware_protected=false SA 跑在普通 Linux上,K_root 在进程内存里,板子 root 能读 /proc/<pid>/mem ⇒ 无硬件保护
attest 自签报告,cert_chain_len=0 只能证明「某个 SA 实例说了这句话」,不能证明硬件身份
信任模型 主种子共享,依赖双方半诚实 见 §4.2
真硬件隔离 未做 要等真板 OP-TEE:当前内核 CONFIG_TEE is not set、BOOT.BIN 无 EL3 承载 ⇒ 须换启动链(见 docs/ZYNQ.md §4.3)

⇒ 本轮证明的是「接口与边界形状成立」,不是「K_root 硬件隔离成立」。


7. 怎么跑

7.1 本机契约回归(主门禁第 23 条)

python3 tools/selftest-sa.py

52 条判据,回环模式。守的是协议契约: seal/unseal 往返、错误 AAD 拒、篡改密文拒、缺凭据拒、错凭据拒、 协议无导出端点、非回环无密钥拒启动、全零根密钥拒启动…

7.2 零种子守卫(主门禁第 24 条)

python3 tools/selftest-seed-guard.py

18 条判据。守的是全零主种子这条隐蔽失败线。

7.3 ★ 真机端到端(26 条)

# 一次性准备
deploy/arm/zynq7015/sa-pair-e2e.sh --prepare-with-fwd

# 跑判据
deploy/arm/zynq7015/sa-pair-e2e.sh

拓扑:

  [OrbStack VM 192.168.139.149]
         │  mpc-client (x86_64)
         │  TCP 192.168.139.3:19300
         ▼
  [本机 192.168.139.3]  socat TCP-LISTEN:19300 → TCP:192.168.1.233:9300
         │  TCP 192.168.1.233:9300
         ▼
  [Zynq-7015 192.168.1.233]  mpc-sa tee sa-serve (armv7 静态 musl)

★ 为什么中间要一层 socat:VM 的默认网关是 OrbStack 虚拟网关 192.168.139.1,它不做跨网段转发 ⇒ VM 直连 192.168.1.233 会得到 No route to host(加路由也没用,网关根本不转)。 而本机同时在两个网段(192.168.139.3 与 192.168.1.x),所以做转发。 ⇒ 这层转发是拓扑必需,不是临时凑合。

★ 板端凭据:根密钥与共享密钥都在板子上生成(0600), 只有共享密钥送到 VM 侧。根密钥不入库、不出板。


8. 演进路径:阶段二(PCIe 直通调度)

用户定的路线:先在 OrbStack 起 VM 当算力资源,后面用 PCIe 直通调度。

阶段 算力位置 安全世界 状态
一(本轮) OrbStack VM(网络跨接) 板子普通 Linux 进程(platform=none) [实证] 跑通
二 PCIe 直通的 VM(算力直通到板子同域) 板子普通 Linux 进程 未做:需 PCIe 直通 + 直通后的设备枚举与中断分配
三 同上 真板 OP-TEE(K_root 进安全世界) 未做:须换启动链(ATF + OP-TEE + U-Boot FIP)

阶段二的关键变化:VM 不再是「另一台机器」,而是板子同域的设备—— 这会同时改变两件事:

  1. 网络路径消失(不再需要 socat 转发);
  2. 攻击面变大(同域 ⇒ 根密钥的物理隔离要求更高)⇒ 阶段二必须与阶段三(真 OP-TEE)一起做,否则把「跨机隔离」换成 「同机无隔离」,信任模型是倒退的。

⇒ 所以演进顺序是:阶段二与阶段三绑在一起做,不能只做阶段二。


9. 相关入口

想知道 去哪
SA 协议与实现 crates/mpc-tee/src/sa/{mod,protocol,server,client}.rs
CLI 入口 crates/mpc-cli/src/sa.rs(mpc tee sa-serve / mpc tee sa-client)
物料口径(单一真相源) crates/mpc-core/src/material.rs
本机契约判据 tools/selftest-sa.py
零种子守卫判据 tools/selftest-seed-guard.py
真机端到端 deploy/arm/zynq7015/sa-pair-e2e.sh
板端资产与真板 OP-TEE 缺口 deploy/arm/zynq7015/README.md、docs/ZYNQ.md §4
物料在链上层怎么用 docs/ARCHITECTURE_SYSTEM.md

10. 变更记录

日期 变更
2026-11-09 首版。SA 协议 + CLI 入口 + 本机判据(52 条)+ 零种子守卫(18 条)+ 真机端到端跑通(26 条);阶段一边界写死为 platform=none