Files
ssw-mpc/crates/mpc-tee/src/session.rs
T
admin 0326311888 feat(tee): KBS 从 stub 变为真判定,打通「先验证明,才给密钥」闭环
密钥下发从「问就给」改成「先出证明,才给密钥」:

- 新增 crates/mpc-tee/src/bundle.rs:唯一的证明判定实现,判定五关
  全部 fail-closed(平台一致+布局解析 / 重算绑定值挡重放 / 度量 pin /
  TCB 门槛 / 芯片签名)。验证方与放行方共用同一份,口径不分叉。
- 新增 crates/mpc-tee/src/collect.rs:guest 内从芯片驱动采真报告
  (CSV ioctl 0xC0104401;SNP 证书链需单独 ioctl,显式 Unsupported)。
- 新增 crates/mpc-core/src/sm3.rs:CSV launch 度量与挑战哈希用。
- deploy/tee/kbs/serve.py:新增 /kbs/v0/attestation,判定调
  `mpc tee attest-check`(Rust),Python 只搬字节看退出码。
  严格模式默认开,缺判定器或缺验签器一律拒发。
- guest/init.sh:去掉 offline-demo 兜底,改「采集证明 → POST 换 token
  → 凭 token 取钥」。
- 新增 CLI 子命令 tee attest-collect/attest-check/attest-mkbundle/attest-post。

修掉多个真 bug:

- GNU coreutils `tee` 把非选项参数当文件名创建且成功退出,判定退化成
  「不报错就算过」就是假绿 → KBS 加五道闸(判定器校验 / 独立工作目录 /
  stdin=DEVNULL / 超时上限 / 输出必须是含 ok+verdict 的判定结论)。
- Rust TcpStream::connect 无超时,对端不可达时挂 ~130s,guest 表现为
  卡死 → 新增 connect_with_timeout(10s)。
- guest 显式等 carrier 就绪(LOWER_UP),消除 attest-post 偶发超时。
- tap 名两处各记一份导致「配置全对但连不上」→ 统一兜底。
- iproute2 接口名上限 15 字符,超长报误导性的 policy validation → 预检。
- argparse 吞「以 - 开头的值」→ 证书链目录改用独立选项 --chain-dir。
- 跨目标编译盲区:#[cfg(target_os="linux")] 代码在宿主目标被整段排除,
  宿主零告警但交叉编译出告警 → CI 新增跨目标零告警闸门。
- lint-shell-vars.py 只扫 deploy/tee,对 tools/ci.sh 自身无感 → 扩到
  tools;并跳过纯注释行(shell 不解析注释,对教学示例持续误报会让人
  习惯性忽略闸门输出 = 假绿的温床)。

真机(海光 CSV 192.168.1.102):正向 7/7 全绿,负向 6/6 全部 fail-closed。
CI 扩到九条,全部通过。
2026-11-07 08:46:24 +08:00

