在上一篇文章
如何设计一个单点登录系统(2)?
中主要讲解了可跨域SSO系统服务端,客户端在登录,登出过程中分别应该承担的职责,本文将重点聊一下具体技术实现,源码地址: https://github.com/zhoudapeng/zsso
首先聊服务端的实现,毕竟服务端是整个单点登录系统的大脑
-
提供登录页,这个是登录的基础,所有的接入方在发现当前用户未登录的情况下都会重定向到sso服务端的登录页,服务端的逻辑如下:
这里服务端需要做个判断:
-
如果当前登录存在.sso.com域下的有效cookie,则证明此用户之前在其他业务系统登录过,此时无需再让用户登录,只需要绑定token与此系统名的关系,然后重定向到此系统的回调接口(接入方需要在此回调接口中验证token,创建本地会话)
-
不存在.sso.com域下的有效cookie,证明此用户未登录过,需要跳转到登录页,让用户登录,为了用户登录后能直接进入之前的页面,这里重定向的过程中需要带上redirectUrl 这个参数
2.提供登录接口,用户在登录页输入账号密码后会通过form表单已post的形式提交到此接口
-
如果账号密码不对,则再次跳转到登录页
-
账号密码匹配,则需要创建token,绑定token与系统名的关系,写全局cookie,然后重定向到接入方的回调地址
3.提供验证token接口
-
token不存在,返回验证失败
-
token存在,则取出token的有效截止日期,并绑定token与系统名的关系
4.提供登出接口
登出时,需要根据token查到所有绑定过的系统名,然后调用各个系统的登出接口一一登出。
以上是服务端需要提供的4个接口,下面我们再将一下客户端的实现
在第一篇文章中讲过,一个好的sso系统必须要让接入方接入简单,所以本人借鉴了spring auto-driven的思想,也提供了对应的命名空间,并抽象出了UrlHelper,UserStore,ZssoClient,ZssoConfigResolver4个组件,以及默认实现类,接入方在接入过程中可以随意拓展这4个组件,然后直接注入到业务层上下文即可。
-
UrlHelper:拼接url的组件,如无特殊需求不建议重新实现
-
ZssoClient:跟服务端交互的组件,如无特殊需求不建议重新实现
-
ZssoConfigResolver:解析配置文件的组件,默认实现是读取本地classpath下zsso-client.properties配置文件,如无特殊需求不建议重新实现
-
UserStore:存取用户信息的组件,包括根据token解析用户信息,绑定token与userId关系,解绑token,默认实现只是为了演示用,接入方请务必自己实现此接口,并以userStore的名称注入到业务层上下文中。
拓展组件使用方式:
在spring扫描掉
至此组件初始化的问题已经解决了,另外需要接入方开发的是如下问题:
-
判断登录状态
-
登录成功回调接口(包括check token的逻辑)
-
登出回调接口
既然每个接入方都有这样的共性,所以我提供了一个ZssoFilter,在Filter里根据不同的url做不同的处理,接入方只需要配置此Filter即可,Filter内部会自动去获取组件,接入方只需要拓展相关组件即可,ZssoFilter核心代码如下:
LoginCallbackFilter已封装好解析请求参数中token,check token,创建本地会话,跳转到原页面等功能
LoginCheckFilter已封装好判断当前用户是否登录及跳转到登录页的逻辑
LogoutFilter已封装好删除本地会话的功能
代码中很多代码都是演示类的,尤其是server端的实现,比如保持用户信息都是存的本地缓存,如果要放到生成环境则需要优化下这块的逻辑,比如放到redis这样的分布式缓存等等。
最后非常感谢大家能在百忙中抽空看我的文章,大家的每一次查看都是我继续写文章的动力,由于本人是典型理科男,文笔可能欠妥,希望大家能够继续支持我,我也会继续努力,继续坚持原创,但愿能让大家都能有所收获!