[047][Crypto模块]基于 Hutool 的常见加解密算法封装与密钥自动生成

简介: 本文基于Hutool封装统一加解密框架,提供AES/RSA/SM2/SM4/HMAC等算法的`CryptoProcessor`标准接口,支持密钥自动生成与动态切换,解耦业务代码,兼顾国密合规与易用性,提升安全性与可测试性。(239字)

[047][Crypto模块]基于 Hutool 的常见加解密算法封装与密钥自动生成

Hutool 是一个优秀的 Java 工具库,提供了简单易用的加密 API。但直接在业务代码中调用 Hutool 仍然存在耦合。本文展示如何将 Hutool 的各种加解密算法封装为统一的 CryptoProcessor 接口,并实现密钥自动生成能力。

一、为什么选择 Hutool?

Hutool 的加密模块(cn.hutool.crypto)封装了 JDK 内置的加密算法和 BouncyCastle 的国密算法,使用起来非常简洁:

// 对称加密示例
AES aes = SecureUtil.aes(keyBytes);
String encryptHex = aes.encryptHex(data);
String decryptStr = aes.decryptStr(encryptHex);

相比于直接操作 Cipher,Hutool 大大减少了样板代码。同时,它支持 SM2/SM3/SM4 等国密算法,满足合规要求。

二、封装对称加密处理器:以 AES 为例

实现 CryptoProcessor 接口,内部持有 Hutool 的 AES 对象:

@RequiredArgsConstructor
public class AESCryptoProcessor implements CryptoProcessor {
   
    protected final AES aes;
    protected final SecretKey secretKey;

    public static AESCryptoProcessor create() {
   
        return create(SecretKeyGenerator.generateASEKey());
    }

    public static AESCryptoProcessor create(SecretKey secretKey) {
   
        Assert.notNull(secretKey, "'secretKey' must not be null");
        AES aes = SecureUtil.aes(secretKey.symmetricKeyByte());
        return new AESCryptoProcessor(aes, secretKey);
    }

    @Override
    public String encrypt(String data) {
   
        return aes.encryptHex(data);
    }

    @Override
    public String decrypt(String data) {
   
        return aes.decryptStr(data);
    }

    @Override
    public CryptoCategory getCategory() {
   
        return CryptoCategory.AES;
    }
    // 其他方法...
}

SecretKey 是一个简单的值对象,封装了对称密钥的 Hex 字符串(对于非对称,包含公私钥对)。SecretKeyGenerator 负责生成各种算法的密钥。

三、密钥自动生成器

SecretKeyGenerator 是一个接口,但提供了静态方法:

public interface SecretKeyGenerator {
   
    static SecretKey generateASEKey() {
   
        byte[] encoded = SecureUtil.generateKey(SymmetricAlgorithm.AES.getValue()).getEncoded();
        return new SecretKey(HexUtil.encodeHexStr(encoded));
    }

    static SecretKey generateRSAKey() {
   
        KeyPair keyPair = SecureUtil.generateKeyPair(AsymmetricAlgorithm.RSA.getValue(), 1024);
        return new SecretKey(
            HexUtil.encodeHexStr(keyPair.getPublic().getEncoded()),
            HexUtil.encodeHexStr(keyPair.getPrivate().getEncoded()));
    }

    static SecretKey generateSM2Key() {
    ... }
    static SecretKey generateHmacSHA256Key() {
    ... }
    // ...
}

这样,当用户在配置文件中没有提供密钥时,处理器可以通过 create() 方法自动生成密钥并创建实例,实现了“开箱即用”。

四、封装非对称加密处理器:以 RSA 为例

非对称加密相比对称加密多了一对密钥。Hutool 的 RSA 类支持通过公钥加密、私钥解密:

@RequiredArgsConstructor
public class RSACryptoProcessor implements CryptoProcessor {
   
    private final RSA rsa;
    private final SecretKey secretKey;

