From eba460b4ffe780d2102126612a9e0a41e562cb6b Mon Sep 17 00:00:00 2001 From: admin Date: Fri, 6 Nov 2026 20:08:23 +0800 Subject: [PATCH] =?UTF-8?q?fix(tee):=20=E6=8C=89=E6=B5=B7=E5=85=89?= =?UTF-8?q?=E5=8E=82=E5=95=86=20SDK=20=E5=AE=9E=E6=B5=8B=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?=20CSV=20=E6=8A=A5=E5=91=8A=E6=80=BB=E9=95=BF=204096=E2=86=9225?= =?UTF-8?q?48?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 在 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 四道全绿。 --- crates/mpc-tee/src/verify.rs | 67 +++++++++++++++++++++++++++--------- docs/TEE_DIRECT_LAUNCH.md | 44 ++++++++++++++--------- 2 files changed, 78 insertions(+), 33 deletions(-) diff --git a/crates/mpc-tee/src/verify.rs b/crates/mpc-tee/src/verify.rs index c7dc6d1..f872d56 100644 --- a/crates/mpc-tee/src/verify.rs +++ b/crates/mpc-tee/src/verify.rs @@ -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 { 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); diff --git a/docs/TEE_DIRECT_LAUNCH.md b/docs/TEE_DIRECT_LAUNCH.md index 2d01675..6d49dbc 100644 --- a/docs/TEE_DIRECT_LAUNCH.md +++ b/docs/TEE_DIRECT_LAUNCH.md @@ -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 镜像流水线仍在生产化之外。