SSO单点登录Java实现实例

最新推荐文章于 2025-02-28 10:40:17 发布
最新推荐文章于 2025-02-28 10:40:17 发布
阅读量2.1w 收藏 463
点赞数 53
分类专栏： SSO单点登录 文章标签： SSO 单点 单点登录
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_38011415/article/details/113695587
版权
本文详细介绍了如何使用SpringBoot构建基于令牌token的SSO单点登录系统，包括统一登录页、登录接口、令牌校验、登录状态检查及统一退出等功能。通过示例代码展示了SSO认证中心和客户端的配置与交互过程，提供了源码下载链接及实际测试场景，帮助读者理解SSO的实现原理。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

随着公司系统的增加，每次新建一个项目是否还在做登录功能呢，还在做重复的工作？统一登录SSO你值得拥有。本文主要讲解，基于令牌token方式实现，SpringBoot工程下的SSO单点登录整合代码实例Demo，文末附源码地址。

1.环境准备

  • SSO认证中心服务（ www.mysso.com）
  • 客户端1（www.myclient1.com）
  • 客户端2（www.myclient2.com）

由于是Demo实例，这里若有要访问-需要修改一下本机host，添加如下映射

 127.0.0.1 www.mysso.com
 127.0.0.1 www.myclient1.com
 127.0.0.1 www.myclient2.com

2.搭建SSO认证中心服务

问题来了，搭建一个SSO统一登录需要哪些功能？

  • 统一登录页+接口
  • 校验令牌有效性接口（调用来源：子系统）
  • 校验登录状态接口（调用来源：子系统）
  • 统一退出（调用来源：子系统或退出认证中心服务）

这里就不贴Maven依赖了，主要讲解功能，详见文末附源码。

2.1统一登录页

创建一个统一登录页

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>程序员小强-SSODemo</title>
</head>
<style>body.center {
    text-align: center;
}
</style>
<body class="center">
<div>
    <h1>SSO用户统一登录</h1>
</div>
<div>
    <form name="loginForm" action="/sso/login" method="POST" accept-charset="UTF-8">
        <div><input placeholder="用户名" value="admin" name="username" type="text"/></div>
        <div><input placeholder="密码" value="123456" name="password" type="password"/></div>
        <div style="color: red"><span th:text="${msg}"></span></div>
        <div><input name="redirectUrl" type="hidden" th:value="${redirectUrl}"/></div>
        <input type="submit" value="登录"/>
        <input type="reset" value="重置"/>
    </form>
</div>
</body>
</html>

效果图
在这里插入图片描述

2.2统一登录接口

这里为了简化示例，未引入redis等缓存数据库，使用的 session存储登录信息

  /**
     * 认证中心SSO统一登录方法
     */
    @RequestMapping("/login")
    public String login(LoginParam loginParam, RedirectAttributes redirectAttributes,
                        HttpSession session, Model model) {

        //Demo 项目此处模拟数据库账密校验
        if (!"admin".equals(loginParam.getUsername()) || !"123456".equals(loginParam.getPassword())) {
            model.addAttribute("msg", "账户或密码错误，请重新登录!");
            model.addAttribute("redirectUrl", loginParam.getRedirectUrl());
            return "login";
        }

        //登录成功
        //创建令牌
        String ssoToken = UUID.randomUUID().toString();
        //把令牌放到全局会话中
        session.setAttribute("ssoToken", ssoToken);
        //设置session失效时间-单位秒
        session.setMaxInactiveInterval(3600);
        //将有效的令牌-放到map容器中(存在该容器中的token都是合法的,正式环境建议redis或存库)
        SSOConstantPool.TOKEN_POOL.add(ssoToken);

        //未携带重定向跳转地址-默认跳转到认证中心首页
        if (StringUtils.isEmpty(loginParam.getRedirectUrl())) {
            return "index";
        }

        // 携带令牌到客户端
        redirectAttributes.addAttribute("ssoToken", ssoToken);
        log.info("[ SSO登录 ] login success ssoToken:{} , sessionId:{}", ssoToken, session.getId());
        // 跳转到客户端
        return "redirect:" + loginParam.getRedirectUrl();
    }

2.3校验令牌接口

在跳转到子系统后会携带令牌token,这时候需要调用以下接口来校验token的有效性
以下接口一共做了2件事情

  • 校验token是否有效
  • 若有效-则记录了注册上来的子系统信息，用于统一注销时候使用
