Files
ssw-mpc/crates/mpc-tee/src/platform.rs
T
admin e839a972c0 feat(tee): 接入 AMD SEV-SNP 芯片验签,双平台「先验证明才给密钥」全部真机跑通
## 改了什么

- **SNP 芯片签名验签闭环**:新增 `snp_collect.rs`(SNP_GET_EXT_REPORT ioctl
  + GHCB 切分)、`snp-verify-attestation.sh`(VCEK 走 AMD KDS)、
  `selftest-snp-verify.py`(正 1 + 负 8),进主闸门第 10 条。
- **框架侧补 `mpc.tee.platform`**:`tee plan` 现在告诉 guest 用哪个平台采证明。
- **KBS 补独立 `--pin`**:`MPC_KBS_PIN` 与 `--measurement` 解耦,缺省回落,
  既有部署行为不变 —— 这是「度量 pin 那一关」唯一能被单独测到的姿势。
- **guest stdout 修复**:init 开头 mknod 真 `/dev/console` + `exec > ... 2>&1`;
  `run-guest.py` 加 `MPC_TEE_SERIAL_LOG` 换 chardev file 落盘。
- **负向矩阵**:新增 `snp-attest-negative.sh`(6 条),判据全部收紧到该关独有文案。
- **KBS 就绪判据**:`kbs-net.sh` 从「进程存活」改成「端口进 LISTEN」。
- **文档**:`TEE_DIRECT_LAUNCH.md` 新增 SNP 整节 + bug 1~9;
  `TEE_OCI_PATH.md` 补 SNP 侧与负向判据唯一性;新增 `INTEGRATION_ANALYSIS.md`
  与 `OPTEE_VERIF_PLAN.md`;`ci.sh` 加 no_std 双守、TA UUID 对拍、SNP 自测。

## 什么影响

- 真机(海光 CSV `192.168.1.102` + AMD SNP `192.168.1.7`)**双向跑通**,
  两端用同一份 Rust 判定代码。
- SNP 正向 e2e 7/7、负向 6/6 全部真拒在各自关卡;`tools/ci.sh` 十条全绿。
- 三处真 bug 已修:guest stdout 全丢(`/dev/console` 是普通文件 +
  `-nographic`/`-serial stdio` 抢 stdio)、`MPC_KBS_PIN` 接口缺口、
  负向判据不唯一(兜底分支导致假绿)。
- 边界不变:`attest-mkbundle` 仍是合成件,过不了芯片验签(仅自测用)。
2026-11-07 12:47:22 +08:00

