授权服务器框架Spring Authorization Server的过滤器链

Spring Security的模块化配置

在开始之前，我们先来回顾一下上一篇中提到OAuth2.0 Client、Resource Server、Authorization Server目前已经在Spring Security体系中模块化了。那么它们是如何做到灵活的模块化的呢？经过对配置的分析我发现了下面的几个相同点。

这是OAuth2.0 Client的核心配置类：

public final class OAuth2ClientConfigurer>
  extends AbstractHttpConfigurer, B> {
    // 省略
}

这是OAuth2.0 Resource Server的核心配置类：

public final class OAuth2ResourceServerConfigurer>
  extends AbstractHttpConfigurer, H> {
    // 省略
}

这是OAuth2.0 Authorization Server的核心配置类：

public final class OAuth2AuthorizationServerConfigurer>
  extends AbstractHttpConfigurer, H> {
    // 省略
}

它们的配置类都继承了AbstractHttpConfigurer，并最终由HttpSecurity的apply(C configurer)将这些配置加载到Spring Security中。

❝

该机制对你有什么启发？是不是可以实现一些自定义功能配置呢？

Spring Authorization Server的过滤器

❝

基于0.2.0版本。

在DEMO中Spring Authorization Server通过下面的默认配置引入授权服务器相关功能：

@Bean
@Order(Ordered.HIGHEST_PRECEDENCE)
public SecurityFilterChain authorizationServerSecurityFilterChain(HttpSecurity http) throws Exception {
    // Authorization Server 默认配置
    OAuth2AuthorizationServerConfiguration.applyDefaultSecurity(http);
    return http.formLogin(Customizer.withDefaults()).build();
}

这里会构建一个独立的SecurityFilterChain来载入授权服务器的配置，之所以会说是独立的，是因为HttpSecurity是基于原型（@Scope("prototype")）注入Spring IoC的。然后相关的请求会被该过滤器链所处理。

OAuth2AuthorizationServerConfigurer

这个类是负责配置Spring Authorization Server过滤器链SecurityFilterChain的。它负责授权服务器所有相关过滤器的配置和初始化。其中四个过滤器可以通过各自的Configurer来灵活的自定义，这里列举一下。

OAuth2ClientAuthenticationConfigurer

该配置类用来配置
OAuth2ClientAuthenticationFilter，这个过滤器用来处理OAuth2.0 Client身份验证请求，用来查询OAuth2.0 Client的注册信息
OAuth2ClientAuthenticationToken。以下三个端点都会被该过滤器拦截：

• /oauth2/token 获取令牌端点。
• /oauth2/introspect 令牌自省端点。
• /oauth2/revoke 令牌废除端点。

OAuth2AuthorizationEndpointConfigurer

该配置类用来配置
OAuth2AuthorizationEndpointFilter，这个过滤器用来处理OAuth 2.0 Authorization Code Grant授权请求/oauth2/authorize，包含用户二次确认（Consent）逻辑。

OAuth2TokenEndpointConfigurer

该配置类用来配置OAuth2TokenEndpointFilter，这个过滤器用来处理/oauth2/token端点请求，管理管理OAuth2.0 令牌的生命周期。

OidcConfigurer

该配置类用来提供对OIDC协议的支持。有两个过滤器。

• OidcClientRegistrationEndpointFilter，用来处理/connect/register端点请求，实现 OpenID Connect 1.0 动态客户端注册请求。
• OidcProviderConfigurationEndpointFilter，通过/.well-known/openid-configuration端点提供OIDC Provider的元配置信息。

❝

你可以在上一个DEMO中调用
http://localhost:9000/.well-known/openid-configuration，试试看有什么效果。

其它过滤器

除了上面几个可以通过各自的Configurer可以灵活的配置对应的过滤器外。还有一些目前不可开放配置的过滤器。

• OAuth2TokenIntrospectionEndpointFilter ，用来处理/oauth2/introspect令牌自省逻辑。
• OAuth2TokenRevocationEndpointFilter，用来处理令牌废除逻辑
• NimbusJwkSetEndpointFilter，用来处理JWK信息URI端点/oauth2/jwks的逻辑。
• OAuth2AuthorizationServerMetadataEndpointFilter，用来提供OAuth2.0授权服务器元数据访问端点/.well-known/oauth-authorization-server的逻辑。你也可以通过上一个DEMO中调用http://localhost:9000/.well-known/oauth-authorization-server来试试看有什么效果。

总结

以上就是目前Spring Authorization Server涉及的所有服务器端点，通过上一文提供的DEMO你也可以揣摩一下对应端点执行的过滤器逻辑。不过目前好像还没有用户信息UserInfo端点，根据Spring Authorization Server路线图，该端点会在下一个版本进行支持，到时候我们再进行补充。