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

RuoYi-Vue登录模块改造实录：当Spring Security遇上国密SM4

news 2026/5/3 3:35:08

RuoYi-Vue安全升级实战：Spring Security与SM4国密加密的无缝融合

在数字化转型加速的今天，数据安全已成为企业级应用不可忽视的核心需求。作为国内广泛使用的快速开发框架，RuoYi-Vue默认采用Spring Security提供的安全机制，但在特定行业场景下，尤其是涉及政务、金融等领域时，国密算法的合规性要求往往成为技术选型的硬性指标。本文将深入探讨如何在不破坏Spring Security原有安全架构的前提下，将SM4国密算法优雅地集成到认证流程中，实现从传输到存储的全链路加密合规。

1. 国密算法与Spring Security的融合设计

国密算法（SM系列）是由国家密码管理局颁布的一系列商用密码标准，其中SM4作为分组对称加密算法，在安全性上与AES相当，但更符合国内监管要求。与常见的改造误区不同，我们并非要替换Spring Security的整个加密体系，而是在其认证流程的关键节点插入SM4的解密逻辑。

典型集成痛点分析：

  • 前端加密传输与后端解密验证的密钥一致性
  • 密码修改场景下的双向加密处理
  • 与原有BCrypt密码存储机制的兼容
  • 过滤器链中认证时机的精准把控

在RuoYi-Vue的默认实现中，密码传输采用明文或简单哈希，这显然无法满足高安全场景。我们的改造目标是在以下三个关键环节引入SM4：

  1. 用户登录时的密码传输加密
  2. 密码修改时的旧密码验证与新密码加密
  3. 用户注册时的初始密码处理

2. 后端核心改造实战

2.1 依赖引入与SM4工具类封装

首先需要引入BouncyCastle提供的国密算法支持：

<dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcprov-jdk15on</artifactId> <version>1.70</version> </dependency>

随后构建SM4加解密工具类，关键点在于处理ECB模式下的PKCS5Padding：

public class Sm4Util { private static final String ALGORITHM_NAME = "SM4"; private static final String ALGORITHM_NAME_ECB = "SM4/ECB/PKCS5Padding"; public static String decryptEcb(String cipherText, String hexKey) throws Exception { byte[] keyData = ByteUtils.fromHexString(hexKey); byte[] cipherData = ByteUtils.fromHexString(cipherText); Cipher cipher = Cipher.getInstance(ALGORITHM_NAME_ECB, "BC"); cipher.init(Cipher.DECRYPT_MODE, new SecretKeySpec(keyData, ALGORITHM_NAME)); return new String(cipher.doFinal(cipherData), StandardCharsets.UTF_8); } }

注意：实际生产环境中应将hexKey存储在配置中心或使用密钥管理系统，避免硬编码

2.2 认证流程改造关键点

在UsernamePasswordAuthenticationFilter的处理过程中，我们需要在密码验证前插入解密步骤：

