news 2026/4/23 20:01:20

Python GMSSL v3.2.1实战：手把手教你搞定SM2国密算法的签名与验签（附ID处理避坑指南）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Python GMSSL v3.2.1实战：手把手教你搞定SM2国密算法的签名与验签（附ID处理避坑指南）

Python GMSSL v3.2.1实战：SM2国密算法签名与验签全流程解析

当安全工程师第一次在项目中看到"需要支持SM2签名"的需求时，往往会被各种国标文档和参数转换搞得晕头转向。作为我国自主研发的椭圆曲线公钥密码算法，SM2在政务、金融等领域已成为标配，但Python生态中的实践资料却零散难懂。本文将用可运行的代码，带您穿透理论迷雾，直击密钥生成→基础签名→带ID验签全流程，特别是解决官方文档语焉不详的ENTL计算和ASCII编码转换两大痛点。

1. 环境配置与密钥对生成

在开始前，请确认已安装支持SM2算法的密码库。GMSSL作为OpenSSL的国密分支，提供了完整的SM2/SM3/SM4实现：

pip install gmssl==3.2.1

生成SM2密钥对时，需要注意曲线参数的选择。国密标准GM/T 0003-2012规定使用sm2p256v1曲线，其参数已内置在GMSSL中：

from gmssl import sm2, sm3 # 生成随机密钥对 private_key = '00B9AB0B828FF68872F21A837FC303668428DEA11DCD1B24429D0C99E24EED83D5' public_key = 'B9C9A6E04E9C91F7BA880429273747D7EF5DDEB0BB2FF6317EB00BEF331A83081A6994B8993F3F5D6EADDDB81872266C87C018FB4162F5AF347B483E24620207' # 初始化加密对象 crypt_sm2 = sm2.CryptSM2( public_key=public_key, private_key=private_key, ecc_table=sm2.default_ecc_table )

关键验证点：

  • 私钥应为64字符的十六进制字符串
  • 公钥应为128字符（包含04前缀的未压缩格式）
  • 可通过sm2._kg()方法验证公钥是否由私钥派生

2. 基础签名与验签实现

SM2签名过程本质上是"私钥加密哈希值"，而验签则是"用公钥解密并比对"。以下是标准流程的代码实现：

def basic_sign(private_key: str, message: str) -> tuple: """基础签名流程""" msg_bytes = message.encode('utf-8') msg_hash = sm3.sm3_hash(sm2.func.bytes_to_list(msg_bytes)) crypt = sm2.CryptSM2( private_key=private_key, public_key=None, ecc_table=sm2.default_ecc_table ) random_k = sm2.func.random_hex(crypt.para_len) signature = crypt.sign(msg_hash.encode(), random_k) return signature def basic_verify(public_key: str, message: str, signature: str) -> bool: """基础验签流程""" msg_bytes = message.encode('utf-8') msg_hash = sm3.sm3_hash(sm2.func.bytes_to_list(msg_bytes)) crypt = sm2.CryptSM2( private_key=None, public_key=public_key, ecc_table=sm2.default_ecc_table ) return crypt.verify(signature, msg_hash.encode())

典型错误排查表：

错误现象可能原因解决方案
签名长度异常随机数k生成不规范使用func.random_hex()确保长度
验签始终失败哈希计算不一致确认双方使用相同的SM3哈希算法
中文签名异常编码未统一为UTF-8全程使用.encode('utf-8')转换

注意：实际项目中应将随机数k改为确定性生成（RFC 6979），避免因随机性导致签名不一致。

3. 带用户ID的签名验签实战

数字证书等场景要求签名包含用户标识符ID，这是SM2最易出错的环节。根据国标要求，需要处理：

  1. ID的ASCII编码转换
  2. ENTL（ID比特长度）计算
  3. Z值合成哈希

以下是带ID签名的完整实现：

def id_to_ascii(user_id: str) -> str: """将用户ID转换为ASCII编码的十六进制字符串""" hex_map = {c: f"{ord(c):02X}" for c in set(user_id)} return ''.join(hex_map[c] for c in user_id) def sign_with_id(private_key: str, user_id: str, message: str) -> str: """带用户ID的签名""" # 参数准备 id_ascii = id_to_ascii(user_id) entl = f"{len(user_id) * 8:04X}" # 计算比特长度 # 获取曲线参数 ecc_table = sm2.default_ecc_table a = ecc_table['a'] b = ecc_table['b'] x_G = ecc_table['g'][:64] y_G = ecc_table['g'][64:] # 计算Z值 pub_key = sm2.CryptSM2._kg(int(private_key, 16), ecc_table['g']) z_input = entl + id_ascii + a + b + x_G + y_G + pub_key z_bytes = bytes.fromhex(z_input) Z = sm3.sm3_hash(sm2.func.bytes_to_list(z_bytes)) # 合成签名数据 msg_bytes = message.encode('utf-8') e_input = Z + msg_bytes.hex() e_hash = sm3.sm3_hash(sm2.func.bytes_to_list(bytes.fromhex(e_input))) # 执行签名 crypt = sm2.CryptSM2( private_key=private_key, public_key=None, ecc_table=ecc_table ) k = sm2.func.random_hex(crypt.para_len) return crypt.sign(e_hash.encode(), k)

验签时需要特别注意Z值的同步计算：