/**
 * 校验令牌是否合法
 *
 * @param ssoToken    令牌
 * @param loginOutUrl 退出登录访问地址
 * @param jsessionid
 * @return 令牌是否有效
 */
@ResponseBody
@RequestMapping("/checkToken")
public String verify(String ssoToken, String loginOutUrl, String jsessionid) {
    // 判断token是否存在map容器中,如果存在则代表合法
    boolean isVerify = SSOConstantPool.TOKEN_POOL.contains(ssoToken);
    if (!isVerify) {
        log.info("[ SSO-令牌校验 ] checkToken 令牌已失效 ssoToken:{}", ssoToken);
        return "false";
    }

    //把客户端的登出地址记录起来,后面注销的时候需要根据使用(生产环境建议存redis或库)
    List<ClientRegisterModel> clientInfoList =
        SSOConstantPool.CLIENT_REGISTER_POOL.computeIfAbsent(ssoToken, k -> new ArrayList<>());
    ClientRegisterModel vo = new ClientRegisterModel();
    vo.setLoginOutUrl(loginOutUrl);
    vo.setJsessionid(jsessionid);
    clientInfoList.add(vo);
    log.info("[ SSO-令牌校验 ] checkToken success ssoToken:{} , clientInfoList:{}", ssoToken, clientInfoList);
    return "true";
}

2.4校验登录状态接口

当令牌校验返回失败时，子系统需要调用此接口

/**
 * 校验是否已经登录认证中心（是否有全局会话）
 * 1.若存在则携带令牌ssoToken跳转至目标页面
 * 2.若不存在则跳转到登录页面
 */
@RequestMapping("/checkLogin")
public String checkLogin(String redirectUrl, RedirectAttributes redirectAttributes,
                         Model model, HttpServletRequest request) {
    //从认证中心-session中判断是否已经登录过(判断是否有全局会话)
    Object ssoToken = request.getSession().getAttribute("ssoToken");

    // ssoToken为空 - 没有全局回话
    if (StringUtils.isEmpty(ssoToken)) {
        log.info("[ SSO-登录校验 ] checkLogin fail 没有全局回话 ssoToken:{}", ssoToken);
        //登录成功需要跳转的地址继续传递
        model.addAttribute("redirectUrl", redirectUrl);
        //跳转到统一登录页面
        return "login";
    }

    log.info("[ SSO-登录校验 ] checkLogin success 有全局回话  ssoToken:{}", ssoToken);
    //重定向参数拼接（将会在url中拼接）
    redirectAttributes.addAttribute("ssoToken", ssoToken);
    //重定向到目标系统
    return "redirect:" + redirectUrl;
}

2.5统一退出接口

    /**
     * 统一注销
     * 1.注销全局会话
     * 2.通过监听全局会话session时效性，向已经注册的所有子系统发起注销请求
     */
    @RequestMapping("/logOut")
    public String logOut(HttpServletRequest request) {
        HttpSession session = request.getSession();
        log.info("[ SSO-统一退出 ] ....start.... sessionId:{}", session.getId());
        //注销全局会话, SSOSessionListener 监听器会处理后续操作
        request.getSession().invalidate();
        log.info("[ SSO-统一退出 ] ....end.... sessionId:{}", session.getId());
        return "logout";
    }

退出监听，当统一认证中心session销毁时，同时注销子系统

/**
 * session监听器
 *
 * @author 程序员小强
 */
@Slf4j
@WebListener
public class SSOSessionListener implements HttpSessionListener {
    
