松哥原创的 Spring Boot 视频教程已经杀青，感兴趣的小伙伴戳这里-->Spring Boot+Vue+微人事视频教程java
我们继续来撸 Spring Security 源码。web
前面和你们分享了 SecurityBuilder 以及它的一个重要实现 HttpSecurity，在 SecurityBuilder 的实现类里边，还有一个重要的分支，那就是 AuthenticationManagerBuilder，AuthenticationManagerBuilder 看名字就知道是用来构建 AuthenticationManager 的，因此今天咱们就来看一看 AuthenticationManager 究竟是怎么构建的。缓存
1.初步理解
在 Spring Security 中，用来处理身份认证的类是 AuthenticationManager，咱们也称之为认证管理器。微信
AuthenticationManager 中规范了 Spring Security 的过滤器要如何执行身份认证，并在身份认证成功后返回一个通过认证的 Authentication 对象。AuthenticationManager 是一个接口，咱们能够自定义它的实现，可是一般咱们使用更多的是系统提供的 ProviderManager。架构
1.1 ProviderManager
ProviderManager 是的最经常使用的 AuthenticationManager 实现类。app
ProviderManager 管理了一个 AuthenticationProvider 列表，每一个 AuthenticationProvider 都是一个认证器，不一样的 AuthenticationProvider 用来处理不一样的 Authentication 对象的认证。一次完整的身份认证流程可能会通过多个 AuthenticationProvider。编辑器
ProviderManager 至关于代理了多个 AuthenticationProvider，他们的关系以下图：ide
1.2 AuthenticationProvider
AuthenticationProvider 定义了 Spring Security 中的验证逻辑，咱们来看下 AuthenticationProvider 的定义：工具
public interface AuthenticationProvider {
Authentication authenticate(Authentication authentication)
throws AuthenticationException;
boolean supports(Class<?> authentication);
}
能够看到，AuthenticationProvider 中就两个方法：源码分析
-
authenticate 方法用来作验证，就是验证用户身份。 -
supports 则用来判断当前的 AuthenticationProvider 是否支持对应的 Authentication。
在一次完整的认证中，可能包含多个 AuthenticationProvider，而这多个 AuthenticationProvider 则由 ProviderManager 进行统一管理，具体能够参考松哥以前的文章：松哥手把手带你捋一遍 Spring Security 登陆流程。
最经常使用的 AuthenticationProvider 实现类是 DaoAuthenticationProvider。
1.3 Parent
每个 ProviderManager 管理多个 AuthenticationProvider，同时每个 ProviderManager 均可以配置一个 parent，若是当前的 ProviderManager 中认证失败了，还能够去它的 parent 中继续执行认证，所谓的 parent 实例，通常也是 ProviderManager，也就是 ProviderManager 的 parent 仍是 ProviderManager。能够参考以下架构图：
从上面的分析中你们能够看出，AuthenticationManager 的初始化会分为两块，一个全局的 AuthenticationManager，也就是 parent，另外一个则是局部的 AuthenticationManager。先给你们一个结论，一个系统中，咱们能够配置多个 HttpSecurity（参见Spring Security 居然能够同时存在多个过滤器链？），而每个 HttpSecurity 都有一个对应的 AuthenticationManager 实例（局部 AuthenticationManager），这些局部的 AuthenticationManager 实例都有一个共同的 parent，那就是全局的 AuthenticationManager。
接下来，咱们经过源码分析来验证咱们上面的结论。
本文内容和上篇文章紧密相关，若是你们还没看过上篇源码分析文章，必定点击超连接先看下。
2.源码分析
在上篇文章中，松哥已经和你们分析了 SecurityBuilder 的几个常见实现类 AbstractSecurityBuilder、AbstractConfiguredSecurityBuilder、HttpSecurityBuilder，本文关于这几个类我就不重复介绍了。
咱们直接来看 AuthenticationManagerBuilder，先来看它的一个继承关系：
能够看到，【上篇文章】中介绍的所有都是 AuthenticationManagerBuilder 的父类，因此 AuthenticationManagerBuilder 已经自动具有了其父类的功能。
AuthenticationManagerBuilder 的源码比较长，咱们来看几个关键的方法：
public class AuthenticationManagerBuilder
extends
AbstractConfiguredSecurityBuilder<AuthenticationManager, AuthenticationManagerBuilder>
implements ProviderManagerBuilder<AuthenticationManagerBuilder> {
public AuthenticationManagerBuilder(ObjectPostProcessor<Object> objectPostProcessor) {
super(objectPostProcessor, true);
}
public AuthenticationManagerBuilder parentAuthenticationManager(
AuthenticationManager authenticationManager) {
if (authenticationManager instanceof ProviderManager) {
eraseCredentials(((ProviderManager) authenticationManager)
.isEraseCredentialsAfterAuthentication());
}
this.parentAuthenticationManager = authenticationManager;
return this;
}
public InMemoryUserDetailsManagerConfigurer<AuthenticationManagerBuilder> inMemoryAuthentication()
throws Exception {
return apply(new InMemoryUserDetailsManagerConfigurer<>());
}
public JdbcUserDetailsManagerConfigurer<AuthenticationManagerBuilder> jdbcAuthentication()
throws Exception {
return apply(new JdbcUserDetailsManagerConfigurer<>());
}
public <T extends UserDetailsService> DaoAuthenticationConfigurer<AuthenticationManagerBuilder, T> userDetailsService(
T userDetailsService) throws Exception {
this.defaultUserDetailsService = userDetailsService;
return apply(new DaoAuthenticationConfigurer<>(
userDetailsService));
}
@Override
protected ProviderManager performBuild() throws Exception {
if (!isConfigured()) {
logger.debug("No authenticationProviders and no parentAuthenticationManager defined. Returning null.");
return null;
}
ProviderManager providerManager = new ProviderManager(authenticationProviders,
parentAuthenticationManager);
if (eraseCredentials != null) {
providerManager.setEraseCredentialsAfterAuthentication(eraseCredentials);
}
if (eventPublisher != null) {
providerManager.setAuthenticationEventPublisher(eventPublisher);
}
providerManager = postProcess(providerManager);
return providerManager;
}
}
-
首先，咱们能够经过调用 parentAuthenticationManager 方法来给一个 AuthenticationManager 设置 parent。 -
inMemoryAuthentication、jdbcAuthentication 以及 userDetailsService 几个方法松哥在以前的文章中都已经介绍过了（ 深刻理解 SecurityConfigurer 【源码篇】），做用就是为了配置数据源，这里就再也不赘述。 -
最后就是 performBuild 方法，这个方法的做用就是根据当前 AuthenticationManagerBuilder 来构建一个 AuthenticationManager 出来，AuthenticationManager 自己是一个接口，它的默认实现是 ProviderManager，因此这里构建的就是 ProviderManager。在构建 ProviderManager 时，一方面传入 authenticationProviders，就是该 ProviderManager 所管理的全部的 AuthenticationProvider，另外一方面传入 ProviderManager 的 parent（其实也是一个 ProviderManager）。
总体来讲，这段代码仍是很好理解的，松哥在以前的文章中和你们介绍过 Spring Security 整合多个数据源，那个时候咱们本身配置 ProviderManager，跟这里的方式相似，具体能够参考：Spring Security 能够同时对接多个用户表？。
不过本身配置有一个问题就是咱们没有配置 ProviderManager 的 parent，没有配置的话，若是当前 ProviderManager 中认证失败的话，就直接抛出失败，而不会去 parent 中再次进行认证了（通常来讲也不须要，若是系统比较复杂的话，可能须要）。
AuthenticationManagerBuilder 还有一个实现类叫作 DefaultPasswordEncoderAuthenticationManagerBuilder，做为内部类分别定义在 WebSecurityConfigurerAdapter 和 AuthenticationConfiguration 中，不过 DefaultPasswordEncoderAuthenticationManagerBuilder 的内容比较简单，重写了父类 AuthenticationManagerBuilder 的几个方法，配置了新的 PasswordEncoder，无他，因此这里我就不列出这个的源码了，感兴趣的小伙伴能够自行查看。可是这并非说 DefaultPasswordEncoderAuthenticationManagerBuilder 就不重要了，由于在后面的使用中，基本上都是使用 DefaultPasswordEncoderAuthenticationManagerBuilder 来构建 AuthenticationManagerBuilder。
好啦，这就是 AuthenticationManagerBuilder。
那么是何时经过 AuthenticationManagerBuilder 来构建 AuthenticationManager 的呢？
这就涉及到咱们的老熟人 WebSecurityConfigurerAdapter 了。固然，关于 WebSecurityConfigurerAdapter 自己的初始化过程，松哥在后面会专门写文章介绍，今天咱们主要来看下如何在 WebSecurityConfigurerAdapter 中开启 AuthenticationManager 的初始化的。
2.1 初始化流程
在初始化流程中，松哥得先和你们介绍一个 AuthenticationConfiguration 类。这个类你们能够看成是一个全局被配类来理解，里边都是一些全局属性的配置：
@Configuration(proxyBeanMethods = false)
@Import(ObjectPostProcessorConfiguration.class)
public class AuthenticationConfiguration {
@Bean
public AuthenticationManagerBuilder authenticationManagerBuilder(
ObjectPostProcessor<Object> objectPostProcessor, ApplicationContext context) {
LazyPasswordEncoder defaultPasswordEncoder = new LazyPasswordEncoder(context);
AuthenticationEventPublisher authenticationEventPublisher = getBeanOrNull(context, AuthenticationEventPublisher.class);
DefaultPasswordEncoderAuthenticationManagerBuilder result = new DefaultPasswordEncoderAuthenticationManagerBuilder(objectPostProcessor, defaultPasswordEncoder);
if (authenticationEventPublisher != null) {
result.authenticationEventPublisher(authenticationEventPublisher);
}
return result;
}
@Bean
public static GlobalAuthenticationConfigurerAdapter enableGlobalAuthenticationAutowiredConfigurer(
ApplicationContext context) {
return new EnableGlobalAuthenticationAutowiredConfigurer(context);
}
@Bean
public static InitializeUserDetailsBeanManagerConfigurer initializeUserDetailsBeanManagerConfigurer(ApplicationContext context) {
return new InitializeUserDetailsBeanManagerConfigurer(context);
}
@Bean
public static InitializeAuthenticationProviderBeanManagerConfigurer initializeAuthenticationProviderBeanManagerConfigurer(ApplicationContext context) {
return new InitializeAuthenticationProviderBeanManagerConfigurer(context);
}
public AuthenticationManager getAuthenticationManager() throws Exception {
if (this.authenticationManagerInitialized) {
return this.authenticationManager;
}
AuthenticationManagerBuilder authBuilder = this.applicationContext.getBean(AuthenticationManagerBuilder.class);
if (this.buildingAuthenticationManager.getAndSet(true)) {
return new AuthenticationManagerDelegator(authBuilder);
}
for (GlobalAuthenticationConfigurerAdapter config : globalAuthConfigurers) {
authBuilder.apply(config);
}
authenticationManager = authBuilder.build();
if (authenticationManager == null) {
authenticationManager = getAuthenticationManagerBean();
}
this.authenticationManagerInitialized = true;
return authenticationManager;
}
@Autowired
public void setApplicationContext(ApplicationContext applicationContext) {
this.applicationContext = applicationContext;
}
@Autowired
public void setObjectPostProcessor(ObjectPostProcessor<Object> objectPostProcessor) {
this.objectPostProcessor = objectPostProcessor;
}
private static class EnableGlobalAuthenticationAutowiredConfigurer extends
GlobalAuthenticationConfigurerAdapter {
private final ApplicationContext context;
private static final Log logger = LogFactory
.getLog(EnableGlobalAuthenticationAutowiredConfigurer.class);
EnableGlobalAuthenticationAutowiredConfigurer(ApplicationContext context) {
this.context = context;
}
@Override
public void init(AuthenticationManagerBuilder auth) {
Map<String, Object> beansWithAnnotation = context
.getBeansWithAnnotation(EnableGlobalAuthentication.class);
if (logger.isDebugEnabled()) {
logger.debug("Eagerly initializing " + beansWithAnnotation);
}
}
}
}
-
这里首先构建了一个 AuthenticationManagerBuilder 实例，这个实例就是用来构建全局 AuthenticationManager 的 AuthenticationManagerBuilder，具体的构建过程在下面的 getAuthenticationManager 方法中。不过这里的这个全局的 AuthenticationManagerBuilder 并不是老是有用，为何这么说呢？且看松哥下面的的分析。 -
另外还有一些 initializeXXX 方法，用来构建全局的 UserDetailService 和 AuthenticationProvider，这些方法小伙伴能够做为一个了解，由于正常状况下是不会用到这几个 Bean 的，只有当 getAuthenticationManager 方法被调用时，这些默认的 Bean 才会被配置，而 getAuthenticationManager 方法被调用，意味着咱们要使用系统默认配置的 AuthenticationManager 做为 parent，而在实际使用中，咱们通常不会使用系统默认配置的 AuthenticationManager 做为 parent，咱们本身多多少少都会从新定制一下。
这就是 AuthenticationConfiguration 的主要功能，它主要是提供了一些全局的 Bean，这些全局的 Bean 虽然必定会初始化，可是并不是必定用到。
那么到底何时用到，何时用不到，这就和 WebSecurityConfigurerAdapter 有关了，在 WebSecurityConfigurerAdapter 中有三个重要的方法涉及到 AuthenticationManager 的初始化问题，第一个是 setApplicationContext 方法：
public void setApplicationContext(ApplicationContext context) {
this.context = context;
ObjectPostProcessor<Object> objectPostProcessor = context.getBean(ObjectPostProcessor.class);
LazyPasswordEncoder passwordEncoder = new LazyPasswordEncoder(context);
authenticationBuilder = new DefaultPasswordEncoderAuthenticationManagerBuilder(objectPostProcessor, passwordEncoder);
localConfigureAuthenticationBldr = new DefaultPasswordEncoderAuthenticationManagerBuilder(objectPostProcessor, passwordEncoder) {
@Override
public AuthenticationManagerBuilder eraseCredentials(boolean eraseCredentials) {
authenticationBuilder.eraseCredentials(eraseCredentials);
return super.eraseCredentials(eraseCredentials);
}
@Override
public AuthenticationManagerBuilder authenticationEventPublisher(AuthenticationEventPublisher eventPublisher) {
authenticationBuilder.authenticationEventPublisher(eventPublisher);
return super.authenticationEventPublisher(eventPublisher);
}
};
}
在该方法中，建立了两个几乎一摸同样的 AuthenticationManagerBuilder 实例，为何会有两个呢？第一个 authenticationBuilder 是一个局部的 AuthenticationManagerBuilder，未来会传入 HttpSecurity 中去构建局部的 AuthenticationManager；第二个 localConfigureAuthenticationBldr 则是一个用来构建全局 AuthenticationManager 的 AuthenticationManagerBuilder。
有小伙伴会问了，构建全局的 AuthenticationManager 不是一开始就在 AuthenticationConfiguration 中建立了吗？为何这里还有一个？是的，当前这个 localConfigureAuthenticationBldr 是能够禁用的，若是禁用了，就会使用 AuthenticationConfiguration 中提供的 AuthenticationManagerBuilder，若是没禁用，就使用 localConfigureAuthenticationBldr 来构建全局的 AuthenticationManager。
另外一个方法则是 getHttp 方法：
protected final HttpSecurity getHttp() throws Exception {
if (http != null) {
return http;
}
AuthenticationEventPublisher eventPublisher = getAuthenticationEventPublisher();
localConfigureAuthenticationBldr.authenticationEventPublisher(eventPublisher);
AuthenticationManager authenticationManager = authenticationManager();
authenticationBuilder.parentAuthenticationManager(authenticationManager);
Map<Class<?>, Object> sharedObjects = createSharedObjects();
http = new HttpSecurity(objectPostProcessor, authenticationBuilder,
sharedObjects);
//省略
return http;
}
在 getHttp 方法中，会首先调用 authenticationManager 方法去获取一个全局的 AuthenticationManager，并设置给 authenticationBuilder 做为 parent，而后在构建 HttpSecurity 时将 authenticationBuilder 传入进去。
那么接下来就是 authenticationManager() 方法究竟是怎么执行的了：
protected AuthenticationManager authenticationManager() throws Exception {
if (!authenticationManagerInitialized) {
configure(localConfigureAuthenticationBldr);
if (disableLocalConfigureAuthenticationBldr) {
authenticationManager = authenticationConfiguration
.getAuthenticationManager();
}
else {
authenticationManager = localConfigureAuthenticationBldr.build();
}
authenticationManagerInitialized = true;
}
return authenticationManager;
}
protected void configure(AuthenticationManagerBuilder auth) throws Exception {
this.disableLocalConfigureAuthenticationBldr = true;
}
能够看到，若是 AuthenticationManager 还没初始化，那就先进行初始化。初始化首先调用 configure 方法，默认状况下，configure 方法里边会把 disableLocalConfigureAuthenticationBldr 变量设置为 true，这样接下来就会进入到 if 分支中了。这个 configure 方法不知道你们有没有以为眼熟？咱们在自定义的 SecurityConfig 配置类中，通常都是要重写该方法的，一旦重写了这个方法，那么 disableLocalConfigureAuthenticationBldr 变量就不会变为 true，依然是 false，这样在获取 authenticationManager 的时候就会进入到 else 分支中。
若是进入到 if 分支中，意味着开发者并无重写 configure 方法，AuthenticationManagerBuilder 就使用默认的，你们能够看到，此时就是调用 authenticationConfiguration.getAuthenticationManager() 方法去获取 AuthenticationManager，也就是一开始咱们说的那个全局的配置。
若是开发者重写了 configure 方法，意味着开发者对 AuthenticationManagerBuilder 进行了一些定制，此时就不能继续使用 AuthenticationConfiguration 中配置的默认的的 AuthenticationManager 了，而要根据开发者 的具体配置，调用 localConfigureAuthenticationBldr.build 方法去构建新的 AuthenticationManager。
一言以蔽之，AuthenticationConfiguration 中的配置有没有用上，全看开发者有没有重写 configure(AuthenticationManagerBuilder auth) 方法，重写了，就用 localConfigureAuthenticationBldr 来构建 parent 级别的 AuthenticationManager，没重写，就用 AuthenticationConfiguration 中的方法来构建。
这是扮演 parent 角色的 AuthenticationManager 的构建过程，固然，parent 并不是必须，若是你没有这个需求的话，也能够不配置 parent。
最后咱们再来看下局部的 AuthenticationManager 是如何构建的，也就是和 HttpSecurity 绑定的那个 AuthenticationManager。
根据前面的介绍，HttpSecurity 在构建的时候就会传入 AuthenticationManagerBuilder，以下：
public HttpSecurity(ObjectPostProcessor<Object> objectPostProcessor,
AuthenticationManagerBuilder authenticationBuilder,
Map<Class<?>, Object> sharedObjects) {
super(objectPostProcessor);
Assert.notNull(authenticationBuilder, "authenticationBuilder cannot be null");
setSharedObject(AuthenticationManagerBuilder.class, authenticationBuilder);
//省略
}
传入进来的 AuthenticationManagerBuilder ，二话不说就存到 SharedObject 里边去了，这个根据官方的注释，说它是一个在不一样 Configurer 中共享的对象的工具，其实你能够理解为一个缓存，如今存进去，须要的时候再取出来。
取出来的方法，在 HttpSecurity 中也定义好了，以下：
private AuthenticationManagerBuilder getAuthenticationRegistry() {
return getSharedObject(AuthenticationManagerBuilder.class);
}
在 HttpSecurity 中，凡是涉及到 AuthenticationManager 配置的，都会调用到 getAuthenticationRegistry 方法，以下：
public HttpSecurity userDetailsService(UserDetailsService userDetailsService)
throws Exception {
getAuthenticationRegistry().userDetailsService(userDetailsService);
return this;
}
public HttpSecurity authenticationProvider(
AuthenticationProvider authenticationProvider) {
getAuthenticationRegistry().authenticationProvider(authenticationProvider);
return this;
}
最后在 HttpSecurity 的 beforeConfigure 方法中完成构建：
@Override
protected void beforeConfigure() throws Exception {
setSharedObject(AuthenticationManager.class, getAuthenticationRegistry().build());
}
至此，不管是全局的 AuthenticationManager，仍是局部的 AuthenticationManager，就都和你们捋一遍了。
3.小结
有的小伙伴可能对这里的全局、局部不是特别理解，我再给你们稍微总结一下。
为何每个 HttpSecurity 都要绑定一个 AuthenticationManager？
由于在同一个系统中，咱们能够回配置多个 HttpSecurity，也就是多个不一样的过滤器链（参见Spring Security 居然能够同时存在多个过滤器链？一文），既然有多个过滤器链，每个请求到来的时候，它须要进入到某一个过滤器链中去处理，每个过滤器链中又会涉及到 AuthenticationProvider 的管理，不一样过滤器链中的 AuthenticationProvider 确定是各自管理最为合适，也就是不一样的过滤器链中都有一个绑定的 AuthenticationManager，即每个 HttpSecurity 都要绑定一个 AuthenticationManager。
本文略有难度，可能有点绕，有没看懂的地方，欢迎你们留言讨论。
若是小伙伴们以为有收获，记得点个在看鼓励下松哥哦～
今日干货
公众号后台回复 2TB，免费获取 2TB Java 学习资料。
本文分享自微信公众号 - 江南一点雨（a_javaboy）。
若有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一块儿分享。