当前位置：首页 > news >正文

基于OpenSSL的SM2/SM3国密算法C语言实战实现与工程指南

news 2026/6/22 5:11:22

1. 项目概述：为什么我们需要亲手实现SM2/SM3？

如果你是一名从事金融、政务、物联网或者任何对数据安全有高要求领域的C语言开发者，那么“国密算法”这个词对你来说一定不陌生。SM2（椭圆曲线公钥密码算法）、SM3（杂凑算法）作为我国自主设计的密码算法标准，正逐步成为这些领域中的“标配”。然而，当你在项目中真正需要集成它们时，可能会发现：网上关于SM2/SM3的纯理论文章不少，但能直接拿来编译、运行、并理解每一步在做什么的C语言实战代码，却像沙漠里的绿洲一样难寻。很多教程要么停留在概念，要么依赖某个特定的、封装过度的商业库，让你知其然不知其所以然。

这正是我写这篇长文的原因。我将基于OpenSSL这个业界公认强大且开源的基础密码学库，带你从零开始，一步步用C语言实现SM2的加密、解密、签名、验签，以及SM3的哈希计算。我不会只给你一堆冰冷的函数调用，而是会拆解每一个步骤背后的逻辑：为什么参数要这么传？生成的密文或签名是什么结构？常见的坑点在哪里？我的目标是，让你在读完并实践完本文后，不仅能得到一套可运行的代码，更能建立起对国密算法在工程层面上的深刻理解，下次遇到相关需求时，能够从容地排查和解决。

2. 环境准备与OpenSSL的国密支持编译

在开始敲代码之前，一个正确支持国密算法的OpenSSL开发环境是基石。很多开发者卡在第一步，就是因为使用了默认不支持SM2/SM3的OpenSSL版本。

2.1 获取支持国密的OpenSSL源码

首先，你需要知道，直到OpenSSL 1.1.1版本，国密算法才被正式合并到主分支。因此，确保你使用的版本是1.1.1或更高。我强烈建议使用1.1.1系列的最新稳定版，它的兼容性和稳定性经过了大量实践检验。

前往OpenSSL官网的下载页面，找到源码包（例如openssl-1.1.1w.tar.gz）。下载并解压后，我们进入关键步骤：配置与编译。

2.2 编译配置详解与实操

在Linux或macOS的终端，或者Windows的MSYS2/MinGW-w64环境中，进入解压后的OpenSSL源码目录。编译配置命令是核心：

./config --prefix=/usr/local/openssl-sm2 no-shared no-dso no-idea no-mdc2 no-rc5 no-zlib no-ssl3 enable-sm2 enable-sm3 enable-sm4

这条命令的每一个参数都值得解释：

--prefix=/usr/local/openssl-sm2：指定安装目录。我习惯安装到一个独立的路径，避免污染系统自带的OpenSSL。后续编译我们的程序时需要链接这个目录。
no-shared：只编译静态库（.a文件）。对于项目集成，静态链接更简单，避免运行时依赖库版本问题。
enable-sm2 enable-sm3 enable-sm4：这是关键！显式启用国密算法支持。没有这个，后续的SM2相关函数将无法使用。

配置完成后，执行make和make install。如果一切顺利，你将在/usr/local/openssl-sm2目录下看到include和lib文件夹，里面包含了我们需要的头文件和库文件。

注意：在Windows上使用Visual Studio编译OpenSSL过程更为复杂，通常需要先安装Perl和NASM，并使用perl Configure命令。对于新手，我建议先在Linux子系统（WSL）或虚拟机中完成学习和开发，环境配置会顺畅很多。

2.3 开发环境配置

创建一个新的C项目，在编译时需要告诉编译器头文件和库的位置。以GCC为例：

gcc -o sm2_demo sm2_demo.c -I/usr/local/openssl-sm2/include -L/usr/local/openssl-sm2/lib -lssl -lcrypto -ldl -lpthread

-I：指定OpenSSL头文件路径。
-L：指定OpenSSL库文件路径。
-lssl -lcrypto：链接OpenSSL的SSL和Crypto库。
-ldl -lpthread：链接动态加载和线程库，OpenSSL通常需要它们。

