开源软件名称:spring-oauth-server
开源软件地址:https://gitee.com/shengzhao/spring-oauth-server
开源软件介绍:
#spring-oauth-server java config版本(Spring Boot) Spring与OAuth2的整合示例 授权协议:GPL-2.0 项目用Maven管理 Base on Spring-Boot 使用的技术与版本号 - JDK (1.8.0_40)
- Servlet (3.1.0)
- Spring Boot(2.1.4.RELEASE)
技术视频http://list.youku.com/albumlist/show/id_51900110.html(持续更新...)
1000 star Gitee奖杯: sos-1000-stars.jpg
MySQL版本请访问Branch: master MongoDB版本请访问Branch: mongodb Redis版本请访问Branch: config-redis
Shiro与OLTU整合的OAuth2项目 https://gitee.com/mkk/oauth2-shiro (相比spring-oauth-server, 该项目入门门槛相对较低, 代码更加透明, 理解更容易,可扩展性更强, 且模块化开发)
如何使用? - 项目是Maven管理的, 需要本地安装maven(开发用的maven版本号为3.3.3), 还有MySql(开发用的mysql版本号为5.6)
- 下载(或clone)项目到本地
- 创建MySQL数据库(如数据库名oauth2_boot), 并运行相应的SQL脚本(脚本文件位于others/database目录),
运行脚本的顺序: initial_db.ddl -> oauth.ddl -> initial_data.ddl - 修改application.properties(位于src/main/resources目录)中的数据库连接信息(包括username, password等)
- 将本地项目导入到IDE(如Intellij IDEA)中,配置Tomcat(或类似的servlet运行服务器), 并启动Tomcat(默认端口为8080);
注意将项目的 contextPath(根路径) 设置为 'spring-oauth-server'. 另: 也可通过maven package命令将项目编译为war文件(spring-oauth-server.war), 将war放在Tomcat中并启动(注意: 这种方式需要将application.properties加入到classpath中并正确配置数据库连接信息). - 参考oauth_test.txt(位于others目录)的内容并测试之(也可在浏览器中访问相应的地址,如: http://localhost:8080/spring-oauth-server).
grant_type 说明OAuth2支持的grant_type(授权方式)与功能 authorization_code -- 授权码模式(即先登录获取code,再获取token) password -- 密码模式(将用户名,密码传过去,直接获取token) refresh_token -- 刷新access_token implicit -- 简化模式(在redirect_uri 的Hash传递token; Auth客户端运行在浏览器中,如JS,Flash) client_credentials -- 客户端模式(无用户,用户向客户端注册,然后客户端以自己的名义向'服务端'获取资源) 帮助与改进 与该项目相关的博客请访问 http://blog.csdn.net/monkeyking1987/article/details/16828059 如果在使用过程中遇到特殊的问题(如:如何将oauth_code存入数据库),请访问项目的 Wiki 与 附件. 我会把大家反馈的问题解决办法添加在这里. 若在这两个地方没有找到解决办法的, 欢迎发邮件到[email protected]一起讨论. 如果在使用项目的过程中发现任何的BUG或者更好的提议, 建议将其提交到项目的 Issues 中, 我会一直关注并不断改进项目.
功能扩展 -
oauth_code存入数据库的配置 , 请下载文件 oauth_code存入数据库的配置.jpg -
改变token过期的时间的配置 , 请下载文件改变token过期的时间的配置.jpg -
自定义 grant_type , 默认情况支持的grant_type包括 [password,authorization_code,refresh_token,implicit], 若不需要其中的某些grant_type, 则可以修改 oauth_client_details 表中的 authorized_grant_types 字段的值; 若想把整个OAuth2服务修改来只支持某些grant_type, 请修改 security.xml文件中的 oauth2:authorization-server 中的内容,将对应的 grant_type 注释或删掉即可 -
如何刷新access_token(refresh_token) , 在通过客户端(如移动设备)登录成功后返回的数据如下 {"access_token":"3420d0e0-ed77-45e1-8370-2b55af0a62e8","token_type":"bearer","refresh_token":"b36f4978-a172-4aa8-af89-60f58abe3ba1","expires_in":43199,"scope":"read write"} 若需要刷新获取新的token(一般在 expires_in 有效期时间快到时), 请求的URL类似如下 http://localhost:8080/oauth/token?client_id=mobile-client&client_secret=mobile&grant_type=refresh_token&refresh_token=b36f4978-a172-4aa8-af89-60f58abe3ba1 注意: refresh_token 参数值必须与登录成功后获取的 refresh_token 一致, 且grant_type = refresh_token 另: 刷新token 需要 ClientDetails 支持 refresh_token 类型的 grant_type (默认是支持的)
开发计划从 0.3版本开始将项目的所有计划的开发内容列出来, 方便大家跟进, 也欢迎你加入. 项目的开发管理使用开源项目 andaily-developer. -
Version: 2.1.0 [pending] Date: 2020-06-05 / --- 升级access_token, refresh_token为JWT(Json Web Token), 提高性能 升级spring-security oauth2版本为2.3.8.RELEASE, 增加spring-security-jwt版本1.1.1.RELEASE
-
Version: 2.0.2 [finished] Date: 2019-08-05 / 2020-06-04 Fix CVE-2019-3778, use spring-security-oauth 2.3.5.RELEASE
解决数据库多条 access_token问题,增加唯一约束
升级Spring-Boot版本为2.1.4.RELEASE
-
Version: 2.0.1 [finished] Date: 2018-05-01 / 2019-08-04 增加使用代码生成AccessToken功能
增加将AccessToken存入Redis的配置参考
升级Spring Security OAuth版本为2.3.4.RELEASE
修改ROLE的错误配置
Use spring-boot 2.0.2.RELEASE
Fix issue #IJO9R /oauth/rest_token 接口 client_secret字段没有校验
将项目用视频方式展现出来,更直观
-
Version: 2.0.0 [finished] Date: 2018-04-09 / 2018-04-21 更新UI,为了更易理解与使用,场景化
使用 spring-boot 重构 -
Version: 1.1 [cancel] Date: 2018-10-14 / --- --- -
Version: 1.0 [finished] Date: 2017-03-30 / 2018-04-04 implicit测试时 取消掉 client secret
更新UI,为了更易理解与使用,场景化 增加删除access_token API 增加删除 refresh_token API 增加校验 access_token API: /oauth/check_token
Fix ISSUE #IGNQ9 CustomJdbcTokenStore中的CacheEvict不起作用
--- -
Version: 0.6 [finished] Date: 2016-07-07 / 2016-10-13 (150) - 修改OAUTH错误时返回JSON数据
(151) - 数据添加Ehcache缓存支持
(158) - 对配置,代码必要的地方添加注释,方便理解
添加OIDC协议文档
-
Version: 0.5 [finished] Date: 2016-02-19 / 2016-05-24 (118) - Add java-config(零配置) 的支持, 以及启用 新的注解, branch: config
(138) - OAuth 'token' Restful API
(139) - User Overview/ user add/archive
(143) - Add project API document
(144) - Add MongoDB branch
-
Version: 0.4 [finished] Date: 2015-11-09 / 2015-11-30 (97) - Fix custom access_token_validity,refresh_token_validity issue(#5)
(109) - 升级 spring-security-oauth2 的版本到 2.0.6以上, 目前是1.0.5
(113) - Upgrade spring, spring security version to > 4.0
将项目添加到在线测试服务器
(115) - Sync update spring-oauth-client version with spring-oauth-server
(116) - Remove mybatis dependency
Upgrade JAVA to 1.8; Servlet 3.0
Oauth table add index
-
Version: 0.3 [finished] Date: 2015-05-14 / 2015-06-07 #73 - Upgrade 'spring-security-oauth2' version to '2.0.6.RELEASE' (current: 1.0.5.RELEASE) [CANCELED] #74 - oauth mysql ddl add create_time, default is now()
#75 - Add user information API, for spring-oauth-client project use URL: /unity/user_info Login: Yes (ROLE_UNITY) Data Format: JSON URL: /m/user_info Login: Yes (ROLE_MOBILE) Data Format: JSON #77 - User add Privilege domain. Addition initial two user: unityuser(ROLE_UNITY),mobileuser("ROLE_MOBILE). If default user, return all privilegs, otherwise return specify privilege(s)
#78 - Initial 'sprint-oauth-client' project(maven), add sub-modules
#91 - User log4j replace logback dependency
#92 - Add database table column description. (添加数据库表的字段说明)
#93 - 将默认的 oauth_code存入数据库(当前是存入内存)
spring-oauth-server project add Bootstrap CSS
#95 - Add 'client-details' management; create/delete, show testing links
数据库表字段说明 在0.3版本中添加了db_table_description.html 文件(位于/others目录), 用来说明数据库脚本文件oauth.ddl 中各表,各字段的用途及使用场合. 也可在线访问http://andaily.com/spring-oauth-server/db_table_description.html. Project Log 2013-11-19 Initial project, start push code 2013-11-20 发布0.1版本 2015-05-06 发布0.2版本 2015-05-27 创建项目博客,访问地址 http://andaily.com/blog/?cat=19 2015-06-07 发布0.3版本 2015-06-16 添加github访问: https://github.com/monkeyk/spring-oauth-server, 以后的更新将同步github与gitosc. 2015-11-09 开始开发 0.4-beta 版本 2015-11-18 发布 0.4-beta 版本 2016-01-02 发布 0.4 版本 2016-02-19 Add 0.5 version development planning 2016-04-03 Add config branch 2016-04-14 Add mongodb branch 2018-04-21 使用spring-boot重构,增加2.0.0实现 2.0.0 2018-05-01 开始 2.0.1 分支开发 2019-07-04 Add Redis config branch 2019-08-04 发布 2.0.1 版本 2020-06-04 发布 2.0.2 版本 更多资源以下是在学习工作中收集的更多关于OAuth2的资源,对深入理解与运用OAuth2有帮助 -
RFC 6749 - The OAuth 2.0 Authorization Framework, OAuth2.0协议(英文) -
OAuth 2.0 — OAuth, OAuth2.0官方网站 -
OAuth2核心参数说明, 重点介绍了grant_type 与 response_type 以及示例 -
OAuth2 flows, 详细介绍OAuth2的流程,各类错误发生时的响应 -
OAuth 2 开发人员指南(Spring security oauth2), 翻译OAuth 2 Developers Guide(spring security oauth2) -
理解OAuth 2.0, 介绍OAuth2各类grant_type的使用 -
OAuth2:隐式授权(Implicit Grant)类型的开放授权, 介绍grant_type='implicit'模式 -
Apache Oltu, Java版的 OAuth2参考实现, 建议去了解了解 -
OIDC–基于OAuth2的下一代身份认证授权协议 -
在spring-oauth-server中将AccessToken存入Redis的配置 -
如何通过代码生成AccessToken -
OAuth2中 access_token,refresh_token的各类配置与使用场景FAQ
问答与讨论 与项目相关的,与OAuth2相关的问题与回答,以及各类讨论请访问 http://andaily.com/blog/?dwqa-question_category=oauth
使用案例以下是已知的使用(或基于) spring-oauth-server 开源项目的各类商业项目(排名不分先后), 若你有案例希望添加, 请联系作者. Hongkong Parkway Online (在线医疗服务系统) 海尔日日平台 (B2B电商平台) wdcy-game (手机游戏服务端) Honyee Management System (企业管理系统) AoLin Open Platform (国际物流开发平台) IDS (移动安全产品) ......
捐助 支付宝: [email protected] (**钊) 快意江湖 -- 100元 yufan -- 100元
关注更多开源项目请访问 http://andaily.com/my_projects.html 欢迎联系作者 [email protected] 进行探讨
|
请发表评论