    /**
     * 销毁事件监听
     * <p>
     * 1.session超时的时候会调用
     * 2.手动调用session.invalidate()方法时会调用.
     *
     * @param se
     */
    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        HttpSession session = se.getSession();
        String token = (String) session.getAttribute("ssoToken");
        log.debug("[ SSOSessionListener ] ...start..... sessionId:{},token:{}", session.getId(), token);
        //注销全局会话,SSOSessionListener监听类删除对应的信息
        session.invalidate();
        if (StringUtils.isEmpty(token)) {
            log.debug("[ SSOSessionListener ] token is null sessionId:{}", session.getId());
            return;
        }
        //清除存储的有效token数据
        SSOConstantPool.TOKEN_POOL.remove(token);
        //清除并返回已经注册的系统信息
        List<ClientRegisterModel> clientRegisterList = SSOConstantPool.CLIENT_REGISTER_POOL.remove(token);
        if (CollectionUtils.isEmpty(clientRegisterList)) {
            return;
        }
        for (ClientRegisterModel client : clientRegisterList) {
            if (null == client) {
                continue;
            }
            //取出注册的子系统，依次调用子系统的登出方法(通过会话ID退出子系统的局部会话)
            sendHttpRequest(client.getLoginOutUrl(), client.getJsessionid());
            log.info("[ SSOSessionListener ] 注销系统 url:{},Jsessionid:{}", client.getLoginOutUrl(), client.getJsessionid());
        }
        log.debug("[ SSOSessionListener ] ...end..... sessionId:{},token:{}", session.getId(), token);
    }

    /**
     * 发送退出登录请求
     * 模拟浏览器访问形式
     *
     * @param reqUrl     发送请求的地址
     * @param jesssionId 会话Id
     */
    private static void sendHttpRequest(String reqUrl, String jesssionId) {
        try {
            //建立URL连接对象
            URL url = new URL(reqUrl);
            //创建连接
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            //设置请求的方式(需要是大写的)
            conn.setRequestMethod("POST");
            //设置需要响应结果
            conn.setDoOutput(true);
            //通过设置JSESSIONID模拟浏览器端操作
            conn.addRequestProperty("Cookie", "JSESSIONID=" + jesssionId);
            //发送请求到服务器
            conn.connect();
            conn.getInputStream();
            conn.disconnect();
        } catch (Exception e) {
            log.error("[ sendHttpRequest ] exception >> reqUrl:{}", reqUrl, e);
        }
    }
}

3.搭建客户端服务

问题来了，搭建一个客户端需要哪些功能？

  • 拦截请求
  • 请求认证中心校验令牌有效性
    • 有效则创建局部会话
    • 无效则继续请求认证中心登录
  • 注销系统-请求认证中心统一注销

3.1核心请求拦截器实现

@Configuration
public class WebConfig extends WebMvcConfigurationSupport {

    /**
     * 创建拦截器
     */
    @Bean
    WebInterceptor webInterceptor() {
        return new WebInterceptor();
    }

    /**
     * 添加拦截器-进行拦截
     * addPathPatterns 添加拦截
     * excludePathPatterns 排除拦截
     **/
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(this.webInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/logOut");
        super.addInterceptors(registry);
    }

    /**
     * 返回值-编码 UTF-8
     */
    @Bean
    public HttpMessageConverter<String> responseBodyConverter() {
        return new StringHttpMessageConverter(StandardCharsets.UTF_8);
    }

    @Override
    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
        configurer.favorPathExtension(false);
    }

    /**
     * 资源处理器-资源路径 映射
     *
     * @param registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }

}

/**
 * 创建拦截器-拦截需要安全访问的请求
 * 方法说明
 * 1.preHandle():前置处理回调方法，返回true继续执行，返回false中断流程，不会继续调用其它拦截器
 * 2.postHandle():后置处理回调方法，但在渲染视图之前
 * 3.afterCompletion():全部后置处理之后，整个请求处理完毕后回调。
 *
 * @author 程序员小强
 */
@Slf4j
public class WebInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws IOException {
        log.info("[ WebInterceptor ] >> preHandle  requestUrl:{} ", request.getRequestURI());
        //判断是否有局部会话
        HttpSession session = request.getSession();
        Object isLogin = session.getAttribute("isLogin");
        if (isLogin != null && (Boolean) isLogin) {
            log.debug("[ WebInterceptor ] >> 已登录,有局部会话 requestUrl:{}", request.getRequestURI());
            return true;
        }
        //获取令牌ssoToken
        String token = SSOClientHelper.getSsoToken(request);

        //无令牌
        if (StringUtils.isEmpty(token)) {
            //认证中心验证是否已经登录(是否存在全局会话)
            SSOClientHelper.checkLogin(request, response);
            return true;
        }

        //有令牌-则请求认证中心校验令牌是否有效
        Boolean checkToken = SSOClientHelper.checkToken(token, session.getId());

