Sa-Token单点登录教程：3种模式解决跨域认证难题

Sa-Token单点登录教程：3种模式解决跨域认证难题

【免费下载链接】Sa-Token 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！—— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、单点登录、OAuth2.0 项目地址: https://gitcode.com/GitHub_Trending/sa/Sa-Token

Sa-Token是一个轻量级Java权限认证框架，专门解决单点登录SSO、跨域认证等复杂场景。本文将详细介绍Sa-Token的三种单点登录模式，帮助开发者快速掌握分布式系统认证方案。

🎯 什么是单点登录SSO？

单点登录（Single Sign-On）允许用户在一个系统中登录后，无需重复登录即可访问其他关联系统。Sa-Token提供了三种灵活的SSO模式，满足不同架构需求：

• 模式一：同域+同Redis架构
• 模式二：跨域+同Redis架构
• 模式三：跨域+跨Redis架构

🚀 快速搭建SSO认证中心

首先需要创建统一的SSO-Server认证中心：

<!-- 添加Sa-Token SSO依赖 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-sso</artifactId>
    <version>${sa.top.version}</version>
</dependency>

配置SSO-Server控制器：

@RestController
public class SsoServerController {
    @RequestMapping("/sso/*")
    public Object ssoRequest() {
        return SaSsoServerProcessor.instance.dister();
    }
}

🔄 模式一：同域同Redis方案

适用场景：所有子系统使用相同域名和Redis实例

配置非常简单，只需设置Cookie域：

sa-token:
  cookie:
    domain: your-domain.com

优势：配置简单，性能最佳，适合企业内部系统

🌐 模式二：跨域同Redis方案

适用场景：不同域名但共享Redis实例

需要为每个客户端配置独立密钥：

sa-token:
  sso-server:
    clients:
      client1:
        secret-key: your-secret-key-1
      client2:  
        secret-key: your-secret-key-2

特点：支持完全跨域，安全性较高

🔗 模式三：跨域跨Redis方案

适用场景：完全独立的系统和数据存储

配置消息推送机制：

sa-token:
  sso-server:
    clients:
      client3:
        is-push: true
        push-url: http://client3.com/sso/push

核心功能：

• 支持分布式会话同步
• 实时消息推送
• 完全解耦架构

📊 三种模式对比总结

特性	模式一	模式二	模式三
域名要求	同域	跨域	跨域
Redis要求	共享	共享	独立
配置复杂度	简单	中等	复杂
性能	最佳	良好	一般
适用场景	内部系统	关联业务	完全独立系统

💡 最佳实践建议

1. 选择合适模式：根据实际架构需求选择最匹配的模式
2. 安全配置：生产环境务必配置详细的allow-url白名单
3. 监控日志：开启Sa-Token操作日志便于排查问题
4. 性能优化：合理设置ticket过期时间平衡安全与体验

🎉 开始使用Sa-Token SSO

Sa-Token的单点登录解决方案覆盖了从简单到复杂的所有场景，三种模式灵活应对不同业务需求。通过本文的教程，您可以快速上手并选择最适合您项目的SSO方案。

官方示例代码位于：sa-token-demo-sso-server 目录，包含完整的实现示例。

立即体验Sa-Token带来的便捷单点登录体验，让您的分布式系统认证变得更加简单优雅！🚀

【免费下载链接】Sa-Token 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！—— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、单点登录、OAuth2.0 项目地址: https://gitcode.com/GitHub_Trending/sa/Sa-Token