def verify_with_id(public_key: str, user_id: str, message: str, signature: str) -> bool: """带用户ID的验签""" # 参数准备（必须与签名方完全一致） id_ascii = id_to_ascii(user_id) entl = f"{len(user_id) * 8:04X}" # 获取曲线参数 ecc_table = sm2.default_ecc_table a = ecc_table['a'] b = ecc_table['b'] x_G = ecc_table['g'][:64] y_G = ecc_table['g'][64:] # 计算Z值 z_input = entl + id_ascii + a + b + x_G + y_G + public_key z_bytes = bytes.fromhex(z_input) Z = sm3.sm3_hash(sm2.func.bytes_to_list(z_bytes)) # 合成验签数据 msg_bytes = message.encode('utf-8') e_input = Z + msg_bytes.hex() e_hash = sm3.sm3_hash(sm2.func.bytes_to_list(bytes.fromhex(e_input))) # 执行验签 crypt = sm2.CryptSM2( private_key=None, public_key=public_key, ecc_table=ecc_table ) return crypt.verify(signature, e_hash.encode())

ID处理关键点对照表：

参数示例值计算规则
原始ID"user123"用户提供的明文字符串
ASCII编码"75736572313233"每个字符转换为其ASCII十六进制
ENTL"0038"len(ID)*8，转为4位十六进制
Z值输入ENTL+ID+a+b+x_G+y_G+公钥字符串拼接后哈希

4. 证书签名验证实战

在X.509证书验证场景中，签名通常采用带ID的模式。以下是解析证书并验证签名的典型流程：

from cryptography import x509 from cryptography.hazmat.primitives import serialization def verify_cert_signature(cert_pem: str, ca_public_key: str) -> bool: """验证证书SM2签名""" cert = x509.load_pem_x509_certificate(cert_pem.encode()) # 提取签名值 signature = cert.signature.hex() # 构造待验签数据（TBSCertificate） tbs_cert = cert.tbs_certificate_bytes.hex() # 国密证书默认ID gm_id = "1234567812345678" return verify_with_id( public_key=ca_public_key, user_id=gm_id, message=tbs_cert, signature=signature )

证书验证的三大陷阱：

  1. ID不一致：不同CA可能使用非默认ID，需确认实际值
  2. 编码格式：证书签名值可能是DER编码，需转换为原始十六进制
  3. 哈希对象：实际哈希的是TBSCertificate部分而非整个证书

在金融支付系统集成时，曾遇到因ENTL计算错误导致央行验签失败的案例。调试发现是长度计算时误用了字节数而非比特数，将len(id)*8误写为len(id)。这种细节差异在测试环境可能被忽略，但在严格验签环境下会直接导致业务中断。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/23 20:01:20

PS2EXE终极指南：快速将PowerShell脚本转换为EXE可执行文件

PS2EXE终极指南：快速将PowerShell脚本转换为EXE可执行文件 【免费下载链接】PS2EXE Module to compile powershell scripts to executables 项目地址: https://gitcode.com/gh_mirrors/ps/PS2EXE 你是否曾经想要将PowerShell脚本分享给他人，但又不…

作者头像 李华
网站建设 2026/4/23 19:57:09

高速移植任何FPGA中的SDIO模式下的SD卡读写源码，达到50Mbps以上速率

FPGA以SDIO模式读写SD卡源码，可移植到任何FPGA中。 在SDIO模式下，SD卡读写速率50Mbps以上。 文件里包含tb和说明文档，已经下板验证通过。一、程序核心功能概述 本程序实现了FPGA通过SDIO模式对SD卡进行高速读写操作的完整解决方案&#xff0c…

作者头像 李华
网站建设 2026/4/23 19:56:42

高通CAMX架构下，一个8M前置摄像头的AE调试实战笔记（附避坑清单）

高通CAMX架构下8M前置摄像头AE调试实战：从参数计算到避坑指南 调试摄像头自动曝光（AE）系统就像在微光环境下寻找焦点——既需要精确的数学计算，又依赖丰富的实战经验。作为刚接触高通CAMX架构的工程师，我在调试一款8M像…

作者头像 李华
网站建设 2026/4/23 19:54:03

Python asyncio 并发文件下载

Python asyncio并发文件下载：高效处理IO密集型任务 在当今数据驱动的时代，高效下载多个文件是开发者常遇到的挑战。传统的同步下载方式会因等待网络响应而阻塞程序，导致性能瓶颈。Python的asyncio库通过异步IO和事件循环机制，让开…

作者头像 李华
网站建设 2026/4/23 19:53:41

APB总线实战：避开这3个常见坑，让你的Slave设计一次仿真通过

APB Slave设计实战：从波形异常到稳定通信的调试全指南 刚接触APB协议时，我曾在实验室熬到凌晨三点，就为了找出为什么Slave模块的仿真波形总是出现诡异的毛刺。那段时间的调试经历让我深刻体会到——理解协议文档只是起点，真正实现…

作者头像 李华
网站建设 2026/4/23 19:53:40

Spring Boot Maven插件repackage配置避坑指南：可执行JAR与依赖JAR的抉择

Spring Boot Maven插件repackage配置避坑指南：可执行JAR与依赖JAR的抉择 在Spring Boot项目的开发过程中，打包环节往往是最后一道关卡，也是最容易踩坑的地方。特别是当你的项目既需要作为独立应用运行，又需要被其他模块依赖时&…

作者头像 李华