        //令牌无效
        if (!checkToken) {
            log.debug("[ WebInterceptor ] >> 令牌无效,将跳转认证中心进行认证 requestUrl:{}, token:{}", request.getRequestURI(), token);
            //认证中心验证是否已经登录(是否存在全局会话)
            SSOClientHelper.checkLogin(request, response);
            return true;
        }

        //token有效，创建局部会话设置登录状态，并放行
        session.setAttribute("isLogin", true);
        //设置session失效时间-单位秒
        session.setMaxInactiveInterval(1800);
        //设置本域cookie
        CookieUtil.setCookie(response, SSOClientHelper.SSOProperty.TOKEN_NAME, token, 1800);
        log.debug("[ WebInterceptor ] >> 令牌有效,创建局部会话成功 requestUrl:{}, token:{}", request.getRequestURI(), token);
        return true;
    }

}

4.源码介绍

源码地址：传送门
在这里插入图片描述

5.源码实例测试

由于是Demo实例，这里若有要访问-需要修改一下本机host，添加如下映射

 127.0.0.1 www.mysso.com
 127.0.0.1 www.myclient1.com
 127.0.0.1 www.myclient2.com

添加好本机host映射后-分别启动
sso-server 域名使用内网域名（www.mysso.com:8081）
sso-client1 域名使用内网域名（www.myclient1.com:8082）
sso-client2 域名使用内网域名（www.myclient1.com:8083）在这里插入图片描述

5.1 客户端1登录

5.1.1在浏览器端访问 www.myclient1.com:8082

由于没有登录过任何一个系统，也没有全局会话，所以会跳转到统一认证中心进行登录，可以查看到redirectUrl就是我们要访问的www.myclient1.com:8082
在这里插入图片描述

点击登录（账密demo项目写死了，可以直接点击登录）
在这里插入图片描述
登录成功后会跳转到redirectUrl地址，并且携带ssoToken，这个时候客户端系统就可以请求认证中心校验ssoToken后创建内部的局部会话。

5.2 客户端2登录

由于客户端1已经登录，也就是说已经存在全局会话了，那么在访问客户端2的时候，其实无需登录的，只需要认证中心将最新的ssoToken携带过来就可以了。

浏览器输入 www.myclient2.com:8083
在这里插入图片描述
可以查看到统一认证中心直接返回了认证token

5.3 统一退出登录

这里退出客户端1，退出完成后查看客户端1 与客户端2的登录状态
在这里插入图片描述
在这里插入图片描述

这里继续访问www.myclient1.com:8082，会提示继续登录
在这里插入图片描述

访问www.myclient2.com:8083，会提示继续登录
在这里插入图片描述

说明统一退出登录成功了

查看一下监听的日志，也是注销了每一个局部会话
在这里插入图片描述

至此SSO统一登录实战讲解完毕。

需要完善的点还很多，比如服务端与客户端交互的时候可以通过加密或者加签方式防止数据被篡改。

