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)。
12 KiB
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 不再是「另一台机器」,而是板子同域的设备—— 这会同时改变两件事:
- 网络路径消失(不再需要 socat 转发);
- 攻击面变大(同域 ⇒ 根密钥的物理隔离要求更高)⇒ 阶段二必须与阶段三(真 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 |