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

18 KiB
Raw Blame History

安全连接器测试用例

本文档基于 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)