3. SM3哈希算法：单向指纹的生成

SM3是一种密码杂凑算法，类似于国际上的SHA-256。它接收任意长度的输入，生成一个固定长度（256位，即32字节）的“指纹”或“摘要”。这个过程的特性是单向和抗碰撞，常用于数据完整性校验和数字签名的组成部分。

3.1 SM3的接口与基础使用

OpenSSL中SM3的使用接口与MD5、SHA256等非常相似，易于上手。

#include <openssl/evp.h> #include <string.h> #include <stdio.h> void sm3_hash(const unsigned char *data, size_t len, unsigned char *md) { EVP_MD_CTX *ctx = EVP_MD_CTX_new(); const EVP_MD *md_type = EVP_sm3(); EVP_DigestInit_ex(ctx, md_type, NULL); EVP_DigestUpdate(ctx, data, len); EVP_DigestFinal_ex(ctx, md, NULL); EVP_MD_CTX_free(ctx); } int main() { char msg[] = "Hello, SM3!"; unsigned char digest[EVP_MAX_MD_SIZE]; unsigned int digest_len; // 计算哈希 sm3_hash((unsigned char*)msg, strlen(msg), digest); // 打印十六进制结果 printf("SM3 Hash: "); for(int i = 0; i < 32; i++) { // SM3输出固定32字节 printf("%02x", digest[i]); } printf("\n"); return 0; }

代码解析：

EVP_MD_CTX_new(): 创建一个消息摘要上下文，用于管理整个哈希过程的状态。
EVP_sm3(): 获取SM3算法的EVP_MD对象。这是OpenSSL提供的统一抽象接口，使得切换哈希算法（如换成EVP_sha256()）非常容易。
EVP_DigestInit_ex: 使用指定的算法初始化上下文。
EVP_DigestUpdate: 可以多次调用此函数，用于处理大文件或流式数据。这是哈希算法支持任意长度输入的关键。
EVP_DigestFinal_ex: 结束哈希计算，输出最终的摘要值到md缓冲区。
EVP_MD_CTX_free: 释放上下文资源。

3.2 大文件哈希与性能考量

对于大文件，必须使用Update方法分块读取和计算，避免一次性将整个文件加载到内存。

int sm3_file_hash(const char *filepath, unsigned char *md) { FILE *file = fopen(filepath, "rb"); if (!file) return -1; EVP_MD_CTX *ctx = EVP_MD_CTX_new(); const EVP_MD *md_type = EVP_sm3(); EVP_DigestInit_ex(ctx, md_type, NULL); unsigned char buffer[4096]; size_t bytes_read; while ((bytes_read = fread(buffer, 1, sizeof(buffer), file)) > 0) { EVP_DigestUpdate(ctx, buffer, bytes_read); } EVP_DigestFinal_ex(ctx, md, NULL); EVP_MD_CTX_free(ctx); fclose(file); return 0; }

实操心得：缓冲区大小（这里用了4KB）可以根据实际情况调整。对于超大型文件，适当增大缓冲区（如64KB）可以减少系统调用次数，可能提升效率，但会增加单次内存占用。需要在内存和I/O之间做一个平衡。

4. SM2非对称加密：原理与C语言实现

SM2是基于椭圆曲线密码学（ECC）的公钥算法。它包含加密/解密和签名/验签两套机制。我们先看加密解密。

4.1 SM2密钥对生成

任何非对称加密的开始都是生成一对密钥：公钥（公开）和私钥（秘密保存）。

#include <openssl/ec.h> #include <openssl/evp.h> #include <openssl/objects.h> int generate_sm2_keypair(EVP_PKEY **pkey) { EVP_PKEY_CTX *ctx = EVP_PKEY_CTX_new_id(EVP_PKEY_EC, NULL); if (!ctx) return 0; // 1. 初始化密钥生成上下文 if (EVP_PKEY_keygen_init(ctx) <= 0) goto err; // 2. 设置椭圆曲线参数为SM2曲线（prime256v1或明确的SM2曲线名） if (EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx, NID_sm2) <= 0) goto err; // 3. 生成密钥对 if (EVP_PKEY_keygen(ctx, pkey) <= 0) goto err; EVP_PKEY_CTX_free(ctx); return 1; err: EVP_PKEY_CTX_free(ctx); return 0; }

