Spring Security 自定义资源服务器实践

我就是我 2024-04-08 10:31 31阅读 0赞

> 相关文章：
> 
> 1.  [OAuth2的定义和运行流程][OAuth2]
> 2.  [Spring Security OAuth实现Gitee快捷登录][Spring Security OAuth_Gitee]
> 3.  [Spring Security OAuth实现GitHub快捷登录][Spring Security OAuth_GitHub]
> 4.  [Spring Security的过滤器链机制][Spring Security]
> 5.  [Spring Security OAuth Client配置加载源码分析][Spring Security OAuth Client]
> 6.  [Spring Security内置过滤器详解][Spring Security 1]
> 7.  [为什么加载了两个OAuth2AuthorizationRequestRedirectFilter分析][OAuth2AuthorizationRequestRedirectFilter]
> 8.  [Spring Security 自定义授权服务器实践][Spring Security 2]

## 前言 ##

在前面我们使用最小化配置的方式搭建了自己的授权服务器，现在我们依旧用最小化的方式配置自己的资源服务器。  
资源服务器负责scope的鉴权、authorities的鉴权、基于用户角色的鉴权等。

## 最小化配置 ##

### 安装资源服务器 ###

1、 新建一个Spring Boot项目，命名为`spring-security-resource-server`  
2、引入pom.xml依赖

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

其中与授权服务器依赖不同的是，资源服务器有spring boot版本，版本号会有spring boot进行管理，不需要显示声明。

### 配置资源服务器 ###

1、配置application.yml 文件

spring:
      security:
        oauth2:
          resourceserver:
            jwt:
              issuer-uri: http://localhost:9000

该配置用于指定授权服务器地址，资源服务器将从该地址获取JWT令牌，并根据JWT中的属性进一步自我配置，发现授权服务器的公钥、验证JWT令牌。

2、创建配置类

@EnableWebSecurity(debug = true)
    public class ResoruceServerConfig {
        
    
        @Bean
        SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        
            http
                    .authorizeRequests()
                    .mvcMatchers("/userinfo/**").hasAuthority("SCOPE_userinfo")
                    .and()
                    .oauth2ResourceServer()
                    .jwt();
            return http.build();
        }
    
    }

`.mvcMatchers("/userinfo/**").hasAuthority("SCOPE_userinfo")`匹配`/userinfo/**`地址，允许访问范围是`SCOPE_userinfo`  
`oauth2ResourceServer()`定义为资源服务器  
`jwt()`使用JWT令牌

3、 创建一个资源接口  
`/userinfo/`用来获取资源所有者基本信息

@Data
    public class UserInfoRes {
        
    
        private String username;
    }

创建Rest接口

@RestController
    public class UserInfoController {
        
    
        @GetMapping("/userinfo")
        public UserInfoRes getUserInfo() {
        
            UserInfoRes userInfoRes = new UserInfoRes();
            userInfoRes.setUsername("阿提说说");
            return userInfoRes;
        }
    }

### 配置客户端 ###

目前我们客户端的配置是这样的：

spring:
      security:
        oauth2:
          client:
            registration:
              gitee:
                client-id: gitee_clientId
                client-secret: gitee_secret
                authorization-grant-type: authorization_code
                redirect-uri: '{baseUrl}/login/oauth2/code/{registrationId}'
                client-name: Gitee
              github:
                client-id: github_clientId
                client-secret: github_secret
              # 自定义
              customize:
                client-id: testClientId
                client-secret: testClientSecret
                authorization-grant-type: authorization_code
                redirect-uri: '{baseUrl}/login/oauth2/code/{registrationId}'
                client-name: Customize
                scope:
                  - userinfo
            provider:
              gitee:
                authorization-uri: https://gitee.com/oauth/authorize
                token-uri: https://gitee.com/oauth/token
                user-info-uri: https://gitee.com/api/v5/user
                user-name-attribute: name
              # 自定义
              customize:
                authorization-uri: http://localhost:9000/oauth2/authorize
                token-uri: http://localhost:9000/oauth2/token
                user-info-uri: http://localhost:9000/userinfo
                user-name-attribute: username

这里我们只需要修改`customize`部分的`user-info-uri`和 `user-name-attribute`  
调整后配置如下，其他部分跟原来是一样的。

customize:
                authorization-uri: http://localhost:9000/oauth2/authorize
                token-uri: http://localhost:9000/oauth2/token
                user-info-uri: http://localhost:8090/userinfo
                user-name-attribute: username

