- 20 个 KDF/HMAC/PSI/TEE/分片/作业种子标签全量换 mpc 前缀,集中到 mpc-core::domain 唯一真相源,业务代码不再写裸字符串 - 等长替换,消息格式与长度不变;mpc-tee 的 COMMIT/EGRESS 消息长度改由 label.len() 计算,避免写死数字漂移 - 不兼容变更:会话密钥、TEE 封存 blob、PSI 盲化点、缓存指纹、分片流全部换钥,参与方须同步升级,旧 blob/缓存/离线物料作废;不提供旧 nax 标签兼容读取 - README/CLAUDE/OPT_PLAN 重写兼容约定与迁移清单;仍保留 refs/nax 路径与 Python 包名 import nax(独立只读仓库真实路径) - golden 向量(ring/paillier/zkp)是纯数学、check_psi.py 只比语义,均不依赖这些标签,无需重生成 - CI 三条闸门全绿(全量测试 / -Dwarnings / mpc-core no_std)
This commit is contained in:
1 parent
e01c7f9419
commit
535c63a690
17 files changed
+173
-50
No files matched your search
@@ -10,8 +10,12 @@ Rust 实现,单二进制、低依赖、可编进 TEE。
|
||||
> **改名约定(前身 `nax-rs` → `ssw-mpc`)**:crate `mpc-*`、二进制 `mpc`、环境变量 `MPC_*`。
|
||||
> 旧名指「N 方算术执行引擎(Rust 重写 Python 参考实现)」,新名指「多方数据协作下的安全计算」,
|
||||
> 定位不同;叙述以新名语义为准,Python 参考实现只作行为基线。
|
||||
> 协议域分隔常量(`nax/...`、`nax-psi-v1` 等)与 `refs/nax/` 路径是**兼容契约,禁止改名** ——
|
||||
> 前者决定密钥/分片派生,后者是独立仓库的真实目录与 Python 包名(golden 脚本按此加载)。详见 README「命名沿革与兼容约定」。
|
||||
> 协议域分隔常量已统一到 `mpc-core::domain`(唯一真相源,`mpc/...` 前缀),2026-11-05 由 `nax/...` 全量切换。
|
||||
> **新增用途只在 `domain` 加常量,业务代码不要写裸字符串;改任一标签都是协议 breaking change**:
|
||||
> 它参与会话密钥 / TEE 封存 / PSI 盲化 / 分片流派生,必须全参与方同步升级,并同步更新 README 迁移清单
|
||||
> (旧 blob、缓存、离线物料作废)。golden 向量是纯数学,不依赖这些标签。
|
||||
> 仍禁止改名的是 `refs/nax/` 路径与 Python 包名 `import nax` —— 独立只读仓库的真实目录
|
||||
> (golden 脚本按此加载)。详见 README「命名沿革与兼容约定」。
|
||||
|
||||
## 三条铁律(优先级高于一切)
|
||||
|
||||
|
||||
@@ -14,12 +14,27 @@
|
||||
数据不出域、以密态参与运算,Python 参考实现退为行为基线,不再是复刻目标。
|
||||
改名前基线 tag `nax-rs-final`,改名提交 tag `ssw-mpc-rename`,CI 全绿首版 tag `ssw-mpc-v0.1.0`。
|
||||
|
||||
代码与文档里仍有少量 `nax` 字面量,是**刻意保留的兼容契约,不要顺手清理**:
|
||||
### 协议域分隔常量:已全量切换(不兼容变更)
|
||||
|
||||
2026-11-05 把 `nax/...`、`nax-psi-v1`、`nax-v1/derive` 等全部换成 `mpc` 前缀,
|
||||
并**集中到 `mpc-core::domain`**(唯一真相源,业务代码不再写裸字符串;改动纪律见该模块文档)。
|
||||
这些标签参与会话密钥、TEE 封存密钥、PSI 盲化点、缓存指纹与分片随机流的派生,
|
||||
**改一个字节就等于换钥**,因此:
|
||||
|
||||
- 新旧版本**混跑会静默出错**(交集变空 / AEAD 解不开 / 分片和不回去),不会干净报错 ——
|
||||
所有参与方必须同时升级,不能灰度。
|
||||
- 已 provision 的 TEE 板子:`K_root` 对象名与派生密钥都变了,需重新 provision,旧 blob 作废。
|
||||
- PSI 缓存指纹变了,旧表按设计自动作废;跨版本复用的离线物料 / 分片需全量重生成。
|
||||
- 不提供旧 `nax` 标签的兼容读取 —— 双读只会让「这次到底走哪套」变成新的混乱源。
|
||||
- golden 向量(ring / paillier / zkp)是纯数学,**不依赖**这些标签,无需重生成;
|
||||
`check_psi.py` 只比交集语义,也不受影响。
|
||||
|
||||
### 仍保留的 `nax`(不要顺手清理)
|
||||
|
||||
| 类别 | 例子 | 原因 |
|
||||
|---|---|---|
|
||||
| 协议域分隔常量 | `nax/tee/dev/v1`、`nax-psi-v1`、`nax-v1/derive` | KDF/HMAC 标签参与密钥与分片派生,改了会与已部署节点、Python golden 向量逐位不一致 |
|
||||
| 参考实现路径与包名 | `refs/nax/nax/...`、`import nax` | 独立只读仓库的真实目录与 Python 包名(`.gitignore` 已排除);`gen_golden.py` / `check_psi.py` / `bench_numpy.py` 按此路径加载,改了 golden 向量就生成不出来 |
|
||||
| 沿革说明里的历史名 | `nax-rs`、`nax-rs-final`、`NAX_*` | 记录迁移来源,不是现行标识 |
|
||||
|
||||
部署迁移:`NAX_*` → `MPC_*`、`libnax_ray.so` → `libmpc_ray.so`、远端 `ssw/nax-rs.git` → `ssw/ssw-mpc.git`。
|
||||
|
||||
|
||||
@@ -0,0 +1,95 @@
|
||||
//! 协议域分隔常量 —— 全框架唯一真相源。
|
||||
//!
|
||||
//! KDF / HMAC / hash-to-curve / 承诺消息里用到的标签全部集中在这里,
|
||||
//! 业务代码不允许再写裸字符串。理由不是「整齐」,是安全:
|
||||
//!
|
||||
//! 1. **域分隔的作用,是让同一把主密钥在不同语义下派生出不同字节**。
|
||||
//! 散在各处的手写字符串既看不出全集,也无法确认有没有撞车;
|
||||
//! 而撞车等于两种不同用途复用了同一把子密钥。
|
||||
//! 2. **改一个字节 = 换钥**。这些标签参与会话密钥、TEE 封存 blob、
|
||||
//! PSI 盲化点、缓存指纹与分片随机流的派生,任何变更都会让旧数据与
|
||||
//! 新代码**静默对不上**(PSI 交集变空、AEAD 解不开、分片和不回去),
|
||||
//! 而不是干净地报一个错。因此必须在同一处改、同一处审。
|
||||
//!
|
||||
//! # 变更纪律
|
||||
//!
|
||||
//! - 新增用途:在这里加常量,不要在业务代码里写 `b"..."`。
|
||||
//! - 改标签或版本:**协议 breaking change**,所有参与方必须同步升级;
|
||||
//! 同步更新 README「命名沿革与兼容约定」的迁移清单,并写清旧缓存 /
|
||||
//! blob / 离线物料如何作废。
|
||||
//! - 前缀统一 `mpc`,与 crate `mpc-*`、环境变量 `MPC_*` 一致。
|
||||
//! 2026-11-05 由前身 `nax/...` 全量切换,属一次性不兼容变更,
|
||||
//! **旧 `nax` 标签不提供兼容读取** —— 留双读只会让「这次到底走哪套」
|
||||
//! 变成新的混乱源,与集中管理的目的相悖。
|
||||
//! - 标签有 `mpc/...` 与 `mpc-xxx-v1` 两种写法,是前身留下的结构差异;
|
||||
//! 本次**只换品牌前缀、不改结构与版本号**,让消息长度与格式保持不变。
|
||||
//! 今后新增常量统一用 `mpc/用途/v1` 一种写法,不再制造第三种风格。
|
||||
//! - `nax` → `mpc` 是等长替换,所以 `mpc-tee` 的定长消息编码不受影响
|
||||
//! (长度已改为由 label 自动计算)。
|
||||
//!
|
||||
//! # 长度敏感
|
||||
//!
|
||||
//! [`TEE_COMMIT`] / [`TEE_EGRESS`] 参与定长消息编码。`mpc-tee` 的消息长度
|
||||
//! 常量直接由 `.len()` 计算,不要在别处另写一个数字。
|
||||
|
||||
/// 带标签派生(`hmac::derive_labeled`)的固定域前缀。
|
||||
pub const KDF_DERIVE: &[u8] = b"mpc-v1/derive";
|
||||
|
||||
/// ChaCha20 nonce 的派生标签:key 与 nonce 不复用同一段种子字节。
|
||||
pub const PRG_NONCE: &[u8] = b"mpc/chacha20/nonce";
|
||||
|
||||
/// 成对掩码种子派生标签,避免两方 ID 拼接歧义。
|
||||
pub const PRG_PAIR: &[u8] = b"mpc/pair";
|
||||
|
||||
/// 握手后 client → server 方向会话密钥的派生标签。
|
||||
pub const SESSION_C2S: &[u8] = b"mpc/session/c2s";
|
||||
|
||||
/// 握手后 server → client 方向会话密钥的派生标签。
|
||||
pub const SESSION_S2C: &[u8] = b"mpc/session/s2c";
|
||||
|
||||
/// ECDH-PSI 的默认 hash-to-point domain。按「关系」固定,不随会话变化,
|
||||
/// 否则跨会话盲化缓存无法复用(见 `mpc-psi::cache`)。
|
||||
pub const PSI_DOMAIN: &[u8] = b"mpc-psi-v1";
|
||||
|
||||
/// PSI 盲化缓存的格式指纹;语义变了就递增,旧表自动作废。
|
||||
pub const PSI_CACHE_VERSION: &[u8] = b"mpc-psi-cache-v1";
|
||||
|
||||
/// 抗恶意硬化 PSI 的协议版本串,进 domain 与集合承诺。
|
||||
pub const PSI_STRICT_VERSION: &[u8] = b"mpc-psi-strict-v1";
|
||||
|
||||
/// 每作业会话种子的派生标签:作业名不同 → 种子不同,避免 Beaver 三元组跨作业重用。
|
||||
pub const JOB_SEED: &[u8] = b"mpc-job";
|
||||
|
||||
/// 设备侧分片随机流的派生标签。
|
||||
pub const SHARE_DEVICE: &[u8] = b"mpc/device/share";
|
||||
|
||||
/// 协议编排层分片随机流的派生标签(带轮次号一起进 label)。
|
||||
pub const SHARE_VAULT: &[u8] = b"mpc/share";
|
||||
|
||||
/// TEE 设备绑定标签:混入 Device DNA,同一 K_root 换芯片派生出不同密钥。
|
||||
pub const TEE_DEV: &[u8] = b"mpc/tee/dev/v1";
|
||||
|
||||
/// TEE 密封密钥(AEAD)派生标签。
|
||||
pub const TEE_ENC: &[u8] = b"mpc/tee/v1/enc";
|
||||
|
||||
/// TEE 签名密钥派生标签。
|
||||
pub const TEE_SIG: &[u8] = b"mpc/tee/v1/sig";
|
||||
|
||||
/// 输入承诺消息前缀:TEE 对这段字节签名,证明「这个时刻承诺了这份数据」。
|
||||
pub const TEE_COMMIT: &[u8] = b"mpc/commit/v1";
|
||||
|
||||
/// 出域策略判定消息前缀:TEE 对判定结果签名,审计链可验证。
|
||||
pub const TEE_EGRESS: &[u8] = b"mpc/egress/v1";
|
||||
|
||||
/// OP-TEE secure storage 里 K_root 的对象名(含 C 字符串结尾的 NUL)。
|
||||
/// 改名后读不到旧对象,已 provision 的板子必须重新 provision。
|
||||
pub const TEE_OBJ_ROOT: &[u8] = b"mpc.tee.root.v1\0";
|
||||
|
||||
/// 纯软件 TEE 替身的 seal 密钥派生标签,与真实 TA 同语义。
|
||||
pub const TEE_MOCK_SEAL: &[u8] = b"mpc/seal/v2";
|
||||
|
||||
/// 纯软件 TEE 替身的 attestation 报告密钥派生标签。
|
||||
pub const TEE_MOCK_ATTEST: &[u8] = b"mpc/attest";
|
||||
|
||||
/// 纯软件 TEE 替身的签名密钥派生标签。
|
||||
pub const TEE_MOCK_SIGN: &[u8] = b"mpc/sign";
|
||||
@@ -71,11 +71,11 @@ pub fn ct_eq(a: &[u8], b: &[u8]) -> bool {
|
||||
|
||||
/// 从主密钥按标签 + 两段上下文派生一个 32 字节子密钥。
|
||||
///
|
||||
/// 用固定的 `"nax-v1"` 前缀把派生域和其它用途(比如直接拿主密钥当 HMAC key)
|
||||
/// 用固定的 `domain::KDF_DERIVE` 前缀把派生域和其它用途(比如直接拿主密钥当 HMAC key)
|
||||
/// 隔开,避免同一把密钥在不同语义下复用。
|
||||
pub fn derive_labeled(master: &[u8; 32], label: &[u8], a: &[u8], b: &[u8]) -> [u8; 32] {
|
||||
let mut ctx = Sha256::new();
|
||||
ctx.update(b"nax-v1/derive");
|
||||
ctx.update(crate::domain::KDF_DERIVE);
|
||||
ctx.update(&[0u8]);
|
||||
ctx.update(label);
|
||||
ctx.update(&[0u8]);
|
||||
|
||||
@@ -18,6 +18,7 @@
|
||||
//! # 分层
|
||||
//!
|
||||
//! ```text
|
||||
//! domain 协议域分隔常量(全框架唯一真相源;改一个字节 = 换钥)
|
||||
//! ring Z_2^64 定点算术 + 矩阵乘(唯一碰裸 u64 的模块)
|
||||
//! hash SHA-256(commitment / 种子派生 / attestation 摘要)
|
||||
//! hmac HMAC-SHA256 + 定长比较 + 带标签派生(握手认证用)
|
||||
@@ -41,6 +42,7 @@ extern crate alloc;
|
||||
|
||||
pub mod aead;
|
||||
pub mod compare;
|
||||
pub mod domain;
|
||||
pub mod hash;
|
||||
pub mod hmac;
|
||||
/// OS 熵源。**只在 `std` 下存在** —— TA 里没有 `/dev/urandom`,由宿主注入。
|
||||
|
||||
@@ -58,7 +58,7 @@ impl Stream {
|
||||
}
|
||||
// 后 12 字节(key 用满 32 字节,nonce 单独从 seed 再派生一次,
|
||||
// 避免 key 与 nonce 复用同一段字节导致的结构相关性)
|
||||
let n = derive(seed, b"nax/chacha20/nonce");
|
||||
let n = derive(seed, crate::domain::PRG_NONCE);
|
||||
let nonce = [
|
||||
u32::from_le_bytes([n[0], n[1], n[2], n[3]]),
|
||||
u32::from_le_bytes([n[4], n[5], n[6], n[7]]),
|
||||
@@ -168,7 +168,7 @@ fn pair_seed(master: &[u8; 32], a: &[u8], b: &[u8]) -> [u8; 32] {
|
||||
let (lo, hi) = if a <= b { (a, b) } else { (b, a) };
|
||||
let mut h = Sha256::new();
|
||||
h.update(master);
|
||||
h.update(b"nax/pair");
|
||||
h.update(crate::domain::PRG_PAIR);
|
||||
h.update(&(lo.len() as u32).to_be_bytes());
|
||||
h.update(lo);
|
||||
h.update(&(hi.len() as u32).to_be_bytes());
|
||||
|
||||
@@ -18,8 +18,8 @@
|
||||
//!
|
||||
//! ```text
|
||||
//! ctx = idx_c ‖ idx_s ‖ na ‖ nb (定长 34 字节,无歧义拼接)
|
||||
//! tag_s = KDF(psk, "server", ctx) 服务端对 ctx 的签名
|
||||
//! tag_c = KDF(psk, "client", ctx) 客户端对 ctx 的签名
|
||||
//! tag_s = KDF(psk, domain::SESSION_S2C, ctx) 服务端对 ctx 的签名
|
||||
//! tag_c = KDF(psk, domain::SESSION_C2S, ctx) 客户端对 ctx 的签名
|
||||
//! ```
|
||||
//!
|
||||
//! 两侧用**不同的 label**,所以不能把对方的 tag 原样打回来冒充自己。
|
||||
@@ -128,8 +128,8 @@ pub(crate) fn session_keys(
|
||||
) -> SessionKeys {
|
||||
let ctx = ctx_bytes(client_idx, server_idx, na, nb);
|
||||
SessionKeys {
|
||||
c2s: derive_labeled(psk, b"nax/session/c2s", &ctx, &[]),
|
||||
s2c: derive_labeled(psk, b"nax/session/s2c", &ctx, &[]),
|
||||
c2s: derive_labeled(psk, mpc_core::domain::SESSION_C2S, &ctx, &[]),
|
||||
s2c: derive_labeled(psk, mpc_core::domain::SESSION_S2C, &ctx, &[]),
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -744,7 +744,7 @@ fn judge(job: &JobSpec, reports: &[Report]) -> Result<f64, String> {
|
||||
/// 输入就露了。派生用域分离标签,所以作业名不同 → 种子不同,
|
||||
/// 且从种子反推不出别的作业的种子。
|
||||
fn job_seed(master: [u8; 32], job: &str) -> [u8; 32] {
|
||||
mpc_core::hash::derive2(&master, b"mpc-job", job.as_bytes())
|
||||
mpc_core::hash::derive2(&master, mpc_core::domain::JOB_SEED, job.as_bytes())
|
||||
}
|
||||
|
||||
/// 记一条事件:进内存列表(供汇总)+ 落盘(供重启后查)。
|
||||
|
||||
@@ -47,7 +47,7 @@ use mpc_core::hash::Sha256;
|
||||
use crate::{hash_to_point, scalar_mult};
|
||||
|
||||
/// 缓存格式版本:条目语义变了就递增,旧表自动作废(绑定时比指纹)。
|
||||
const CACHE_VERSION: &[u8] = b"nax-psi-cache-v1";
|
||||
const CACHE_VERSION: &[u8] = mpc_core::domain::PSI_CACHE_VERSION;
|
||||
|
||||
/// 默认条目上限(每张表)。超过就整表清空。
|
||||
///
|
||||
|
||||
@@ -51,8 +51,11 @@ use curve25519_dalek::montgomery::MontgomeryPoint;
|
||||
pub mod cache;
|
||||
pub mod strict;
|
||||
|
||||
/// 默认 domain 分隔串,与参考实现一致。
|
||||
pub const DOMAIN: &[u8] = b"nax-psi-v1";
|
||||
/// 默认 domain 分隔串,统一定义在 `mpc_core::domain::PSI_DOMAIN`。
|
||||
///
|
||||
/// 参考实现的 `hash_to_point` 用 SHA-512、这里用 SHA-256,两边曲线点本就不同;
|
||||
/// 这个 domain 只约束**本框架各参与方**必须用同一个映射。
|
||||
pub const DOMAIN: &[u8] = mpc_core::domain::PSI_DOMAIN;
|
||||
|
||||
/// 把一个 ID(任意字节)映射到曲线上的 u 坐标。
|
||||
///
|
||||
|
||||
@@ -36,7 +36,7 @@
|
||||
use mpc_core::hash::Sha256;
|
||||
|
||||
/// 协议版本串,进 domain 与承诺,换格式时递增。
|
||||
pub const STRICT_VERSION: &[u8] = b"nax-psi-strict-v1";
|
||||
pub const STRICT_VERSION: &[u8] = mpc_core::domain::PSI_STRICT_VERSION;
|
||||
|
||||
/// 已知的低阶(8-torsion)点,以 Montgomery `u` 坐标表示。
|
||||
///
|
||||
@@ -287,7 +287,7 @@ mod tests {
|
||||
}
|
||||
}
|
||||
|
||||
const DOMAIN: &[u8] = b"nax-psi-v1";
|
||||
const DOMAIN: &[u8] = crate::DOMAIN;
|
||||
|
||||
#[test]
|
||||
fn rejects_duplicates_and_reports_both_positions() {
|
||||
|
||||
@@ -322,7 +322,7 @@ impl Value {
|
||||
/// 拆成本方那一份分片。`Stream` 按列推进,保持与发牌一致的随机序列。
|
||||
fn split_for(&self, dev: &Secret) -> Result<Self, DeviceError> {
|
||||
// 带标签派生:同一主种子在同一域里复用不会与其他用途的随机流撞车
|
||||
let mut stream = Stream::derive(dev.seed(), b"nax/device/share");
|
||||
let mut stream = Stream::derive(dev.seed(), mpc_core::domain::SHARE_DEVICE);
|
||||
let mut out = Vec::with_capacity(self.cols.len());
|
||||
for (name, vals) in &self.cols {
|
||||
let mut buf = vec![0u64; dev.parties() * vals.len()];
|
||||
|
||||
@@ -73,7 +73,7 @@ impl MockTee {
|
||||
|
||||
/// seal 用的 AEAD 密钥(与签名、报告密钥域分离)。
|
||||
fn seal_key(&self) -> [u8; 32] {
|
||||
derive(&self.device_key, b"nax/seal/v2")
|
||||
derive(&self.device_key, mpc_core::domain::TEE_MOCK_SEAL)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -163,7 +163,7 @@ impl Tee for MockTee {
|
||||
|
||||
fn attest(&self, user_data: &[u8; 64]) -> Result<Attestation, TeeError> {
|
||||
// 真平台的报告由硬件密钥签;这里用设备密钥派生一个报告密钥来模拟
|
||||
let report_key = derive(&self.device_key, b"nax/attest");
|
||||
let report_key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_ATTEST);
|
||||
let dev = self.device_id();
|
||||
|
||||
let mut body = Vec::with_capacity(64 + 64 + 8);
|
||||
@@ -187,7 +187,7 @@ impl Tee for MockTee {
|
||||
}
|
||||
|
||||
fn sign(&self, msg: &[u8]) -> Result<Signature, TeeError> {
|
||||
let key = derive(&self.device_key, b"nax/sign");
|
||||
let key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_SIGN);
|
||||
Ok(Signature {
|
||||
alg: "hmac-sha256-mock",
|
||||
bytes: mac(&key, &[msg]).to_vec(),
|
||||
@@ -224,7 +224,7 @@ impl MockTee {
|
||||
return Err(TeeError::AttestFailed("TCB 版本不符".into()));
|
||||
}
|
||||
let digest = sha256(&att.report[..100]);
|
||||
let report_key = derive(&self.device_key, b"nax/attest");
|
||||
let report_key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_ATTEST);
|
||||
let want = mac(&report_key, &[&digest, &att.user_data]);
|
||||
if !ct_eq(&att.report[100..], &want) {
|
||||
return Err(TeeError::AttestFailed("签名不符".into()));
|
||||
@@ -360,7 +360,7 @@ mod tests {
|
||||
let t = tee();
|
||||
let s = t.sign(b"policy: allow reveal to alice").unwrap();
|
||||
assert_eq!(s.bytes.len(), 32);
|
||||
let key = derive(&t.device_key, b"nax/sign");
|
||||
let key = derive(&t.device_key, mpc_core::domain::TEE_MOCK_SIGN);
|
||||
assert!(ct_eq(&s.bytes, &mac(&key, &[b"policy: allow reveal to alice"])));
|
||||
}
|
||||
}
|
||||
@@ -8,11 +8,14 @@
|
||||
//!
|
||||
//! # 密钥层次
|
||||
//!
|
||||
//! 下列标签全部来自 `mpc_core::domain`(唯一真相源),这里只写常量名,
|
||||
//! 不复制字面值 —— 改标签时不会出现「代码改了、文档还是旧值」。
|
||||
//!
|
||||
//! ```text
|
||||
//! K_root 32B,TA 首次 provision 时生成,存 secure storage,永不导出
|
||||
//! dev_tag 8B = SHA256("nax/tee/dev/v1" ‖ device_dna)[0..8]
|
||||
//! K_seal 32B = derive(K_root, "nax/tee/v1/enc")
|
||||
//! K_sig 32B = derive(K_root, "nax/tee/v1/sig")
|
||||
//! dev_tag 8B = SHA256(domain::TEE_DEV ‖ device_dna)[0..8]
|
||||
//! K_seal 32B = derive(K_root, domain::TEE_ENC)
|
||||
//! K_sig 32B = derive(K_root, domain::TEE_SIG)
|
||||
//! ```
|
||||
//!
|
||||
//! `dev_tag` 混入派生的目的是**设备绑定**:同一份 K_root 落到不同芯片
|
||||
@@ -37,7 +40,7 @@
|
||||
//! # 输入承诺消息(`commitment_bytes`)
|
||||
//!
|
||||
//! ```text
|
||||
//! "nax/commit/v1" ‖ session_id(32) ‖ party_id(1) ‖ data_hash(32) ‖ timestamp(8)
|
||||
//! domain::TEE_COMMIT ‖ session_id(32) ‖ party_id(1) ‖ data_hash(32) ‖ timestamp(8)
|
||||
//! ```
|
||||
//!
|
||||
//! TEE 对这段字节签名 → 对端验证"这个 TEE 在这个时刻承诺了这份数据"。
|
||||
@@ -45,7 +48,7 @@
|
||||
//! # 出域策略判定消息(`egress_bytes`)
|
||||
//!
|
||||
//! ```text
|
||||
//! "nax/egress/v1" ‖ session_id(32) ‖ operation(1) ‖ target(1) ‖ allowed(1) ‖ counter(8)
|
||||
//! domain::TEE_EGRESS ‖ session_id(32) ‖ operation(1) ‖ target(1) ‖ allowed(1) ‖ counter(8)
|
||||
//! ```
|
||||
//!
|
||||
//! TEE 对判定结果签名 → 审计链可验证"enclave 批准了这次出域"。
|
||||
@@ -60,6 +63,7 @@ use mpc_core::aead;
|
||||
use mpc_core::hash::{derive, Sha256};
|
||||
|
||||
// 供 TA / CA / 宿主测试复用的原语:全部来自 mpc-core,不在这里另写一份
|
||||
pub use mpc_core::domain::TEE_OBJ_ROOT;
|
||||
pub use mpc_core::hash::sha256;
|
||||
pub use mpc_core::hmac::ct_eq;
|
||||
|
||||
@@ -81,16 +85,16 @@ pub const DEVICE_TAG_LEN: usize = 8;
|
||||
pub const ROOT_KEY_LEN: usize = 32;
|
||||
|
||||
/// 输入承诺消息前缀。
|
||||
pub const COMMIT_LABEL: &[u8] = b"nax/commit/v1";
|
||||
pub const COMMIT_LABEL: &[u8] = mpc_core::domain::TEE_COMMIT;
|
||||
|
||||
/// 出域策略判定消息前缀。
|
||||
pub const EGRESS_LABEL: &[u8] = b"nax/egress/v1";
|
||||
pub const EGRESS_LABEL: &[u8] = mpc_core::domain::TEE_EGRESS;
|
||||
|
||||
/// 承诺消息总长:14(label) + 32(session) + 1(party) + 32(hash) + 8(ts) = 87。
|
||||
pub const COMMIT_MSG_LEN: usize = 14 + 32 + 1 + 32 + 8;
|
||||
/// 承诺消息总长:label + 32(session) + 1(party) + 32(hash) + 8(ts) = 87。
|
||||
pub const COMMIT_MSG_LEN: usize = COMMIT_LABEL.len() + 32 + 1 + 32 + 8;
|
||||
|
||||
/// 出域消息总长:13(label) + 32(session) + 1(op) + 1(target) + 1(allowed) + 8(counter) = 56。
|
||||
pub const EGRESS_MSG_LEN: usize = 13 + 32 + 1 + 1 + 1 + 8;
|
||||
/// 出域消息总长:label + 32(session) + 1(op) + 1(target) + 1(allowed) + 8(counter) = 56。
|
||||
pub const EGRESS_MSG_LEN: usize = EGRESS_LABEL.len() + 32 + 1 + 1 + 1 + 8;
|
||||
|
||||
// ---------------------------------------------------------------- 密钥派生
|
||||
|
||||
@@ -114,23 +118,23 @@ pub struct DerivedKeys {
|
||||
/// 加密与认证共用 `K_seal`,那把密钥已无用处,随格式一并删掉 ——
|
||||
/// 留着一把没人用的密钥只会让人以为它还在保护什么。
|
||||
pub fn derive_keys(root: &[u8; ROOT_KEY_LEN], device_dna: &[u8; DEVICE_DNA_LEN]) -> DerivedKeys {
|
||||
// 先派生设备绑定中间密钥:k_dev = derive(K_root, "nax/tee/dev/v1" ‖ dna)
|
||||
let mut dev_label = Vec::with_capacity(20);
|
||||
dev_label.extend_from_slice(b"nax/tee/dev/v1");
|
||||
// 先派生设备绑定中间密钥:k_dev = derive(K_root, domain::TEE_DEV ‖ dna)
|
||||
let mut dev_label = Vec::with_capacity(mpc_core::domain::TEE_DEV.len() + DEVICE_DNA_LEN);
|
||||
dev_label.extend_from_slice(mpc_core::domain::TEE_DEV);
|
||||
dev_label.extend_from_slice(device_dna);
|
||||
let k_dev = derive(root, &dev_label);
|
||||
|
||||
// 再从 k_dev 派生子密钥(标签里也带 dna,双重绑定)
|
||||
let mut enc_label = Vec::with_capacity(24);
|
||||
enc_label.extend_from_slice(b"nax/tee/v1/enc");
|
||||
enc_label.extend_from_slice(mpc_core::domain::TEE_ENC);
|
||||
enc_label.extend_from_slice(device_dna);
|
||||
let mut sig_label = Vec::with_capacity(24);
|
||||
sig_label.extend_from_slice(b"nax/tee/v1/sig");
|
||||
sig_label.extend_from_slice(mpc_core::domain::TEE_SIG);
|
||||
sig_label.extend_from_slice(device_dna);
|
||||
|
||||
DerivedKeys {
|
||||
// 标签字符串沿用 "v1/enc":它是密钥派生域,与 blob 格式版本无关,
|
||||
// 改了会让已 provision 的板子全部换钥(blob 全废)。
|
||||
// 标签里的 "v1/..." 是密钥派生域版本,与 blob 格式版本(SEAL_VERSION)无关;
|
||||
// 改这些标签会让已 provision 的板子全部换钥、旧 blob 解不开(见 domain.rs 变更纪律)。
|
||||
k_seal: derive(&k_dev, &enc_label),
|
||||
k_sig: derive(&k_dev, &sig_label),
|
||||
}
|
||||
@@ -139,7 +143,7 @@ pub fn derive_keys(root: &[u8; ROOT_KEY_LEN], device_dna: &[u8; DEVICE_DNA_LEN])
|
||||
/// 设备指纹(快速判断"这不是我的 blob")。
|
||||
pub fn device_tag(device_dna: &[u8; DEVICE_DNA_LEN]) -> [u8; DEVICE_TAG_LEN] {
|
||||
let mut h = Sha256::new();
|
||||
h.update(b"nax/tee/dev/v1");
|
||||
h.update(mpc_core::domain::TEE_DEV);
|
||||
h.update(device_dna);
|
||||
let digest = h.finalize();
|
||||
let mut out = [0u8; DEVICE_TAG_LEN];
|
||||
|
||||
@@ -30,7 +30,7 @@ use optee_utee::{
|
||||
//(E0432 + E0433,2026-10-29 QEMU 实测踩过)。只导具体符号。
|
||||
use mpc_tee::optee::core::{
|
||||
derive_keys, device_tag, hmac, seal, sha256, unseal, DerivedKeys, DEVICE_DNA_LEN, ROOT_KEY_LEN,
|
||||
SEAL_OVERHEAD,
|
||||
SEAL_OVERHEAD, TEE_OBJ_ROOT as OBJ_ROOT,
|
||||
};
|
||||
use mpc_tee::optee::proto;
|
||||
|
||||
@@ -42,8 +42,7 @@ pub const UUID: &str = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d";
|
||||
// optee-utee-build 生成到 $OUT_DIR/user_ta_header.rs,文件末尾 include!。
|
||||
// 不要在这里手写 #[no_mangle] 弱符号——会与生成的定义冲突(重复定义)。
|
||||
|
||||
/// secure storage 里的 K_root 对象名。
|
||||
const OBJ_ROOT: &[u8] = b"nax.tee.root.v1\0";
|
||||
// K_root 对象名来自 mpc_core::domain(经 optee::core re-export),不在 TA 里另写一份。
|
||||
|
||||
// ---------------------------------------------------------------- storage
|
||||
|
||||
|
||||
@@ -230,7 +230,7 @@ impl<T: Transport> Vault<T> {
|
||||
let len = values.len();
|
||||
self.share_round = self.share_round.wrapping_add(1);
|
||||
let mut label = Vec::with_capacity(16);
|
||||
label.extend_from_slice(b"nax/share");
|
||||
label.extend_from_slice(mpc_core::domain::SHARE_VAULT);
|
||||
label.extend_from_slice(&self.share_round.to_le_bytes());
|
||||
let mut s = Stream::derive(&self.master_seed, &label);
|
||||
|
||||
|
||||
+4
-3
@@ -49,11 +49,12 @@ Python 算法层、BFIA 互操作(有对接需求才做)。
|
||||
|
||||
```
|
||||
主动方 A → B : REQ{idx=A, nonce_a}
|
||||
B → A : ACK{idx=B, nonce_b, tag_b = HMAC(psk, "nax/v1/server" ‖ A ‖ B ‖ na ‖ nb)}
|
||||
A → B : OK {tag_a = HMAC(psk, "nax/v1/client" ‖ A ‖ B ‖ na ‖ nb)}
|
||||
B → A : ACK{idx=B, nonce_b, tag_b = HMAC(psk, domain::SESSION_S2C ‖ A ‖ B ‖ na ‖ nb)}
|
||||
A → B : OK {tag_a = HMAC(psk, domain::SESSION_C2S ‖ A ‖ B ‖ na ‖ nb)}
|
||||
```
|
||||
|
||||
> label 沿用前身的域分隔常量 `nax/v1/*`,是兼容契约,不随改名调整(见 README「命名沿革与兼容约定」)。
|
||||
> label 见 `mpc_core::domain` 的 `SESSION_S2C` / `SESSION_C2S`,与 `mpc-node::auth` 的握手实现一致;
|
||||
> 改任一标签都是协议 breaking change(见 README「命名沿革与兼容约定」)。
|
||||
|
||||
两个 tag 用不同 label,防「把对方 tag 原样打回来」。
|
||||
`connect_mesh(...)` 保持原签名,内部转调 `psk = None`(存量测试不受影响);
|
||||
|
||||
Reference in new issue
Block a user