# 安全连接器测试用例 本文档基于 `docs/连接器安全增强设计方案.md` 设计,对应系统架构和关键流程。 --- ## 一、模块对应关系 | 模块 | 源代码位置 | 测试重点 | |------|-----------|---------| | crypto | `common/crypto/` | 加密原语、密钥派生、签名验签 | | proto | `common/proto/` | 消息解析、序列化 | | auth | `server/auth/` | 设备认证、挑战-响应 | | keyring | `server/keyring/` | KEK/DEK 密钥管理 | | tpm | `connector/tpm/` | Mock TPM 行为 | | keys | `connector/keys/` | 本地密钥存储 | | register | `connector/register/` | 设备注册流程 | --- ## 二、加密原语测试 (`common/crypto`) ### TC-Crypto-001: ECDH 密钥交换 **描述**: 两端通过 ECDH 推导相同的共享密钥 **前置条件**: 无 **测试步骤**: 1. 连接器生成 ECDSA P-256 密钥对 `K_conn` 2. 服务端生成 ECDSA P-256 密钥对 `K_srv` 3. 连接器计算 `SS = ECDH(K_conn, K_srv.PublicKey)` 4. 服务端计算 `SS = ECDH(K_srv, K_conn.PublicKey)` 5. 验证两端共享密钥相等 **预期结果**: `SS_conn == SS_srv`,长度 32 字节 **对应设计**: 密钥层次 Layer 1 (ECDH 派生 KEK) ### TC-Crypto-002: HKDF 密钥派生 **描述**: 使用 HKDF-SHA256 从共享密钥派生指定长度密钥 **前置条件**: TC-Crypto-001 通过 **测试步骤**: 1. 给定 salt、ikm、info,使用 `DeriveKey(salt, ikm, info, 32)` 派生 32 字节 KEK 2. 相同输入再次派生,验证结果一致 3. 不同 info 派生,验证结果不同 **预期结果**: 相同输入产生相同 32 字节输出,不同 info 产生不同输出 **对应设计**: KEK 派生流程 ### TC-Crypto-003: ECDSA 签名与验签 **描述**: TPM 使用私钥签名,数据消费者用公钥验签 **前置条件**: 无 **测试步骤**: 1. 生成 ECDSA P-256 密钥对 2. 对消息 `M` 计算 SHA-256 哈希 3. 使用私钥签名得到 `sig` 4. 使用公钥验证 `sig` 对 `M` 的签名 5. 篡改消息后验证应失败 **预期结果**: 原始消息验签通过,篡改消息验签失败 **对应设计**: TPM Quote 签名验证 ### TC-Crypto-004: AES-256-GCM 加密解密 **描述**: 使用 256 位密钥和随机 Nonce 加解密 **前置条件**: 无 **测试步骤**: 1. 生成 32 字节随机密钥 2. 加密 plaintext,得到 ciphertext 3. 解密 ciphertext,验证与原 plaintext 一致 4. 使用错误密钥解密,应失败 5. 验证两次相同 plaintext 产生不同 ciphertext(随机 nonce) **预期结果**: 加解密往返一致;错误密钥返回 `ErrDecryptionFailed`;密文不同(nonce 随机) **对应设计**: KEK 加密 DEK、密钥存储加密 ### TC-Crypto-005: HMAC-SHA256 完整性保护 **描述**: 使用 HMAC 保护消息完整性 **前置条件**: 无 **测试步骤**: 1. 对消息 `M` 计算 HMAC 2. 用正确 MAC 验证通过 3. 用篡改后的 MAC 验证失败 **预期结果**: 验证结果符合预期 **对应设计**: 消息完整性校验 ### TC-Crypto-006: 非确定性随机数生成 **描述**: `GenerateNonce` 每次生成不同的随机字节 **前置条件**: 无 **测试步骤**: 1. 调用 `GenerateNonce(32)` 生成两个随机数 2. 验证长度均为 32 字节 3. 验证两次结果不同 **预期结果**: 每次输出唯一,长度正确 ### TC-Crypto-007: 公钥编码与解析 **描述**: ECDSA 公钥序列化和反序列化 **前置条件**: TC-Crypto-001 密钥对已生成 **测试步骤**: 1. 编码公钥为 DER 格式 2. 解析 DER 恢复公钥 3. 验证 X、Y 坐标一致 **预期结果**: 公钥往返一致 ### TC-Crypto-008: 会话密钥派生 **描述**: `DeriveSessionKeys` 从主密钥派生多组会话密钥 **前置条件**: 无 **测试步骤**: 1. 使用 `DeriveSessionKeys(masterSecret, sessionID, 4)` 派生 4 把密钥 2. 验证每把密钥长度 32 字节 3. 验证 4 把密钥两两不同 **预期结果**: 4 把唯一 32 字节密钥 **对应设计**: Layer 3 会话密钥 --- ## 三、协议消息测试 (`common/proto`) ### TC-Proto-001: RegisterRequest 序列化反序列化 **描述**: 设备注册请求消息的 JSON 序列化 **前置条件**: 无 **测试步骤**: 1. 构造 `RegisterRequest`,包含 `TPMPublicKey`、`Nonce`、`DeviceID` 等 2. 序列化为 JSON 3. 反序列化回结构体 4. 验证字段一致 **预期结果**: 往返后字段一致 **对应设计**: 连接器识别与认证 - 设备注册 ### TC-Proto-002: ChallengeRequest 响应配对 **描述**: 服务端下发挑战,设备响应 **前置条件**: 无 **测试步骤**: 1. 服务端生成 `ChallengeRequest`,含 `Nonce` 和 `Challenge` 2. 设备收到后构造 `ChallengeResponse`,引用 `Nonce` 并附加 `Signature` 3. 验证设备响应的 Nonce 与服务端下发的一致 **预期结果**: Nonce 引用正确 **对应设计**: 连接器识别与认证 - 挑战-响应 ### TC-Proto-003: 错误码覆盖 **描述**: 所有错误码应可被正确解析 **前置条件**: 无 **测试步骤**: 1. 遍历 `proto.ErrSuccess`、`ErrInvalidRequest`、`ErrDeviceNotFound`、`ErrAuthFailed` 等 2. 验证各错误码的 `Error()` 方法返回正确的 string **预期结果**: 所有错误码可正确识别 ### TC-Proto-004: KeyIncrementalUpdate 消息格式 **描述**: 增量密钥更新消息包含完整的 offset/length/data 结构 **前置条件**: 无 **测试步骤**: 1. 构造包含 `PartialUpdate{Offset:16, Length:32, Data:"..."}` 的 `KeyIncrementalUpdate` 2. 序列化和反序列化 3. 验证 offset、length、data 字段一致 **预期结果**: 增量更新字段正确 **对应设计**: 密钥增量烧录协议 --- ## 四、服务端认证测试 (`server/auth`) ### TC-Auth-001: 设备注册流程 **描述**: 设备首次注册,服务端验证并下发 KEK **前置条件**: 服务端 FPGA 根密钥已初始化 **测试步骤**: 1. 设备发送 `RegisterRequest`(含 TPM 公钥、Quote、Nonce) 2. 服务端验证公钥格式 3. 服务端 FPGA 派生设备专属 KEK 4. 服务端返回 `RegisterResponse`(含加密 KEK、KEK 版本、服务器公钥) 5. 设备验证响应并存储 KEK **预期结果**: 双方各自持有相同的 KEK(加密形式),设备状态为 pending **对应设计**: 连接器识别与认证 - 设备注册流程 ### TC-Auth-002: 挑战-响应认证 **描述**: 服务端下发随机挑战,设备用 TPM 签名响应 **前置条件**: TC-Auth-001 完成,设备已注册 **测试步骤**: 1. 服务端创建 `ChallengeRequest`(含 32 字节 Nonce + Challenge) 2. 设备收到后,用 TPM 私钥签名 `Challenge || Nonce` 3. 设备发送 `ChallengeResponse` 4. 服务端验证签名 5. 验证通过后,更新设备状态为 active **预期结果**: 有效签名通过验证,设备变为 active;伪造签名被拒绝 **对应设计**: 连接器识别与认证 - 挑战-响应 ### TC-Auth-003: 挑战过期处理 **描述**: 过期的挑战应被拒绝 **前置条件**: 服务端已创建未使用的挑战 **测试步骤**: 1. 服务端创建有效期 5 分钟(可配置)的挑战 2. 等待超过有效期 3. 设备提交挑战响应 4. 服务端检查 `ExpiresAt`,拒绝过期挑战 **预期结果**: 服务端返回 `ErrChallengeExpired` **对应设计**: 挑战-响应 - 过期处理 ### TC-Auth-004: 设备状态机 **描述**: 设备状态按 `pending → registered → active → revoked` 流转 **前置条件**: 无 **测试步骤**: 1. 设备注册后,验证状态为 `pending` 2. 挑战-响应通过后,验证状态为 `active` 3. 服务端吊销设备,验证状态为 `revoked` **预期结果**: 状态流转符合预期 ### TC-Auth-005: 重复注册拒绝 **描述**: 已注册设备重复注册应返回已有状态 **前置条件**: 设备已注册 **测试步骤**: 1. 已注册设备再次发起注册请求 2. 服务端检查设备是否已存在 3. 返回已有 KEK 版本(不重新派生) **预期结果**: 返回已存在错误或现有状态 --- ## 五、密钥管理测试 (`server/keyring`) ### TC-Keyring-001: KEK 派生与存储 **描述**: 服务端根据设备公钥派生 KEK 并存储 **前置条件**: 服务端 FPGA 已初始化根密钥 **测试步骤**: 1. 调用 `DeriveDeviceKEK(deviceID, devicePublicKey)` 2. 验证 KEK 版本号唯一递增 3. 服务端存储 KEK(含版本、过期时间) 4. 通过 `GetDeviceKEK(deviceID)` 可检索 **预期结果**: KEK 派生成功,版本号正确 **对应设计**: 密钥层次 Layer 1 - KEK ### TC-Keyring-002: 密钥版本管理 **描述**: 密钥轮换时版本号递增 **前置条件**: 设备已有一版 KEK **测试步骤**: 1. 服务端触发密钥轮换 2. 调用 `DeriveDeviceKEK` 生成新版本 3. 验证新版本号 > 旧版本号 4. 验证旧版本在宽限期内仍可用 **预期结果**: 版本号递增,旧版本在宽限期内可用 ### TC-Keyring-003: 密钥加密传输 **描述**: KEK 下发时使用会话密钥加密 **前置条件**: TC-Auth-002 认证通过 **测试步骤**: 1. 服务端用会话密钥加密 KEK 2. 设备用会话密钥解密 KEK 3. 设备将 KEK 存入 FPGA 内存 **预期结果**: 传输过程中 KEK 以密文存在 ### TC-Keyring-004: 增量密钥更新 **描述**: 仅传输部分密钥数据更新 KEK **前置条件**: 设备已持有旧版本 KEK **测试步骤**: 1. 服务端构造 `KeyIncrementalUpdate`,设置 `PartialUpdate{Offset:16, Length:32}` 2. 服务端签名消息 3. 设备验证签名,检查版本号 4. 设备更新 KEK 指定偏移的 32 字节 5. 设备发送确认 **预期结果**: 部分更新成功,KEK 新版可用 **对应设计**: 密钥增量烧录协议 --- ## 六、Mock TPM 测试 (`connector/tpm`) ### TC-TPM-001: TPM 初始化 **描述**: Mock TPM 上电后生成 SRK **前置条件**: 无 **测试步骤**: 1. 调用 `tpm.Initialize()` 2. 验证 SRK 已生成 3. 验证 SRK 可用于签名 **预期结果**: SRK 生成成功,SRK 私钥不可提取 ### TC-TPM-002: 密钥生成 **描述**: Mock TPM 生成设备签名密钥 **前置条件**: TPM 已初始化 **测试步骤**: 1. 调用 `GenerateKey("device_key", KeyTypeSigning)` 2. 验证返回的 `TPMKey` 包含公钥和私钥引用 3. 调用 `GetPublicKey("device_key")`,验证 DER 格式公钥 4. 调用 `GetPublicKeyBase64("device_key")`,验证 base64 输出 **预期结果**: 公钥格式正确,可用于服务验证 ### TC-TPM-003: TPM 签名 **描述**: Mock TPM 使用私钥签名数据 **前置条件**: TC-TPM-002 完成 **测试步骤**: 1. 调用 `Sign("device_key", data)` 2. 验证返回 ASN.1 DER 格式签名 3. 调用 `SignBase64`,验证 base64 输出 4. 使用 `Verify` 验证签名 **预期结果**: 签名有效,可被公钥验证 ### TC-TPM-004: TPM Quote **描述**: 生成 TPM Quote 用于远程认证 **前置条件**: TPM 已初始化,有可用的 AIK **测试步骤**: 1. 调用 `Quote("device_key", nonce, pcrMask)`,mask=0xFF(全 PCR) 2. 验证返回的 `Quote` 包含 `Quote`、`Signature`、`PCRMask`、`PCRValues` 3. 调用 `QuoteToBase64`,验证 base64 输出 4. 服务端使用公钥验证签名 **预期结果**: Quote 包含 PCR 值,签名有效 **对应设计**: 远程认证 - TPM Quote ### TC-TPM-005: PCR 扩展 **描述**: PCR 寄存器可扩展新度量值 **前置条件**: TPM 已初始化 **测试步骤**: 1. 调用 `PCR_Extend(0, measurement1)` 2. 调用 `PCR_Read(0)`,验证值 = SHA256(0 || measurement1) 3. 调用 `PCR_Extend(0, measurement2)` 4. 调用 `PCR_Read(0)`,验证值 = SHA256(prev || measurement2) **预期结果**: PCR 扩展正确,累积度量 ### TC-TPM-006: Seal/Unseal **描述**: 数据可被 SRK 密封,只有 TPM 才能解封 **前置条件**: TPM 已初始化,有 SRK **测试步骤**: 1. 调用 `Seal(data, pcrMask=0)` 密封数据 2. 调用 `Unseal(sealedData)` 解封数据 3. 验证解封后数据与原始数据一致 4. 使用错误数据解封应失败 **预期结果**: 往返数据一致;错误数据解封失败 --- ## 七、本地密钥存储测试 (`connector/keys`) ### TC-Keys-001: 密钥存储与加载 **描述**: ECDSA 私钥加密后持久化到磁盘 **前置条件**: 无 **测试步骤**: 1. 创建 `Manager`,指定 `keyDir` 2. 调用 `StoreKey("device_key", ecdsaKey)` 3. 验证 keyDir 下生成 `device_key.json` 4. 新建 `Manager` 实例 5. 调用 `LoadKey("device_key")`,验证加载的私钥与原始一致 **预期结果**: 密钥往返一致;文件内容加密存储 ### TC-Keys-002: masterKey 为空时重新生成 **描述**: 重启后 masterKey 丢失,应重新生成 **前置条件**: 已有密钥文件存在 **测试步骤**: 1. 创建 `Manager` 并存储密钥 2. 新建 `Manager` 实例(模拟重启) 3. 调用 `StoreKey`,验证成功(不报 key size 错误) **预期结果**: masterKey 为空时自动生成新的 32 字节密钥 ### TC-Keys-003: 加密解密数据 **描述**: 使用 masterKey 加密任意数据 **前置条件**: `Manager` 已初始化 **测试步骤**: 1. 调用 `Encrypt(plaintext)` 得到 ciphertext 2. 调用 `Decrypt(ciphertext)` 解密 3. 验证解密后数据与原始一致 **预期结果**: 往返数据一致 ### TC-Keys-004: 导出导入加密密钥 **描述**: 密钥可被传输密钥加密后导出/导入 **前置条件**: 有两套 Manager 实例 **测试步骤**: 1. Manager A 存储了 `device_key` 2. 调用 `ExportEncrypted("device_key", transportKey)` 导出 3. Manager B 调用 `ImportEncrypted("device_key", transportKey, ciphertext)` 导入 4. Manager B 调用 `LoadKey("device_key")`,验证加载成功 **预期结果**: 跨 Manager 迁移成功,传输过程密文 --- ## 八、集成测试 ### TC-Int-001: 完整设备注册流程 **描述**: 连接器从启动到注册完成的全流程 **前置条件**: 服务端运行,Mock TPM 就绪 **测试步骤**: 1. 连接器启动,初始化 Mock TPM 2. Mock TPM 生成设备密钥对 3. 连接器发送注册请求到 `/api/v1/device/register` 4. 服务端验证,返回加密 KEK 5. 连接器存储密钥,状态更新 6. 查询 `/api/v1/device/status`,验证设备列表 **预期结果**: 注册成功,设备状态 pending,KEK 版本 1 **对应设计**: 连接器启动顺序 - AUTH_REGISTER ### TC-Int-002: 完整挑战-响应认证流程 **描述**: 设备注册后进行挑战-响应认证 **前置条件**: TC-Int-001 完成 **测试步骤**: 1. 连接器请求 `/api/v1/device/challenge` 2. 服务端返回 Nonce + Challenge 3. 连接器用 TPM 签名 Challenge || Nonce 4. 连接器发送 `/api/v1/device/auth` 5. 服务端验证签名,更新设备状态 6. 验证返回 SessionKey **预期结果**: 认证成功,设备状态 active,收到 SessionKey ### TC-Int-003: 密钥更新流程 **描述**: 服务端推送增量密钥更新 **前置条件**: TC-Int-002 完成,设备 active **测试步骤**: 1. 服务端发送 `POST /api/v1/key/incremental-update` 2. 消息包含部分密钥数据和 FPGA 签名 3. 设备验证签名,检查版本号 4. 设备更新本地 KEK 5. 设备发送确认 ACK **预期结果**: KEK 版本递增,设备继续正常工作 ### TC-Int-004: 服务端重启后设备恢复 **描述**: 服务端重启,设备重新认证 **前置条件**: 有已认证设备 **测试步骤**: 1. 服务端重启(内存状态清空) 2. 设备发起挑战请求 3. 服务端重建挑战(设备存在于持久化存储) 4. 设备完成挑战-响应 5. 验证恢复后设备状态一致 **预期结果**: 设备状态恢复,旧挑战被清理 ### TC-Int-005: 离线启动本地业务 **描述**: 连接器无服务端时仍可运行本地业务 **前置条件**: 设备已完成注册并缓存密钥 **测试步骤**: 1. 设备已注册,KEK 存储在 SED 加密区 2. 断开网络连接 3. 设备本地服务启动 4. 本地数据加密存储到 SED 5. 验证 SED 密文无法被无密钥设备读取 **预期结果**: 本地业务正常运行,数据加密存储 **对应设计**: 连接器生命周期 - 阶段 2 可离线运行 --- ## 九、安全测试 ### TC-Sec-001: 密钥文件加密存储 **描述**: 磁盘上的密钥文件必须加密 **前置条件**: 已存储设备密钥 **测试步骤**: 1. 读取 `keyDir` 下的 `.json` 文件 2. 尝试用明文解析,应无法获取私钥明文 3. 使用 `DecryptAES256GCM` 和正确 masterKey 可解密 **预期结果**: 磁盘上的密钥文件为密文 ### TC-Sec-002: 错误密钥解密失败 **描述**: 使用错误密钥无法解密 **前置条件**: 已有加密数据 **测试步骤**: 1. 用 `Manager A` 加密数据 2. 用另一 `Manager B`(不同 masterKey)解密 3. 验证解密返回 `ErrDecryptionFailed` **预期结果**: 解密失败,防止跨设备密钥泄露 ### TC-Sec-003: 签名验证防篡改 **描述**: 篡改数据后签名验证失败 **前置条件**: 有效签名 **测试步骤**: 1. 对消息 `M` 生成签名 `sig` 2. 篡改 `M` 的任意字节 3. 用原公钥验证篡改后的 `M + sig` **预期结果**: 验证失败 **对应设计**: 远程认证 - 防篡改 ### TC-Sec-004: 会话密钥短期有效 **描述**: SessionKey 有效期有限,过期后无法使用 **前置条件**: 已认证设备持有 SessionKey **测试步骤**: 1. 设备获取 SessionKey(有效期 24 小时) 2. 等待或模拟超时 3. 用过期 SessionKey 发请求 4. 验证服务端拒绝 **预期结果**: 过期请求被拒绝 **对应设计**: 密钥层次 Layer 3 会话密钥 --- ## 十、边界条件测试 ### TC-Bound-001: 空数据加密 **描述**: 加密空 plaintext 应成功 **前置条件**: 无 **测试步骤**: 1. 调用 `EncryptAES256GCM(key, []byte{}, nil)` 2. 验证返回非空 ciphertext(包含 nonce + auth tag) 3. 解密后验证等于空字节 **预期结果**: 加解密往返成功 ### TC-Bound-002: 大数据块加密 **描述**: 4KB 以上数据加密正常 **前置条件**: 无 **测试步骤**: 1. 生成 4096 字节随机数据 2. 加密后解密 3. 验证往返一致 **预期结果**: 大数据块处理正常 ### TC-Bound-003: 非法公钥格式 **描述**: 解析非法公钥应返回错误 **前置条件**: 无 **测试步骤**: 1. 调用 `ParsePublicKey([]byte("not a valid pkcs8"))` 2. 验证返回错误 **预期结果**: 解析失败,不 panic ### TC-Bound-004: Nonce 长度验证 **描述**: `GenerateNonce` 支持不同长度 **前置条件**: 无 **测试步骤**: 1. 调用 `GenerateNonce(16)`、`GenerateNonce(32)`、`GenerateNonce(64)` 2. 验证每次返回指定长度的字节 **预期结果**: 长度准确 --- ## 十一、覆盖率目标 | 模块 | 最低覆盖率 | 目标覆盖率 | |------|-----------|-----------| | `common/crypto` | 80% | 90% | | `common/proto` | 60% | 80% | | `server/auth` | 70% | 85% | | `server/keyring` | 70% | 85% | | `connector/tpm` | 80% | 90% | | `connector/keys` | 80% | 90% | --- *文档版本: v1.0* *编制日期: 2026/05/22* *依据文档: `docs/连接器安全增强设计方案.md` (v7.1)*