Spring 技术栈的组成部分。
通过提供完整可扩展的认证和授权支持保护你的应用程序。
https://spring.io/projects/spring-security
SpringSecurity 特点:
- 和 Spring 无缝整合。
- 全面的权限控制。
- 专门为 Web 开发而设计。
- 旧版本不能脱离 Web 环境使用。
- 新版本对整个框架进行了分层抽取,分成了核心模块和 Web 模块。单独引入核心模块就可以脱离Web 环境。
- 重量级。
Apache 旗下的轻量级权限控制框架。
特点:
- 轻量级。Shiro 主张的理念是把复杂的事情变简单。针对对性能有更高要求的互联网应用有更好表现。
- 通用性。
- 好处:不局限于 Web 环境,可以脱离 Web 环境使用。
- 缺陷:在 Web 环境下一些特定的需求需要手动编写代码定制。
Spring Security 是 Spring 家族中的一个安全管理框架,实际上,在 Spring Boot 出现之前,Spring Security 就已经发展了多年了,但是使用的并不多,安全管理这个领域,一直是 Shiro 的天下。
相对于 Shiro,在 SSM 中整合 Spring Security 都是比较麻烦的操作,所以,Spring Security 虽然功能比 Shiro 强大,但是使用反而没有 Shiro 多(Shiro 虽然功能没有 Spring Security 多,但是对于大部分项目而言,Shiro 也够用了)。
自从有了 Spring Boot 之后,Spring Boot 对于 Spring Security 提供了自动化配置方案,可以使用更少的配置来使用 Spring Security。因此,一般来说,常见的安全管理技术栈的组合是这样的:
• SSM + Shiro
• Spring Boot/Spring Cloud + Spring Security
以上只是一个推荐的组合而已,如果单纯从技术上来说,无论怎么组合,都是可以运行的。
org.springframework.boot spring-boot-starter-security
项目启动,默认用户名:user,密码打印在控制台
访问 localhost:7777 即可登录
- 主体:英文单词:principal,使用系统的用户或设备或从其他系统远程登录的用户等等。简单说就是谁使用系统谁就是主体。
- 认证:英文单词:authentication,权限管理系统确认一个主体的身份,允许主体进入系统。简单说就是“主体”证明自己是谁。笼统的认为就是以前所做的登录操作。
- 授权:英文单词:authorization,将操作系统的“权力”“授予”“主体”,这样主体就具备了操作系统中特定功能的能力。所以简单来说,授权就是给用户分配权限。
@Service
public class UserServiceImpl implements UserDetailsService {
@Resource
private PasswordEncoder passwordEncoder;
@Override
public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
// 实际开发中需要从 DB 查询,这里暂时写死
return new User("xiaoming", passwordEncoder.encode("123456"), Collections.emptyList());
}
}
2.3.2 创建配置类
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Resource
private UserDetailsService userDetailsService;
@Bean
public PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
@Override
public void configure(AuthenticationManagerBuilder auth) throws Exception {
auth.userDetailsService(userDetailsService) // 配置 userDetailService
.passwordEncoder(passwordEncoder()); // 配置密码加密工具
}
这样在登录页输入 xiaoming/123456 即可完成认证
2.4 自定义跳转页面引入前端依赖框架
2.4.1 跳转配置org.springframework.boot spring-boot-starter-thymeleaf
@Override
protected void configure(HttpSecurity http) throws Exception {
// 配置认证
http.formLogin()
.loginPage("/index") // 配置哪个 url 为登录页面
.loginProcessingUrl("/login") // 设置哪个是登录的 url。
.successForwardUrl("/success") // 登录成功之后跳转到哪个 url
.failureForwardUrl("/failed"); // 登录失败之后跳转到哪个 url
http.authorizeRequests()
.antMatchers("/index") //表示配置请求路径
.permitAll() // 指定 URL 无需保护。
.anyRequest() // 其他请求
.authenticated(); //需要认证
// 关闭 csrf
http.csrf().disable();
}
2.4.2 跳转 Controller
@Controller
public class IndexController {
@GetMapping("/index")
public String index() {
return "login";
}
@PostMapping("/success")
public String success() {
return "success";
}
@PostMapping("/failed")
public String failed() {
return "failed";
}
}
2.4.3 登陆测试
配置好跳转页面进行测试即可,登陆成功跳转到 success,登录失败跳转到 failed
启动类添加
@EnableGlobalMethodSecurity(securedEnabled = true, prePostEnabled = true)2.5.2 用户分配角色、权限
UserServiceImpl 修改
@Override
public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
// 实际开发中需要从 DB 查询,这里暂时写死。
List authorityList;
if ("right".equals(username)) {
// 如果是 right 登陆分配 right 权限
authorityList = AuthorityUtils.commaSeparatedStringToAuthorityList("right");
} else if ("admin".equals(username)) {
// 如果是 admin 登陆分配 admin 角色
authorityList = AuthorityUtils.commaSeparatedStringToAuthorityList("ROLE_admin");
} else if ("super".equals(username)) {
// 如果是 super 登陆分配 super 角色
authorityList = AuthorityUtils.commaSeparatedStringToAuthorityList("ROLE_super");
} else {
// 其他用户登陆不分配角色
authorityList = Collections.emptyList();
}
return new User(username, passwordEncoder.encode("123456"), authorityList);
}
2.5.3 配置 403 页面
@GetMapping("/forbidden")
public String forbidden() {
return "forbidden";
}
// 自定义403 页面
http.exceptionHandling().accessDeniedPage("/forbidden");
2.5.4 配置资源控制
@Override
public void configure(WebSecurity web) throws Exception {
// 和 /resource/ignore 有关的页面未认证即可访问
web.ignoring().antMatchers("/resource/ignore
@Override
protected void successfulAuthentication(HttpServletRequest req, HttpServletResponse res, FilterChain chain, Authentication auth) throws IOException {
User user = (User) auth.getPrincipal();
// 权限集合存到 redis
redisTemplate.opsForValue().set("right:" + user.getUsername(), user.getAuthorities().stream()
.map(GrantedAuthority::getAuthority)
.collect(Collectors.toList()));
// 生成 token 并返回
String token = tokenManager.createToken(user.getUsername());
ResponseUtil.write(res, Result.SUCCESS, token);
}
@Override
protected void unsuccessfulAuthentication(HttpServletRequest request, HttpServletResponse response, AuthenticationException e) throws IOException {
ResponseUtil.write(response, Result.INVALID_PRINCIPAL);
}
}
token 认证过滤器
public class TokenAuthenticationFilter extends BasicAuthenticationFilter {
private TokenManager tokenManager;
private RedisTemplate redisTemplate;
public TokenAuthenticationFilter(AuthenticationManager authenticationManager,
AuthenticationEntryPoint authenticationEntryPoint,
TokenManager tokenManager,
RedisTemplate redisTemplate) {
super(authenticationManager, authenticationEntryPoint);
this.tokenManager = tokenManager;
this.redisTemplate = redisTemplate;
}
@Override
protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res, FilterChain chain) throws IOException, ServletException {
SecurityContextHolder.getContext().setAuthentication(getAuthentication(req));
chain.doFilter(req, res);
}
private UsernamePasswordAuthenticationToken getAuthentication(HttpServletRequest request) {
// token 置于 header 里
String token = request.getHeader("token");
if (StrUtil.isBlank(token)) {
return null;
}
String userName = tokenManager.getUserFromToken(token);
if (StrUtil.isBlank(userName)) {
return null;
}
List permissionValueList = (List) redisTemplate.opsForValue().get("right:" + userName);
// 添加权限
Collection authorities = new ArrayList<>();
if (CollectionUtil.isNotEmpty(permissionValueList)) {
for (String permissionValue : permissionValueList) {
if (StrUtil.isBlank(permissionValue)) {
continue;
}
SimpleGrantedAuthority authority = new SimpleGrantedAuthority(permissionValue);
authorities.add(authority);
}
}
return new UsernamePasswordAuthenticationToken(userName, token, authorities);
}
}
用户登出处理器
@Slf4j
@Component
public class TokenLogoutHandler implements LogoutHandler {
@Resource
private TokenManager tokenManager;
@Resource
private RedisTemplate redisTemplate;
@Override
public void logout(HttpServletRequest request, HttpServletResponse response, Authentication authentication) {
// 清空认证信息
SecurityContextHolder.getContext().setAuthentication(null);
String token = request.getHeader("token");
if (token != null) {
//清空当前用户缓存中的权限数据
String userName = tokenManager.getUserFromToken(token);
log.info("user logout:{}", userName);
redisTemplate.delete("right:" + userName);
}
try {
ResponseUtil.write(response, Result.SUCCESS);
} catch (IOException e) {
e.printStackTrace();
}
}
}
用户未认证提示信息
public class UnauthorizedEntryPoint implements AuthenticationEntryPoint {
@Override
public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException {
// 回复错误信息
ResponseUtil.write(response, Result.UNAUTHORIZED);
}
}
用户无权限提示信息
public class JsonAccessDeniedHandler implements AccessDeniedHandler {
@Override
public void handle(HttpServletRequest httpServletRequest, HttpServletResponse response, AccessDeniedException e) throws IOException, ServletException {
ResponseUtil.write(response, Result.FORBIDDEN);
}
}
配置修改
@Override
protected void configure(HttpSecurity http) throws Exception {
http.exceptionHandling()
// 未认证处理类
.authenticationEntryPoint(new UnauthorizedEntryPoint())
// 未授权处理类
.accessDeniedHandler(new JsonAccessDeniedHandler())
.and().csrf().disable()
.authorizeRequests()
.anyRequest().authenticated()
.and().logout().logoutUrl("/logout")
.addLogoutHandler(tokenLogoutHandler)
.and()
.addFilter(new TokenLoginFilter(authenticationManager(), tokenManager, redisTemplate))
.addFilter(new TokenAuthenticationFilter(authenticationManager(), new UnauthorizedEntryPoint(), tokenManager, redisTemplate))
.httpBasic();
}
测试:
直接访问资源:
输入错误的用户名密码:
输入正确的用户名密码:
携带 token 请求资源:
请求未授权的资源
手机号验证码登陆可以抽象为一种用户名密码登录方式,只不过有了自定义的登录地址、传参名称
2.7.1 短信验证码过滤器public class PhoneLoginFilter extends TokenLoginFilter {
public PhoneLoginFilter(AuthenticationManager authenticationManager, TokenManager tokenManager, RedisTemplate redisTemplate) {
super(authenticationManager, tokenManager, redisTemplate);
super.setUsernameParameter("phone");
super.setPasswordParameter("code");
this.setRequiresAuthenticationRequestMatcher(new AntPathRequestMatcher("/phone-login", "POST"));
}
@Override
public Authentication attemptAuthentication(HttpServletRequest request, HttpServletResponse response) throws AuthenticationException {
String username = obtainUsername(request);
String password = obtainPassword(request);
if (username == null) {
username = "";
}
if (password == null) {
password = "";
}
username = username.trim();
PhoneAuthenticationToken authRequest = new PhoneAuthenticationToken(username, password, Collections.emptyList());
return this.getAuthenticationManager().authenticate(authRequest);
}
@Override
protected void unsuccessfulAuthentication(HttpServletRequest request, HttpServletResponse response, AuthenticationException e) throws IOException {
ResponseUtil.write(response, Result.INVALID_CODE);
}
}
2.7.2 短信验证码 token
public class PhoneAuthenticationToken extends UsernamePasswordAuthenticationToken {
public PhoneAuthenticationToken(String phone, String code, Collection extends GrantedAuthority> authorities) {
super(new User(phone, code, authorities), code, authorities);
setAuthenticated(false);
}
}
2.7.3 短信验证码校验处理工具
@Slf4j
@Component
public class PhoneAuthenticationProvider implements AuthenticationProvider {
@Override
public Authentication authenticate(Authentication authentication) throws AuthenticationException {
// 获取手机号和验证码
String phone = authentication.getName();
String rawCode = authentication.getCredentials().toString();
// 实际开发中需要校验用户信息和验证码是否正确,这里省略
if (!"123456".equals(rawCode)) {
throw new BadCredentialsException("invalid code");
}
// 返回经过认证的 Authentication,
PhoneAuthenticationToken result = new PhoneAuthenticationToken(phone, rawCode, AuthorityUtils.commaSeparatedStringToAuthorityList("right"));
result.setDetails(authentication.getDetails());
return result;
}
@Override
public boolean supports(Class> authentication) {
return PhoneAuthenticationToken.class.isAssignableFrom(authentication);
}
}
2.7.4 配置类修改
2.7.5 登录测试
错误的手机号验证码:
正确的手机号验证码
访问有权限的资源
访问无权限的资源



