1. 项目概述为什么要在Java里折腾SM系列算法如果你正在开发一个面向国内市场的金融、政务或者物联网应用那么“国密”这个词对你来说一定不陌生。SM系列算法作为国家商用密码标准已经从“可选”变成了很多场景下的“必选”。最近我在重构一个涉及数据安全交换的Java服务时就不得不把原先的RSA/AES全家桶逐步替换成SM2/SM3/SM4。这个过程远不是换个算法名那么简单从标准理解、库选型到实际集成每一步都有不少门道。简单来说这个“详解与实践”项目就是要解决一个核心问题如何在一个标准的Java工程里安全、正确且高效地集成和使用SM2、SM3、SM4算法。这不仅仅是调用几个API更涉及到对国密算法标准本身的理解、第三方库的甄选、与现有架构的融合以及那些在官方文档里不会写的“坑”。无论你是需要满足合规性要求还是单纯对国密算法实现感兴趣这篇从一线实战中总结的内容都能给你一份可直接参考的“路线图”。2. 核心算法解析SM2、SM3、SM4究竟是何方神圣在动手写代码之前我们必须先搞清楚要用的“工具”到底是什么。SM系列算法是一个家族我们常用的主要是SM2非对称、SM3杂凑和SM4对称。2.1 SM2椭圆曲线上的“签名”与“密钥交换”SM2是基于椭圆曲线密码学ECC的公钥算法。你可以把它理解为国密版的ECC算法但它使用的椭圆曲线参数是特定的、中国定义的曲线sm2p256v1。和RSA相比在相同安全强度下SM2的密钥长度更短256位对比RSA 2048位计算更快存储空间也更小。它的主要用途有两个数字签名验证数据的完整性和来源真实性。比如服务器下发一个重要配置附上SM2签名客户端就能验证这个配置是否被篡改、是否来自可信服务器。密钥交换在不安全的信道上协商出一个只有通信双方知道的共享密钥。这个密钥后续可以用来进行SM4对称加密。这里有个关键点SM2的签名和加密密钥交换是两套不同的流程不能混用。我们通常说的“SM2加密”往往指的是密钥交换协议而非像RSA那样直接对数据进行公钥加密虽然标准也定义了加密算法但实践中较少直接用于加密大量数据。2.2 SM3密码杂凑算法的“中国芯”SM3是一种密码杂凑算法输出长度为256位32字节。它的角色和国际上的SHA-256类似用于生成数据的“指纹”。无论输入数据多大输出都是固定长度的摘要。主要用途包括完整性校验计算文件或报文的摘要比对以确认数据未被篡改。数字签名的一部分SM2签名过程的核心步骤之一就是对消息先用SM3进行摘要。消息认证码结合密钥可以生成HMAC-SM3用于消息认证。派生密钥在密钥派生过程中使用。一个重要的实践细节是SM3在设计上考虑了对抗“长度扩展攻击”其结构比早期的MD5、SHA-1更安全。2.3 SM4分组对称加密的“工作主力”SM4是一种分组对称加密算法分组长度和密钥长度均为128位。它在整个加密体系中扮演着“工作密钥”的角色负责对实际传输的大量业务数据进行高速加解密。其模式和国际上常用的AES对应。SM4支持多种工作模式你需要根据场景选择ECB模式最简单但不安全相同的明文块会加密成相同的密文块不推荐用于加密有意义的数据。CBC模式最常用的模式之一需要提供一个初始化向量IV。它能有效隐藏明文的模式但加密过程是串行的。CTR模式将分组密码转换为流密码可以并行加解密非常适合加密数据流或需要随机访问的场景。注意在实际项目中绝对不要使用ECB模式来加密业务数据。对于文本、JSON等数据CBC是稳妥的选择对于大文件或流式数据可以考虑CTR或GCM如果库支持模式。3. 环境准备与核心库选型在Java世界里JDK标准库并没有内置对SM系列算法的支持。因此我们的第一步就是选择一个可靠、高效且维护良好的第三方密码库。3.1 主流库对比与选型建议目前社区主要有以下几个选择库名称提供方优点缺点/注意事项适用场景Bouncy Castle第三方开源组织历史悠久生态最广支持算法最全文档丰富。提供了JCE Provider和轻量级API两种使用方式。包体积较大API相对底层需要开发者对密码学概念有较好理解。绝大多数通用场景尤其是需要兼容性或使用多种非标算法时。国密算法SDK官方或指定厂商通常由密码产品厂商提供经过官方认证可能在某些合规场景是硬性要求。可能闭源、收费或绑定特定硬件通用性和灵活性较差。有明确合规要求且指定使用某厂商产品的项目。Hutool-crypto国内开源项目在Bouncy Castle等基础上做了上层封装API非常友好开箱即用适合快速开发。封装可能隐藏细节在需要深度定制或排查复杂问题时需要理解底层。追求开发效率业务逻辑不涉及极端复杂密码学操作的中小型项目。我的选型思路是对于大多数自研的、追求可控性和学习深度的项目我推荐使用Bouncy CastleBC。它是事实上的标准你能遇到的所有问题几乎都能找到社区解答。通过直接使用BC你能更透彻地理解算法调用的每一个环节这对于调试和解决问题至关重要。Hutool可以作为辅助在那些不关心内部细节、只求快速实现功能的工具类中使用。3.2 项目依赖引入与Provider注册假设我们使用Maven引入Bouncy Castle的依赖。注意我们通常引入两个包bcprov-jdk15on核心密码学提供者和bcpkix-jdk15on处理证书和CRL等。dependency groupIdorg.bouncycastle/groupId artifactIdbcprov-jdk15on/artifactId version1.70/version !-- 请使用最新稳定版 -- /dependency dependency groupIdorg.bouncycastle/groupId artifactIdbcpkix-jdk15on/artifactId version1.70/version /dependency引入依赖后必须在代码中静态注册BC为JCE的Provider这是最关键的一步否则JVM无法识别SM系列算法。import org.bouncycastle.jce.provider.BouncyCastleProvider; import java.security.Security; public class SmCryptoInitializer { static { // 防止重复注册 if (Security.getProvider(BouncyCastleProvider.PROVIDER_NAME) null) { Security.addProvider(new BouncyCastleProvider()); } } }你可以把这段初始化代码放在应用启动类里或者一个静态工具类的静态块中确保在使用任何SM算法前执行。实操心得曾经在Web项目中我把Provider注册写在一个PostConstruct方法里结果某个定时任务在容器完全初始化前就跑起来了导致NoSuchAlgorithmException。最好的实践是在一个独立的配置类或工具类的静态块中注册确保线程安全且最早执行。4. SM3摘要算法实现详解SM3是基础我们从它开始。在Java中使用SM3本质上就是获取一个MessageDigest实例。4.1 基础用法与数据完整性校验import java.security.MessageDigest; import java.security.Security; import org.bouncycastle.jce.provider.BouncyCastleProvider; public class Sm3Util { static { Security.addProvider(new BouncyCastleProvider()); } /** * 计算数据的SM3摘要十六进制字符串形式 */ public static String hash(byte[] data) throws Exception { MessageDigest md MessageDigest.getInstance(SM3, BouncyCastleProvider.PROVIDER_NAME); byte[] digest md.digest(data); return bytesToHex(digest); // 需要实现一个bytesToHex方法 } /** * 验证数据的摘要是否匹配 */ public static boolean verify(byte[] data, String expectedHash) throws Exception { String actualHash hash(data); return MessageDigest.isEqual(actualHash.getBytes(), expectedHash.getBytes()); // 使用恒定时间比较 } }关键点解析MessageDigest.getInstance(SM3, BouncyCastleProvider.PROVIDER_NAME)这里必须显式指定Provider为BouncyCastle否则JVM会用默认Provider而默认Provider不支持SM3。MessageDigest.isEqual用于比较两个摘要值。千万不要用String.equals()或Arrays.equals()来比较密码学哈希值前者可能因为字符串缓存导致时间侧信道攻击后者在发现第一个不同字节时就返回也可能泄露信息。MessageDigest.isEqual是恒定时间比较更安全。4.2 大文件流式处理与HMAC-SM3对于大文件不能一次性读入内存需要流式处理public static String hashFile(Path filePath) throws Exception { MessageDigest md MessageDigest.getInstance(SM3, BouncyCastleProvider.PROVIDER_NAME); try (InputStream is Files.newInputStream(filePath); DigestInputStream dis new DigestInputStream(is, md)) { // 读取流的过程中摘要会自动更新 byte[] buffer new byte[8192]; while (dis.read(buffer) ! -1) { // 只需读取DigestInputStream会处理更新 } } byte[] digest md.digest(); return bytesToHex(digest); }如果需要使用带密钥的HMAC-SM3用于消息认证Bouncy Castle也提供了支持import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; public static byte[] hmacSm3(byte[] key, byte[] data) throws Exception { Mac mac Mac.getInstance(HMAC-SM3, BouncyCastleProvider.PROVIDER_NAME); SecretKeySpec secretKeySpec new SecretKeySpec(key, HMAC-SM3); mac.init(secretKeySpec); return mac.doFinal(data); }5. SM4对称加密算法实现与实践SM4是业务数据加密的主力。我们重点看最常用的CBC模式。5.1 CBC模式加解密完整实现CBC模式需要几个关键参数密钥Key、初始化向量IV、以及填充方式Padding。SM4通常使用PKCS7Padding在Java标准中叫PKCS5Padding两者在分组密码中等价。import javax.crypto.Cipher; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; public class Sm4Util { private static final String ALGORITHM_NAME SM4; private static final String TRANSFORMATION_CBC SM4/CBC/PKCS5Padding; // 算法/模式/填充 /** * SM4 CBC模式加密 * param key 16字节的密钥 * param iv 16字节的初始化向量 * param plaintext 明文数据 * return Base64编码的密文 */ public static String encryptCbc(byte[] key, byte[] iv, byte[] plaintext) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION_CBC, BouncyCastleProvider.PROVIDER_NAME); SecretKeySpec secretKeySpec new SecretKeySpec(key, ALGORITHM_NAME); IvParameterSpec ivParameterSpec new IvParameterSpec(iv); cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, ivParameterSpec); byte[] ciphertext cipher.doFinal(plaintext); return Base64.getEncoder().encodeToString(ciphertext); } /** * SM4 CBC模式解密 * param key 16字节的密钥 * param iv 16字节的初始化向量 * param base64Ciphertext Base64编码的密文 * return 解密后的明文数据 */ public static byte[] decryptCbc(byte[] key, byte[] iv, String base64Ciphertext) throws Exception { Cipher cipher Cipher.getInstance(TRANSFORMATION_CBC, BouncyCastleProvider.PROVIDER_NAME); SecretKeySpec secretKeySpec new SecretKeySpec(key, ALGORITHM_NAME); IvParameterSpec ivParameterSpec new IvParameterSpec(iv); cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, ivParameterSpec); byte[] ciphertext Base64.getDecoder().decode(base64Ciphertext); return cipher.doFinal(ciphertext); } }参数生成与安全要点密钥生成SM4密钥必须是16字节128位。务必使用密码学安全的随机数生成器CSPRNG来生成。import java.security.SecureRandom; SecureRandom secureRandom new SecureRandom(); byte[] key new byte[16]; secureRandom.nextBytes(key);IV生成IV也必须是16字节同样需要是密码学安全的随机数。重要CBC模式下同一个密钥绝不能重复使用相同的IV否则会泄露明文信息。每次加密都应生成新的随机IV。IV不需要保密可以随密文一起传输通常拼接在密文前面。密钥管理上述代码中密钥是作为参数传入的但在生产环境中绝对不要将硬编码在代码里。密钥应该来自安全的密钥管理系统KMS或配置中心并定期轮换。5.2 封装一个更易用的工具类在实际项目中我们通常会将IV和密文打包在一起方便传输和存储。public class Sm4CbcHelper { private static final int IV_LENGTH 16; // SM4块大小是16字节 /** * 加密返回格式为 Base64(IV) : Base64(Ciphertext) */ public static String encryptWithIv(String plaintext, byte[] key) throws Exception { SecureRandom sr new SecureRandom(); byte[] iv new byte[IV_LENGTH]; sr.nextBytes(iv); // 生成随机IV Cipher cipher Cipher.getInstance(SM4/CBC/PKCS5Padding, BC); cipher.init(Cipher.ENCRYPT_MODE, new SecretKeySpec(key, SM4), new IvParameterSpec(iv)); byte[] ciphertext cipher.doFinal(plaintext.getBytes(StandardCharsets.UTF_8)); String ivBase64 Base64.getEncoder().encodeToString(iv); String ctBase64 Base64.getEncoder().encodeToString(ciphertext); return ivBase64 : ctBase64; // 用分隔符连接 } /** * 解密处理 Base64(IV):Base64(Ciphertext) 格式的输入 */ public static String decryptWithIv(String encryptedData, byte[] key) throws Exception { String[] parts encryptedData.split(:); if (parts.length ! 2) { throw new IllegalArgumentException(Invalid encrypted data format); } byte[] iv Base64.getDecoder().decode(parts[0]); byte[] ciphertext Base64.getDecoder().decode(parts[1]); Cipher cipher Cipher.getInstance(SM4/CBC/PKCS5Padding, BC); cipher.init(Cipher.DECRYPT_MODE, new SecretKeySpec(key, SM4), new IvParameterSpec(iv)); byte[] plaintext cipher.doFinal(ciphertext); return new String(plaintext, StandardCharsets.UTF_8); } }这种方式将IV和密文捆绑避免了单独管理IV的麻烦是实践中很常见的做法。6. SM2非对称加密算法深度实践SM2的实现比SM4复杂因为它涉及密钥对生成、签名验签、密钥交换等多个方面。我们重点看最常用的数字签名。6.1 密钥对生成与PEM格式导出首先我们需要生成SM2的密钥对公钥和私钥。import org.bouncycastle.asn1.gm.GMNamedCurves; import org.bouncycastle.asn1.x9.X9ECParameters; import org.bouncycastle.crypto.AsymmetricCipherKeyPair; import org.bouncycastle.crypto.generators.ECKeyPairGenerator; import org.bouncycastle.crypto.params.ECDomainParameters; import org.bouncycastle.crypto.params.ECKeyGenerationParameters; import org.bouncycastle.crypto.params.ECPrivateKeyParameters; import org.bouncycastle.crypto.params.ECPublicKeyParameters; import org.bouncycastle.jcajce.provider.asymmetric.ec.BCECPrivateKey; import org.bouncycastle.jcajce.provider.asymmetric.ec.BCECPublicKey; import org.bouncycastle.jce.spec.ECParameterSpec; import java.security.KeyPair; import java.security.KeyPairGenerator; import java.security.SecureRandom; public class Sm2KeyUtil { /** * 生成SM2密钥对 (使用BC轻量级API更直接) */ public static AsymmetricCipherKeyPair generateKeyPair() { // 获取SM2的椭圆曲线参数 X9ECParameters sm2ECParameters GMNamedCurves.getByName(sm2p256v1); ECDomainParameters domainParameters new ECDomainParameters( sm2ECParameters.getCurve(), sm2ECParameters.getG(), sm2ECParameters.getN(), sm2ECParameters.getH() ); ECKeyPairGenerator keyPairGenerator new ECKeyPairGenerator(); ECKeyGenerationParameters keyGenerationParameters new ECKeyGenerationParameters(domainParameters, new SecureRandom()); keyPairGenerator.init(keyGenerationParameters); return keyPairGenerator.generateKeyPair(); } /** * 将BC轻量级密钥对转换为JCE标准的KeyPair便于用JCE API进行签名 */ public static KeyPair convertToJCEKeyPair(AsymmetricCipherKeyPair bcKeyPair) { X9ECParameters sm2ECParameters GMNamedCurves.getByName(sm2p256v1); ECParameterSpec ecParameterSpec new ECParameterSpec( sm2ECParameters.getCurve(), sm2ECParameters.getG(), sm2ECParameters.getN(), sm2ECParameters.getH() ); BCECPrivateKey privateKey new BCECPrivateKey( ((ECPrivateKeyParameters) bcKeyPair.getPrivate()).getD(), ecParameterSpec ); BCECPublicKey publicKey new BCECPublicKey( (ECPublicKeyParameters) bcKeyPair.getPublic(), ecParameterSpec ); return new KeyPair(publicKey, privateKey); } }生成密钥对后通常需要将它们导出为PEM格式-----BEGIN PRIVATE KEY-----进行存储或分发。这里需要用到Bouncy Castle的PEM读写工具。import org.bouncycastle.openssl.jcajce.JcaPEMWriter; import java.io.StringWriter; import java.security.PrivateKey; import java.security.PublicKey; public class PemExportUtil { public static String exportPrivateKeyToPem(PrivateKey privateKey) throws Exception { StringWriter stringWriter new StringWriter(); try (JcaPEMWriter pemWriter new JcaPEMWriter(stringWriter)) { pemWriter.writeObject(privateKey); } return stringWriter.toString(); } public static String exportPublicKeyToPem(PublicKey publicKey) throws Exception { StringWriter stringWriter new StringWriter(); try (JcaPEMWriter pemWriter new JcaPEMWriter(stringWriter)) { pemWriter.writeObject(publicKey); } return stringWriter.toString(); } }6.2 数字签名与验签完整流程有了密钥对我们就可以进行签名和验签了。SM2的签名算法本身包含了SM3摘要过程通常表示为SM3withSM2。import java.security.Signature; import java.security.KeyPair; import java.util.Base64; public class Sm2SignatureUtil { private static final String SIGNATURE_ALGORITHM SM3withSM2; /** * 使用私钥对数据进行签名 * param privateKey 私钥 * param data 原始数据 * return Base64编码的签名值 */ public static String sign(PrivateKey privateKey, byte[] data) throws Exception { // 获取Signature实例指定算法和Provider Signature signature Signature.getInstance(SIGNATURE_ALGORITHM, BouncyCastleProvider.PROVIDER_NAME); signature.initSign(privateKey); signature.update(data); byte[] signBytes signature.sign(); return Base64.getEncoder().encodeToString(signBytes); } /** * 使用公钥验证签名 * param publicKey 公钥 * param data 原始数据 * param base64Signature Base64编码的签名值 * return 验签是否通过 */ public static boolean verify(PublicKey publicKey, byte[] data, String base64Signature) throws Exception { Signature signature Signature.getInstance(SIGNATURE_ALGORITHM, BouncyCastleProvider.PROVIDER_NAME); signature.initVerify(publicKey); signature.update(data); byte[] signBytes Base64.getDecoder().decode(base64Signature); return signature.verify(signBytes); } }签名流程解析Signature.getInstance(SM3withSM2, BC)获取签名算法实例。这个字符串告诉JCE我们要用SM2算法并且使用SM3做摘要。signature.initSign(privateKey)用私钥初始化签名对象进入签名模式。signature.update(data)传入待签名的数据。可以多次调用update处理流式数据。signature.sign()执行签名操作生成签名字节数组。验签流程与之对称只是用公钥初始化为验证模式最后调用verify方法。踩坑记录SM2的签名值signBytes通常是64字节左右两个256位整数r和s的DER编码但如果你发现签名长度是71或72字节这很可能是BC默认包含了ASN.1编码结构。这是正常的验签时也需要用同样编码格式的签名值。上述代码中Signature类已经处理了这些细节所以直接使用即可。但如果你需要与其他系统如某些硬件加密机或特定SDK交互必须确认双方的签名值编码格式是否一致通常是DER编码的ASN.1序列。6.3 结合SM4的典型应用场景混合加密系统在实际系统中很少单独使用某一种算法而是组合使用。一个经典的场景是使用SM2进行密钥协商或数字信封再用协商出的密钥通过SM4加密业务数据。场景客户端需要安全地向服务器发送一段敏感数据。流程客户端生成一个随机的SM4会话密钥sessionKey。客户端使用服务器的SM2公钥加密这个sessionKey得到encryptedSessionKey。这个过程就是SM2加密或密钥封装。客户端用sessionKey和随机IV通过SM4-CBC加密实际业务数据plainData得到cipherData。客户端将encryptedSessionKey、IV和cipherData一起发送给服务器。服务器用自己的SM2私钥解密encryptedSessionKey得到sessionKey。服务器用sessionKey和IV解密cipherData得到plainData。这样做的优点是利用了SM2非对称加密的安全性和SM4对称加密的高效性。即使需要加密的数据很大非对称加密部分也只作用于短的会话密钥性能开销很小。7. 常见问题、性能调优与生产实践在实际集成SM算法时你会遇到各种各样的问题。下面是我总结的一些典型问题和解决方案。7.1 常见异常与排查表异常信息可能原因解决方案java.security.NoSuchAlgorithmException: SM3 MessageDigest not available1. Bouncy Castle Provider未正确注册。2. 依赖冲突BC老版本被覆盖。1. 检查静态注册代码是否执行。2. 使用Security.getProviders()打印所有Provider确认。3. Maven使用mvn dependency:tree检查依赖排除冲突的旧版本BC。javax.crypto.IllegalBlockSizeException: last block incomplete in decryption1. 密文被损坏或截断。2. 密钥或IV错误。3. 加密和解密使用的填充模式不一致。1. 检查网络传输或存储过程是否导致数据丢失。2. 确认加解密双方使用的密钥和IV完全一致。3. 确认Cipher.getInstance中的Transformation字符串如SM4/CBC/PKCS5Padding完全一致。java.security.InvalidKeyException1. 密钥长度不符合算法要求如SM4密钥不是16字节。2. 密钥格式错误如PEM解析失败。3. 错误的密钥类型如用SM2公钥去做SM4解密初始化。1. 检查密钥生成逻辑确保长度正确。2. 调试检查加载的密钥对象是否为null或类型错误。3. 使用key.getAlgorithm()打印算法名确认。SM2验签始终失败1. 签名值编码格式不一致原始值 vs DER编码。2. 公钥与签名使用的私钥不匹配。3. 待验签的数据在签名和验签两个环节有差异如空格、编码。1. 与对方系统确认签名值的具体格式通常是DER编码的ASN.1。2. 确保使用的是正确的公钥。3.将待验签的数据在双方打印Hex或Base64进行严格比对这是最常见的原因。性能问题加解密慢1. 频繁创建Cipher、Signature等重量级对象。2. 使用大的密钥长度对于SM2256位是固定的。3. 单线程处理大量数据。1. 使用对象池如Apache Commons Pool复用Cipher对象。2. 对于SM4加密大文件使用CipherInputStream/CipherOutputStream流式处理避免内存溢出。3. 考虑对非关联数据块使用CTR等可并行模式。7.2 性能优化实践心得密码学操作是CPU密集型任务在高并发场景下需要优化。对象复用Cipher、Signature、MessageDigest等对象的创建和初始化成本较高。对于处理大量小数据包的场景如API网关对每个请求体加解密可以考虑使用ThreadLocal或对象池来缓存和复用这些对象。但要注意Cipher对象不是线程安全的每个线程必须使用独立的实例。private static final ThreadLocalCipher SM4_CIPHER_THREAD_LOCAL ThreadLocal.withInitial(() - { try { return Cipher.getInstance(SM4/CBC/PKCS5Padding, BC); } catch (Exception e) { throw new RuntimeException(Failed to create SM4 Cipher, e); } });流式处理加密大文件或数据流时务必使用CipherInputStream和CipherOutputStream它们会在读写过程中逐步加解密避免将整个文件加载到内存。算法模式选择如果业务允许且数据块之间无关联使用CTR或GCM模式可以利用现代CPU的多核特性进行并行加密提升吞吐量。硬件加速在极端性能要求的场景下可以调研是否使用支持国密指令集的硬件加密卡或支持SM系列算法加速的云服务将计算负载卸载到专用硬件。7.3 生产环境密钥管理安全规范这是最重要也是最容易忽视的一环。代码里的算法实现只是“战术”密钥管理才是“战略”。严禁硬编码任何密钥、密码都不能以明文形式写在源代码、配置文件中。使用密钥管理系统生产环境应使用专业的KMS如HashiCorp Vault, AWS KMS, 阿里云KMS等或硬件安全模块HSM来生成、存储和轮换密钥。应用程序在启动时或运行时从KMS动态获取密钥。密钥分离加密密钥、签名密钥、MAC密钥应该分开遵循“一钥一用”原则。定期轮换制定密钥轮换策略。对于SM4会话密钥每次会话都应不同。对于SM2长期密钥也应定期如每年更换。完善的日志与监控记录密钥的使用情况但绝不记录密钥本身监控异常的加解密操作频率设置告警。8. 进阶话题证书、SSL/TLS与国密改造当你的应用从内部服务升级到对外提供HTTPS接口或者需要与外部权威机构交互时就需要用到基于SM2的证书了。8.1 生成SM2证书签名请求你可以使用keytool需要支持BC的版本或openssl通过引擎生成SM2密钥对和证书请求CSR。这里以命令行概念为例生成SM2私钥和证书请求通常需要借助openssl的国密引擎。过程比较复杂涉及到编译支持国密的openssl。将CSR提交给支持国密算法的CA机构如CFCA等进行签名获得你的服务器SM2证书。在Web服务器如Nginx, Tomcat中配置使用此证书即可启用基于国密算法的HTTPS有时称为GMSSL。8.2 在Java应用中验证SM2证书在客户端你可能需要验证对方提供的SM2证书。Bouncy Castle的bcpkix包提供了支持。import org.bouncycastle.cert.X509CertificateHolder; import org.bouncycastle.cert.jcajce.JcaX509CertificateConverter; import org.bouncycastle.openssl.PEMParser; import java.io.FileReader; import java.security.cert.X509Certificate; import java.security.PublicKey; // 从PEM文件加载证书 public static X509Certificate loadCertificate(String pemFilePath) throws Exception { try (PEMParser pemParser new PEMParser(new FileReader(pemFilePath))) { X509CertificateHolder certificateHolder (X509CertificateHolder) pemParser.readObject(); return new JcaX509CertificateConverter().setProvider(BC).getCertificate(certificateHolder); } } // 验证证书签名假设是自签名或已知根证书 public static boolean verifyCertificate(X509Certificate cert, PublicKey rootPublicKey) throws Exception { try { cert.verify(rootPublicKey, BC); // 使用BC Provider进行验证 return true; } catch (Exception e) { return false; } }国密算法的全面落地是一个系统工程从底层的算法实现到中间件的协议支持如GMSSL再到上层应用的改造每一步都需要仔细考量。作为Java开发者我们从掌握核心的SM2/SM3/SM4的编程接口开始逐步构建起对国密生态的理解就能在需要的时候从容地让自己的应用满足合规与安全的要求。