> ❗ user-name-attribute的名字，必须在user-info-uri返回的属性名中存在

### 整流程体验 ###

在如上三部分配置完成后，就可以体验了，启动`spring-security-resource-server`、`spring-security-authorization-server`、`spring-security-oauth2-client`

浏览器访问地址：[http://127.0.0.1:8080/hello][http_127.0.0.1_8080_hello]，在授权完成后，即跳转回并显示结果。

![image.png][]  
ResourceServer下能看到带着token的`/userinfo`请求日志。

************************************************************
    
    Request received for GET '/userinfo':
    
    org.apache.catalina.connector.RequestFacade@3418bfc9
    
    servletPath:/userinfo
    pathInfo:null
    headers: 
    accept: application/json
    authorization: Bearer eyJraWQiOiI5YjZjZWMzNi05ZDYyLTRkMWMtOWRiNi0wMWM1ODQzMDc1N2UiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJ1c2VyIiwiYXVkIjoidGVzdENsaWVudElkIiwibmJmIjoxNjYwOTU1ODQyLCJzY29wZSI6WyJ1c2VyaW5mbyJdLCJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3Q6OTAwMCIsImV4cCI6MTY2MDk1NjE0MiwiaWF0IjoxNjYwOTU1ODQyfQ.gVWwwfzB-xNuWWUBpgGokIOy5xwV9Wkd05k3rqpk1h92b-TWENB4ZArEL--zpngSyE8iuml0vG3veCv647FDx_EY56ClM-UxH-3Wq0D2f3b6WTgFO5RpCCwRLCHahBlV5g9plr7hWYY5uX2cQ4MsC4-ltZSR6wga5LSLDB-bIK46ZmJ3DOaQFwTTCpWB4OgOuq1j59i9XkgDUc_I8WUsHB4eEDEbBJeOmdimDn5O1Ux6nDhPgLMLcpnrt3lHLmXDTk8Q7hX7YBynO2VBm6wkTeYP4a2rfinfhW-LtF1o3hm8QAY0hn1QKSEeWU5K5qiIOVeSJ5FqrYJ_VQPadT1qAQ
    user-agent: Java/11
    host: localhost:8090
    connection: keep-alive
    
    
    Security filter chain: [
      DisableEncodeUrlFilter
      WebAsyncManagerIntegrationFilter
      SecurityContextPersistenceFilter
      HeaderWriterFilter
      CsrfFilter
      LogoutFilter
      BearerTokenAuthenticationFilter
      RequestCacheAwareFilter
      SecurityContextHolderAwareRequestFilter
      AnonymousAuthenticationFilter
      SessionManagementFilter
      ExceptionTranslationFilter
      FilterSecurityInterceptor
    ]
    
    
    ************************************************************

## 总结 ##

到此，我们通过自己搭建的授权服务器和资源服务器，完整体验了OAuth2流程，再来体会下第一篇文章中说明的交互流程。  
![在这里插入图片描述][fed875441be24660a0a6e5730b72af44.png]

在整个流程中，我们使用的是最严密的授权码模式，它将用户引导到授权服务器进行身份验证，授权服务器将发放的访问令牌传递给客户端，目前主流都是使用该模式，**因此特别重要，要好好体会**。

![在这里插入图片描述][f63b235144994ba99c2b1620bb7586b5.png]

> 源代码地址：https://github.com/jujunchen/21Study

[OAuth2]: https://itsaysay.blog.csdn.net/article/details/126204163
[Spring Security OAuth_Gitee]: https://itsaysay.blog.csdn.net/article/details/126210758
[Spring Security OAuth_GitHub]: https://itsaysay.blog.csdn.net/article/details/126208537
[Spring Security]: https://itsaysay.blog.csdn.net/article/details/126237129
[Spring Security OAuth Client]: https://itsaysay.blog.csdn.net/article/details/126296562
[Spring Security 1]: https://itsaysay.blog.csdn.net/article/details/126326208
[OAuth2AuthorizationRequestRedirectFilter]: https://itsaysay.blog.csdn.net/article/details/126354459
[Spring Security 2]: https://itsaysay.blog.csdn.net/article/details/126397563
[http_127.0.0.1_8080_hello]: http://127.0.0.1:8080/hello
[image.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/2feab866205a4f4ca30f7d964862e726.png
[fed875441be24660a0a6e5730b72af44.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/4375e0cd7a7e42e6a2024de2fba8effd.png
[f63b235144994ba99c2b1620bb7586b5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/4cd6fc66704148e68d14c860ab984de4.png