README.md · Hero/spring-oauth-server

## spring-oauth-server

java config版本(Spring Boot)

Spring与OAuth2的整合示例

项目用Maven管理
 
Base on Spring-Boot

使用的技术与版本号
<ol>
 <li>JDK (1.8.0_40)</li>
 <li>spring-security-oauth2 (2.3.8.RELEASE)</li>
 <li>spring-security-jwt (1.1.1.RELEASE)</li>
 <li>Spring Boot(2.1.4.RELEASE)</li>
</ol>

<h3>技术视频</h3>
<a href="http://list.youku.com/albumlist/show/id_51900110.html" target="_blank">http://list.youku.com/albumlist/show/id_51900110.html</a>
(持续更新...)
 
 

 1000 star Gitee奖杯: <a href="http://andaily.com/blog/wp-content/uploads/2019/09/sos-1000-stars.jpg" target="_blank">sos-1000-stars.jpg</a> [2019年]

<hr/>

<h3>版本分支介绍</h3>
MySQL版本请访问Branch: <a href="https://gitee.com/shengzhao/spring-oauth-server/">master</a>
 
MongoDB版本请访问Branch: <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/mongodb/">mongodb</a>
 
Redis版本请访问Branch: <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/config-redis/">
config-redis</a>
<hr/>
<h3>相关项目</h3>
<h4>
 OAuth2客户端项目请访问 <a href="https://gitee.com/mkk/spring-oauth-client">spring-oauth-client</a>
</h4>
<h4>
 在线测试访问地址 <a href="http://andaily.com/spring-oauth-server/">http://andaily.com/spring-oauth-server/</a>
</h4>
<h4>
 Shiro与OLTU整合的OAuth2项目 <a href="https://gitee.com/mkk/oauth2-shiro">https://gitee.com/mkk/oauth2-shiro</a>
 (相比spring-oauth-server, 该项目入门门槛相对较低, 代码更加透明, 理解更容易,可扩展性更强, 且模块化开发)
</h4>
<hr/>

<div>
<h3>如何使用?</h3>
<ol>
<li>
项目是Maven管理的, 需要本地安装maven(开发用的maven版本号为3.3.3), 还有MySql(开发用的mysql版本号为5.6)
</li>
<li>
<a href="https://gitee.com/shengzhao/spring-oauth-server/repository/archive?ref=master">下载</a>(或clone)项目到本地
</li>
<li>
创建MySQL数据库(如数据库名oauth2_boot), 并运行相应的SQL脚本(脚本文件位于others/database目录),
 
 运行脚本的顺序: initial_db.ddl -> oauth.ddl -> initial_data.ddl
</li>
<li>
修改application.properties(位于src/main/resources目录)中的数据库连接信息(包括username, password等)
</li>
<li>
将本地项目导入到IDE(如Intellij IDEA)中, 可直接运行<code>SpringOauthServerApplication.java</code>进行访问；或配置Tomcat(或类似的servlet运行服务器), 并启动Tomcat(默认端口为8080);
 
 也可通过maven package命令将项目编译为war文件(spring-oauth-server.war),
 将war放在Tomcat中并启动(注意: 这种方式需要将application.properties加入到classpath中并正确配置数据库连接信息).
 
 若使用<code>java -jar spring-oauth-server.war</code>启动, 则需要使用参数spring.config.location指定配置文件, 
 如：<code>java -jar spring-oauth-server.war --spring.config.location=xxx.properties</code>
 
 提示：若打包为war则项目的 contextPath(根路径) 为 'spring-oauth-server'.