    public static RSACryptoProcessor create(SecretKey secretKey) {
   
        RSA rsa = SecureUtil.rsa(secretKey.privateKeyByte(), secretKey.publicKeyByte());
        return new RSACryptoProcessor(rsa, secretKey);
    }

    @Override
    public String encrypt(String content) {
   
        return rsa.encryptBase64(content, StandardCharsets.UTF_8, KeyType.PublicKey);
    }

    @Override
    public String decrypt(String content) {
   
        return rsa.decryptStr(content, KeyType.PrivateKey);
    }
}

注意:非对称加密对数据长度有限制,实际生产环境中通常会组合对称加密(如用 RSA 加密对称密钥,再用对称密钥加密业务数据)。本框架为简化演示,直接使用非对称加密短文本。

五、封装 HMAC 摘要处理器

摘要(消息认证码)接口是 DigestProcessor,HMac 需要密钥:

@RequiredArgsConstructor
public class HmacSHA256DigestProcessor implements DigestProcessor {
   
    private final HMac mac;
    private final SecretKey secretKey;

    @Override
    public String digest(String content) {
   
        return mac.digestHex(content);
    }
}

无密钥的摘要(如 SHA256、SM3)则不需要 SecretKey:

public class SHA256DigestProcessor implements DigestProcessor {
   
    private final Digester sha256;

    @Override
    public String digest(String content) {
   
        return sha256.digestHex(content);
    }

    @Override
    public SecretKey getSecretKey() {
   
        return null; // 不支持
    }
}

六、newInstance 方法的设计

每个处理器都提供了 newInstance() 和 newInstance(SecretKey secretKey) 方法,用于动态创建新的处理器实例。这在多租户场景或需要临时更换密钥时非常有用:

// 创建一个默认密钥的 AES 处理器
CryptoProcessor defaultAes = AESCryptoProcessor.create();
// 根据特定租户的密钥创建新实例
CryptoProcessor tenantAes = defaultAes.newInstance(tenantSecretKey);
String encrypted = tenantAes.encrypt(data);

由于摘要处理器(SHA256/SM3)不需要密钥,newInstance(SecretKey) 返回 null 或抛出异常即可。

七、总结

通过封装 Hutool,我们获得了:

  • 统一接口:无论是对称、非对称还是摘要,都通过一致的 encrypt/decrypt 或 digest 方法调用。
  • 密钥灵活性:可以从配置文件注入 Hex 字符串,也可以自动生成,满足开发和生产不同阶段的需求。
  • 易于测试:可以轻松 mock CryptoProcessor,无需真实调用加密库。
  • 支持国密:SM2/SM3/SM4 同样被封装在框架中,符合安全合规要求。

下一步可以扩展的包括:密钥版本管理、密钥轮换、与 KeyStore 集成等。

