sev-attestation

面向加密虚拟机身份验证的 AMD SEV-SNP 远程证明能力。

描述

执行 AMD SEV-SNP（Secure Encrypted Virtualization - Secure Nested Paging，安全加密虚拟化-安全嵌套分页）远程证明，以密码学方式验证虚拟机（VM）的身份与完整性。在以下场景中使用该能力：

• 证明虚拟机正在真实的 AMD SEV-SNP 机密计算环境中运行
• 在将密钥等敏感信息委托给机密虚拟机前，验证其完整性
• 检查 SEV-SNP 是否可用且已正确配置
• 生成用于远程验证的证明报告
• 验证 AMD 证书链（ARK → ASK → VCEK）
• 调试证明失败或证书相关问题

关键词: SEV-SNP, attestation, confidential computing, AMD, VCEK, certificate chain, remote attestation, VM identity, TCB, measurement

工作流

┌─────────────────────────────────────────────────────────────────┐
│                    SEV-SNP Attestation Flow                      │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │  1. Detection    │
                    │  Is SEV-SNP      │
                    │  available?      │
                    └────────┬────────┘
                             │
              ┌──────────────┴──────────────┐
              │                             │
              ▼                             ▼
        ┌─────────┐                   ┌─────────┐
        │   YES   │                   │   NO    │
        └────┬────┘                   └────┬────┘
             │                              │
             ▼                              ▼
    ┌─────────────────┐             ┌─────────────────┐
    │ 2. Generate     │             │ Exit with       │
    │    Report       │             │ helpful error   │
    └────────┬────────┘             └─────────────────┘
             │
             ▼
    ┌─────────────────┐
    │ 3. Display      │
    │    Report Info  │
    └────────┬────────┘
             │
             ▼
    ┌─────────────────┐
    │ 4. Fetch AMD    │
    │    Certificates │
    │ (ARK, ASK, VCEK)│
    └────────┬────────┘
             │
             ▼
    ┌─────────────────┐
    │ 5. Verify       │
    │    Cert Chain   │
    └────────┬────────┘
             │
             ▼
    ┌─────────────────┐
    │ 6. Verify       │
    │    Report Sig   │
    └────────┬────────┘
             │
             ▼
    ┌─────────────────┐
    │   PASSED or     │
    │   FAILED        │
    └─────────────────┘

快速入门

检查 SEV-SNP 是否可用

./scripts/detect-sev-snp.sh

运行完整证明流程

./scripts/full-attestation.sh [output_dir]

该命令将执行完整的六步证明工作流，并输出 PASSED 或 FAILED。

各独立步骤

每个步骤均可单独运行，适用于调试或构建自定义工作流：

前提条件

• snpguest: 来自 virtee/snpguest 的 Rust CLI 工具
• openssl: 用于证书操作
• curl: 用于从 AMD KDS 获取证书
• Root 权限: 访问 /dev/sev-guest 设备所必需

安装 snpguest：

cargo install snpguest

参考文档

• Report Fields —— 证明报告字段说明
• Error Codes —— 常见错误及排障指南
• Manual Verification —— 不依赖 snpguest、基于 OpenSSL 的手动验证方法

技术细节

• AMD KDS 地址: https://kdsintf.amd.com
• 证书链结构: ARK（自签名）→ ASK → VCEK
• 报告签名算法: ECDSA P-384
• 设备路径: /dev/sev-guest（需 root 权限或属于 sev 用户组）