fix(tee): 按海光厂商 SDK 实测修正 CSV 报告总长 4096→2548

- 在 192.168.1.102 用海光厂商 SDK 头文件 /opt/hygon/csv/attestation/csv_status.h 经本机 gcc offsetof/sizeof 实测确认 struct csv_attestation_report:user_data@0x40、measure@0x90(32B SM3)、policy@0xB0、sig1@0xC0(144B),sizeof=2548,且结构体内无 version 字段。\n- 修正真 bug:CSV_REPORT_LEN / hygon_csv_layout().total_len 原写 4096(那是 hypercall/mmap 页大小),而 get-attestation 实际写出 sizeof(struct)=2548,原长度下限会拒掉每一份真实 CSV 报告;现改为 2548,4096 页填充仍按下限接受。\n- 新增回归测试 csv_real_size_accepted_and_page_padding_tolerated(2548 接受 / 2547 拒绝 / 4096 页填充接受),mpc-tee 单测 87→88。\n- docs/TEE_DIRECT_LAUNCH.md 同步表与说明,并如实标注「真实 CSV 报告 live 捕获未做(.102 主机无 /dev/csv-guest,须在 guest 内 ioctl 取)」。\n- 验证:./tools/ci.sh 四道全绿。
This commit is contained in:
admin committed 2026-11-06 20:08:23 +08:00
1 parent 25c3baf880
commit eba460b4ff
2 files changed
+78 -33

No files matched your search

