oauth2快速入门过程是怎样的
这期内容当中小编将会给大家带来有关oauth2快速入门过程是怎样的,文章内容丰富且以专业的角度为大家分析和叙述,阅读完这篇文章希望大家可以有所收获。
创新互联公司是一家集网站建设,道里企业网站建设,道里品牌网站建设,网站定制,道里网站建设报价,网络营销,网络优化,道里网站推广为一体的创新建站企业,帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿,时刻以成就客户成长自我,坚持不断学习、思考、沉淀、净化自己,让我们为更多的企业打造出实用型网站。
一 快速启动
1 在项目中加入相关的依赖
需要 导入 易水公共组件 和 spring-security-oauth3-autoconfigure
两个依赖
org.springframework.security.oauth.boot spring-security-oauth3-autoconfigure 2.2.0.RELEASE com.yishuifengxiao.common common-spring-boot-starter 4.1.2
2 在项目加入以下代码
@Configuration public class CustomOauth3Config extends OAuth3Config{ }
3 加上开启注解
加上@EnableResourceServer
和 @EnableAuthorizationServer
注解
完全开启示例代码如下:
@Configuration @EnableWebSecurity @EnableResourceServer @EnableAuthorizationServer public class SecurityConfig extends AbstractSecurityConfig { @Override protected void configure(HttpSecurity http) throws Exception { // 调用父类中的默认配置 applyAuthenticationConfig(http); } @Configuration public class CustomOauth3Config extends OAuth3Config{ } }
4 实现自定义认证逻辑
实现UserDetailsService
接口 和 UserDetailsService
接口,完成自己的认证逻辑,并将其注入到spring 的上下文中
【特别注意】在用户未按照此步骤配置自己的授权逻辑时,组件会默认进行一个缺省实现。在缺省实现的情况下,用户能使用任意用户名配合密码(12345678)进行登录
需要特别注意的是,在下面的授权方式之中,UserDetailsService
负责校验clientId
和clientSecret
是否正确,UserDetailsService
负责校验username
和password
是否正确。
完成前面的步骤之后,一个简单的oauth3认证服务器就搭建完成了。
二 四种授权方式
密码模式
POST /oauth/token HTTP/1.1 Host: oauth3.yishuifengxiao.com Authorization: Basic fdsfdsfdsfds Content-Type: application/x-www-form-urlencoded grant_type=password&username=johndoe&password=A3ddj3w
在请求中,各参数的含义如下
grant_type:表示授权类型,此处的值固定为"password",必选项。
username:表示用户名,必选项。
password:表示用户的密码,必选项。
scope:表示权限范围,可选项。
Authorization: 请求头参数 ,值是 clientId:clientSecret 经过 base64 编码后的值
下面是一个响应的例子
{ "access_token": "BDF867DE69F05143C709", "token_type": "bearer", "refresh_token": "d7cda8fb15714209a9f9f3b039a0034f", "expires_in": 43199, "scope": "read write trust", "client_id": "yishui" }
客户端模式
POST /oauth/token HTTP/1.1 Host: oauth3.yishuifengxiao.com Authorization: Basic fdsfdsfdsfds Content-Type: application/x-www-form-urlencoded grant_type=client_credentials
在本请求中,各参数的含义如下
grant_type:表示授权类型,此处的值固定为"client_credentials",必选项。
Authorization: 请求头参数 ,值是 clientId:clientSecret 经过 base64 编码后的值
下面是一个响应的例子
{ "access_token": "BDF867DE69F05143D3BF", "token_type": "bearer", "expires_in": 43199, "scope": "read write trust", "client_id": "yishui" }
同密码模式相比,客户端模式的响应中缺少了
refresh_token
参数
授权码模式
授权码模式首先需要保证 spring security 的登陆功能正常可用。只有开启 spring security 的登陆功能可用,才能开启授权码功能。
先访问一下请求
GET /oauth/authorize?response_type=code&client_id=yishui&state=xyz &redirect_uri=http://demo.yishuifengxiao.com/demo HTTP/1.1 Host: oauth3.yishuifengxiao.com
在本请求中,各参数的含义如下:
code:表示授权码,必选项。该码的有效期应该很短,通常设为 10 分钟,客户端只能使用该码一次,否则会被授权服务器拒绝。该码与客户端 ID 和重定向 URI,是一一对应关系。
state:如果客户端的请求中包含这个参数,认证服务器的回应也必须一模一样包含这个参数。
client_id: 用户的 client_id
在进行此请求时,假如用户没有登录,spring security 会进行拦截,因此需要用户先进行登录。
在正常情况下,访问以上请求会被重定向到
http://demo.yishuifengxiao.com/demo?code=fsfsdf &state=xyz
服务器回应客户端的 URI,包含以下参数:
code:表示授权码,必选项。该码的有效期应该很短,通常设为 10 分钟,客户端只能使用该码一次,否则会被授权服务器拒绝。该码与客户端 ID 和重定向 URI,是一一对应关系。
state:如果客户端的请求中包含这个参数,认证服务器的回应也必须一模一样包含这个参数。
通过上面的请求得到了code
以后,用户需要使用下面请求获取到授权码
POST /oauth/token HTTP/1.1 Host: oauth3.yishuifengxiao.com Authorization: Basic fdsfdsfdsfds Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&code=fsfsdf &redirect_uri=demo.yishuifengxiao.com/demo
在本请求中,各参数的含义如下:
grant_type:表示使用的授权模式,必选项,此处的值固定为"authorization_code"。
code:表示上一步获得的授权码,必选项。
redirect_uri:表示重定向 URI,必选项,且必须与 A 步骤中的该参数值保持一致。
client_id:表示客户端 ID,必选项。
简化模式
GET /oauth/authorize?response_type=token&client_id=yishui&state=xyz &redirect_uri=http://demo.com/demo HTTP/1.1 Host: server.example.com
在本请求中,各参数的含义如下:
response_type:表示授权类型,此处的值固定为"token",必选项。
client_id:表示客户端的 ID,必选项。
redirect_uri:表示重定向的 URI,可选项。
scope:表示权限范围,可选项。
state:表示客户端的当前状态,可以指定任意值,认证服务器会原封不动地返回这个值。
刷新 token
POST /oauth/token HTTP/1.1 Host: oauth3.yishuifengxiao.com Authorization: Basic fdsfdsfdsfds Content-Type: application/x-www-form-urlencoded grant_type=refresh_token&refresh_token=sdff
请求中个参数的含义:
granttype:表示使用的授权模式,此处的值固定为"refreshtoken",必选项。
refresh_token:表示早前收到的更新令牌,必选项。
scope:表示申请的授权范围,不可以超出上一次申请的范围,如果省略该参数,则表示与上一次一致。
三 access_token 使用
通过 前面的方法获取到 access_token 之后,一般有两种使用方法
将 access_token 做为请求参数携带在 url 参数上
http://demo.yishuifengxiao.com/user/123?access_token=获得到的access_token
将 access_token 做为请求参数放在请求头中
在所有需要授权的请求的请求头里都携带上参数 Authorization=Bearer 获得到的 access_token
在通用组件中,由于对access_token
进行了深度处理,因此用户可以access_token
通过易水工具包里的 DES 工具饭解析出 token 里携带的信息。
在解密时需要使用的密钥由【安全管理】中设置的yishuifengxiao.security.secret-key
属性值决定。
下面是一个 access_token
的解密信息示例
{ "username": "yishui", "clientId": "admin", "roles": [ "ROLE_USER", "admin" ], "grantType": "password" }
解密信息的各参数的解释:
username: 用户登录时使用到的用户名(在客户端模式下该值为空)
clientId: 用户登录时使用的 clientId(在简化模式下该值为空)
roles: 此登录用户拥有的角色(即此用户的 authorities)
grantType:access_token 对应的授权类型
由
access_token
反解析出用户信息仅限于本组件,原生的 oauth3 的access_token
不支持此功能
上述就是小编为大家分享的oauth2快速入门过程是怎样的了,如果刚好有类似的疑惑,不妨参照上述分析进行理解。如果想知道更多相关知识,欢迎关注创新互联行业资讯频道。
当前名称:oauth2快速入门过程是怎样的
网页URL:http://hbruida.cn/article/jedgjp.html