Spring Authorization Server 使用 Redis 实现核心服务指南

幸生朋Margot

于 2025-06-08 09:15:21 发布

阅读量377

点赞数 5

本文链接：https://blog.youkuaiyun.com/gitblog_00514/article/details/148508022

版权

Spring Authorization Server 使用 Redis 实现核心服务指南

spring-authorization-server Spring Authorization Server 项目地址: https://gitcode.com/gh_mirrors/sp/spring-authorization-server

前言

在现代分布式系统中，授权服务器是安全架构的关键组件。Spring Authorization Server 提供了一套完整的 OAuth 2.0 和 OpenID Connect 实现方案。本文将详细介绍如何使用 Redis 作为持久化存储来实现 Spring Authorization Server 的核心服务。

Redis 作为存储的优势

Redis 作为内存数据库，具有以下特点使其非常适合作为授权服务器的存储后端：

高性能：授权服务器需要频繁处理令牌的生成、验证和撤销操作
数据结构丰富：支持哈希、集合等数据结构，便于存储复杂的授权信息
持久化能力：支持 RDB 和 AOF 两种持久化方式
高可用性：通过哨兵或集群模式实现高可用

核心实体模型设计

注册客户端实体 (OAuth2RegisteredClient)

这个实体对应 OAuth 2.0 中的客户端注册信息，主要包含：

public class OAuth2RegisteredClient implements Serializable {
    private String id;
    private String clientId;
    private Instant clientIdIssuedAt;
    private String clientSecret;
    private Instant clientSecretExpiresAt;
    private String clientName;
    // 其他客户端相关属性...
}

设计要点：

使用唯一 ID 作为主键
clientId 需要建立索引以便快速查找
敏感信息如 clientSecret 应加密存储

授权授权基类 (OAuth2AuthorizationGrantAuthorization)

作为所有授权类型的基类，定义了公共属性：

public abstract class OAuth2AuthorizationGrantAuthorization implements Serializable {
    private String id;
    private String registeredClientId;
    private String principalName;
    private String authorizationGrantType;
    // 其他公共属性...
}

具体授权类型实体

根据不同授权类型，我们设计了专门的实体类：

授权码授权 (OAuth2AuthorizationCodeGrantAuthorization)
- 包含授权码、重定向URI等特定属性
OpenID Connect 授权码授权 (OidcAuthorizationCodeGrantAuthorization)
- 扩展自OAuth2授权码授权
- 包含ID Token等OpenID Connect特有属性
客户端凭证授权 (OAuth2ClientCredentialsGrantAuthorization)
- 专为客户端凭证流程设计
设备码授权 (OAuth2DeviceCodeGrantAuthorization)
- 支持设备授权流程
- 包含用户码、设备码等属性
令牌交换授权 (OAuth2TokenExchangeGrantAuthorization)
- 支持令牌交换流程

用户授权同意实体 (OAuth2UserConsent)

记录用户对客户端的授权同意情况：

public class OAuth2UserConsent implements Serializable {
    @Id
    private String registeredClientId;
    @Id
    private String principalName;
    private Set<String> authorities;
    // 其他属性...
}

设计特点：

使用复合主键(客户端ID+用户主体名)
记录授予的权限范围

Spring Data Redis 仓库实现

注册客户端仓库 (OAuth2RegisteredClientRepository)

关键操作：

按ID查找
按clientId查找
保存操作

public interface OAuth2RegisteredClientRepository extends CrudRepository<OAuth2RegisteredClient, String> {
    Optional<OAuth2RegisteredClient> findByClientId(String clientId);
}

授权授权仓库 (OAuth2AuthorizationGrantAuthorizationRepository)

支持多种查询方式：

按状态查询
按授权码查询
按访问令牌查询
按刷新令牌查询等

public interface OAuth2AuthorizationGrantAuthorizationRepository extends CrudRepository<OAuth2AuthorizationGrantAuthorization, String> {
    // 多种查询方法...
}

用户授权同意仓库 (OAuth2UserConsentRepository)

关键操作：

按复合主键查询
删除操作

public interface OAuth2UserConsentRepository extends CrudRepository<OAuth2UserConsent, OAuth2UserConsent.Id> {
    void deleteByRegisteredClientIdAndPrincipalName(String registeredClientId, String principalName);
}

核心服务实现

注册客户端服务 (RedisRegisteredClientRepository)

实现要点：

使用ModelMapper进行对象转换
处理客户端密钥等敏感信息
实现客户端查找和保存逻辑

public class RedisRegisteredClientRepository implements RegisteredClientRepository {
    private final OAuth2RegisteredClientRepository registeredClientRepository;
    private final ModelMapper modelMapper;
    
    // 实现接口方法...
}

授权服务 (RedisOAuth2AuthorizationService)

关键功能：

授权信息保存
按各种令牌查找授权
授权信息更新
授权信息删除

public class RedisOAuth2AuthorizationService implements OAuth2AuthorizationService {
    private final OAuth2AuthorizationGrantAuthorizationRepository authorizationGrantAuthorizationRepository;
    private final ModelMapper modelMapper;
    
    // 实现接口方法...
}

授权同意服务 (RedisOAuth2AuthorizationConsentService)

主要职责：

保存用户授权同意
查询授权同意状态
撤销授权同意

public class RedisOAuth2AuthorizationConsentService implements OAuth2AuthorizationConsentService {
    private final OAuth2UserConsentRepository userConsentRepository;
    private final ModelMapper modelMapper;
    
    // 实现接口方法...
}

配置类实现

完整的Redis配置示例：

@Configuration
@EnableRedisRepositories(basePackages = "sample.redis.repository")
public class RedisConfig {
    
    @Bean
    public RedisConnectionFactory redisConnectionFactory() {
        // 配置Jedis连接工厂
        return new JedisConnectionFactory();
    }
    
    @Bean
    public RegisteredClientRepository registeredClientRepository(
            OAuth2RegisteredClientRepository registeredClientRepository) {
        return new RedisRegisteredClientRepository(registeredClientRepository, modelMapper());
    }
    
    // 其他服务bean配置...
    
    @Bean
    public ModelMapper modelMapper() {
        // 配置对象映射器
        ModelMapper modelMapper = new ModelMapper();
        // 添加自定义类型转换...
        return modelMapper;
    }
}

配置要点：