298 lines
11 KiB
Rust
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.
//! 会话绑定证明 —— 让远程证明回答「这一次计算」而不是「这台机器」。
//!
//! # 为什么必须有这一层
//!
//! 只把容器塞进加密 VM,得到的结论是「有个 SNP guest 在跑」。但 MPC 要验证的
//! 是更具体的一件事:**对面这份二进制,正在用这把会话公钥,参与这一轮计算**。
//! 芯片报告里的 `user_data` / `report_data`(64 字节定长)就是为这个准备的:
//! 生成方把绑定值填进去,验证方重新算一遍并逐字节比对。
//!
//! 没有绑定,攻击者可以拿一份**别的时间、别的会话**里合法签过的报告来重放,
//! 密钥注入与 L2 明文合并的判定就全建立在错的前提上。这也是「直接调度 TEE」
//! 与「只是启动了加密虚拟机」的分界线。
//!
//! # 本模块不做什么
//!
//! **不做芯片验签**。VCEK ← ASK ← ARK 证书链、CSV 报告签名、TCB 语义都由
//! 验证方(对端 / KBS / attest 服务)核验;框架只负责生成绑定值、检查报告
//! 结构与绑定一致性。函数返回 `Ok` 的含义严格是「结构和绑定对得上」,
//! 不是「硬件证明已通过」。
use crate::{Attestation, PlatformKind, TeeError};
use alloc::string::String;
use alloc::vec::Vec;
use mpc_core::domain;
use mpc_core::hash::sha256;
use mpc_core::hmac::ct_eq;
/// 芯片报告里调用方数据的定长(SNP `report_data` 为 64 字节)。
pub const USER_DATA_LEN: usize = 64;
/// 一次 MPC 会话的绑定材料。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct SessionBinding {
/// 会话标识(各方握手后共同确认的值,不能为全零)。
pub session_id: [u8; 32],
/// 本方 site 名。绑进报告,防止把 A 方的报告拿到 B 方复用。
pub site: String,
/// 本轮会话公钥的哈希。
pub session_pubkey: [u8; 32],
/// guest 镜像 / 二进制的代码度量(SHA-256)。
pub code_measurement: [u8; 32],
}
impl SessionBinding {
/// 构造绑定材料。
pub fn new(
session_id: [u8; 32],
site: impl Into<String>,
session_pubkey: [u8; 32],
code_measurement: [u8; 32],
) -> Self {
Self {
session_id,
site: site.into(),
session_pubkey,
code_measurement,
}
}
/// 会话标识是否为全零(全零 = 没握手,不允许出证明)。
pub fn has_session(&self) -> bool {
self.session_id.iter().any(|b| *b != 0)
}
/// 代码度量是否已 pin(全零 = 未知镜像,不允许出证明)。
pub fn has_measurement(&self) -> bool {
self.code_measurement.iter().any(|b| *b != 0)
}
/// 计算要填进芯片报告的 64 字节。
///
/// 分两段各 32 字节,分别用不同域分隔常量:前半段绑「谁、哪一轮、哪把
/// 会话公钥」,后半段绑「哪份代码、哪个平台、什么 TCB」。任一输入变化,
/// 两段都会变;两段用不同标签,也不会出现同一摘要被两种语义复用。
pub fn user_data(&self, platform: PlatformKind, tcb: u32) -> [u8; USER_DATA_LEN] {
let mut first: Vec<u8> = Vec::with_capacity(
domain::TEE_SESSION_BIND.len() + 32 + self.site.len() + 32,
);
first.extend_from_slice(domain::TEE_SESSION_BIND);
first.extend_from_slice(&self.session_id);
first.extend_from_slice(self.site.as_bytes());
first.extend_from_slice(&self.session_pubkey);
let tag = platform_tag(platform);
let mut second: Vec<u8> =
Vec::with_capacity(domain::TEE_SESSION_ATTEST.len() + 32 + tag.len() + 4);
second.extend_from_slice(domain::TEE_SESSION_ATTEST);
second.extend_from_slice(&self.code_measurement);
second.extend_from_slice(tag.as_bytes());
second.extend_from_slice(&tcb.to_le_bytes());
let a = sha256(&first);
let b = sha256(&second);
let mut out = [0u8; USER_DATA_LEN];
out[..32].copy_from_slice(&a);
out[32..].copy_from_slice(&b);
out
}
}
/// 平台的稳定标签(不依赖 `Display` 的字符串分配,no_std 下可直接用)。
fn platform_tag(kind: PlatformKind) -> &'static str {
match kind {
PlatformKind::None => "none",
PlatformKind::Optee => "optee",
PlatformKind::SevSnp => "sev-snp",
PlatformKind::Tdx => "tdx",
PlatformKind::HygonCsv => "hygon-csv",
}
}
/// 定长字节串的常量时间比较。
///
/// `mpc_core::hmac::ct_eq` 只覆盖 32 字节,而证明绑定值是 **64 字节**
/// (SNP `report_data` / CSV `user_data` 的定长),所以这里补一个通用版本。
///
/// 比较长度不同时直接返回 `false`(长度本身不是秘密),相等时逐字节累积
/// 异或再判零 —— 不在第一个不等的字节上提前返回。
pub fn verify_user_data_eq(a: &[u8], b: &[u8]) -> bool {
if a.len() != b.len() {
return false;
}
let mut diff = 0u8;
for (x, y) in a.iter().zip(b.iter()) {
diff |= x ^ y;
}
diff == 0
}
/// 校验一份远程证明是否与本轮会话绑定。
///
/// # 检查项(全部 fail-closed)
///
/// - 报告平台与期望一致;
/// - `user_data` 与 [`SessionBinding::user_data`] 逐字节一致(定长比较);
/// - 报告原文非空;
/// - 会话已建立、镜像度量已 pin;
/// - 节点 TCB 不低于门槛;
/// - 调用方给出的 measurement pin 与绑定值一致。
///
/// 证书链**不在这里验**:芯片签名与证书链由验证方核验,见模块文档。
#[allow(clippy::too_many_arguments)]
pub fn verify_bound_attestation(
att: &Attestation,
binding: &SessionBinding,
platform: PlatformKind,
tcb: u32,
min_tcb: u32,
pinned_measurement: Option<&[u8; 32]>,
) -> Result<(), TeeError> {
if att.platform != platform {
return Err(TeeError::AttestFailed(String::from("报告平台与期望平台不一致")));
}
if !binding.has_session() {
return Err(TeeError::AttestFailed(String::from("会话未建立,不能出证明")));
}
if !binding.has_measurement() {
return Err(TeeError::AttestFailed(String::from("代码度量未 pin")));
}
if tcb < min_tcb {
return Err(TeeError::AttestFailed(String::from("节点 TCB 低于门槛")));
}
if att.report.is_empty() {
return Err(TeeError::AttestFailed(String::from("报告原文为空")));
}
if let Some(pinned) = pinned_measurement {
if !ct_eq(pinned, &binding.code_measurement) {
return Err(TeeError::AttestFailed(String::from(
"代码度量与准入时 pin 的值不一致",
)));
}
}
let expected = binding.user_data(platform, tcb);
if !ct_eq(&att.user_data, &expected) {
return Err(TeeError::AttestFailed(String::from(
"user_data 与本次会话绑定不一致(可能是重放报告)",
)));
}
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
fn binding() -> SessionBinding {
SessionBinding::new([7u8; 32], "alice", [3u8; 32], [9u8; 32])
}
fn report(ud: [u8; 64]) -> Attestation {
Attestation {
platform: PlatformKind::SevSnp,
user_data: ud,
report: Vec::from([1u8, 2, 3, 4]),
cert_chain: Vec::new(),
}
}
fn check(att: &Attestation, b: &SessionBinding) -> Result<(), TeeError> {
verify_bound_attestation(att, b, PlatformKind::SevSnp, 5, 3, None)
}
#[test]
fn user_data_is_64_bytes_and_deterministic() {
let b = binding();
assert_eq!(b.user_data(PlatformKind::SevSnp, 5).len(), USER_DATA_LEN);
assert_eq!(
b.user_data(PlatformKind::SevSnp, 5),
b.user_data(PlatformKind::SevSnp, 5)
);
}
#[test]
fn every_binding_input_changes_user_data() {
let b = binding();
let base = b.user_data(PlatformKind::SevSnp, 5);
let mut other = b.clone();
other.session_id[0] ^= 1;
assert_ne!(base, other.user_data(PlatformKind::SevSnp, 5));
let mut other = b.clone();
other.site = String::from("bob");
assert_ne!(base, other.user_data(PlatformKind::SevSnp, 5));
let mut other = b.clone();
other.session_pubkey[0] ^= 1;
assert_ne!(base, other.user_data(PlatformKind::SevSnp, 5));
let mut other = b.clone();
other.code_measurement[0] ^= 1;
assert_ne!(base, other.user_data(PlatformKind::SevSnp, 5));
assert_ne!(base, b.user_data(PlatformKind::HygonCsv, 5), "换平台必须换值");
assert_ne!(base, b.user_data(PlatformKind::SevSnp, 6), "换 TCB 必须换值");
}
#[test]
fn valid_bound_report_passes() {
let b = binding();
let att = report(b.user_data(PlatformKind::SevSnp, 5));
assert!(check(&att, &b).is_ok());
}
#[test]
fn replayed_or_wrong_session_report_is_rejected() {
let b = binding();
let mut stale = b.clone();
stale.session_id[0] ^= 1;
let att = report(stale.user_data(PlatformKind::SevSnp, 5));
assert!(check(&att, &b).is_err(), "别的会话的报告不能重放到本轮");
}
#[test]
fn rejects_empty_report_and_wrong_platform() {
let b = binding();
let mut att = report(b.user_data(PlatformKind::SevSnp, 5));
att.report.clear();
assert!(check(&att, &b).is_err());
let mut att = report(b.user_data(PlatformKind::SevSnp, 5));
att.platform = PlatformKind::HygonCsv;
assert!(check(&att, &b).is_err());
}
#[test]
fn rejects_unpinned_measurement_and_zero_session() {
let mut b = binding();
b.code_measurement = [0u8; 32];
let att = report(b.user_data(PlatformKind::SevSnp, 5));
assert!(check(&att, &b).is_err());
let mut b = binding();
b.session_id = [0u8; 32];
let att = report(b.user_data(PlatformKind::SevSnp, 5));
assert!(check(&att, &b).is_err());
}
#[test]
fn rejects_low_tcb_and_mismatched_pin() {
let b = binding();
let att = report(b.user_data(PlatformKind::SevSnp, 2));
assert!(verify_bound_attestation(
&att,
&b,
PlatformKind::SevSnp,
2,
3,
None
)
.is_err());
let att = report(b.user_data(PlatformKind::SevSnp, 5));
let wrong = [1u8; 32];
assert!(verify_bound_attestation(
&att,
&b,
PlatformKind::SevSnp,
5,
3,
Some(&wrong)
)
.is_err());
}
}