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