Files
ssw-mvp/scard/code/tests/case.md
T
admin 3247e9fd15 init: ssw-mvp initial commit
- boot/ (Java/Maven, JNPF 7.0) — 移除旧的 boot/.git,源码直接纳入仓库
- web/ (Vue 3 + Vite + Ant Design Vue, pnpm)
- docs/, scard/, nax/
- refs/INDEX.md + refs/国标/(其余 refs/* 开源子仓库不纳入)
- 已忽略: connector_data/, jweb/, log/, web/{dist,node_modules,.pnpm}, boot/*/target/, .DS_Store, .idea, .vscode
2026-08-05 18:29:12 +08:00

521 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 安全连接器测试用例
本文档基于 `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)*