目录
相关文章
|
4月前
|
前端开发 Java API
[049][Crypto模块]前后端混合加密API实战:基于Spring Boot的AES+RSA安全传输方案
本文详解Spring Boot中AES+RSA混合加密实战:前端用RSA公钥加密随机AES密钥并传输,后端通过`@Crypto`注解自动解密请求体。涵盖公钥分发、Hex/Base64编码统一、ECB模式适配及Caffeine缓存优化,提供开箱即用的端到端安全传输方案。(239字)
507 0
|
4月前
|
JSON 安全 Java
[024][Web模块]基于 AntiSamy 的 Spring Boot XSS 防护实践:从过滤器到反序列化的多层防御
本文介绍基于OWASP AntiSamy的Spring Boot XSS多层防护方案:通过Servlet过滤器清洗表单/查询参数,结合Jackson反序列化器净化JSON数据,实现非侵入、全覆盖的输入清洗,业务代码零修改。(239字)
495 2
|
4月前
|
前端开发 NoSQL Java
[027][Web模块]基于 Spring MVC 的 API 签名校验拦截器设计与实现
本文介绍基于Spring MVC的API签名校验拦截器,支持HmacSHA256签名、时间窗校验、nonce防重放及密钥动态加载,通过`@RequiredSignature`注解无侵入集成,具备高扩展性与生产可用性。(239字)
265 1
|
4月前
|
JSON 前端开发 Java
[048][Crypto模块]Spring Boot 请求体自动解密:@Crypto 注解 + RequestBodyAdvice 实现
本文介绍基于Spring Boot的请求体自动解密方案:通过自定义`@Crypto`注解与`RequestBodyAdvice`,在Controller入参前透明解密RSA/SM2加密的JSON请求体,实现业务代码零侵入、算法可插拔、开关灵活的安全传输机制。(239字)
288 1
|
4月前
|
人工智能 弹性计算 API
【AI 尝鲜实验室】上新 | New API:一个入口打通全网大模型的统一网关
New API 是 QuantumNous 开源的下一代大模型网关与 AI 资产管理系统(GitHub 42k+ Stars,AGPL-3.0 协议)。它将 OpenAI、Claude、Gemini、DeepSeek、通义 Qwen、Midjourney、Suno 等全网主流大模型聚合到一个统一的 OpenAI 兼容接口,内置多渠道分组、加权随机分发、失败自动重试、完整的用户/令牌/额度管理和在线充值能力。 本次实验通过阿里云计算巢一键部署 New API 到云端,几分钟即可拥有一套专属大模型网关。部署完成后你可以在后台集中管理所有模型渠道、给团队成员分发独立令牌和额度,并通过格式互转让 Cl
1159 2
|
4月前
|
SQL Java 数据库连接
[026][数据模块]基于 MyBatis Plus 的企业级数据访问框架设计与实现
本文介绍基于MyBatis Plus二次封装的企业级数据访问框架,支持多租户隔离、分页、乐观锁、SQL防攻击及审计字段自动填充。通过有序拦截器链、条件化配置与开放扩展点,实现可插拔、易维护的统一数据访问能力。(239字)
248 2
|
4月前
|
设计模式 Java Spring
[046][Crypto模块]Spring Boot 自动配置进阶:按需装配加解密处理器
本文详解Spring Boot自动配置进阶实践:基于Crypto模块,通过`@ConditionalOnMissingBean`、`@EnableConfigurationProperties`等注解,实现加解密处理器的按需装配与灵活覆盖。涵盖配置属性绑定、多配置类拆分、条件加载(Web/非Web)、日志调试及Hutool集成,助力构建高可扩展Starter。
256 2
|
4月前
|
数据采集 安全 网络安全
组织化电商交易网络钓鱼犯罪链路与主动防御技术研究 —— 基于白俄罗斯 21 人诈骗团伙案件实证分析
本文以白俄罗斯21人电商钓鱼团伙案为实证,揭示中小规模组织化钓鱼“低龄主犯、线上招募、轻量页面、实时分赃”新特征,指出静态黑名单滞后性缺陷;创新构建域名相似度、会话语义、页面表单三层动态检测框架,配套Python代码,识别准确率达92.7%;并提出技术防控、平台治理、跨境协作、全民宣教四维综合治理路径。(239字)
175 0
|
4月前
|
缓存 监控 安全
[025][Web模块]基于 Spring Boot 的请求日志过滤器设计与实现
本文介绍基于Spring Boot的可配置请求日志过滤器,通过自定义`WebHttpProperties`、扩展`CommonsRequestLoggingFilter`及自动配置类,支持时间戳、客户端信息、请求头/体记录、动态前缀等灵活配置,开箱即用,兼顾可维护性与生产安全性。(239字)
482 1
|
4月前
|
算法 Java 数据安全/隐私保护
[045][Crypto模块]设计一个可扩展的加解密框架:策略模式与工厂模式实战
本文基于Spring Boot,运用策略模式与工厂模式设计可扩展加解密框架:统一`CryptoProcessor`接口封装AES、RSA、SM2等算法;通过`CryptoProcessorFactory`按枚举类别自动注册/查找处理器;结合Spring自动装配,新增算法(如SM9)仅需实现接口并声明Bean,零侵入扩展。高内聚、低耦合、易维护。(239字)
284 2