Spring Boot进阶(87)：基于Spring Security实现单点登录（SSO） | 超级详细，建议收藏
**My Coding Family**
04-17 3089
基于Spring Security实现单点登录（SSO），一文带你学会。
简单实现Shiro单点登录（自定义Token令牌）
menghuannvxia的专栏
05-28 8499
1. MVC Controller 映射 sso 方法。 Java代码   /**   * 单点登录（如已经登录，则直接跳转）   * @param userCode 登录用户编码   * @param token 登录令牌，令牌组成：sso密钥+用户名+日期，进行md5加密，举例：    *      String secretKey = Global.getCo
Java 单点登录 (SSO) 全流程实践指南
最新发布
weixin_58316280的博客
02-28 1151
协议选择：互联网应用首选OAuth2+JWT，企业内网考虑SAML令牌管理：设置合理有效期（推荐：访问令牌2小时，刷新令牌30天）监控指标：重点关注认证成功率、平均响应时间、并发会话数灾备方案：部署多活认证中心，实现自动故障转移合规要求：遵循GDPR等数据保护法规，记录完整审计日志推荐工具链压力测试：JMeter。
单点登录sso的原理与java实现详细讲解与示例(文档与源码)
06-23
单点登录sso的原理与java实现详细讲解与示例(文档与源码)
简单的单点登录案例
盗帅
12-10 4350
单点登录是什么呢，简单的来说吧，你去旅游景点参观，里面有一种票叫做全票（也不知道是不是这个，反正就是有这个票里面所有的景区你都可以去参观），还有一种票就是单个景区的票，这个票只是这个景区可以用，到了其它的景点就要再买票了。单点登录就类似于全票，只要和这个绑定了的网站或者其他的网页，只要你在其中一个地方登录了，另一个地方便会自动的登录，这样的话用户的体验便大大的增强了。 今天我们就来做一做简单的单点...
简单单点登录实例
夜深人静后的码农
03-15 1247
[java] view plaincopy package com.ll.singlelogin;         import javax.servlet.http.*;   import java.util.*;         public class SingleLogin implements HttpSessionListener {  
Java实现单点登录（SSO）详解
勤劳的小琪
04-24 6056
单点登录（Single Sign-On，简称SSO）是目前比较流行的企业业务整合的解决方案之一，它的主要功能是：在多个应用系统中，用户只需要登录一次就可以访问所有相互信任的应用系统。单点登录的实现机制是：当用户第一次访问应用系统1的时候，因为还没有登录，所以会被引导到认证系统中进行登录；根据用户提供的登录信息，认证系统进行验证，如果通过验证，则应该返回给用户一个认证的凭据——ticket；
SSO单点登录---案例
weixin_50029329的博客
10-22 885
单点登录(SingleSignOn，SSO)，就是通过用户的一次性鉴别登录。当用户在身份认证服务器上登录一次以后，即可获得访问单点登录系统中其他关联系统和应用软件的权限。 UserController层----代码案例 package com.jt.controller; import com.alibaba.dubbo.config.annotation.Reference; import com.jt.pojo.User; import com.jt.service.DubboUserService
使用springboot结合vue实现sso单点登录
08-25
使用 Spring Boot 结合 Vue 实现 SSO 单点登录 本文主要为大家详细介绍了如何使用 Spring Boot 和 Vue 实现 SSO 单点登录，具有一定的参考价值。下面我们将从技术角度深入探讨该实现的细节。 Spring Boot 的选择 ...
SSO单点登录实例
10-10
SSO（Single Sign-On）单点登录是一种网络应用中...总结来说，SSO单点登录实例是一个学习和实践SSO技术的好材料。通过理解和运行这个Demo，你不仅能掌握SSO的基本原理，还能了解到如何在实际开发中实施和优化SSO系统。
Java Servlet实现SSO单点登录实例
8. **单点登出**：除了单点登录之外，SSO系统还支持单点登出，即用户可以从任一已认证的应用中登出，这个操作会导致所有其他应用的会话同时失效。 9. **跨域问题**：由于SSO系统涉及多个应用，可能会存在跨域问题。...
单点登录小例子
01-07
这是之前同学在传智播客学习的时候老师讲课用的开发文档，里面有开发中需要的jar包，以及一些详细的开发步骤，希望能够帮助大家。
用Java实现单点登录
01-12
用java实现单点登录授权，认证，机制。值得一看的分享
单点登录经典案例
05-31
经典单点登录案例
JAVA-WEB单点登录实例
08-20
这个DEMO是我手写,亲测能运行的项目,适合没有接触过单点登陆的新手,不足之处还请多多指教
java sso 单点登录 demo
12-07
java sso 单点登录 demo , 实现单点登录服务，用于开发与测试。
java跨域单点登录实例_SSO单点登录、跨域重定向、跨域设置Cookie、京东单点登录实例分析...
weixin_33582801的博客
02-27 677
原标题：SSO单点登录、跨域重定向、跨域设置Cookie、京东单点登录实例分析SSO单点登录技术，其中有一种就是通过js的跨域设置cookie来达到单点登录目的的，下面就已京东商城为例来解释下跨域设置cookie的过程涉及的关键知识点：1、跨域redirect实例：test.html< src="jquery.js">>< type="text/java">var r...
SSO 单点登录(java）
m0_73194691的博客
11-28 621
登陆页面 携带 ==hidden== 隐藏的 客户端url。这里参照 controller 的login方法。携带重定向的 url发给认证服务器。这样 服务器处理完登陆结果，也知道把信息返回给哪个服务器的地址。使用Spring Initializr 初始化springBoot项目。2.1 client 客户端编写。2.2 客户端的html文件。2.4 认证服务器页面。2.3 认证服务器端。添加 redis依赖。
[Java 基于SSO实现单点登录]
汤圆的博客
06-14 2530
顺风顺水
评论 19
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员小强

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值