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:
1 parent
25c3baf880
commit
eba460b4ff
2 files changed
+78
-33
No files matched your search
@@ -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
@@ -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 镜像流水线仍在生产化之外。
|
||||
Reference in new issue
Block a user