若依RuoYi-Vue项目接入第三方系统？手把手教你实现SSO单点登录（附完整代码）

若依RuoYi-Vue项目SSO单点登录深度整合指南1. 企业级SSO架构设计原理在数字化转型浪潮中企业往往需要整合多个业务系统如CRM、OA、ERP等而统一身份认证成为刚需。基于若依(RuoYi-Vue)框架构建SSO认证中心能够实现一次登录全网通行的效果。其核心原理是通过中央认证服务(CAS)模式将若依系统改造为认证枢纽。关键组件交互流程用户访问业务系统A时被重定向到若依登录页成功认证后生成加密令牌(Token)并返回业务系统业务系统携带令牌向若依验证中心发起校验请求验证通过后建立本地会话完成单点登录注意令牌应采用JWT标准格式包含用户标识、有效期和数字签名避免使用简单DES加密典型SSO架构中的技术挑战包括跨域会话管理令牌防篡改机制分布式会话同步安全退出所有系统2. 若依后端改造实战2.1 认证中心核心代码实现在SsoLoginController基础上进行企业级增强PostMapping(/verify) ApiOperation(令牌验证接口) public AjaxResult verifyToken(RequestParam String token) { // JWT解析验证 Claims claims Jwts.parser() .setSigningKey(secretKey) .parseClaimsJws(token) .getBody(); // 检查过期时间 if(claims.getExpiration().before(new Date())){ return AjaxResult.error(令牌已过期); } // 返回用户基本信息 MapString, Object result new HashMap(); result.put(username, claims.getSubject()); result.put(deptId, claims.get(deptId)); return AjaxResult.success(result); }2.2 安全增强配置在SecurityConfig中增加OAuth2资源服务器配置Override protected void configure(HttpSecurity http) throws Exception { http.oauth2ResourceServer() .jwt() .decoder(jwtDecoder()); // 原有配置... } Bean public JwtDecoder jwtDecoder() { return NimbusJwtDecoder.withSecretKey( Keys.hmacShaKeyFor(secretKey.getBytes()) ).build(); }关键参数对比参数项简单实现企业级方案令牌类型DES加密字符串JWT标准令牌传输安全URL参数传递HTTPSHttpOnly Cookie会话管理内存存储Redis集群存储跨域支持无CORS精细控制3. 前端接入方案详解3.1 若依作为认证提供方改造permission.js实现全局登录拦截router.beforeEach(async (to, from, next) { // 白名单路径直接放行 if (whiteList.includes(to.path)) { next() return } // 检查是否存在有效令牌 const hasToken getToken() if (hasToken) { next() } else { // 重定向到统一登录页 window.location.href https://sso.ruoyi.com/login?redirect${encodeURIComponent(to.fullPath)} } })3.2 业务系统接入方案第三方Vue应用接入示例// 在main.js中添加全局拦截 axios.interceptors.response.use(response { return response }, error { if (error.response.status 401) { // 跳转到若依认证中心 const currentUrl window.location.href window.location.href https://sso.ruoyi.com/login?service${encodeURIComponent(currentUrl)} } return Promise.reject(error) })常见问题解决方案跨域问题配置Nginx反向代理或后端CORS令牌过期实现静默续签机制样式冲突使用iframe嵌入或CSS命名空间隔离4. 生产环境部署要点4.1 高可用架构设计建议采用以下部署架构认证服务集群部署负载均衡Redis哨兵模式存储会话数据Nginx配置SSL终端和HTTP/2分布式日志收集系统4.2 性能优化配置在application.yml中添加关键参数spring: session: store-type: redis redis: flush-mode: on_save namespace: ruoyi:sessions security: oauth2: resourceserver: jwt: issuer-uri: https://sso.ruoyi.com监控指标参考值指标名称预警阈值优化建议认证延迟500ms增加Redis节点并发会话数10,000水平扩展实例CPU使用率70%优化JWT验签算法5. 进阶安全策略实现防重放攻击机制RestController RequestMapping(/api/sso) public class SsoController { PostMapping(/nonce) public AjaxResult generateNonce() { String nonce UUID.randomUUID().toString(); redisTemplate.opsForValue().set( nonce:nonce, 1, 5, TimeUnit.MINUTES ); return AjaxResult.success(nonce); } }在网关层添加安全过滤器public class SsoSecurityFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) { HttpServletRequest req (HttpServletRequest) request; String nonce req.getHeader(X-Nonce); if(!redisTemplate.hasKey(nonce:nonce)){ throw new IllegalStateException(非法请求); } redisTemplate.delete(nonce:nonce); chain.doFilter(request, response); } }实际部署中发现采用JWTRedis双校验机制可以在保证性能的同时有效防止令牌盗用。建议关键业务系统额外添加二次验证层如短信验证码或生物识别验证。