📚 课程目录第2章国密接口测试基础

第2章国密接口分类：先看清再动手

好，咱们正式开始聊国密接口。

很多同学一上来就问：“国密接口到底长啥样？” 我的回答通常是：你先别管它长啥样，先搞清楚它分几类。分清楚类，你才知道测试用例该往哪个方向写。

刚入行那会儿，我拿到一份密码模块的接口文档，整整200页。硬啃了两天，发现其实核心就4类东西。搞懂这4类，剩下的全是细枝末节。

国密接口的核心四分类：

下面我一个个拆开讲。讲的时候我会穿插一些项目里踩过的坑，你听着会更有感觉。

密码算法API，说白了就是提供加密、解密、哈希运算的底层接口。SM2、SM3、SM4、SM9，这些算法你都得能调得动。

我建议你测试时重点关注三个维度：

举个例子。我在测试一款国产密码卡时，SM3哈希接口返回的结果长度是31字节，不是标准的32字节。当时我差点以为是算法实现错了，后来查了内核驱动版本才发现，是内部一个指针偏移算错了。这种问题不跑边界测试根本抓不出来。

测试小技巧： 对密码算法API，永远准备两份数据——一份是标准向量（国标附录），一份是异常向量（空输入、长输入、非法密钥）。两个都跑通才算过关。

密钥管理接口，我愿称之为“最容易被忽视的雷区”。很多团队测算法测得很嗨，一到密钥管理就随便点点完事。结果出问题的全是密钥管理。

密钥管理API主要有以下操作：

我曾经接过一个项目，客户的密码机密钥导出接口有两个版本：一个输出PEM格式，一个输出DER格式。文档里写的是“支持两种标准格式”，但实际测试发现，PEM格式的头部注释写错了，导致第三方解析失败。你想想看，这种问题只靠“看着通”是测不出来的，必须得真拿解析器去解一遍。

注意： 密钥生命周期管理是密码合规检查的重点。尤其密钥销毁，大部分接口只做了“标记删除”，实际数据还在内存里。合规审计时这是致命漏洞。

证书接口，管的是X.509证书的签发、验证、解析。国密这边，SM2证书的结构跟RSA证书不太一样，很多现成的通用库不兼容。

证书接口常见的操作：

我印象最深的一次，是测一个电子签章平台的证书解析接口。它读入SM2证书时，公钥长度解析对了，但曲线参数标识读错了。结果签名验签成功，但公钥导出后曲线不对，别的模块根本用不了。嗯，这种问题只能靠全流程联调才能暴露。

签名验签接口，是最能体现“兼容性”难度的。因为签名结果谁都能验，但标准不统一就会出幺蛾子。

签名验签的测试点：

有个真实案例。某支付系统对接两家密码厂商，A厂签名结果输出的是ASN.1 DER编码的r||s，B厂输出的是固定64字节的r+s拼接。结果数据交换时，两边怎么都验不过。查了一天，才发现是编码格式问题。你说冤不冤？

我的建议： 签名验签接口做兼容性测试，务必准备一个“标准互认用例”。用国密局官方的测试向量签一次，验一次，两边结果一致才算过。不要相信“我觉得能验过”。

这四类接口不是孤立的。

从图上你看得出来，密码算法API是中心节点。密钥管理API给它提供密钥材料，证书接口给它提供公钥/私钥对，最后签名验签API在算法之上封装业务逻辑。

这意味着什么？意味着你测试单接口的时候，得知道它在整个链条里承担什么角色。单纯测一个SM2签名接口通过，不代表整个链路能跑通。密钥对不匹配、证书链不完整，都会导致签名验签失败。

我个人习惯是把四类接口的测试设计成“分段验证 + 端到端验证”双模式。分段验证确保每个接口自身没问题，端到端验证模拟真实业务场景。两条线并行，覆盖率才够。

好，这一章就先到这儿。记住这四类接口的分类，后面每类展开讲的时候，你心里有地图，不会迷路。

第2章 国密接口分类：先看清再动手