此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Security 6.4.1! |
基本身份验证
本节详细介绍了 Spring Security 如何为基于 servlet 的应用程序提供对基本 HTTP 身份验证的支持。
本节描述了 HTTP 基本身份验证在 Spring Security 中的工作原理。 首先,我们看到 WWW-Authenticate 标头被发送回未经身份验证的客户端:
![BasicAuthenticationEntryPoint](https://docs.spring.io/spring-security/reference/6.2-SNAPSHOT/_images/servlet/authentication/unpwd/basicauthenticationentrypoint.png)
前面的图建立在我们的SecurityFilterChain
图。
首先,用户向资源发出未经身份验证的请求
/private
它未获得授权。
Spring Security 的
AuthorizationFilter
表示未经身份验证的请求被拒绝,方法是抛出AccessDeniedException
.
由于用户未经过身份验证,因此
ExceptionTranslationFilter
启动 Start Authentication。
配置的AuthenticationEntryPoint
是BasicAuthenticationEntryPoint
,它发送 WWW-Authenticate 标头。
这RequestCache
通常是NullRequestCache
这不会保存请求,因为 Client 端能够重放它最初请求的请求。
当客户端收到WWW-Authenticate
标头,它知道它应该使用用户名和密码重试。
下图显示了正在处理的用户名和密码的流程:
![basicauthenticationfilter](https://docs.spring.io/spring-security/reference/6.2-SNAPSHOT/_images/servlet/authentication/unpwd/basicauthenticationfilter.png)
前面的图建立在我们的SecurityFilterChain
图。
当用户提交其用户名和密码时,
BasicAuthenticationFilter
创建一个UsernamePasswordAuthenticationToken
,这是一种Authentication
通过从HttpServletRequest
.
接下来,
UsernamePasswordAuthenticationToken
传递到AuthenticationManager
进行身份验证。
什么的细节AuthenticationManager
看起来取决于用户信息的存储方式。
如果身份验证失败,则为 Failure。
-
RememberMeServices.loginFail
被调用。 如果未配置 Remember me,则为 no-op。 请参阅RememberMeServices
接口。 -
AuthenticationEntryPoint
以触发 WWW-Authenticate 再次发送。 请参阅AuthenticationEntryPoint
接口。
如果身份验证成功,则为 Success。
-
RememberMeServices.loginSuccess
被调用。 如果未配置 Remember me,则为 no-op。 请参阅RememberMeServices
接口。 -
这
BasicAuthenticationFilter
调用FilterChain.doFilter(request,response)
以继续执行 Application Logic 的其余部分。 请参阅BasicAuthenticationFilter
Javadoc 中的 Class
默认情况下,Spring Security 的 HTTP 基本身份验证支持处于启用状态。 但是,一旦提供了任何基于 servlet 的配置,就必须显式提供 HTTP Basic。
以下示例显示了一个最小的显式配置:
-
Java
-
XML
-
Kotlin
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) {
http
// ...
.httpBasic(withDefaults());
return http.build();
}
<http>
<!-- ... -->
<http-basic />
</http>
@Bean
open fun filterChain(http: HttpSecurity): SecurityFilterChain {
http {
// ...
httpBasic { }
}
return http.build()
}