关键点解析：

NID_sm2：这是OpenSSL中代表SM2椭圆曲线的对象标识符。确保你的OpenSSL编译时启用了SM2，否则这个NID可能不存在。
EVP_PKEY：OpenSSL中公钥/私钥的统一抽象容器。后续所有操作都基于这个对象。

生成密钥后，通常需要将它们导出为文件（如PEM格式）进行持久化或分发。

// 保存私钥到文件 (PEM格式， 密码保护) int save_private_key_to_file(EVP_PKEY *pkey, const char *filename, const char *passwd) { FILE *fp = fopen(filename, "w"); if (!fp) return 0; // 使用AES-256-CBC加密私钥文件 int ret = PEM_write_PrivateKey(fp, pkey, EVP_aes_256_cbc(), (unsigned char*)passwd, strlen(passwd), NULL, NULL); fclose(fp); return ret; } // 保存公钥到文件 int save_public_key_to_file(EVP_PKEY *pkey, const char *filename) { FILE *fp = fopen(filename, "w"); if (!fp) return 0; int ret = PEM_write_PUBKEY(fp, pkey); fclose(fp); return ret; }

4.2 SM2加密过程详解

SM2加密标准（GM/T 0009-2012）定义了一种特定的加密流程，其生成的密文不是简单的二进制流，而是一个结构化的ASN.1序列。OpenSSL的高层EVP_PKEY接口为我们处理了这些复杂的细节。

#include <openssl/evp.h> int sm2_encrypt(EVP_PKEY *pub_key, const unsigned char *plaintext, size_t pt_len, unsigned char **ciphertext, size_t *ct_len) { EVP_PKEY_CTX *ctx = EVP_PKEY_CTX_new(pub_key, NULL); if (!ctx) return 0; // 1. 初始化加密操作 if (EVP_PKEY_encrypt_init(ctx) <= 0) goto err; // 2. 设置SM2加密的填充模式（如果需要） // SM2加密本身有特定格式，通常不需要额外设置。但这里可以设置加密类型。 // 例如，明确使用SM2加密。某些旧版本可能需要。 // EVP_PKEY_CTX_set_ec_scheme(ctx, NID_sm_scheme); // 3. 第一次调用，获取所需密文缓冲区长度 if (EVP_PKEY_encrypt(ctx, NULL, ct_len, plaintext, pt_len) <= 0) goto err; // 4. 分配缓冲区 *ciphertext = (unsigned char *)OPENSSL_malloc(*ct_len); if (!*ciphertext) goto err; // 5. 执行加密 if (EVP_PKEY_encrypt(ctx, *ciphertext, ct_len, plaintext, pt_len) <= 0) { OPENSSL_free(*ciphertext); goto err; } EVP_PKEY_CTX_free(ctx); return 1; err: EVP_PKEY_CTX_free(ctx); return 0; }

为什么需要两次调用EVP_PKEY_encrypt？这是OpenSSL EVP接口处理变长输出的常见模式。第一次调用时，将输出缓冲区指针设为NULL，函数会通过ct_len参数返回所需的缓冲区大小。第二次调用才是真正的加密，将数据写入我们分配好的缓冲区。这种模式避免了缓冲区溢出。

4.3 SM2解密过程与密文结构

解密是加密的逆过程，需要使用私钥。