+50 -17
View File
@@ -22,15 +22,17 @@
//!
//! | 字段 | AMD SEV-SNP | 海光 CSV(固件报告) |
//! |---|---|---|
//! | 报告总长 | 1184 字节 | 4096 字节(一页) |
//! | 报告总长 | 1184 字节 | **2548 字节**(结构体;hypercall 页为 4096) |
//! | `user_data`/`report_data` 偏移 | 0x50,64 字节 | **0x40**,64 字节 |
//! | launch measurement 偏移 / 长度 | 0x90 / **48 字节 SHA-384** | 0x90 / **32 字节 SM3** |
//! | 签名字段偏移 / 长度 | 0x2A0 / **512 字节** | 0xC0 / **144 字节** |
//!
//! CSV 报告布局来自开源参考 `inclavare-containers/rats-tls` 的 `csv.h`
//!(`csv_attestation_report`,`__attribute__((packed))`)。**这是汇编/固件级事实,
//! 必须在 `192.168.1.102` 用 `csv-guest-tool` 导出真实报告复核偏移与签名算法**
//! (见本文件 `hygon_csv_layout()` 的 TODO)。因此解析逻辑被泛化成
//! CSV 报告布局**已在 `192.168.1.102` 用海光厂商 SDK 实测确认**:头文件
//! `/opt/hygon/csv/attestation/csv_status.h` 的 `struct csv_attestation_report`
//! 经本机 gcc 编译 `offsetof/sizeof` 得到真实偏移与长度(`user_data`@0x40、
//! `measure`@0x90(32B)、`policy`@0xB0、`sig1`@0xC0(144B)、`sizeof`=**2548**);
//! 早前参照的 `inclavare-containers/rats-tls` `csv.h` 仅作交叉印证。
//! 解析逻辑因此被泛化成
//! [`parse_sev_like_report`],SNP 与 CSV 复用同一套代码,各自带自己的
//! [`ReportLayout`]——既落实「能力通用」,又不为图省事把 SNP 的字节偏移套到 CSV 上。
//!
@@ -52,8 +54,13 @@ use std::vec::Vec;
/// AMD SEV-SNP 固件报告总长(字节)。
pub const SNP_REPORT_LEN: usize = 1184;
/// 海光 CSV 固件报告总长(字节,一页)。
pub const CSV_REPORT_LEN: usize = 4096;
/// 海光 CSV 固件报告总长(字节)。
///
/// 这是 `struct csv_attestation_report` 的 `sizeof`,在 `192.168.1.102` 用海光
/// 厂商 SDK 头文件经 gcc 实测确认。**注意 4096 是 hypercall/mmap 的页大小,
/// 不是报告长度**——`get-attestation` 写出的是 `sizeof(struct)` = 2548 字节;
/// 若把这里写成 4096,真实报告会被长度下限直接拒掉。
pub const CSV_REPORT_LEN: usize = 2548;
/// 一份 SEV 系证明报告的字节布局。
///
@@ -102,14 +109,18 @@ pub const fn snp_layout() -> ReportLayout {
/// 海光 CSV(固件 `sev-guest`,派生自 AMD SEV/SEV-ES)的固件报告布局。
///
/// 偏移与长度来自 `inclavare-containers/rats-tls` 的 `csv.h`
///(`csv_attestation_report`,`__attribute__((packed))`):
/// `user_data` @0x40(64B 挑战值)、`measure` @0x90(32B SM3 度量)、
/// `sig1` @0xC0(144B ECC 签名)、`policy` @0xB0(4B)。
/// **已在 `192.168.1.102` 用海光厂商 SDK 实测确认**:头文件
/// `/opt/hygon/csv/attestation/csv_status.h` 的 `struct csv_attestation_report`
///(`__attribute__((packed))`),经本机 gcc 编译 `offsetof/sizeof` 得到:
/// - `user_pubkey_digest` @0x00、`vm_id` @0x20、`vm_version` @0x30
/// - `user_data` @0x40(64B 挑战值)、`mnonce` @0x80(16B,框架不用)
/// - `measure` @0x90(32B SM3 度量)、`policy` @0xB0(4B)
/// - `sig1` @0xC0(144B ECC 签名,`ECC_POINT_SIZE*2`)、`pek_cert` @0x150
/// - `sizeof(struct)` = **2548**,`get-attestation` 写出的就是 2548 字节
/// - 结构体内**没有** `version` 字段 → `version_offset: None` 成立
///
/// TODO(verify-on-hygon): 在 `192.168.1.102` 用 `csv-guest-tool` 导出真实 CSV
/// 报告,复核本布局的偏移、签名算法(ECC 曲线)与 `version` 是否确实不在报告体内。
/// 若复核有差,改这里一处即可,解析逻辑不动。
/// hypercall/mmap 用 4096 一页,但报告结构体本身 2548 字节;解析按 2548 做下限,
/// 4096 的页填充文件同样接受。签名算法 / ECC 曲线语义仍交给验签器按芯片规范解析。
pub const fn hygon_csv_layout() -> ReportLayout {
ReportLayout {
total_len: CSV_REPORT_LEN,
@@ -459,8 +470,9 @@ mod tests {
r
}
/// CSV 报告 fixture:4096 字节,user_data@0x40 = 调用方挑战值,
/// measure@0x90 与 sig1@0xC0 非零。版本号不在报告体内,故不在此构造。
/// CSV 报告 fixture:真实尺寸 2548 字节(`sizeof(struct csv_attestation_report)`,
/// 在 192.168.1.102 用海光厂商 SDK 头文件经 gcc 实测),user_data@0x40 =
/// 调用方挑战值,measure@0x90 与 sig1@0xC0 非零。版本号不在报告体内,故不构造。
fn csv_fixture(user_data: &[u8; 64]) -> Vec<u8> {
let mut r = vec![0u8; CSV_REPORT_LEN];
r[0x40..0x40 + 64].copy_from_slice(user_data);
@@ -523,7 +535,7 @@ mod tests {
#[test]
fn parse_rejects_malformed_csv_reports() {
let ud = [9u8; 64];
// 长度不足(至少要 4096,这里给 100)
// 长度不足(真实报告 2548,这里给 100)
assert!(parse_sev_like_report(&csv_fixture(&ud)[..100], &hygon_csv_layout()).is_err());
// measure 全零
let mut r = csv_fixture(&ud);
@@ -540,6 +552,27 @@ mod tests {
assert_eq!(view.signature.len(), 144);
}
/// 真机真值回归:真实 CSV 报告是 2548 字节(不是 4096),必须被接受;
/// 少 1 字节必须被拒;页填充到 4096 也要接受(下限语义)。
/// 这条测试专门钉住「把 sizeof 误写成 4096 会拒掉所有真实报告」这个真机 bug。
#[test]
fn csv_real_size_accepted_and_page_padding_tolerated() {
let ud = [7u8; 64];
let real = csv_fixture(&ud);
assert_eq!(real.len(), 2548, "CSV 报告真实尺寸应为 sizeof(struct)");
assert!(
parse_sev_like_report(&real, &hygon_csv_layout()).is_ok(),
"真实 2548 字节的 CSV 报告必须通过长度下限"
);
// 少 1 字节按边界拒绝。
assert!(parse_sev_like_report(&real[..2547], &hygon_csv_layout()).is_err());
// hypercall 页(4096)填充的文件同样接受。
let mut padded = real.clone();
padded.resize(4096, 0);
let view = parse_sev_like_report(&padded, &hygon_csv_layout()).unwrap();
assert_eq!(view.user_data, ud);
}
#[test]
fn snp_without_verifier_is_explicitly_not_verified() {
let (b, a) = setup(PlatformKind::SevSnp);
+28 -16
View File
@@ -199,7 +199,7 @@ AMD SEV/SEV-ES,**与 SNP 共享同一套证明绑定原语**(64 字节 `user
| 字段 | AMD SEV-SNP | 海光 CSV(固件报告) |
|---|---|---|
| 报告总长 | 1184 字节 | 4096 字节(一页) |
| 报告总长 | 1184 字节 | **2548 字节**(结构体;hypercall 页为 4096) |
| `user_data`/`report_data` 偏移 / 长度 | 0x50 / 64B | **0x40** / 64B |
| launch measurement 偏移 / 长度 | 0x90 / **48B SHA-384** | 0x90 / **32B SM3** |
| 签名字段偏移 / 长度 | 0x2A0 / **512B** | 0xC0 / **144B** |
@@ -209,20 +209,32 @@ AMD SEV/SEV-ES,**与 SNP 共享同一套证明绑定原语**(64 字节 `user
字节偏移错套到 CSV 上。`HygonCsv` 现在按 CSV 固件报告布局真实解析、并校验 `user_data`
与会话绑定一致,不再走兜底。
> CSV 报告的字节布局来自开源参考 `inclavare-containers/rats-tls` 的 `csv.h`
>(`csv_attestation_report`,`__attribute__((packed))`)。**这是汇编/固件级事实,
> 必须在 `192.168.1.102` 用 `csv-guest-tool` 导出真实报告复核偏移与签名算法**
> (`crates/mpc-tee/src/verify.rs` 的 `hygon_csv_layout()` 已留 TODO)。
> **已在 `192.168.1.102` 用海光厂商 SDK 实测确认**(不是只靠开源参考):头文件
> `/opt/hygon/csv/attestation/csv_status.h` 的 `struct csv_attestation_report`
> 经本机 gcc 编译 `offsetof/sizeof` 得到——`user_pubkey_digest`@0x00、`vm_id`@0x20、
> `vm_version`@0x30、`user_data`@0x40、`mnonce`@0x80、`measure`@0x90(32B SM3)、
> `policy`@0xB0、`sig1`@0xC0(144B)、`pek_cert`@0x150、`sizeof`=**2548**,且结构体内
> 无 `version` 字段。这次复核抓到一个真 bug:`verify.rs` 原先把报告总长写成 4096
>(那是 hypercall/mmap 的页大小,不是报告长度),会让**每一份真实 CSV 报告被长度下限
> 直接拒掉**;已改为 2548 并加回归测试钉死。开源参考 `inclavare-containers/rats-tls`
> 的 `csv.h` 仅作交叉印证。签名算法 / ECC 曲线语义仍由验签器按芯片规范负责。
**已交付(本轮)**:AMD SNP 与海光 CSV 两份固件报告的**结构校验**已统一实现
(布局参数化、共用解析逻辑),CSV 不再走「长度≥64 即过」的兜底;`verify_attestation`
对两平台都如实区分「结构与绑定通过 / 芯片签名未验证」。`mpc tee verify` / `mpc tee kbs-get`
已可调用(见上一轮提交)。
**已交付**:AMD SNP 与海光 CSV 两份固件报告的**结构校验**已统一实现(布局参数化、
共用解析逻辑),CSV 不再走兜底;CSV 布局已在真机用厂商 SDK 编译器确认(2548 字节),
`verify_attestation` 对两平台都如实区分「结构与绑定通过 / 芯片签名未验证」。
`mpc tee verify` / `mpc tee kbs-get` 已可调用;KBS 最小客户端与 OCI 分层镜像构建
(`deploy/tee/{kbs,oci}`)已入仓。
**仍未交付**:芯片签名的**真实验签器**尚未接入(框架只做结构校验 + 会话绑定,把
ECDSA/证书链验签委托给外部验签器,但目前没有配置好的验签器——`verify_attestation`
返回 `Ok` 仅表示「结构与绑定通过」);自定义 guest initrd 的构建流水线(本次仍是手工构造)、
KBS 资源下发协议与证书链验签器仍属 stub。本次 guest 的 PSK 内置在 initrd 里(测试用),
生产必须走 KBC 注入。因此准确说法是:**AMD SNP 与海光 CSV 两条路径的直接启动
与跨机密文会话均已端到端跑通**;芯片验签、KBC 密钥下发、镜像构建流水线
仍在生产化之外。
**仍未交付(如实标注)**:
- **芯片签名真实验签器**尚未接入:框架只做结构校验 + 会话绑定,ECDSA / 证书链 /
`sig_algo` 曲线语义交给外部验签器,目前没有配置好的验签器——`verify_attestation`
返回 `Ok` 仅表示「结构与绑定通过」。
- **真实 CSV 报告的 live 捕获未做**:`.102` 主机没有 `/dev/csv-guest`(报告必须在
CSV guest 内用 ioctl 取),主机上跑 `get-attestation` 直接 `open /dev/csv-guest failed`。
本轮验证是「厂商 SDK 头文件 + 编译器确认布局」,尚未从一间运行中的 CSV guest
导出真实报告字节做端到端比对。
- **OCI 打包 + KBS 注入**链路代码已就位,但尚未在两台真机端到端复跑。
因此准确说法是:**AMD SNP 与海光 CSV 两条路径的直接启动与跨机密文会话均已端到端
跑通**;芯片验签、KBC 密钥下发、真实报告捕获、OCI 镜像流水线仍在生产化之外。