monkeyk / oauth2-shiro Goto Github PK

• 更加透明 -- 每一步实现都有可以查看的, 更容易理解的源代码, 一目了然

• 更多的可自定义与可扩展 -- 不管是ERROR返回信息的内容或格式, 都可根据需要自定义, 对请求参数,处理细节等可添加更多的具体实现

• 可读性更强 -- 由于Shiro, Oltu 没有Spring Security,spring-security-oauth2 的门槛高, 所有代码都是常用的Controller或Java Bean实现各项业务, 更可读,更易于理解

• 模块化 -- 得益于Oltu的模块化设计, 将authz, resources分开成不同的模块, 使用时可根据实际需要将二者合并在一个项目中或拆分为不同的模块

• JDK -- 1.8.0_40

• Maven -- 3.6.0

• MySQL -- 5.7.22

oauth2-shiro项目使用模块化开发, 以实现"高内聚, 低耦合"目标, 更符合实际项目需要; 分为三个模块: authz, core 与 resources, 具体说明如下

• authz 实现使用各类grant_type去获取token业务逻辑----获取access_token

• core 将公共部分提取到该模块中, 减少重复代码, 保证一致性, 如定义ClientDetails, AccessToken; authz, resources 模块都依赖于该模块

• resources 资源管理模块,将受OAuth2保护的资源(URI)放在这里----使用access_token

• authz https://andaily.com/authz/ v0.2

• resources https://andaily.com/rs/ v0.2

• Redis + MySQL https://gitee.com/mkk/oauth2-shiro-redis

• Redis https://gitee.com/mkk/oauth2-shiro-redis/tree/redis/

1. 项目是Maven管理的, 需要本地安装maven(开发用的maven版本号为3.6.0), 数据库MySql(开发用的mysql版本号为5.7.22)
2. 下载(或clone)项目到本地
3. 项目由三个模块(core,authz,resources)组成, core是一个Java项目(jar), authz与resources是SpringBoot项目(.jar)
4. 创建MySQL数据库(数据库名 oauth2_shiro), 并运行相应的SQL脚本(脚本文件位于others/database目录),
   运行脚本的顺序: oauth2-shiro.ddl -> initial-db.ddl
   若需要运行单元测试，则还需要创建数据库 oauth2_shiro_test 并运行SQL脚本 （单元测试的配置文件为application-test.properties，位于 src/test/resources 目录中）。
5. 依次修改authz模块的配置文件application.properties(位于模块的src/main/resources目录)与resources模块的配置文件application.properties(位于模块的src/main/resources目录); 修改配置文件中的数据库连接信息(包括username, password等), 都连接到数据库oauth2_shiro
6. 将本地项目导入到IDE(如Intellij IDEA)中, 并启动服务。
   (authz默认端口为8080,启动类 AuthzApplication.java; resources默认端口为8083,启动类 ResourcesApplication.java )。
   启动后查看控制台的日志输出或查看logs/目录中按日期分类的log日志。
   另: 也可通过maven package命令将项目编译为SpringBoot jar文件(authz.jar 与 rs.jar), 注意编译时每个模块的pom.xml文件中配置的数据库连接信息, 可在Maven命令中添加 -Dmaven.test.skip=true 忽略单元测试; 将authz模块与resources模块生成的jar通过 java -jar 命令启动( java -jar authz.jar 与 java -jar rs.jar)。
7. 在浏览器中直接访问authz地址: http://localhost:8080 在线测试或 参考oauth_test.txt(位于others目录)的内容使用postman等工具测试。

1. 2015-05-17 Initial project, start push code (private)

2. 2015-07-16 oauth2-shiro项目开发状态(7月)

3. 2015-09-06 oauth2-shiro项目开发状态(8月)

4. 2015-09-06 项目由 私有 变为 开源, 开发 resource 模块

5. 2015-09-26 版本0.1 开发完毕, 发布 0.1-beta 版本

6. 2015-10-07 重构项目结构, 发布 0.1-rc 版本

7. 2016-05-26 开始开发 0.2 版本

8. 2016-07-02 添加在线测试环境

9. 2016-08-17 发布 0.2 版本

10. 2017-01-21 加入到GitHub中, Git@OSC地址: http://git.oschina.net/mkk/oauth2-shiro

11. 2020-07-05 开始2.0.0版本开发

12. 2023-09-28 发布 2.0.0 版本，大升级

• spring-oauth-server Spring Security与OAuth2的完整整合项目

• spring-oauth-client OAuth 客户端(client)测试项目