Spring Authorization Server 扩展授权类型实现指南

最新推荐文章于 2025-06-08 09:15:21 发布

邱寒望Half-Dane

最新推荐文章于 2025-06-08 09:15:21 发布

阅读量223

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00451/article/details/148508019

Spring Authorization Server 扩展授权类型实现指南

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

前言

在现代OAuth 2.0授权框架中，标准的授权类型（如授权码模式、密码模式等）已经能够满足大多数场景需求。然而，某些特殊业务场景可能需要自定义授权类型。本文将详细介绍如何在Spring Authorization Server项目中实现自定义授权类型扩展。

核心概念理解

在开始实现前，我们需要明确几个关键概念：

授权类型(Grant Type)：OAuth 2.0中定义客户端获取访问令牌的方式
认证转换器(AuthenticationConverter)：负责将HTTP请求转换为认证对象
认证提供者(AuthenticationProvider)：负责验证认证对象并颁发令牌

实现步骤详解

1. 设计自定义授权类型

假设我们需要实现一个名为"custom_code"的授权类型，其URI为： urn:ietf:params:oauth:grant-type:custom_code

该授权类型将通过code参数传递授权凭证。

2. 实现认证转换器

认证转换器负责从HTTP请求中提取认证信息：

public class CustomCodeGrantAuthenticationConverter implements AuthenticationConverter {
    
    @Override
    public Authentication convert(HttpServletRequest request) {
        // 1. 检查grant_type参数
        String grantType = request.getParameter(OAuth2ParameterNames.GRANT_TYPE);
        if (!"urn:ietf:params:oauth:grant-type:custom_code".equals(grantType)) {
            return null; // 不处理其他授权类型
        }
        
        // 2. 获取客户端认证信息
        Authentication clientPrincipal = SecurityContextHolder.getContext().getAuthentication();
        
        // 3. 提取code参数
        String code = request.getParameter("code");
        if (StringUtils.isEmpty(code)) {
            throw new OAuth2AuthenticationException(OAuth2ErrorCodes.INVALID_REQUEST);
        }
        
        // 4. 构建认证令牌
        return new CustomCodeGrantAuthenticationToken(code, clientPrincipal);
    }
}

关键点说明：

必须首先验证grant_type参数
需要处理客户端认证信息
对必要参数进行非空校验
返回自定义的认证令牌对象

3. 实现认证提供者

认证提供者是核心业务逻辑所在：

public class CustomCodeGrantAuthenticationProvider implements AuthenticationProvider {
    
    private final OAuth2TokenGenerator<? extends OAuth2Token> tokenGenerator;
    private final OAuth2AuthorizationService authorizationService;
    
    // 依赖注入省略...
    
    @Override
    public Authentication authenticate(Authentication authentication) {
        CustomCodeGrantAuthenticationToken customCodeGrant = 
            (CustomCodeGrantAuthenticationToken) authentication;
        
        // 1. 验证客户端
        if (customCodeGrant.getPrincipal() == null) {
            throw new OAuth2AuthenticationException(OAuth2ErrorCodes.INVALID_CLIENT);
        }
        
        // 2. 验证自定义code
        if (!validateCustomCode(customCodeGrant.getCode())) {
            throw new OAuth2AuthenticationException(OAuth2ErrorCodes.INVALID_GRANT);
        }
        
        // 3. 构建令牌
        OAuth2TokenContext tokenContext = createTokenContext(customCodeGrant);
        OAuth2Token generatedToken = this.tokenGenerator.generate(tokenContext);
        
        // 4. 返回认证结果
        return new OAuth2AccessTokenAuthenticationToken(
            customCodeGrant.getPrincipal(),
            customCodeGrant,
            generatedToken);
    }
    
    private boolean validateCustomCode(String code) {
        // 实现自定义code验证逻辑
        return true;
    }
}

业务逻辑说明：

必须验证客户端身份
实现自定义授权码验证逻辑
使用令牌生成器创建访问令牌
返回包含令牌的认证结果

4. 配置令牌端点

最后需要在安全配置中注册上述组件：

@Configuration
public class SecurityConfig {
    
    @Bean
    @Order(Ordered.HIGHEST_PRECEDENCE)
    public SecurityFilterChain authServerSecurityFilterChain(HttpSecurity http) throws Exception {
        OAuth2AuthorizationServerConfigurer configurer = 
            new OAuth2AuthorizationServerConfigurer();
            
        // 配置令牌端点
        configurer.tokenEndpoint(tokenEndpoint -> 
            tokenEndpoint
                .accessTokenRequestConverter(new CustomCodeGrantAuthenticationConverter())
                .authenticationProvider(new CustomCodeGrantAuthenticationProvider()));
                
        http.apply(configurer);
        
        return http.build();
    }
}

配置要点：

确保安全过滤器链具有最高优先级
使用OAuth2AuthorizationServerConfigurer进行配置
注册自定义的认证转换器和提供者

测试自定义授权类型

完成实现后，可以通过以下方式测试：

POST /oauth2/token HTTP/1.1
Authorization: Basic bWVzc2FnaW5nLWNsaWVudDpzZWNyZXQ=
Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:custom_code&code=7QR49T1W3