密钥下发从「问就给」改成「先出证明,才给密钥」: - 新增 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 扩到九条,全部通过。
298 lines
11 KiB
Rust
298 lines
11 KiB
Rust
//! 会话绑定证明 —— 让远程证明回答「这一次计算」而不是「这台机器」。
|
||
//!
|
||
//! # 为什么必须有这一层
|
||
//!
|
||
//! 只把容器塞进加密 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());
|
||
}
|
||
}
|