public class LoginService { public String login(String username, String encryptedPassword) { // SM4解密 String rawPassword = Sm4Util.decryptEcb(encryptedPassword, hexKey); UsernamePasswordAuthenticationToken token = new UsernamePasswordAuthenticationToken(username, rawPassword); // 后续Spring Security标准认证流程 authenticationManager.authenticate(token); // ...生成token等逻辑 } }

密码修改场景需要特别注意新旧密码的双向处理：

@PutMapping("/updatePwd") public AjaxResult updatePwd(String encryptedOldPwd, String encryptedNewPwd) { String oldPwd = Sm4Util.decryptEcb(encryptedOldPwd, hexKey); String newPwd = Sm4Util.decryptEcb(encryptedNewPwd, hexKey); if (!passwordEncoder.matches(oldPwd, currentPwd)) { throw new BusinessException("旧密码校验失败"); } userService.updatePassword(passwordEncoder.encode(newPwd)); }

3. 前端适配方案

3.1 加密模块集成

前端采用sm-crypto库实现同步加密：

import { sm4 } from 'sm-crypto' const encryptPassword = (password, key) => { return sm4.encrypt(password, key) }

3.2 登录流程改造

关键是在发起请求前完成加密处理：

async handleLogin() { const publicKey = await getPublicKey() this.loginForm.password = encryptPassword( this.loginForm.password, publicKey ) login(this.loginForm).then(response => { // 处理登录结果 }) }

对于修改密码和注册流程，需要同样的加密处理：

async submitChangePwd() { const { oldPassword, newPassword } = this.form const key = await getPublicKey() const params = { oldPassword: encryptPassword(oldPassword, key), newPassword: encryptPassword(newPassword, key) } updatePassword(params).then(() => { this.$message.success('修改成功') }) }

4. 安全增强与性能优化

4.1 密钥管理策略

推荐采用动态密钥方案替代固定密钥：

@GetMapping("/sm4/key") public String generateTempKey() { String sessionKey = KeyGenerator.getInstance("SM4").generateKey(); redisTemplate.opsForValue().set( "sm4:"+SecurityUtils.getUserId(), sessionKey, 5, TimeUnit.MINUTES ); return sessionKey; }

4.2 性能优化方案

针对高频认证场景，可采用以下优化策略：

  1. 算法加速：

    // 启用BC硬件加速 static { Security.addProvider(new BouncyCastleProvider()); Security.setProperty("crypto.policy", "unlimited"); }

  2. 缓存策略：

    @Cacheable(value = "sm4Cache", key = "#cipherText") public String decryptWithCache(String cipherText) { return Sm4Util.decryptEcb(cipherText, key); }

  3. 连接池优化：

    # 适当增大Tomcat线程池 server.tomcat.max-threads=200 server.tomcat.min-spare-threads=20

4.3 审计与监控

增强安全审计功能：

@Aspect @Component public class SecurityAuditAspect { @AfterReturning(pointcut = "execution(* *..login(..))", returning = "result") public void auditLogin(JoinPoint jp, Object result) { String username = (String) jp.getArgs()[0]; log.info("登录成功审计 - 用户:{}", username); // 发送审计事件... } }

5. 兼容性处理与异常场景

5.1 多算法兼容方案

为平稳过渡，可设计多算法支持策略：

public PasswordDecoder passwordDecoder() { return new PasswordDecoder() { @Override public String decode(String encrypted) { try { // 尝试SM4解密 return Sm4Util.decryptEcb(encrypted, key); } catch (Exception e) { // 降级处理 return encrypted; } } }; }

5.2 典型异常处理

完善各类异常场景的应对：

try { return sm4.decrypt(cipherText); } catch (InvalidCipherTextException e) { throw new CryptoException("SM4解密失败，密文格式异常"); } catch (IllegalStateException e) { throw new CryptoException("SM4初始化失败，请检查BouncyCastle配置"); }

在前端统一处理加密异常：

async encryptedRequest(apiFunc, params) { try { const key = await getPublicKey() const encryptedParams = encryptParams(params, key) return await apiFunc(encryptedParams) } catch (error) { if (error.message.includes('SM4')) { showError('加密服务异常，请刷新重试') } throw error } }

经过完整改造后，系统安全架构同时具备：

  • 传输层：SM4国密算法保障
  • 存储层：BCrypt强哈希保护
  • 认证层：Spring Security完整机制
  • 合规性：满足等保2.0相关要求
http://www.jsqmd.com/news/742033/

相关文章：

  • LangGraph与Chatchat融合：构建企业级智能体应用框架实战
  • 2026成都卷帘门技术解析：四川卷帘门、成都卷帘门、防火卷帘门、防火门、别墅车库门、堆积门、工业门、彩钢卷帘门选择指南 - 优质品牌商家
  • Jarvis-Ai：基于LLM的智能体框架，赋予AI执行复杂任务的能力
  • 在macOS上完整驱动Xbox 360控制器：技术赋能游戏体验的终极指南
  • 2026Q2西南中空玻镁净化板核心供应厂商排行及采购指南：车间净化工程公司/中空波鎂净化板/中空波鎂净化板/净化工程装修/选择指南 - 优质品牌商家
  • 从零到亿：用ClickHouse+MySQL打造实时用户行为分析看板（附CentOS 7配置）
  • AI创意总监：融合TRIZ与GPT-4的结构化创意工作流实践
  • 别再死记硬背PID公式了！用Arduino和电位器手把手教你调参（附代码）
  • Taotoken CLI 工具如何帮助团队一键统一配置开发环境与模型密钥
  • B站视频转文字终极指南：一键提取字幕的完整解决方案
  • Helmify实战：一键将K8s清单转换为Helm Chart的自动化工具
  • holaOS：AI原生应用开发框架，解决AI能力集成最后一公里难题
  • ARM Cortex-M52追踪技术：嵌入式系统调试与性能优化
  • OSINT与AI融合：构建智能开源情报分析工作流
  • 基于LLM Agent与Godot引擎的智能桌面宠物开发实践
  • Go并发编程实战：Gsync/jobsync库实现任务并行与结果同步
  • 告别HBuilderX手动打包：用Node.js脚本实现Uniapp多项目自动化构建（附完整源码）
  • D3KeyHelper：三大技术突破，重新定义暗黑3自动化操作的智能宏助手
  • 手把手教你复现大华ICC平台readpic任意文件读取漏洞（附Nuclei检测脚本）
  • 神经网络如何学习模块化加法与傅里叶特征
  • 分布式SCION/Muon系统在高能物理数据采集中的实践
  • 第七史诗自动化助手终极使用指南：5分钟快速上手完全攻略
  • 基于LLM的智能蜜罐Beelzebub：AI赋能动态欺骗防御实战
  • Python 3.15类型推导革命：如何用3行新语法替代17行mypy配置，提升CI类型检查速度4.8倍？
  • 开源夹爪开发环境搭建：从仿真到实物的机器人控制实践
  • 利用taotoken实现ubuntu服务器上的大模型api容灾与路由
  • 基于编码结构光三维重建的螺纹检测系统相机标定【附代码】
  • Performance-Fish：RimWorld游戏性能优化的深度技术解析
  • 3个被99%团队忽略的Python标注陷阱：导致感知模型mAP骤降12.8%的元凶曝光
  • ARM Fast Models Trace组件：调试与性能优化实战