</li>
<li>
参考<a href="https://gitee.com/shengzhao/spring-oauth-server/blob/config/others/oauth_test.txt">oauth_test.txt</a>(位于others目录)的内容并测试之(也可在浏览器中访问相应的地址,如: http://localhost:8080/ 在界面上操作).
</li>
</ol>
</div>
<div>
 <h4>配置参数说明</h4>
 说明配置文件application.properties中的主要变量。
 <table>
 <thead>
 <tr><th>参数名</th><th>必须?</th><th>默认值</th><th>说明</th></tr>
 </thead>
 <tbody>
 <tr><td>spring.datasource.*</td><td>是</td><td>-</td><td>数据库连接相关配置</td></tr>
 <tr><td>spring.mvc.*</td><td>是</td><td>-</td><td>Spring MVC相关配置</td></tr>
 <tr><td>logging.level.root</td><td>是</td><td>INFO</td><td>默认的日志级别</td></tr>
 <tr><td>sos.token.store</td><td>是</td><td>jwt</td><td>可选值：jwt,jdbc；配置Token存储方式，v2.1.0增加</td></tr>
 <tr><td>sos.token.store.jwt.key</td><td>否</td><td>IH6S2dhCEMwGr7uE4fBakSuDh9SoIrRa</td><td>当sos.token.store为jwt时配置具体的jwt key(长度16位或32位)</td></tr>
 <tr><td>sos.reuse.refresh-token</td><td>否</td><td>true</td><td>可选值：true,false；true重复使用refresh_token值直到过期，false每次刷新时生成新的refresh_token值(类似session机制进行续期)，v2.1.0增加</td></tr>
 </tbody>
 </table>
</div>

<hr/>
<h3>grant_type 介绍</h3>
 
说明OAuth2支持的grant_type(授权方式)与功能
<ol>
 <li><code>authorization_code</code> -- 授权码模式(即先登录获取code,再获取token)</li>
 <li><code>password</code> -- 密码模式(将用户名,密码传过去,直接获取token)</li>
 <li><code>refresh_token</code> -- 刷新access_token</li>
 <li><code>implicit</code> -- 简化模式(在redirect_uri 的Hash传递token; Auth客户端运行在浏览器中,如JS,Flash)</li>
 <li><code>client_credentials</code> -- 客户端模式(无用户,用户向客户端注册,然后客户端以自己的名义向'服务端'获取资源)</li>
</ol>

<hr/>
<h3>帮助与改进</h3>
<ol>
<li>

 与该项目相关的博客请访问 <a target="_blank" href="http://blog.csdn.net/monkeyking1987/article/details/16828059">http://blog.csdn.net/monkeyking1987/article/details/16828059</a>

</li>
<li>

 如果在使用过程中遇到特殊的问题(如:如何将oauth_code存入数据库),请访问项目的 <a href="https://gitee.com/shengzhao/spring-oauth-server/wikis/pages">Wiki</a> 
 与 <a href="https://gitee.com/shengzhao/spring-oauth-server/attach_files">附件</a>. 
 
 我会把大家反馈的问题解决办法添加在这里.
 
 若在这两个地方没有找到解决办法的,
 欢迎发邮件到<a href="mailto:sz@monkeyk.com">sz@monkeyk.com</a>一起讨论.

</li>

<li>

 如果在使用项目的过程中发现任何的BUG或者更好的提议, 建议将其提交到项目的 <a href="https://gitee.com/shengzhao/spring-oauth-server/issues">Issues</a> 中, 
 我会一直关注并不断改进项目. 

</li>
</ol>

<hr/>
<h3>功能扩展</h3>
<ol>
 <li>
 <code>oauth_code存入数据库的配置</code>, 请下载文件 <a href="https://git.oschina.net/shengzhao/spring-oauth-server/attach_files/download?i=4858&u=http%3A%2F%2Ffiles.git.oschina.net%2Fgroup1%2FM00%2F00%2F31%2FcHwGbFQXzC-AeseiAAfnNw23X70580.jpg%3Ftoken%3De81934223d99a0fddc02639017b568a6%26ts%3D1421151523%26filename%3Doauth_code%E5%AD%98%E5%85%A5%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9A%84%E9%85%8D%E7%BD%AE.jpg">oauth_code存入数据库的配置.jpg</a>
 </li>
 <li>
 <code>改变token过期的时间的配置</code>, 请下载文件<a href="https://git.oschina.net/shengzhao/spring-oauth-server/attach_files/download?i=6589&u=http%3A%2F%2Ffiles.git.oschina.net%2Fgroup1%2FM00%2F00%2F43%2FcHwGbFRpuk6ANN2CAANJ-Rkiz_c649.jpg%3Ftoken%3D686e6d5b1e9ab04446dbfeb977c3b7a1%26ts%3D1421151523%26filename%3D%E6%94%B9%E5%8F%98token%E8%BF%87%E6%9C%9F%E7%9A%84%E6%97%B6%E9%97%B4%E7%9A%84%E9%85%8D%E7%BD%AE.jpg">改变token过期的时间的配置.jpg</a>
 </li>
 <li>
 <code>自定义 grant_type</code>, 默认情况支持的grant_type包括 [password,authorization_code,refresh_token,implicit], 若不需要其中的某些grant_type,
 则可以修改 oauth_client_details 表中的 authorized_grant_types 字段的值;
 
 若想把整个OAuth2服务修改来只支持某些grant_type, 请修改 security.xml文件中的
 <label>oauth2:authorization-server</label> 中的内容,将对应的 grant_type 注释或删掉即可
 </li>
 <li>
 <div>
 <code>如何刷新access_token(refresh_token)</code>, 在通过客户端(如移动设备)登录成功后返回的数据如下
 
 <pre>{"access_token":"3420d0e0-ed77-45e1-8370-2b55af0a62e8","token_type":"bearer","refresh_token":"b36f4978-a172-4aa8-af89-60f58abe3ba1","expires_in":43199,"scope":"read write"}
 </pre>
 
 若需要刷新获取新的token(一般在 expires_in 有效期时间快到时), 请求的URL类似如下
 
 <pre>http://localhost:8080/oauth/token?client_id=mobile-client&client_secret=mobile&grant_type=refresh_token&refresh_token=b36f4978-a172-4aa8-af89-60f58abe3ba1
 </pre>
 
 注意: refresh_token 参数值必须与登录成功后获取的 refresh_token 一致, 且grant_type = refresh_token
 
 另: 刷新token 需要 ClientDetails 支持 refresh_token 类型的 grant_type (默认是支持的)
 </div>
 </li>
</ol>

<hr/>
<h3>开发计划</h3>

从 0.3版本开始将项目的所有计划的开发内容列出来, 方便大家跟进, 也欢迎你加入.
 
项目的开发管理使用开源项目 <a href="https://gitee.com/mkk/andaily-developer">andaily-developer</a>.

<ul> 
	 <li>
 
 Version: 2.1.1 [pending]
 
 Date: 2022-05-05 / ---
 
 <ol>
 <li>尝试升级替换spring-security-oauth2, 详见<a href="https://andaily.com/blog/?p=20077">背景说明</a></li> 
 </ol>
 
 </li> 	 
 <li>
 
 Version: 2.1.0 [finished]
 
 Date: 2020-06-05 / 2022-05-01
 
 <ol>
 <li><del>升级access_token, refresh_token为JWT(Json Web Token), 提高性能</del></li> 
 <li><del>增加灵活性配置参数<code>sos.reuse.refresh-token</code>可实时延长token时效(类似session机制)</del></li> 
 <li><del>升级spring-security oauth2版本为2.3.8.RELEASE, 增加spring-security-jwt版本1.1.1.RELEASE</del></li> 
 </ol>
 
 </li> 
	 <li>
 
 Version: 2.0.2 [finished]
 
 Date: 2019-08-05 / 2020-06-04
 
 <ol>
 <li><del>Fix CVE-2019-3778, use spring-security-oauth 2.3.5.RELEASE</del></li> 
 <li><del>解决数据库多条 access_token问题，增加唯一约束</del></li> 
 <li><del>升级Spring-Boot版本为2.1.4.RELEASE</del></li> 
 </ol>
 
 </li> 
 <li>
 
 Version: 2.0.1 [finished]
 
 Date: 2018-05-01 / 2019-08-04
 
 <ol>
 <li><del>增加使用代码生成AccessToken功能</del></li>
 <li><del>增加将AccessToken存入Redis的配置参考</del></li>
 <li><del>升级Spring Security OAuth版本为2.3.4.RELEASE</del></li>
 <li><del>修改ROLE的错误配置</del></li>
 <li><del>Use spring-boot 2.0.2.RELEASE</del></li>
 <li><del>Fix issue #IJO9R /oauth/rest_token 接口 client_secret字段没有校验</del></li>
 <li><del>将项目用视频方式展现出来，更直观</del></li> 
 </ol>
 
 </li> 
 <li>
 
 Version: 2.0.0 [finished]
 
 Date: 2018-04-09 / 2018-04-21
 
 <ol>
 <li><del>更新UI,为了更易理解与使用,场景化</del></li>
 <li><del>使用 spring-boot 重构</del></li>
 </ol>
 </li>
 <li>
 
 Version: 1.1 [cancel]
 
 Date: 2018-10-14 / ---
 
 <ol>
 <li>---</li>
 </ol>
 </li>
 <li>
 
 Version: 1.0 [finished]
 
 Date: 2017-03-30 / 2018-04-04
 
 <ol>
 <li><del>implicit测试时 取消掉 client secret</del></li>
 <li>更新UI,为了更易理解与使用,场景化</li>
 <li>增加删除access_token API</li>
 <li>增加删除 refresh_token API</li>
 <li><del>增加校验 access_token API: /oauth/check_token</del></li>
 <li><del>Fix ISSUE #IGNQ9 CustomJdbcTokenStore中的CacheEvict不起作用</del></li>
 <li>---</li>
 </ol>
 </li>
 <li>
 
 Version: 0.6 [finished]
 
 Date: 2016-07-07 / 2016-10-13
 
 <ol>
 <li><del>(150) - 修改OAUTH错误时返回JSON数据</del></li>
 <li><del>(151) - 数据添加Ehcache缓存支持</del></li>
 <li><del>(158) - 对配置,代码必要的地方添加注释,方便理解</del></li>
 <li><del>添加OIDC协议文档</del></li>
 </ol>
 </li> 
 <li>
 
 Version: 0.5 [finished]
 
 Date: 2016-02-19 / 2016-05-24
 
 <ol>
 <li><del>(118) - Add java-config(零配置) 的支持, 以及启用 新的注解, branch: config</del></li>
 <li><del>(138) - OAuth 'token' Restful API</del></li>
 <li><del>(139) - User Overview/ user add/archive</del></li>
 <li><del>(143) - Add project API document</del></li>
 <li><del>(144) - Add MongoDB branch</del></li>
 </ol>
 
 </li>
 <li>
 
 Version: 0.4 [finished]
 
 Date: 2015-11-09 / 2015-11-30
 
 <ol>
 <li><del>(97) - Fix custom access_token_validity,refresh_token_validity issue(#5)</del></li>
 <li><del>(109) - 升级 spring-security-oauth2 的版本到 2.0.6以上, 目前是1.0.5 </del></li>
 <li><del>(113) - Upgrade spring, spring security version to > 4.0</del></li>
 <li><del>将项目添加到在线测试服务器</del></li>
 <li><del>(115) - Sync update spring-oauth-client version with spring-oauth-server</del></li>
 <li><del>(116) - Remove mybatis dependency</del></li>
 <li><del>Upgrade JAVA to 1.8; Servlet 3.0</del></li>
 <li><del>Oauth table add index </del></li>
 </ol>
 </li>
 <li>
 
 Version: 0.3 [finished]
 
 Date: 2015-05-14 / 2015-06-07
 
 <ol>
 <li>#73 - Upgrade 'spring-security-oauth2' version to '2.0.6.RELEASE' (current: 1.0.5.RELEASE) [CANCELED]</li>
 <li><del>#74 - oauth mysql ddl add create_time, default is now() </del></li>
 <li><del>#75 - Add user information API, for <a href="https://gitee.com/mkk/spring-oauth-client"><code>spring-oauth-client</code></a> project use
 <pre>
 URL: /unity/user_info
 Login: Yes (ROLE_UNITY)
 Data Format: JSON
 URL: /m/user_info
 Login: Yes (ROLE_MOBILE)
 Data Format: JSON
 </pre>
 </del>
 </li>
 <li><del>#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) </del></li>
 <li><del>#78 - Initial 'sprint-oauth-client' project(maven), add sub-modules</del></li>
 <li><del>#91 - User log4j replace logback dependency </del></li>
 <li><del>#92 - Add database table column description. (添加数据库表的字段说明) </del></li>
 <li><del>#93 - 将默认的 oauth_code存入数据库(当前是存入内存) </del></li>
 <li><del> spring-oauth-server project add Bootstrap CSS </del></li>
 <li><del>#95 - Add 'client-details' management; create/delete, show testing links</del></li>
 </ol>
 </li>
</ul>

<hr/>
<h3>数据库表字段说明</h3>

 在0.3版本中添加了<code>db_table_description.html</code>文件(位于/others目录), 用来说明数据库脚本文件<code>oauth.ddl</code>中各表,各字段的用途及使用场合.
 
 也可在线访问<a href="http://andaily.com/spring-oauth-server/db_table_description.html">http://andaily.com/spring-oauth-server/db_table_description.html</a>.

<hr/>
<h3>Project Log</h3>
<div>
 <ol>
 <li>2013-11-19 Initial project, start push code</li>
 <li>2013-11-20 发布<a href="https://gitee.com/shengzhao/spring-oauth-server/tree/0.1/">0.1</a>版本</li>
 <li>2015-05-06 发布<a href="http://www.oschina.net/news/62176/spring-oauth-server-0-2">0.2</a>版本</li>
 <li>2015-05-27 创建项目博客,访问地址 <a href="http://andaily.com/blog/?cat=19">http://andaily.com/blog/?cat=19</a></li>
 <li>2015-06-07 发布<a href="https://gitee.com/shengzhao/spring-oauth-server/tree/0.3/">0.3</a>版本</li>
 <li>
 2015-06-16 添加github访问: <a href="https://github.com/monkeyk/spring-oauth-server">https://github.com/monkeyk/spring-oauth-server</a>,
 以后的更新将同步github与gitosc.
 </li>
 <li>2015-11-09 开始开发 0.4-beta 版本</li>
 <li>2015-11-18 发布 <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/0.4-beta/">0.4-beta</a> 版本</li>
 <li>2016-01-02 发布 <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/0.4/">0.4</a> 版本</li>
 <li>2016-02-19 Add 0.5 version development planning</li>
 <li>2016-04-03 Add <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/config/">config</a> branch</li>
 <li>2016-04-14 Add <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/mongodb/">mongodb</a> branch</li>
 <li>2018-04-21 使用spring-boot重构,增加2.0.0实现 <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/2.0.0/">2.0.0</a> </li>
 <li>2018-05-01 开始 <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/config/">2.0.1</a> 分支开发</li>
 <li>2019-07-04 Add Redis <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/config-redis/">config</a> branch</li>
 <li>2019-08-04 发布 <a href="https://gitee.com/shengzhao/spring-oauth-server/tree/2.0.1/">2.0.1</a> 版本</li>
 <li>2020-06-04 发布 2.0.2 版本</li>
 <li>2022-05-01 发布 2.1.0 版本</li>
 </ol>
</div>

<hr/>
<h3>更多资源</h3>
以下是在学习工作中收集的更多关于OAuth2的资源,对深入理解与运用OAuth2有帮助
<ul>
 <li>
 
 <a href="http://tools.ietf.org/html/rfc6749">RFC 6749 - The OAuth 2.0 Authorization Framework</a>, OAuth2.0协议(英文)
 
 </li>
 <li>
 
 <a href="http://oauth.net/2/">OAuth 2.0 &mdash; OAuth</a>, OAuth2.0官方网站
 
 </li>
 <li>
 
 <a href="http://netment.iteye.com/blog/945402">OAuth2核心参数说明</a>, 重点介绍了grant_type 与 response_type 以及示例
 
 </li>
 <li>
 
 <a href="http://apiwiki.poken.com/authentication/oauth2">OAuth2 flows</a>, 详细介绍OAuth2的流程,各类错误发生时的响应
 
 </li>
 <li>
 
 <a href="http://www.oschina.net/translate/oauth-2-developers-guide">OAuth 2 开发人员指南（Spring security oauth2）</a>, 翻译OAuth 2 Developers Guide(spring security oauth2)
 
 </li>
 <li>
 
 <a href="http://www.ruanyifeng.com/blog/2014/05/oauth_2_0.html">理解OAuth 2.0</a>, 介绍OAuth2各类grant_type的使用
 
 </li>
 <li>
 
 <a href="http://www.dannysite.com/blog/178/">OAuth2：隐式授权（Implicit Grant）类型的开放授权</a>, 介绍grant_type='implicit'模式
 
 </li>
 <li>
 
 <a href="http://oltu.apache.org/">Apache Oltu</a>, Java版的 OAuth2参考实现, 建议去了解了解
 
 </li>
 <li>
 
 <a href="http://andaily.com/blog/?p=440">OIDC–基于OAuth2的下一代身份认证授权协议</a>
 
 </li> 
 <li>
 
 <a href="http://andaily.com/blog/?p=19776">在spring-oauth-server中将AccessToken存入Redis的配置</a>
 
 </li> 
 <li>
 
 <a href="http://andaily.com/blog/?p=19793">如何通过代码生成AccessToken</a>
 
 </li>
 <li>
 
 <a href="http://andaily.com/blog/?p=19884">OAuth2中 access_token，refresh_token的各类配置与使用场景FAQ</a>
 
 </li>
</ul>

<hr/>
<h4>
 与项目相关的技术文章请访问 <a href="http://andaily.com/blog/?cat=19">http://andaily.com/blog/?cat=19</a> (不断更新与OAuth2相关的文章)
</h4>
<div>
 <h4>问答与讨论</h4>
 
 与项目相关的，与OAuth2相关的问题与回答，以及各类讨论请访问 
 <a href="http://andaily.com/blog/?dwqa-question_category=oauth">http://andaily.com/blog/?dwqa-question_category=oauth</a>
</div>

<hr/>
<h3>使用案例</h3>
以下是已知的使用(或基于) spring-oauth-server 开源项目的各类商业项目(排名不分先后), 若你有案例希望添加, 请联系作者.
<ul>
 <li>Hongkong Parkway Online (在线医疗服务系统)</li>
 <li>海尔日日平台 (B2B电商平台)</li>
 <li>wdcy-game (手机游戏服务端)</li>
 <li>Honyee Management System (企业管理系统)</li>
 <li>AoLin Open Platform (国际物流开发平台)</li>
 <li>IDS (移动安全产品)</li>
 <li>......</li>
</ul>

<hr/>
<div>
 <h3>捐助</h3>
 
 支付宝: monkeyking1987@126.com (**钊)
 
 快意江湖 -- 100元
 
 yufan -- 100元
</div>

<hr/>
<h3>其他...</h3>

 关注更多开源项目请访问 <a href="http://andaily.com/my_projects.html">http://andaily.com/my_projects.html</a>

欢迎联系作者 <a href="mailto:sz@monkeyk.com">sz@monkeyk.com</a> 进行探讨

<hr/>

Hero/spring-oauth-server

简介

发行版

贡献者

近期动态

Hero/spring-oauth-server .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Hero/spring-oauth-server