667 lines
17 KiB
Markdown
667 lines
17 KiB
Markdown
|
||
|
||
因收到Google相关通知，网站将会择期关闭。相关通知内容
|
||
|
||
|
||
03 认证体系：如何深入理解 Spring Security 用户认证机制？
|
||
上一讲，我们给出了 Spring Security 中实现用户认证的系统方法，可以发现整个实现过程还是比较简单的，开发人员只需要通过一些配置方法就能完成复杂的处理逻辑。这种简单性得益于 Spring Security 对用户认证过程的提炼和抽象。今天我们就围绕这个话题展开讨论，继续探究 Spring Security 中的用户和认证对象，以及如何基于这些对象完成定制化的用户认证方案。
|
||
|
||
Spring Security 中的用户和认证
|
||
|
||
Spring Security 中的认证过程由一组核心对象组成，大致可以分成两大类，一类是用户对象，一类是认证对象，下面我们来具体了解一下。
|
||
|
||
Spring Security 中的用户对象
|
||
|
||
Spring Security 中的用户对象用来描述用户并完成对用户信息的管理，涉及UserDetails、GrantedAuthority、UserDetailsService 和 UserDetailsManager这四个核心对象。
|
||
|
||
|
||
UserDetails：描述 Spring Security 中的用户。
|
||
GrantedAuthority：定义用户的操作权限。
|
||
UserDetailsService：定义了对 UserDetails 的查询操作。
|
||
UserDetailsManager：扩展 UserDetailsService，添加了创建用户、修改用户密码等功能。
|
||
|
||
|
||
这四个对象之间的关联关系如下图所示，显然，对于由 UserDetails 对象所描述的一个用户而言，它应该具有 1 个或多个能够执行的 GrantedAuthority：
|
||
|
||
|
||
|
||
Spring Security 中的四大核心用户对象
|
||
|
||
结合上图，我们先来看承载用户详细信息的 UserDetails 接口，如下所示：
|
||
|
||
public interface UserDetails extends Serializable {
|
||
|
||
|
||
|
||
//获取该用户的权限信息
|
||
|
||
Collection<? extends GrantedAuthority> getAuthorities();
|
||
|
||
|
||
|
||
//获取密码
|
||
|
||
String getPassword();
|
||
|
||
|
||
|
||
//获取用户名
|
||
|
||
String getUsername();
|
||
|
||
|
||
|
||
//判断该账户是否已失效
|
||
|
||
boolean isAccountNonExpired();
|
||
|
||
|
||
|
||
//判断该账户是否已被锁定
|
||
|
||
boolean isAccountNonLocked();
|
||
|
||
|
||
|
||
//判断该账户的凭证信息是否已失效
|
||
|
||
boolean isCredentialsNonExpired();
|
||
|
||
|
||
|
||
//判断该用户是否可用
|
||
|
||
boolean isEnabled();
|
||
|
||
}
|
||
|
||
|
||
通过 UserDetails，我们可以获取用户相关的基础信息，并判断其当前状态。同时，我们也可以看到 UserDetails 中保存着一组 GrantedAuthority 对象。而 GrantedAuthority 指定了一个方法用来获取权限信息，如下所示：
|
||
|
||
public interface GrantedAuthority extends Serializable {
|
||
|
||
//获取权限信息
|
||
|
||
String getAuthority();
|
||
|
||
}
|
||
|
||
|
||
UserDetails 存在一个子接口 MutableUserDetails，从命名上不难看出后者是一个可变的 UserDetails，而可变的内容就是密码。MutableUserDetails 接口的定义如下所示：
|
||
|
||
interface MutableUserDetails extends UserDetails {
|
||
|
||
//设置密码
|
||
|
||
void setPassword(String password);
|
||
|
||
}
|
||
|
||
|
||
如果我们想要在应用程序中创建一个 UserDetails 对象，可以使用如下所示的链式语法：
|
||
|
||
UserDetails user = User.withUsername("jianxiang")
|
||
|
||
.password("123456")
|
||
|
||
.authorities("read", "write")
|
||
|
||
.accountExpired(false)
|
||
|
||
.disabled(true)
|
||
|
||
.build();
|
||
|
||
|
||
Spring Security 还专门提供了一个 UserBuilder 对象来辅助构建 UserDetails，使用方式也类似：
|
||
|
||
User.UserBuilder builder =
|
||
|
||
User.withUsername("jianxiang");
|
||
|
||
|
||
|
||
UserDetails user = builder
|
||
|
||
.password("12345")
|
||
|
||
.authorities("read", "write")
|
||
|
||
.accountExpired(false)
|
||
|
||
.disabled(true)
|
||
|
||
.build();
|
||
|
||
|
||
在 Spring Security 中，针对 UserDetails 专门提供了一个 UserDetailsService，该接口用来管理 UserDetails，定义如下：
|
||
|
||
public interface UserDetailsService {
|
||
|
||
|
||
|
||
//根据用户名获取用户信息
|
||
|
||
UserDetails loadUserByUsername(String username) throws UsernameNotFoundException;
|
||
|
||
}
|
||
|
||
|
||
而 UserDetailsManager 继承了 UserDetailsService，并提供了一批针对 UserDetails 的操作接口，如下所示：
|
||
|
||
public interface UserDetailsManager extends UserDetailsService {
|
||
|
||
//创建用户
|
||
|
||
void createUser(UserDetails user);
|
||
|
||
|
||
|
||
//更新用户
|
||
|
||
void updateUser(UserDetails user);
|
||
|
||
|
||
|
||
//删除用户
|
||
|
||
void deleteUser(String username);
|
||
|
||
|
||
|
||
//修改密码
|
||
|
||
void changePassword(String oldPassword, String newPassword);
|
||
|
||
|
||
|
||
//判断指定用户名的用户是否存在
|
||
|
||
boolean userExists(String username);
|
||
|
||
}
|
||
|
||
|
||
这样，几个核心用户对象之间的关联关系就很清楚了，接下来我们需要进一步明确具体的实现过程。
|
||
|
||
我们来看 UserDetailsManager 的两个实现类，一个是基于内存存储的 InMemoryUserDetailsManager，一个是基于关系型数据库存储的 JdbcUserDetailsManager。
|
||
|
||
这里，我们以 JdbcMemoryUserDetailsManager 为例展开分析，它的 createUser 方法如下所示：
|
||
|
||
public void createUser(final UserDetails user) {
|
||
|
||
validateUserDetails(user);
|
||
|
||
|
||
|
||
getJdbcTemplate().update(createUserSql, ps -> {
|
||
|
||
ps.setString(1, user.getUsername());
|
||
|
||
ps.setString(2, user.getPassword());
|
||
|
||
ps.setBoolean(3, user.isEnabled());
|
||
|
||
|
||
|
||
int paramCount = ps.getParameterMetaData().getParameterCount();
|
||
|
||
if (paramCount > 3) {
|
||
|
||
ps.setBoolean(4, !user.isAccountNonLocked());
|
||
|
||
ps.setBoolean(5, !user.isAccountNonExpired());
|
||
|
||
ps.setBoolean(6, !user.isCredentialsNonExpired());
|
||
|
||
}
|
||
|
||
});
|
||
|
||
|
||
|
||
if (getEnableAuthorities()) {
|
||
|
||
insertUserAuthorities(user);
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
可以看到，这里直接使用了 Spring 框架中的 JdbcTemplate 模板工具类实现了数据的插入，同时完成了 GrantedAuthority 的存储。
|
||
|
||
UserDetailsManager 是一条相对独立的代码线，为了完成用户信息的配置，还存在另一条代码支线，即 UserDetailsManagerConfigurer。该类维护了一个 UserDetails 列表，并提供了一组 withUser 方法完成用户信息的初始化，如下所示：
|
||
|
||
private final List<UserDetails> users = new ArrayList<>();
|
||
|
||
|
||
|
||
public final C withUser(UserDetails userDetails) {
|
||
|
||
this.users.add(userDetails);
|
||
|
||
return (C) this;
|
||
|
||
}
|
||
|
||
|
||
而 withUser 方法返回的是一个 UserDetailsBuilder 对象，该对象内部使用了前面介绍的 UserBuilder 对象，因此可以实现类似 .withUser(“spring_user”).password(“password1”).roles(“USER”) 这样的链式语法，完成用户信息的设置。这也是上一讲中，我们在介绍基于内存的用户信息存储方案时使用的方法。
|
||
|
||
作为总结，我们也梳理了 Spring Security 中与用户对象相关的一大批实现类，它们之间的关系如下图所示：
|
||
|
||
|
||
|
||
Spring Security 中用户对象相关类结构图
|
||
|
||
Spring Security 中的认证对象
|
||
|
||
有了用户对象，我们就可以讨论具体的认证过程了，首先来看认证对象 Authentication，如下所示：
|
||
|
||
public interface Authentication extends Principal, Serializable {
|
||
|
||
//安全主体具有的权限
|
||
|
||
Collection<? extends GrantedAuthority> getAuthorities();
|
||
|
||
|
||
|
||
//证明主体有效性的凭证
|
||
|
||
Object getCredentials();
|
||
|
||
|
||
|
||
//认证请求的明细信息
|
||
|
||
Object getDetails();
|
||
|
||
|
||
|
||
//主体的标识信息
|
||
|
||
Object getPrincipal();
|
||
|
||
|
||
|
||
//认证是否通过
|
||
|
||
boolean isAuthenticated();
|
||
|
||
|
||
|
||
//设置认证结果
|
||
|
||
void setAuthenticated(boolean isAuthenticated) throws IllegalArgumentException;
|
||
|
||
}
|
||
|
||
|
||
认证对象代表认证请求本身，并保存该请求访问应用程序过程中涉及的各个实体的详细信息。在安全领域，请求访问该应用程序的用户通常被称为主体（Principal），在 JDK 中存在一个同名的接口，而 Authentication 扩展了这个接口。
|
||
|
||
显然，Authentication 只代表了认证请求本身，而具体执行认证的过程和逻辑需要由专门的组件来负责，这个组件就是 AuthenticationProvider，定义如下：
|
||
|
||
public interface AuthenticationProvider {
|
||
|
||
|
||
|
||
//执行认证，返回认证结果
|
||
|
||
Authentication authenticate(Authentication authentication)
|
||
|
||
throws AuthenticationException;
|
||
|
||
|
||
|
||
//判断是否支持当前的认证对象
|
||
|
||
boolean supports(Class<?> authentication);
|
||
|
||
}
|
||
|
||
|
||
讲到这里，你可能会认为 Spring Security 是直接使用 AuthenticationProvider 接口完成用户认证的，其实不然。如果你翻阅 Spring Security 的源码，会发现它使用了 AuthenticationManager 接口来代理 AuthenticationProvider 提供的认证功能。这里，我们以 InMemoryUserDetailsManager 中的 changePassword 为例，分析用户认证的执行过程（为了展示简洁，部分代码做了裁剪）：
|
||
|
||
public void changePassword(String oldPassword, String newPassword) {
|
||
|
||
Authentication currentUser = SecurityContextHolder.getContext()
|
||
|
||
.getAuthentication();
|
||
|
||
|
||
|
||
if (currentUser == null) {
|
||
|
||
throw new AccessDeniedException(
|
||
|
||
"Can't change password as no Authentication object found in context "
|
||
|
||
+ "for current user.");
|
||
|
||
}
|
||
|
||
|
||
|
||
String username = currentUser.getName();
|
||
|
||
|
||
|
||
if (authenticationManager != null) {
|
||
|
||
|
||
|
||
authenticationManager.authenticate(new UsernamePasswordAuthenticationToken(
|
||
|
||
username, oldPassword));
|
||
|
||
}
|
||
|
||
else {
|
||
|
||
…
|
||
|
||
}
|
||
|
||
|
||
|
||
MutableUserDetails user = users.get(username);
|
||
|
||
|
||
|
||
if (user == null) {
|
||
|
||
throw new IllegalStateException("Current user doesn't exist in database.");
|
||
|
||
}
|
||
|
||
|
||
|
||
user.setPassword(newPassword);
|
||
|
||
}
|
||
|
||
|
||
可以看到，这里使用了 AuthenticationManager 而不是 AuthenticationProvider 中的 authenticate() 方法来执行认证。同时，我们也注意到这里出现了 UsernamePasswordAuthenticationToken 类，这就是 Authentication 接口的一个具体实现类，用来存储用户认证所需的用户名和密码信息。
|
||
|
||
同样作为总结，我们也梳理了 Spring Security 中与认证对象相关的一大批核心类，它们之间的关系如下所示：
|
||
|
||
|
||
|
||
Spring Security 中认证的对象相关类结构图
|
||
|
||
实现定制化用户认证方案
|
||
|
||
通过前面的分析，我们明确了用户信息存储的实现过程实际上是可以定制化的。Spring Security 所做的工作只是把常见的、符合一般业务场景的实现方式嵌入到了框架中。如果有特殊的场景，开发人员完全可以实现自定义的用户信息存储方案。
|
||
|
||
现在，我们已经知道 UserDetails 接口代表着用户详细信息，而负责对 UserDetails 进行各种操作的则是 UserDetailsService 接口。因此，实现定制化用户认证方案主要就是实现 UserDetails 和 UserDetailsService 这两个接口。
|
||
|
||
扩展 UserDetails
|
||
|
||
扩展 UserDetails 的方法就是直接实现该接口，例如我们可以构建如下所示的 SpringUser 类：
|
||
|
||
public class SpringUser implements UserDetails {
|
||
|
||
|
||
|
||
private static final long serialVersionUID = 1L;
|
||
|
||
private Long id;
|
||
|
||
private final String username;
|
||
|
||
private final String password;
|
||
|
||
private final String phoneNumber;
|
||
|
||
//省略 getter/setter
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public String getUsername() {
|
||
|
||
return username;
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public String getPassword() {
|
||
|
||
return password;
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public Collection<? extends GrantedAuthority> getAuthorities() {
|
||
|
||
return Arrays.asList(new SimpleGrantedAuthority("ROLE_USER"));
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public boolean isAccountNonExpired() {
|
||
|
||
return true;
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public boolean isAccountNonLocked() {
|
||
|
||
return true;
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public boolean isCredentialsNonExpired() {
|
||
|
||
return true;
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public boolean isEnabled() {
|
||
|
||
return true;
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
显然，这里使用了一种最简单的方法来满足 UserDetails 中各个接口的实现需求。一旦我们构建了这样一个 SpringUser 类，就可以创建对应的表结构存储类中定义的字段。同时，我们也可以基于 Spring Data JPA 来创建一个自定义的 Repository，如下所示：
|
||
|
||
public interface SpringUserRepository extends CrudRepository<SpringUser, Long> {
|
||
|
||
SpringUser findByUsername(String username);
|
||
|
||
}
|
||
|
||
|
||
SpringUserRepository 扩展了 Spring Data 中的 CrudRepository 接口，并提供了一个方法名衍生查询 findByUsername。
|
||
|
||
扩展 UserDetailsService
|
||
|
||
接着，我们来实现 UserDetailsService 接口，如下所示：
|
||
|
||
@Service
|
||
|
||
public class SpringUserDetailsService
|
||
|
||
implements UserDetailsService {
|
||
|
||
|
||
|
||
@Autowired
|
||
|
||
private SpringUserRepository repository;
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public UserDetails loadUserByUsername(String username)
|
||
|
||
throws UsernameNotFoundException {
|
||
|
||
|
||
|
||
SpringUser user = repository.findByUsername(username);
|
||
|
||
if (user != null) {
|
||
|
||
return user;
|
||
|
||
}
|
||
|
||
throw new UsernameNotFoundException(
|
||
|
||
"SpringUser '" + username + "' not found");
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
我们知道 UserDetailsService 接口只有一个 loadUserByUsername 方法需要实现。因此，我们基于 SpringUserRepository 的 findByUsername 方法，根据用户名从数据库中查询数据。
|
||
|
||
扩展 AuthenticationProvider
|
||
|
||
扩展 AuthenticationProvider 的过程就是提供一个自定义的 AuthenticationProvider 实现类。这里我们以最常见的用户名密码认证为例，梳理自定义认证过程所需要实现的步骤，如下所示：
|
||
|
||
|
||
|
||
自定义 AuthenticationProvider 的实现流程图
|
||
|
||
上图中的流程并不复杂，首先我们需要通过 UserDetailsService 获取一个 UserDetails 对象，然后根据该对象中的密码与认证请求中的密码进行匹配，如果一致则认证成功，反之抛出一个 BadCredentialsException 异常。示例代码如下所示：
|
||
|
||
@Component
|
||
|
||
public class SpringAuthenticationProvider implements AuthenticationProvider {
|
||
|
||
|
||
|
||
@Autowired
|
||
|
||
private UserDetailsService userDetailsService;
|
||
|
||
|
||
|
||
@Autowired
|
||
|
||
private PasswordEncoder passwordEncoder;
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public Authentication authenticate(Authentication authentication) {
|
||
|
||
String username = authentication.getName();
|
||
|
||
String password = authentication.getCredentials().toString();
|
||
|
||
|
||
|
||
UserDetails user = userDetailsService.loadUserByUsername(username);
|
||
|
||
if (passwordEncoder.matches(password, user.getPassword())) {
|
||
|
||
return new UsernamePasswordAuthenticationToken(username, password, u.getAuthorities());
|
||
|
||
} else {
|
||
|
||
throw new BadCredentialsException("The username or password is wrong!");
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
|
||
@Override
|
||
|
||
public boolean supports(Class<?> authenticationType) {
|
||
|
||
return authenticationType.equals(UsernamePasswordAuthenticationToken.class);
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
这里我们同样使用了 UsernamePasswordAuthenticationToken 来传递用户名和密码，并使用一个 PasswordEncoder 对象校验密码。
|
||
|
||
整合定制化配置
|
||
|
||
最后，我们创建一个 SpringSecurityConfig 类，该类继承了 WebSecurityConfigurerAdapter 配置类。这次，我们将使用自定义的 SpringUserDetailsService 来完成用户信息的存储和查询，需要对原有配置策略做一些调整。调整之后的完整 SpringSecurityConfig 类如下所示：
|
||
|
||
@Configuration
|
||
|
||
public class SpringSecurityConfig extends WebSecurityConfigurerAdapter {
|
||
|
||
|
||
|
||
@Autowired
|
||
|
||
private UserDetailsService springUserDetailsService;
|
||
|
||
|
||
|
||
@Autowired
|
||
|
||
private AuthenticationProvider springAuthenticationProvider;
|
||
|
||
|
||
|
||
|
||
|
||
@Override
|
||
|
||
protected void configure(AuthenticationManagerBuilder auth) throws Exception {
|
||
|
||
|
||
|
||
auth.userDetailsService(springUserDetailsService)
|
||
|
||
.authenticationProvider(springAuthenticationProvider);
|
||
|
||
}
|
||
|
||
}
|
||
|
||
|
||
这里我们注入了 SpringUserDetailsService 和 SpringAuthenticationProvider，并将其添加到 AuthenticationManagerBuilder 中，这样 AuthenticationManagerBuilder 将基于这个自定义的 SpringUserDetailsService 完成 UserDetails 的创建和管理，并基于自定义的 SpringAuthenticationProvider 完成用户认证。
|
||
|
||
小结与预告
|
||
|
||
这一讲我们基于 Spring Security 提供的用户认证功能分析了其背后的实现过程。我们的切入点在于分析与用户和认证相关的各个核心类，并梳理它们之间的交互过程。另一方面，我们还通过扩展 UserDetailsService 和 AuthenticationProvider 接口的方式来实现定制化的用户认证方案。
|
||
|
||
本讲内容总结如下：
|
||
|
||
|
||
|
||
最后给你留一道思考题：基于 Spring Security，如何根据用户名和密码实现一套定制化的用户认证解决方案？欢迎在留言区和我分享你的想法。
|
||
|
||
|
||
|
||
|