Id Server是一个基于Spring Authorization Server的开源的授权服务器,拉取代码直接运行,无需过多配置。欢迎Star,如果有兴趣也可以对本项目发起贡献。
- github: https://github.com/NotFound403/id-server
- gitee: https://gitee.com/felord/id-server
- 文档建设中……
- 开箱即用,只需要少量配置即可使用。
- 创建OAuth2客户端,并对OAuth2客户端进行管理。
- 提供OAuth2授权服务。
- 支持四种客户端认证方式:
- CLIENT_SECRET_BASIC
- CLIENT_SECRET_POST
- CLIENT_SECRET_JWT
- PRIVATE_KEY_JWT
- 支持三种OAuth2授权方式:
- AUTHORIZATION_CODE
- CLIENT_CREDENTIALS
- REFRESH_TOKEN
- 支持以下用户认证方式:
- 账密登录
- 手机号验证码登录
- 小程序登录
- OIDC 1.0的支持(完善中)。
- 一键生成配置
yaml
文件。 - 提供UI控制台,降低上手成本。
- 可动态调整管理员的用户角色,对授权服务器进行按钮功能级别的权限控制。
- Java 8及以上
- Spring Boot
- Spring Security
- Spring Authorization Server
- Spring Data JPA
- pear admin layui
- thymeleaf
- 数据库
- H2
- Mysql
- 拉取主分支最新代码到本地。
- 通过
IdServerApplication
来启动授权服务器。管理控制台本地登录路径为http://localhost:9000/system/login
,最高权限用户为root
,密码为idserver
。 - 你可以通过
root
用户做这些事情:- 创建角色(角色管理)并为角色绑定权限。
- 创建控制台管理用户(用户管理),并赋予他们角色。
退出功能还未完善,需要通过关闭浏览器来清除session。
- 启动Id Server,默认情况下在客户端列表提供了一个内置的OAuth2客户端。
- 样例客户端在
samples
文件夹下,直接启动,浏览器配置文件下的http://127.0.0.1:8082/foo/bar
,进入登录页,输入用户名user
和密码user
即可。 - 你也可以在Id Server中创建一个客户端并模仿DEMO中的配置,主要修改
client-id
,client-secret
,client-authentication-method
,scope
,其它选项除非你比较了解OAuth2,否则先不要动,也可以通过issue咨询。
redirect-uri
必须在授权服务器Id Server注册客户端时声明。
首先要正确区分管理用户和普通用户这两个概念。
root
及其创建的用户为UI控制台的管理用户,超级管理员root
是目前提供了一个默认用户,具有Id Server的最高权限。如果你需要自定义,可实现RootUserDetailsService
接口并注入Spring IoC。
普通用户就是OAuth2中的资源拥有者,主要对OAuth2客户端的授权请求进行授权。默认提供了一个user
用来演示,开发者可以实现OAuth2UserDetailsService
接口并注入Spring IoC来自定义用户的来源。
现在OAuth2授权增加了手机号验证码登录,灵感来自扩展包,不影响原有的OAuth2授权流程。资源拥有者可以在下面的页面选择认证方式:
对于不使用验证码认证方式的,可以通过OAuth2LoginController#oauth2LoginPage
接口中的enableCaptchaLogin
参数进行调整,默认值为true
(开启)。
目前Id Server提供H2和Mysql两种数据库环境,分别对应application-h2.yml
和application-mysql.yml
两个配置文件。
- H2,默认数据库,在H2环境下,数据库DDL脚本和DML脚本会自动执行,无需开发者手动执行,该环境主要用来测试、研究、学习。
- Mysql,生产推荐,首次启动时开发者手动执行初始化DML脚本。
目前两种环境的效果是一致的,H2时间长会发生表丢失情况,切换时务必在
pom.xml
中更换对应的数据库驱动程序依赖。