项目开源地址:

青锋开源架构-springboot2.6.x+vue3-antdesign-vite: 青锋-springboot2.6.x+vue3-antdesign-vite开源架构,实现了系统管理模块、权限控制模块(菜单权限、功能按钮权限、数据权限)、代码生成器(单表、树表)、quartz动态定时器等功能。

1、Spring-Security-OAuth2简介

Spring-Security-OAuth2分为Spring-SecurityOAuth2两个知识点。Spring-Security-OAuth2提供了这2个知识点的整合。

Spring Security是一个基于Spring的企业应用系统提供声明式的安全访问控制解决方案的安全框架。由于它 是Spring生态系统中的一员,因此它伴随着整个Spring生态系统不断修正、升级,在spring boot项目中加入spring security更是十分简单,使用Spring Security 减少了为企业系统安全控制编写大量重复代码的工作。

OAuth(开放授权)是一个开放标准协议,允许用户授权第三方应用访问他们存储在另外的服务提供者上的信息,而不需要将用户名和密码提供给第三方应用或分享他们数据的所有内容。

OAuth是一种用来规范令牌(Token)发放的授权机制,主要包含了四种授权模式:授权码模式、简化模式、密码模式和客户端模式。Spring Security OAuth2对这四种授权模式进行了实现。

2、四种授权模式

这里简要的介绍一下4种授权模式及他们适用的范围。

2.1 授权码模式

授权码模式(authorization code)是功能最完整、流程最严密的授权模式。它的特点就是通过客户端的后台服务器,与”服务提供商”的认证服务器进行互动。

适用于和外部系统的对接,例如我们经常使用的微信扫码登录、QQ登录、Github登录都是这种模式。

步骤如下:

(A)用户打开客户端以后,客户端要求用户给予授权。
(B)用户同意给予客户端授权。
(C)客户端使用上一步获得的授权,向认证服务器申请令牌。
(D)认证服务器对客户端进行认证以后,确认无误,同意发放令牌。
(E)客户端使用令牌,向资源服务器申请获取资源。
(F)资源服务器确认令牌无误,同意向客户端开放资源。

A步骤中,客户端申请认证的URI,包含以下参数:

  • response_type:表示授权类型,必选项,此处的值固定为”code”
  • client_id:表示客户端的ID,必选项
  • redirect_uri:表示重定向URI,必选项
  • scope:表示申请的权限范围,可选项
  • state:表示客户端的当前状态,可以指定任意值,认证服务器会原封不动地返回这个值。

C步骤中,服务器回应客户端的URI,包含以下参数:

  • code:表示授权码。该码的有效期应该很短,通常设为10分钟,客户端只能使用该码一次,否则会被授权服务器拒绝。该码与客户端ID和重定向URI,是一 一对应关系。
  • state:如果客户端的请求中包含这个参数,认证服务器的回应也一模一样包含这个参数。

D步骤中,客户端向认证服务器申请令牌的HTTP请求,包含以下参数:

  • grant_type:表示使用的授权模式,必选项,此处的值固定为”authorization_code”。
  • code:表示上一步获得的授权码,必选项。
  • redirect_uri:表示重定向URI,必选项,且必须与A步骤中的该参数值保持一致。
  • client_id:表示客户端ID,必选项。
  • client_secret:表示客户端security,必选项。
  • scope:表示申请的权限范围,可选项

2.2 密码模式

密码模式(Resource Owner Password Credentials Grant)中,用户向客户端提供自己的用户名和密码。客户端使用这些信息,向认证服务器索要授权。

适用于客户端是自己开发的系统,因为我们会将用户名、密码提供给client客户端,必须要是可信系统才行。

步骤如下:
(A)用户向客户端提供用户名和密码。
(B)客户端将用户名和密码发给认证服务器,向后者请求令牌。
(C)认证服务器确认无误后,向客户端提供访问令牌。

B步骤中,客户端发出的HTTP请求,包含以下参数:

  • grant_type:表示授权类型,此处的值固定为”password”,必选项。
  • username:表示用户名,必选项。
  • password:表示用户的密码,必选项。
  • scope:表示权限范围,可选项。

2.3 客户端模式

客户端模式(client_credentials)直接根据client的id和密钥即可获取token,无需用户参与。这种模式比较合适消费api的后端服务,此模式不支持refresh token。


步骤如下:
(A)用户向客户端提供用户名和密码。
(B)客户端将用户名和密码发给认证服务器,向后者请求令牌。

A步骤中,客户端发出的HTTP请求,包含以下参数:

  • grant_type:表示授权类型,此处的值固定为”password”,必选项。
  • client_id:客户端ID,必选项。
  • client_secret:客户端secret,必选项。

2.4 简化模式

简化模式模式(implicit)比授权码模式少了code环节,回调url直接携带token,这种模式的使用场景是基于浏览器的应用
这种模式基于安全性考虑,建议把token时效设置短一些,不支持refresh token

3、scope参数

a 服务 resourceId为 : a
b 服务 resourceId为: b

Client1:clientid: client1 ,scopse: read resourceId:a,b
Client2:clientid: client2 ,scopse: read,write,resourceId:a,b

a服务 某个方法加 @PreAuthorize(“#oauth2.hasScope(‘read’)”)
b服务 某个方法加 @PreAuthorize(“#oauth2.hasScope(‘write’)”)

那么:

client1这个客户端就只能访问a服务和b服务的加了read标识的方法
client2这个client就能同时访问加了read 和 write的方法

另外每个服务都应该有个 resourceId,新建 clientDetails 的时候可以指定 resourceId,不指定就能访问所有,指定了只能访问指定的,访问其他的就会抛异常。

看不懂没关系,先看后面的代码实操,还是不懂也没关系,再看几遍就好了。

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