int sm2_decrypt(EVP_PKEY *priv_key, const unsigned char *ciphertext, size_t ct_len, unsigned char **plaintext, size_t *pt_len) { EVP_PKEY_CTX *ctx = EVP_PKEY_CTX_new(priv_key, NULL); if (!ctx) return 0; if (EVP_PKEY_decrypt_init(ctx) <= 0) goto err; // 第一次调用，获取明文缓冲区长度 if (EVP_PKEY_decrypt(ctx, NULL, pt_len, ciphertext, ct_len) <= 0) goto err; *plaintext = (unsigned char *)OPENSSL_malloc(*pt_len); if (!*plaintext) goto err; // 执行解密 if (EVP_PKEY_decrypt(ctx, *plaintext, pt_len, ciphertext, ct_len) <= 0) { OPENSSL_free(*plaintext); goto err; } EVP_PKEY_CTX_free(ctx); return 1; err: EVP_PKEY_CTX_free(ctx); return 0; }

密文结构解析： SM2加密后的密文（ciphertext）不是一个简单的加密后的字节流。根据国密标准，它是一个ASN.1 DER编码的序列（SEQUENCE），通常包含以下几个部分：

一个椭圆曲线点C1，代表临时公钥。
一个比特串C2，是实际的对称加密密文（使用生成的共享密钥通过KDF和对称算法加密明文得到）。
一个比特串C3，是消息的SM3哈希值，用于完整性校验。

OpenSSL的EVP_PKEY加解密接口在内部帮我们完成了这个结构的组装（加密时）和解析（解密时）。解密时，它会验证C3是否匹配，从而自动完成完整性校验。如果校验失败，解密函数会返回错误。这就是为什么我们不需要手动处理哈希校验的原因。

5. SM2数字签名与验签：身份与完整性的证明

数字签名用于证明消息的来源和完整性。签名者用私钥对消息的摘要（如SM3哈希）进行签名，验证者用对应的公钥进行验签。

5.1 签名生成：私钥的“烙印”

int sm2_sign(EVP_PKEY *priv_key, const unsigned char *digest, size_t digest_len, unsigned char **sig, size_t *sig_len) { EVP_PKEY_CTX *ctx = EVP_PKEY_CTX_new(priv_key, NULL); if (!ctx) return 0; // 1. 初始化签名操作 if (EVP_PKEY_sign_init(ctx) <= 0) goto err; // 2. 设置摘要类型为SM3。这是关键！告诉签名算法我们使用的哈希是SM3。 if (EVP_PKEY_CTX_set_signature_md(ctx, EVP_sm3()) <= 0) goto err; // 3. 获取签名长度 if (EVP_PKEY_sign(ctx, NULL, sig_len, digest, digest_len) <= 0) goto err; *sig = (unsigned char *)OPENSSL_malloc(*sig_len); if (!*sig) goto err; // 4. 执行签名 if (EVP_PKEY_sign(ctx, *sig, sig_len, digest, digest_len) <= 0) { OPENSSL_free(*sig); goto err; } EVP_PKEY_CTX_free(ctx); return 1; err: EVP_PKEY_CTX_free(ctx); return 0; }

核心步骤：EVP_PKEY_CTX_set_signature_md(ctx, EVP_sm3())。这一步至关重要，它指定了签名所基于的哈希算法。SM2签名标准必须与SM3哈希配合使用。如果忘记设置，OpenSSL可能会使用默认的哈希算法（如SHA256），导致生成的签名不符合国密标准，对方也无法验签。

5.2 签名验证：公钥的“检验”

int sm2_verify(EVP_PKEY *pub_key, const unsigned char *digest, size_t digest_len, const unsigned char *sig, size_t sig_len) { EVP_PKEY_CTX *ctx = EVP_PKEY_CTX_new(pub_key, NULL); if (!ctx) return -1; // -1 表示错误 // 1. 初始化验签操作 if (EVP_PKEY_verify_init(ctx) <= 0) goto err; // 2. 同样，必须设置摘要类型为SM3，与签名时一致 if (EVP_PKEY_CTX_set_signature_md(ctx, EVP_sm3()) <= 0) goto err; // 3. 执行验签 int ret = EVP_PKEY_verify(ctx, sig, sig_len, digest, digest_len); EVP_PKEY_CTX_free(ctx); return ret; // 1: 验签成功， 0: 验签失败， -1: 操作错误 err: EVP_PKEY_CTX_free(ctx); return -1; }

验签函数返回三个状态：

1：验签成功，说明签名有效，消息确实来自对应的私钥持有者且未被篡改。
0：验签失败，说明签名无效。可能是消息被篡改、签名被破坏、或者使用的公钥不匹配。
-1：操作过程中发生错误（如内存分配失败、参数错误等），而不是签名本身无效。

5.3 完整的签名与验签流程示例

将哈希、签名、验签串联起来：

int main() { // ... 生成或加载密钥对 (pkey_priv, pkey_pub) ... char message[] = "This is a critical contract."; unsigned char digest[32]; size_t digest_len = 32; // 1. 对消息计算SM3哈希 sm3_hash((unsigned char*)message, strlen(message), digest); // 2. 使用私钥对哈希值进行签名 unsigned char *signature = NULL; size_t sig_len = 0; if (!sm2_sign(pkey_priv, digest, digest_len, &signature, &sig_len)) { printf("Sign failed!\n"); return -1; } // 3. （模拟传输过程...） // 4. 接收方重新计算消息哈希 unsigned char digest_verify[32]; sm3_hash((unsigned char*)message, strlen(message), digest_verify); // 5. 使用公钥验证签名 int verify_result = sm2_verify(pkey_pub, digest_verify, digest_len, signature, sig_len); if (verify_result == 1) { printf("Signature verification SUCCESS!\n"); } else if (verify_result == 0) { printf("Signature verification FAILED! Message may be tampered.\n"); } else { printf("Verification operation ERROR!\n"); } OPENSSL_free(signature); // ... 清理资源 ... return 0; }

6. 核心问题排查与实战经验

在实际集成SM2/SM3时，你几乎一定会遇到下面这些问题。我把它们和解决方案记录下来，希望能帮你节省大量调试时间。

6.1 编译与链接问题

问题：fatal error: openssl/evp.h: No such file or directory或undefined reference toEVP_sm3‘`。
排查：
1. 检查-I和-L路径：确保路径指向你编译安装的支持SM2的OpenSSL目录，而不是系统自带的。
2. 检查库文件：到/usr/local/openssl-sm2/lib目录下查看，是否存在libcrypto.a或libcrypto.so。运行nm libcrypto.a | grep EVP_sm3，看是否能找到SM3相关的符号。如果找不到，说明编译时enable-sm3未生效。
3. 链接顺序：确保-lcrypto放在源文件之后。链接器处理依赖是从左到右的。

6.2 运行时错误

问题：EVP_PKEY_keygen或签名/加密操作返回失败，通过ERR_get_error()获取错误码是0x0607C07E（类似）。
排查：
1. 首要怀疑：曲线未设置或不支持。确保在密钥生成上下文初始化后，调用了EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx, NID_sm2)。可以通过ERR_error_string(ERR_get_error(), NULL)打印人类可读的错误信息。
2. 检查OpenSSL版本和配置：在代码中打印OpenSSL_version(OPENSSL_VERSION)，确认版本号。并确认运行环境的动态库（如果使用动态链接）也是你编译的那个版本。

6.3 签名验签失败

问题：自己签的名，用自己的公钥验签却失败。
排查清单：
1. 哈希算法一致性（最常见）：签名时EVP_PKEY_CTX_set_signature_md(ctx, EVP_sm3())，验签时也必须设置同样的MD。两边都必须显式设置。
2. 摘要数据一致性：确保签名和验签时传入的digest是完全相同的字节序列。一个常见的错误是，签名时对原始字符串str计算哈希，验签时却对str的某种编码（如Base64解码后的数据）计算哈希。
3. 密钥对匹配：确保验签使用的公钥与签名使用的私钥是配对的。
4. 签名值损坏：如果在网络传输或存储过程中，签名值（通常是DER编码的ASN.1结构）被不正确地修改（如被当做字符串处理，添加了换行符或发生了编码转换），验签自然会失败。建议将签名值以二进制模式写入文件，或进行Base64编码后再进行文本传输。

6.4 与其他系统（如Java、Go）的交互问题

问题：用OpenSSL C语言生成的签名，Java端的国密库（如BouncyCastle）验签不通过。
核心原因：SM2签名值的ASN.1 DER编码格式。OpenSSL默认生成的签名是(r, s)的DER序列。但有些国密实现（尤其是早期的一些实现）可能期望的是r和s的简单拼接（各32字节，共64字节），或者顺序相反。
解决方案：
1. 统一格式：与交互方明确约定签名值的格式。是标准的ASN.1 DER，还是64字节的裸r||s。
2. 编解码处理：如果是裸格式，OpenSSL需要额外处理。可以使用EVP_PKEY_CTX_set_ec_scheme和EVP_PKEY_CTX_set_ec_enc_flags进行一些设置（但不同版本支持度不同）。更可靠的方法是，使用OpenSSL较低层的ECDSA_SIG对象进行手动编解码。
```
// 将DER签名解码为ECDSA_SIG对象，再提取r, s ECDSA_SIG *ec_sig = ECDSA_SIG_new(); const unsigned char *pder = signature; // 指向DER编码的签名 ec_sig = d2i_ECDSA_SIG(NULL, &pder, sig_len); const BIGNUM *r = NULL, *s = NULL; ECDSA_SIG_get0(ec_sig, &r, &s); // 现在可以将r和s转换为裸字节了 // BN_bn2bin(r, r_buf); BN_bn2bin(s, s_buf);
```
反之，也可以将裸的r,s字节数组构造成ECDSA_SIG对象，再编码成DER格式。

6.5 内存管理要点

OpenSSL很多函数返回的指针需要手动管理内存，不当使用会导致内存泄漏。

谁分配，谁释放：EVP_PKEY_CTX_new,EVP_MD_CTX_new,OPENSSL_malloc分配的内存，必须用对应的EVP_PKEY_CTX_free,EVP_MD_CTX_free,OPENSSL_free来释放。
检查返回值：几乎所有OpenSSL函数在出错时都返回0或NULL。养成检查返回值的习惯，并在错误时跳转到清理代码段释放已申请的资源。
使用EVP_PKEY_up_ref管理引用计数：EVP_PKEY对象有引用计数。如果你需要在一个函数内返回一个EVP_PKEY*，并且这个pkey是从别处获取的，在返回前调用EVP_PKEY_up_ref(pkey)增加其引用计数，调用者负责在最后EVP_PKEY_free。这样可以避免一个对象被提前释放。

7. 进阶话题：性能优化与生产环境考量

当你的代码从Demo走向生产环境时，以下考虑至关重要。

7.1 密钥管理与存储

私钥安全：生产环境的私钥绝不能像示例那样硬编码在代码里或明文存储在文件中。必须使用强密码进行加密存储（如示例中的PEM_write_PrivateKey使用AES-256）。更好的做法是使用硬件安全模块（HSM）或云密钥管理服务（KMS）。
密钥轮换：制定密钥轮换策略。SM2密钥虽然理论上长期有效，但定期更换可以降低密钥泄露带来的长期风险。
公钥分发：公钥可以公开，但需要确保其完整性和真实性。通常通过数字证书（X.509证书，其中包含SM2公钥并由可信CA签名）的形式分发。

7.2 错误处理与日志

示例中的goto err是一种简单的错误处理。在生产代码中，你需要更健壮的处理：

获取详细错误：使用ERR_get_error_line_data获取错误码、文件名、行号和错误数据，记录到日志中。
资源清理：确保在任何错误退出路径上，所有已分配的上下文、内存、文件描述符都被正确释放。
避免信息泄露：错误日志不应包含敏感信息，如私钥、明文数据等。

7.3 算法标识与兼容性

在需要与其他系统交换数据时（如生成PKCS#7签名或X.509证书），需要明确指定算法标识符。SM2的公钥算法标识是id-ecPublicKey，并且需要指定曲线参数sm2p256v1。SM2-with-SM3的签名算法标识是sm2sign-with-sm3。在OpenSSL中配置这些通常需要在创建证书签名请求（CSR）或证书时，通过-sigopt参数或相应的API进行设置。

我个人在将一个基于OpenSSL SM2的客户端与一个Java服务端对接时，最大的教训就是不要假设。不要假设对方理解的“SM2签名”和你生成的一样。第一步永远是进行一个“握手测试”：用双方都认可的、最明确的测试向量（例如国密标准文档附录中的示例）进行互操作测试，确保从密钥、明文到密文/签名的每一个字节都对齐，再开始真正的业务开发。这能避免后期大量的联调成本。

查看全文

http://www.jsqmd.com/news/1059294/