背景

  • Spring 团队正式宣布 Spring Security OAuth 停止维护,该项目将不会再进行任何的迭代

Spring全新OAuth解决方案 - 图1

  • 目前 Spring 生态中的 OAuth2 授权服务器是 Spring Authorization Server 已经可以正式生产使用
  • 作为 SpringBoot 3.0 的过渡版本 SpringBoot 2.7.0 过期了大量关于 SpringSecurity 的配置类,如沿用旧版本过期配置无法向上升级。

    迁移过程

    ① Java 1.8 支持

    目前最新的 SAS 0.3 基于 Java 11 构建,低版本 Java 无法使用
    经过和 Spring Security 官方团队的沟通 0.3.1 将继续兼容 Java 1.8
    Spring全新OAuth解决方案 - 图2
    我们联合 springboot 中文社区编译了适配 java 1.8 的版本坐标如下
    1. <dependency>
    2. <groupId>io.springboot.security</groupId>
    3. <artifactId>spring-security-oauth2-authorization-server</artifactId>
    4. <version>0.3.0</version>
    5. </dependency>

② 授权模式扩展

Spring全新OAuth解决方案 - 图3

  • 扩展支持密码模式,SAS 基于 oauth 2.1 协议不支持密码模式
  • 扩展支持短信登录

    ③ Redis 令牌存储

    Spring全新OAuth解决方案 - 图4
    支持Redis存储 令牌

  • 官方目前没有提供基于 Redis 令牌持久化方案

  • PIG 扩展 PigRedisOAuth2AuthorizationService 支持

    ④ Token 输出格式化

  • 使用自省令牌的情况下 默认实现为

    1. ku4R4n7YD1f584KXj4k_3GP9o-HbdY-PDIIh-twPVJTmvHa5mLIoifaNhbBvFNBbse6_wAMcRoOWuVs9qeBWpxQ5zIFrF1A4g1Q7LhVAfH1vo9Uc7WL3SP3u82j0XU5x

Spring全新OAuth解决方案 - 图5
默认实现

  • 为方便结合 redis 高效检索 token ,结合 RDM 分组也可以更方便的图形化观察
    1. 统一前缀::令牌类型::客户端ID::用户名::uuid
  1. @Bean
  2. public OAuth2TokenGenerator oAuth2TokenGenerator() {
  3. CustomeOAuth2AccessTokenGenerator accessTokenGenerator = new CustomeOAuth2AccessTokenGenerator();
  4. // 注入Token 增加关联用户信息
  5. accessTokenGenerator.setAccessTokenCustomizer(new CustomeOAuth2TokenCustomizer());
  6. return new DelegatingOAuth2TokenGenerator(accessTokenGenerator, new OAuth2RefreshTokenGenerator());
  7. }

⑤ Token 输出增强

  • 使用自省令牌,默认情况下输出的 Token 格式
    1. {
    2. "access_token": "xx",
    3. "refresh_token": "xx",
    4. "scope": "server",
    5. "token_type": "Bearer",
    6. "expires_in": 43199
    7. }
  • Token 增强输出关联用户信息
    1. {
    2. "sub": "admin",
    3. "clientId": "test",
    4. "access_token": "xx",
    5. "refresh_token": "xx",
    6. "license": "https://pig4cloud.com",
    7. "user_info": {
    8. "username": "admin",
    9. "accountNonExpired": true,
    10. "accountNonLocked": true,
    11. "credentialsNonExpired": true,
    12. "enabled": true,
    13. "id": 1,
    14. "deptId": 1,
    15. "phone": "17034642999",
    16. "name": "admin",
    17. "attributes": {}
    18. }
    19. }

⑥ 授权码模式个性化

Spring全新OAuth解决方案 - 图6
注入自定义confirm
Spring全新OAuth解决方案 - 图7
基于授权码的开发平台

⑦ 资源服务器

  • 自省方案扩展支持资源资源服务器本地查询

Spring全新OAuth解决方案 - 图8
默认的资源服务器自省模式

  • 扩展资源服务器本地自省

Spring全新OAuth解决方案 - 图9
扩展资源服务器本地自省
- 优势:1. 用户状态实时更新 2. 减少网络调用提升性能

参考资料

[1]
PIG 微服务: https://github.com/pig-mesh/pig