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

Spring Security的模块化配置

在开始之前,我们先来回顾一下上一篇中提到OAuth2.0 ClientResource ServerAuthorization 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路线图,该端点会在下一个版本进行支持,到时候我们再进行补充。

你可能感兴趣的:(授权服务器框架Spring Authorization Server的过滤器链)