此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Security 6.4.1spring-doc.cadn.net.cn

OAuth 2.0 资源服务器持有者令牌

Bearer Token 解析

默认情况下,Resource Server 在Authorization页眉。 但是,您可以验证此令牌。spring-doc.cadn.net.cn

例如,您可能需要从自定义标头中读取不记名令牌。 为此,您可以将ServerBearerTokenAuthenticationConverter到 DSL 中:spring-doc.cadn.net.cn

自定义 Bearer Token 标头
ServerBearerTokenAuthenticationConverter converter = new ServerBearerTokenAuthenticationConverter();
converter.setBearerTokenHeaderName(HttpHeaders.PROXY_AUTHORIZATION);
http
    .oauth2ResourceServer(oauth2 -> oauth2
        .bearerTokenConverter(converter)
    );
val converter = ServerBearerTokenAuthenticationConverter()
converter.setBearerTokenHeaderName(HttpHeaders.PROXY_AUTHORIZATION)
return http {
    oauth2ResourceServer {
        bearerTokenConverter = converter
    }
}

Bearer Token 传播

现在,您有了不记名令牌,可以将其传递给下游服务。 这可以通过ServerBearerExchangeFilterFunction:spring-doc.cadn.net.cn

@Bean
public WebClient rest() {
    return WebClient.builder()
            .filter(new ServerBearerExchangeFilterFunction())
            .build();
}
@Bean
fun rest(): WebClient {
    return WebClient.builder()
            .filter(ServerBearerExchangeFilterFunction())
            .build()
}

WebClient如前面的示例执行请求,Spring Security 会查找当前的Authentication并提取任何AbstractOAuth2Token凭据。 然后,它会在Authorizationheader — 例如:spring-doc.cadn.net.cn

this.rest.get()
        .uri("https://other-service.example.com/endpoint")
        .retrieve()
        .bodyToMono(String.class)
this.rest.get()
        .uri("https://other-service.example.com/endpoint")
        .retrieve()
        .bodyToMono<String>()

前面的示例调用other-service.example.com/endpoint,添加 Bearer TokenAuthorization标头。spring-doc.cadn.net.cn

在需要覆盖此行为的地方,您可以自己提供 header:spring-doc.cadn.net.cn

this.rest.get()
        .uri("https://other-service.example.com/endpoint")
        .headers(headers -> headers.setBearerAuth(overridingToken))
        .retrieve()
        .bodyToMono(String.class)
rest.get()
        .uri("https://other-service.example.com/endpoint")
        .headers { it.setBearerAuth(overridingToken) }
        .retrieve()
        .bodyToMono<String>()

在这种情况下,筛选条件会回退并将请求转发到 Web 筛选条件链的其余部分。spring-doc.cadn.net.cn

OAuth 2.0 客户端筛选器函数不同,如果令牌过期,此筛选器函数不会尝试续订令牌。spring-doc.cadn.net.cn