本篇文章为大家展示了XXL-SSO分布式单点登录框架是什么,内容简明扼要并且容易理解,绝对能使你眼前一亮,通过这篇文章的详细介绍希望你能有所收获。
创新互联建站主营阿城网站建设的网络公司,主营网站建设方案,重庆APP软件开发,阿城h5小程序定制开发搭建,阿城网站营销推广欢迎阿城等地区企业咨询
XXL-SSO 是一个分布式单点登录框架。只需要登录一次就可以访问所有相互信任的应用系统。
拥有"轻量级、分布式、跨域、Cookie+Token均支持、Web+APP均支持"等特性。现已开放源代码,开箱即用。
简洁:API直观简洁,可快速上手;
轻量级:环境依赖小,部署与接入成本较低;
单点登录:只需要登录一次就可以访问所有相互信任的应用系统。
分布式:接入SSO认证中心的应用,支持分布式部署;
HA:Server端与Client端,均支持集群部署,提高系统可用性;
跨域:支持跨域应用接入SSO认证中心;
Cookie+Token均支持:支持基于Cookie和基于Token两种接入方式,并均提供Sample项目;
Web+APP均支持:支持Web和APP接入;
实时性:系统登陆、注销状态,全部Server与Client端实时共享;
CS结构:基于CS结构,包括Server"认证中心"与Client"受保护应用";
记住密码:未记住密码时,关闭浏览器则登录态失效;记住密码时,支持登录态自动延期,在自定义延期时间的基础上,原则上可以无限延期;
路径排除:支持自定义多个排除路径,支持Ant表达式。用于排除SSO客户端不需要过滤的路径;
源码仓库地址 | Release Download |
---|---|
https://github.com/xuxueli/xxl-sso | Download |
https://gitee.com/xuxueli0323/xxl-sso | Download |
JDK:1.7+
redis:4.0+
MySQL:5.6+
- xxl-sso-server:中央认证服务,支持集群; - xxl-sso-core:Client端依赖; - xxl-sso-samples:单点登陆Client端接入示例项目; - xxl-sso-web-sample-springboot:基于Cookie接入方式,供用户浏览器访问,springboot版本 - xxl-sso-token-sample-springboot:基于Token接入方式,常用于无法使用Cookie的场景使用,如APP、Cookie被禁用等,springboot版本
项目名:xxl-sso-server
配置文件位置:application.properties
…… // redis 地址: 如 "{ip}"、"{ip}:{port}"、"{redis/rediss}://xxl-sso:{password}@{ip}:{port:6379}/{db}";多地址逗号分隔 xxl.sso.redis.address=redis://127.0.0.1:6379 // 登录态有效期窗口,默认24H,当登录态有效期窗口过半时,自动顺延一个周期; xxl.sso.redis.expire.minite=1440
项目名:xxl-sso-web-sample-springboot
<dependency> <groupId>com.xuxueli</groupId> <artifactId>xxl-sso-core</artifactId> <version>${最新稳定版}</version> </dependency>
@Bean public FilterRegistrationBean xxlSsoFilterRegistration() { // xxl-sso, redis init JedisUtil.init(xxlSsoRedisAddress); // xxl-sso, filter init FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setName("XxlSsoWebFilter"); registration.setOrder(1); registration.addUrlPatterns("/*"); registration.setFilter(new XxlSsoWebFilter()); registration.addInitParameter(Conf.SSO_SERVER, xxlSsoServer); registration.addInitParameter(Conf.SSO_LOGOUT_PATH, xxlSsoLogoutPath); return registration; }
配置文件位置:application.properties
…… ### xxl-sso (CLient端SSO配置) ##### SSO Server认证中心地址(推荐以域名方式配置认证中心,本机可参考章节"2.5"修改host文件配置域名指向) xxl.sso.server=http://xxlssoserver.com:8080/xxl-sso-server ##### 注销登陆path,值为Client端应用的相对路径 xxl.sso.logout.path=/logout ##### 路径排除Path,允许设置多个,且支持Ant表达式。用于排除SSO客户端不需要过滤的路径 xxl-sso.excluded.paths= ### redis // redis address, like "{ip}"、"{ip}:{port}"、"{redis/rediss}://xxl-sso:{password}@{ip}:{port:6379}/{db}";Multiple "," separated xxl.sso.redis.address=redis://xxl-sso:password@127.0.0.1:6379/0
环境准备:启动Redis、初始化Mysql表数据;
修改Host文件:域名方式访问认证中心,模拟跨域与线上真实环境
### 在host文件中添加以下内容0 127.0.0.1 xxlssoserver.com 127.0.0.1 xxlssoclient1.com 127.0.0.1 xxlssoclient2.com
分别运行 "xxl-sso-server" 与 "xxl-sso-web-sample-springboot"
1、SSO认证中心地址:
http://xxlssoserver.com:8080/xxl-sso-server
2、Client01应用地址:
http://xxlssoclient1.com:8081/xxl-sso-web-sample-springboot/
3、Client02应用地址:
http://xxlssoclient2.com:8081/xxl-sso-web-sample-springboot/
SSO登录/注销流程验证
正常情况下,登录流程如下:
1、访问 "Client01应用地址" ,将会自动 redirect 到 "SSO认证中心地址" 登录界面;
2、成功登录后,将会自动 redirect 返回到 "Client01应用地址",并切换为已登录状态;
3、此时,访问 "Client02应用地址",不需登陆将会自动切换为已登录状态;
正常情况下,注销流程如下:
1、访问 "Client01应用地址" 配置的 "注销登陆path",将会自动 redirect 到 "SSO认证中心地址" 并自动注销登陆状态;
2、此时,访问 "Client02应用地址",也将会自动注销登陆状态;
"认证中心" 搭建成功后,默认为Token方式登陆提供API接口如下:
1、登陆接口:/app/login
code:200 表示成功、其他失败;
msg:错误提示
data: 登陆用户的 sso sessionid
username:账号
password:账号
参数:POST参数
响应:JSON格式
2、注销接口:/app/logout
code:200 表示成功、其他失败;
msg:错误提示
sessionId:登陆用户的 sso sessionid
参数:POST参数
响应:JSON格式
3、登陆状态校验接口:/app/logincheck
code:200 表示成功、其他失败;
msg:错误提示
data:登陆用户信息
userid:用户ID
username:用户名
sessionId:登陆用户的 sso sessionid
参数:POST参数
响应:JSON格式
项目名:xxl-sso-token-sample-springboot
可参考 "章节 2.4" 部署 "单点登陆Client端接入示例项目",唯一不同点是:将web应用的 "XxlSsoFilter" 更换为app应用 "XxlSsoTokenFilter";
环境准备:启动Redis、初始化Mysql表数据;
修改Host文件:域名方式访问认证中心,模拟跨域与线上真实环境
### 在host文件中添加以下内容0 127.0.0.1 xxlssoserver.com 127.0.0.1 xxlssoclient1.com 127.0.0.1 xxlssoclient2.com
分别运行 "xxl-sso-server" 与 "xxl-sso-token-sample-springboot"
1、SSO认证中心地址:
http://xxlssoserver.com:8080/xxl-sso-server
2、Client01应用地址:
http://xxlssoclient1.com:8082/xxl-sso-token-sample-springboot/
3、Client02应用地址:
http://xxlssoclient2.com:8082/xxl-sso-token-sample-springboot/
SSO登录/注销流程验证
正常情况下,登录流程如下:
1、获取用户输入的账号密码后,请求SSO Server的登录接口,获取用户 sso sessionid ;(参考代码:TokenClientTest.loginTest)
2、登陆成功后,获取到 sso sessionid ,需要主动存储,后续请求时需要设置在 Header参数 中;
3、此时,使用 sso sessionid 访问受保护的 "Client01应用" 和 "Client02应用" 提供的接口,接口均正常返回;(参考代码:TokenClientTest.clientApiRequestTest)
正常情况下,注销流程如下:
1、请求SSO Server的注销接口,注销登陆凭证 sso sessionid ;(参考代码:TokenClientTest.logoutTest)
2、注销成功后,sso sessionid 将会全局失效;
3、此时,使用 sso sessionid 访问受保护的 "Client01应用" 和 "Client02应用" 提供的接口,接口请求将会被拦截,提示未登录并返回状态码 501 ;(参考代码:TokenClientTest.clientApiRequestTest)
XXL-SSO 是一个分布式单点登录框架。只需要登录一次就可以访问所有相互信任的应用系统。借助 XXL-SSO,可以快速实现分布式系统单点登录。
概念 | 说明 |
---|---|
SSO Server | 中央认证服务,支持集群; |
SSO Client | 接入SSO认证中心的Client应用; |
SSO SessionId | 登录用户会话ID,SSO 登录成功为用户自动分配; |
SSO User | 登录用户信息,与 SSO SessionId 相对应; |
用户于Client端应用访问受限资源时,将会自动 redirect 到 SSO Server 进入统一登录界面。
用户登录成功之后将会为用户分配 SSO SessionId 并 redirect 返回来源Client端应用,同时附带分配的 SSO SessionId。
在Client端的SSO Filter里验证 SSO SessionId 无误,将 SSO SessionId 写入到用户浏览器Client端域名下 cookie 中。
SSO Filter验证 SSO SessionId 通过,受限资源请求放行;
用户与Client端应用请求注销Path时,将会 redirect 到 SSO Server 自动销毁全局 SSO SessionId,实现全局销毁;
然后,访问接入SSO保护的任意Client端应用时,SSO Filter 均会拦截请求并 redirect 到 SSO Server 的统一登录界面。
登陆凭证存储:登陆成功后,用户登陆凭证被自动存储在浏览器Cookie中;
Client端校验登陆状态:通过校验请求Cookie中的是否包含用户登录凭证判断;
系统角色模型:
SSO Server:认证中心,提供用户登陆、注销以及登陆状态校验等功能。
Client应用:受SSO保护的Client端Web应用,为用户浏览器访问提供服务;
用户:发起请求的用户,使用浏览器访问。
登陆凭证存储:登陆成功后,获取到登录凭证(xxl_sso_sessionid=xxx),需要主动存储,如存储在 localStorage、Sqlite 中;
Client端校验登陆状态:通过校验请求 Header参数 中的是否包含用户登录凭证(xxl_sso_sessionid=xxx)判断;因此,发送请求时需要在 Header参数 中设置登陆凭证;
系统角色模型:
SSO Server:认证中心,提供用户登陆、注销以及登陆状态校验等功能。
Client应用:受SSO保护的Client端Web应用,为用户请求提供接口服务;
用户:发起请求的用户,如使用Android、IOS、桌面客户端等请求访问。
基于Cookie,未登录状态请求:
页面请求:redirect 到SSO Server登录界面;
JSON请求:返回未登录的JSON格式响应数据
code:501 错误码
msg:sso not login.
数据格式:
基于Token,未登录状态请求:
返回未登录的JSON格式响应数据
code:501 错误码
msg:sso not login.
数据格式:
支持自定义登录态有效期窗口,默认24H,当登录态有效期窗口过半时,自动顺延一个周期;
未记住密码时,关闭浏览器则登录态失效;记住密码时,登录态自动延期,在自定义延期时间的基础上,原则上可以无限延期;
自定义路径排除Path,允许设置多个,且支持Ant表达式。用于排除SSO客户端不需要过滤的路径
上述内容就是XXL-SSO分布式单点登录框架是什么,你们学到知识或技能了吗?如果还想学到更多技能或者丰富自己的知识储备,欢迎关注创新互联行业资讯频道。
本文名称:XXL-SSO分布式单点登录框架是什么
文章链接:https://www.cdcxhl.com/article22/pshpjc.html
成都网站建设公司_创新互联,为您提供品牌网站建设、网站营销、自适应网站、Google、微信公众号、用户体验
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联