456 lines
19 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.
//! 平台能力表 —— AMD SEV-SNP / 海光 CSV 的硬件与启动参数唯一真相源。
//!
//! # 这一层是什么、不是什么
//!
//! `mpc-tee` 的 [`crate::Tee`] 描述的是 **guest 内**能干什么(seal / attest / sign);
//! 本模块描述的是**把这个 guest 直接启动起来**需要哪些硬件事实:设备节点、
//! qemu 对象类型、guest policy、证明通道、密钥代理模式。框架据此做准入判定并
//! 生成 qemu 参数,**不经过任何容器编排层**。
//!
//! # 海光 CSV 是国产版 SEV:能力通用、参数各异
//!
//! 海光 CSV 派生自 AMD SEV/SEV-ES,与 SNP **共享同一套证明绑定原语**(64 字节
//! `user_data` 必须等于会话绑定值、launch measurement、固件签名),所以 attestation
//! 报告解析在 [`crate::verify`] 里被泛化成布局参数化的共用逻辑。但两者**固件报告的
//! 字节布局并不兼容**(CSV 报告 **2548** 字节、`user_data` @0x40、measurement 32B SM3;
//! SNP 1184 字节、`report_data` @0x50、measurement 48B SHA-384),qemu/hardware 启动
//! 参数(对象名、cbitpos、内存加密参数名、固件加载方式)也确实不同——这些差异是
//! 真实硬件事实,必须分平台保留,不能为了"统一"而套错偏移。
//!
//! 注意这里只放**平台语义**,不放宿主文件路径。qemu / 固件 / 内核 / initrd
//! 的具体位置由部署侧通过 [`crate::schedule::TeeNode`] 注入 —— 换一台机器、
//! 换一个 qemu 构建,改的是节点描述,不是框架代码。真机实测路径记录在
//! `deploy/tee/` 的 profile 示例里。
//!
//! # 参数出处(2026-11-06 真机实测)
//!
//! | 项 | AMD `192.168.1.7`(tee-node-01) | 海光 `192.168.1.102` |
//! |---|---|---|
//! | CPU | AMD EPYC 7203 | Hygon C86 7255 |
//! | 宿主内核 | `6.13.0-snp-guest-*` | `5.10.134-csv` |
//! | 固件设备 | `/dev/sev`,SEV-SNP ASID 1–99 | `/dev/sev`,`sev=1 sev_es=1` |
//! | qemu | 9.1.2 | 6.2.0 |
//! | qemu 对象 | `sev-snp-guest` | `sev-guest` |
//! | guest policy | SNP policy `0x30000` | CSV2 = 7,DCU 变体 = 3,CSV3 = 71 |
//! | vCPU 模型 | 默认 | `host` |
//! | 证明通道 | guest 内 `/dev/sev-guest` | guest 内 vmmcall / ioctl 原生接口 |
//! | 密钥代理 | 在线 `cc_kbc`(Trustee KBS 在同机 `:8080`) | 离线 `offline_fs_kbc`(initrd 内置) |
//!
//! 海光 guest initrd 里实测有 `usr/local/bin/attestation-agent` 与
//! `etc/aa-offline_fs_kbc-keys.json`;宿主 `/opt/hygon/csv/attestation/` 下有
//! `get-attestation` / `verify-attestation` 等原生工具。这两处是「guest 内直接
//! 拿证明和密钥」的现成接口,框架只负责把会话绑定值传给它们。
use crate::PlatformKind;
use alloc::format;
use alloc::string::String;
/// 海光 CSV 的硬件代际。**policy 必须和代际匹配**,错配会直接启动失败。
///
/// 实测该节点是 CSV2(policy 7);DCU 变体用 policy 3 且内存配额显著更大。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum CsvVariant {
/// CSV(初代)。
Csv,
/// CSV2(192.168.1.102 实测)。
Csv2,
/// CSV3,需要 `vcpu_model = "Dhyana"`。
Csv3,
/// DCU 变体。
Dcu,
}
impl CsvVariant {
/// 该代际对应的 `sev_guest_policy`。
pub fn policy(self) -> u32 {
match self {
Self::Csv | Self::Dcu => 3,
Self::Csv2 => 7,
Self::Csv3 => 71,
}
}
/// 稳定名字,用于日志与 CLI。
pub fn as_str(self) -> &'static str {
match self {
Self::Csv => "csv",
Self::Csv2 => "csv2",
Self::Csv3 => "csv3",
Self::Dcu => "csv-dcu",
}
}
/// CSV3 需要显式指定 vCPU 模型,其余代际沿用宿主模型。
pub fn vcpu_model(self) -> Option<&'static str> {
match self {
Self::Csv3 => Some("Dhyana"),
// 192.168.1.102 实测配置项为 `vcpu_model = "host"`
Self::Csv | Self::Csv2 | Self::Dcu => Some("host"),
}
}
/// DCU 变体实测内存配额为 16 GiB,其余为 2 GiB。
pub fn memory_mib(self) -> u32 {
match self {
Self::Dcu => 16384,
_ => 2048,
}
}
}
/// guest 内密钥代理(KBC)模式。
///
/// 这是 **guest 内**证明代理取密钥的方式,与宿主用哪种编排毫无关系:
/// 在线模式走 KBS 协议,离线模式直接用 initrd 内置资源。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum KbcMode {
/// 在线:证明代理经远程证明向 KBS 换密钥(AMD 侧 Trustee)。
Online,
/// 离线:initrd 内置密钥资源,启动即解封(海光侧)。
Offline,
}
impl KbcMode {
/// 稳定名字。
pub fn as_str(self) -> &'static str {
match self {
Self::Online => "cc_kbc",
Self::Offline => "offline_fs_kbc",
}
}
/// 生成传给 guest 内证明代理的内核参数。
///
/// `endpoint` 只在线模式有意义;没给就退回本机默认,不允许拼出空地址。
///
/// endpoint **允许带 scheme 也不允许带**:两种写法都要归一化成
/// `http://host:port` 一个形式。曾经这里直接拼 `cc_kbc::{ep}`,而调用方
/// (节点描述 / CLI 的 --kbs-endpoint)给的已经是 `http://...`,
/// 真机上就拼成了 `cc_kbc::http://http://10.99.0.1:18080` —— guest
/// 拿到一个解析不了的地址,取料必然失败,而报错现场完全看不出是
/// scheme 拼重了。
pub fn kernel_param(self, endpoint: Option<&str>) -> String {
match self {
Self::Online => {
let raw = endpoint.unwrap_or("http://127.0.0.1:8080").trim();
let raw = raw.trim_end_matches('/');
let ep = if raw.is_empty() {
String::from("http://127.0.0.1:8080")
} else if let Some(rest) = raw.strip_prefix("http://") {
format!("http://{rest}")
} else if let Some(rest) = raw.strip_prefix("https://") {
format!("https://{rest}")
} else {
format!("http://{raw}")
};
format!("agent.aa_kbc_params=cc_kbc::{ep}")
}
Self::Offline => String::from("agent.aa_kbc_params=offline_fs_kbc::null"),
}
}
/// 该模式是否需要 guest 能访问网络。
pub fn needs_network(self) -> bool {
matches!(self, Self::Online)
}
}
/// guest 内取得平台证明报告的通道。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AttestChannel {
/// SNP guest 的设备节点 `/dev/sev-guest`(报告 + VCEK 证书链)。
SnpGuestDevice,
/// 海光 CSV 原生 vmmcall / ioctl 接口,不依赖设备节点。
CsvVmmcall,
}
impl AttestChannel {
/// 稳定名字。
pub fn as_str(self) -> &'static str {
match self {
Self::SnpGuestDevice => "snp-guest-device",
Self::CsvVmmcall => "csv-vmmcall",
}
}
/// guest 内需要存在的设备节点(CSV 走 CPU 指令,不需要设备节点)。
pub fn guest_device(self) -> Option<&'static str> {
match self {
Self::SnpGuestDevice => Some("/dev/sev-guest"),
Self::CsvVmmcall => None,
}
}
}
/// 一个平台的启动规格。**全是平台语义,没有宿主路径**。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct PlatformProfile {
/// 平台类型。
pub kind: PlatformKind,
/// 海光代际(AMD 为 `None`)。
pub csv_variant: Option<CsvVariant>,
/// 宿主上必须存在的机密计算设备节点。
pub host_device: &'static str,
/// guest 内取得证明的通道。
pub attest_channel: AttestChannel,
/// guest 内密钥代理模式(**默认**模式)。
///
/// 只是默认:平台实际允许哪些模式看 [`allowed_kbc`](Self::allowed_kbc)。
pub kbc: KbcMode,
/// 该平台允许的密钥代理模式。
///
/// 早先这里是「平台只支持一种 KBC 模式」的硬编码(CSV 固定 Offline、
/// SNP 固定 Online),于是 `admit()` 里 `node.kbc != profile.kbc` 直接把
/// CSV 的在线 KBC 拒掉了 —— 框架层根本走不了「密钥由 KBS 下发」。
/// 真机上 CoCo 本身就提供 `kata-containers-initrd-csv-hygon-gpu.img.online_sev_kbc`
/// 变体,说明 CSV **支持**在线 KBC,只是框架没放开。
///
/// 现在区分「平台支持哪些」与「默认用哪个」:准入只看前者,
/// 后者只是没显式要求时的缺省值。
pub allowed_kbc: &'static [KbcMode],
/// 在线 KBS 的默认端点(实测 Trustee 与 AMD 计算节点同机)。
///
/// 只是**缺省值**:KBS 实际地址由节点描述给出(`kbs_endpoint=`),
/// 因为它取决于现场部署,不是平台属性。`None` 表示该平台没有内置缺省。
pub kbs_endpoint: Option<&'static str>,
/// qemu `-machine` 参数。
pub machine: &'static str,
/// qemu `-cpu` 参数;`None` 表示用 qemu 默认。
pub vcpu_model: Option<&'static str>,
/// qemu `-object` 的类型名。
pub sev_object: &'static str,
/// 内存加密 C-bit 在物理地址里的位置。**两家平台不一样**:
/// AMD `192.168.1.7` 是 51,海光 `192.168.1.102` 是 47;
/// 写错会直接被 KVM 拒绝(`cbitpos check failed, host '47' requested '51'`)。
pub cbitpos: u8,
/// qemu `-machine` 上挂内存加密对象的参数名(qemu 6 / 9 语法不同)。
pub memory_encryption_flag: &'static str,
/// 固件是否必须以 pflash(`-drive if=pflash`)加载。
/// 海光 qemu 6.2 在 `kernel-hashes=on` 时要解析 OVMF flash 表,用 `-bios`
/// 会触发 `pc_system_ovmf_table_find` 断言;AMD qemu 9.1.2 用 `-bios` 即可。
pub firmware_pflash: bool,
/// guest policy(`None` = 由 qemu 平台默认决定)。
pub guest_policy: Option<u32>,
/// 默认 vCPU 数。
pub vcpus: u16,
/// 默认内存(MiB)。
pub memory_mib: u32,
/// 除 KBC 与会话绑定外的附加内核参数。
pub kernel_params: &'static str,
}
impl PlatformProfile {
/// AMD SEV-SNP(qemu 9.x 语法)。
pub fn amd_sev_snp() -> Self {
Self {
kind: PlatformKind::SevSnp,
csv_variant: None,
host_device: "/dev/sev",
attest_channel: AttestChannel::SnpGuestDevice,
kbc: KbcMode::Online,
allowed_kbc: &[KbcMode::Online, KbcMode::Offline],
kbs_endpoint: Some("http://192.168.1.7:8080"),
machine: "q35",
vcpu_model: Some("host"),
sev_object: "sev-snp-guest",
cbitpos: 51,
// 2026-11-06 真机校正:宿主 qemu 9.1.2 的属性名是
// `confidential-guest-support`,真机上正在运行的 SNP guest 命令行
// 用的也是它;`conf-guest-support` 会直接报属性不存在。
memory_encryption_flag: "confidential-guest-support",
firmware_pflash: false,
guest_policy: Some(0x30000),
vcpus: 1,
memory_mib: 2048,
// 串口是唯一能拿到 guest 启动证据的通道;virtio-serial 的
// `console=hvc0` 要有配套控制台设备,直接启动时不具备。
kernel_params: "console=ttyS0 cgroup_no_v1=all systemd.unified_cgroup_hierarchy=1",
}
}
/// 海光 CSV(qemu 6.2 语法)。
pub fn hygon_csv(variant: CsvVariant) -> Self {
Self {
kind: PlatformKind::HygonCsv,
csv_variant: Some(variant),
host_device: "/dev/sev",
attest_channel: AttestChannel::CsvVmmcall,
kbc: KbcMode::Offline,
machine: "q35",
vcpu_model: variant.vcpu_model(),
sev_object: "sev-guest",
cbitpos: 47,
memory_encryption_flag: "memory-encryption",
// 2026-11-06 真机校正:CSV 的 direct boot 必须走 pflash 固件,
// 否则 kernel-hashes=on 会让 qemu 6.2 在 OVMF flash 表上断言失败。
firmware_pflash: true,
guest_policy: Some(variant.policy()),
vcpus: 4,
memory_mib: variant.memory_mib(),
kernel_params: "console=ttyS0",
// CSV 两种模式都支持:CoCo 自带
// `kata-containers-initrd-csv-hygon-gpu.img.online_sev_kbc` 变体,
// 在线 KBC(密钥由 KBS 按会话下发)是可用路径;离线是缺省。
allowed_kbc: &[KbcMode::Online, KbcMode::Offline],
// CSV 没有内置缺省端点 —— KBS 地址取决于现场部署,
// 由节点描述的 `kbs_endpoint=` 给出。
kbs_endpoint: None,
}
}
/// 按平台取内置规格;尚未支持直接启动的平台返回 `None`。
///
/// 海光不指定代际时按实测的 CSV2 处理,不做"猜一个能跑的"降级。
pub fn builtin(kind: PlatformKind, variant: Option<CsvVariant>) -> Option<Self> {
match kind {
PlatformKind::SevSnp => Some(Self::amd_sev_snp()),
PlatformKind::HygonCsv => Some(Self::hygon_csv(variant.unwrap_or(CsvVariant::Csv2))),
_ => None,
}
}
/// 人类可读的规格名。
pub fn name(&self) -> String {
match self.csv_variant {
Some(v) => format!("hygon-csv/{}", v.as_str()),
None => String::from("amd-sev-snp"),
}
}
}
/// 全部内置规格,按固定顺序 —— CLI 的 `tee paths` 直接遍历它。
///
/// 用函数而不是 `const`:规格里的 guest policy 等字段由代际推导,
/// 保持一个来源比为了常量化把整条链路都改成 `const fn` 更不容易写错。
pub fn builtin_profiles() -> [PlatformProfile; 5] {
[
PlatformProfile::amd_sev_snp(),
PlatformProfile::hygon_csv(CsvVariant::Csv),
PlatformProfile::hygon_csv(CsvVariant::Csv2),
PlatformProfile::hygon_csv(CsvVariant::Csv3),
PlatformProfile::hygon_csv(CsvVariant::Dcu),
]
}
/// 解析定长十六进制字节串(no_std,不引格式化库)。
///
/// 节点 profile 里的 measurement / 会话标识都走这里;长度不符或含非十六进制
/// 字符一律 `None`,由调用方转成错误,不做"截一段凑合用"。
pub fn parse_hex<const N: usize>(s: &str) -> Option<[u8; N]> {
let b = s.as_bytes();
if b.len() != N * 2 {
return None;
}
let mut out = [0u8; N];
for i in 0..N {
let hi = (b[2 * i] as char).to_digit(16)? as u8;
let lo = (b[2 * i + 1] as char).to_digit(16)? as u8;
out[i] = (hi << 4) | lo;
}
Some(out)
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn csv_policy_matches_generation() {
assert_eq!(CsvVariant::Csv.policy(), 3);
assert_eq!(CsvVariant::Csv2.policy(), 7);
assert_eq!(CsvVariant::Csv3.policy(), 71);
assert_eq!(CsvVariant::Dcu.policy(), 3);
assert_eq!(CsvVariant::Csv3.vcpu_model(), Some("Dhyana"));
assert_eq!(CsvVariant::Dcu.memory_mib(), 16384);
}
#[test]
fn kbc_params_are_well_formed() {
assert_eq!(
KbcMode::Online.kernel_param(Some("http://192.168.1.7:8080")),
"agent.aa_kbc_params=cc_kbc::http://192.168.1.7:8080"
);
assert_eq!(
KbcMode::Offline.kernel_param(None),
"agent.aa_kbc_params=offline_fs_kbc::null"
);
assert!(KbcMode::Online.needs_network());
assert!(!KbcMode::Offline.needs_network());
}
#[test]
fn online_mode_never_produces_empty_endpoint() {
let p = KbcMode::Online.kernel_param(None);
assert!(p.contains("127.0.0.1:8080"), "{p}");
}
#[test]
fn online_endpoint_scheme_is_never_doubled() {
// 节点描述 / --kbs-endpoint 给的常常已经带 http://。
// 早先这里直接拼 `cc_kbc::{ep}`,真机上就成了
// `cc_kbc::http://http://10.99.0.1:18080` —— guest 拿到一个解析不了
// 的地址,取料必然失败,而报错现场完全看不出是 scheme 拼重了。
for (input, want) in [
("http://10.99.0.1:18080", "http://10.99.0.1:18080"),
("https://10.99.0.1:18080", "https://10.99.0.1:18080"),
("10.99.0.1:18080", "http://10.99.0.1:18080"),
("http://10.99.0.1:18080/", "http://10.99.0.1:18080"),
(" http://10.99.0.1:18080 ", "http://10.99.0.1:18080"),
] {
let p = KbcMode::Online.kernel_param(Some(input));
assert_eq!(
p,
format!("agent.aa_kbc_params=cc_kbc::{want}"),
"输入 {input:?} 的 scheme 归一化不对"
);
assert_eq!(p.matches("http://").count(), if want.starts_with("https") { 0 } else { 1 });
}
}
#[test]
fn profiles_are_platform_neutral() {
for p in builtin_profiles() {
assert_eq!(p.host_device, "/dev/sev");
assert!(!p.sev_object.is_empty());
assert!(p.vcpus > 0);
assert!(p.memory_mib > 0);
}
assert_eq!(
PlatformProfile::amd_sev_snp().memory_encryption_flag,
"confidential-guest-support"
);
assert_eq!(
PlatformProfile::hygon_csv(CsvVariant::Csv2).memory_encryption_flag,
"memory-encryption"
);
assert_eq!(PlatformProfile::amd_sev_snp().cbitpos, 51);
assert_eq!(PlatformProfile::hygon_csv(CsvVariant::Csv2).cbitpos, 47);
// 真机证伪了「CSV 不需要 kernel-hashes」:CSV 反而必须 pflash 固件,
// 否则 -bios + kernel-hashes 会让 qemu 6.2 断言崩溃。
assert!(!PlatformProfile::amd_sev_snp().firmware_pflash);
assert!(PlatformProfile::hygon_csv(CsvVariant::Csv2).firmware_pflash);
}
#[test]
fn hex_parsing_is_strict() {
assert_eq!(parse_hex::<2>("00ff"), Some([0, 255]));
assert_eq!(parse_hex::<32>(&"ab".repeat(32)), Some([0xabu8; 32]));
assert_eq!(parse_hex::<2>("00f"), None);
assert_eq!(parse_hex::<2>("00zz"), None);
}
#[test]
fn unsupported_platforms_have_no_profile() {
assert!(PlatformProfile::builtin(PlatformKind::Tdx, None).is_none());
assert!(PlatformProfile::builtin(PlatformKind::Optee, None).is_none());
assert!(PlatformProfile::builtin(PlatformKind::None, None).is_none());
assert_eq!(
PlatformProfile::builtin(PlatformKind::HygonCsv, None)
.unwrap()
.guest_policy,
Some(7),
"不指定代际时按实测 CSV2 处理"
);
}
}