通过Spring AOP结合SpEL表达式：构建强大且灵活的权限控制体系_Java教程

环境：SpringBoot2.7.12

1.前言

在当今的Web应用程序中，权限验证是一个重要的安全措施，用于确保只有具有适当权限的用户才能访问特定的资源。随着应用程序的规模和复杂性的增加，实现权限验证变得更加困难。为了解决这个问题，我们可以使用Spring AOP（面向切面编程）和Spring Security的组合，它们可以提供一种有效的方法来实现权限验证。

在本文中，我们将探讨如何使用Spring AOP和Spring Security来实现权限验证。我们首先介绍Spring AOP和Spring Security的概念，然后解释如何将它们结合起来实现权限验证。通过这种方式，我们可以确保只有具有适当权限的用户能够访问受保护的资源，从而提高应用程序的安全性。

一、Spring AOP介绍

Spring AOP是Spring框架中的一个模块，用于支持面向切面编程。它允许开发者在应用程序中的关键点定义切面，从而对程序流程进行干预和控制。通过使用AOP，我们可以将与业务逻辑无关的代码（如日志记录、事务管理、权限认证等）抽取出来，并将其放在独立的切面中，这样可以提高代码的可重用性和可维护性。

二、Spring Security介绍

Spring Security是一个强大的安全框架，用于保护Web应用程序。它提供了丰富的安全特性，包括认证、授权、访问控制等。通过使用Spring Security，我们可以轻松地实现用户身份验证、角色授权、URL级别的访问控制等功能，从而确保只有经过授权的用户才能访问受保护的资源。

三、Spring AOP与Spring Security的组合

我们可以将Spring AOP与Spring Security结合起来实现权限验证。具体步骤如下：

定义一个Aspect切面，用于实现权限验证逻辑。该Aspect可以拦截用户对受保护资源的访问请求，并验证其权限。
定义一个Filter，该过滤器实现token的解析，将权限信息保存到当前的安全上下文中，最后添加到Security的过滤器链中。
在Aspect中，我们可以使用Spring Security提供的API来获取当前用户的身份信息、角色等信息，并根据业务需求判断用户是否具有访问受保护资源的权限。
如果用户没有足够的权限访问受保护资源，我们可以抛出一个异常，以阻止用户继续访问。
如果用户具有足够的权限访问受保护资源，我们可以允许用户继续访问该资源。

通过这种方式，我们可以轻松地实现权限验证，从而提高应用程序的安全性。同时，使用Spring AOP和Spring Security还可以降低代码的耦合度，提高代码的可重用性和可维护性。

2. 权限认证实现

权限认证过滤器

该过滤器的作用用来解析token，将权限信息添加到SecurityContext上下文中

public class PackAuthenticationFilter extends OncePerRequestFilter {


  public static final String TOKEN_NAME = "x-api-token" ;
  
  @SuppressWarnings("unused")
  private ApplicationContext context ;
  
  public PackAuthenticationFilter(ApplicationContext context) {
    this.context = context ;
  }
  
  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
      throws ServletException, IOException {
    String token = request.getHeader(TOKEN_NAME) ;
    if (!StringUtils.hasLength(token)) {
      response.setContentType("text/html;charset=UTF-8") ;
      response.getWriter().println("没有权限访问") ;
      return ;
    } 
    // 解析token
    List authorities = JwtUtils.parseAuthority(token) ;
    Authentication authentication = new UsernamePasswordAuthenticationToken("", "", authorities) ;
    SecurityContextHolder.getContext().setAuthentication(authentication) ;
    filterChain.doFilter(request, response) ;
  }


}

安全配置类

将上面的过滤器添加到Security过滤器链中

@Configuration
public class SecurityConfig {
  
  @Autowired
  void setContext(ApplicationContext context) {
    this.context = context ;
  }
  @Bean
  public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
    http.csrf().disable();
    // 对所有的资源全部放行，我们只做对Controller接口的限制访问
    http.authorizeRequests().anyRequest().permitAll() ;
    // 添加过滤器
    http.addFilterBefore(new PackAuthenticationFilter(this.context), UsernamePasswordAuthenticationFilter.class) ;
    http.formLogin().disable() ;
    return http.build();
  }


}

自定义注解

该注解的作用用来标注具体的Controller接口。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface PreAuthority {
  
  String value() default "" ;
  
}

验证切面

该切面读取接口配置的权限，验证是否具有相应的权限

@Component
@Aspect
public class AuthenticationAspect {
  
  private AuthorityVerify authorityVerify ;
  
  public AuthenticationAspect(AuthorityVerify authorityVerify) {
    this.authorityVerify = authorityVerify ;
  }
  
  @Pointcut("@annotation(auth)")
  private void authority(PreAuthority auth) {}
  
  @Around("authority(auth)")
  public Object test(ProceedingJoinPoint pjp, PreAuthority auth) throws Throwable {
    String authority = auth.value() ;
    boolean permit = this.authorityVerify.hasAuthority(authority) ;
    if (!permit) {
      throw new RuntimeException("权限不足") ;
    }
    Object ret = pjp.proceed() ;
    return ret ;
  }
  
}

权限验证工具类

@Component
public class AuthorityVerify {


  public boolean hasAuthority(String authority) {
    Collection authorities = SecurityContextHolder.getContext().getAuthentication().getAuthorities() ;
    return authorities.contains(new SimpleGrantedAuthority(authority)) ;
  }
  
}

全局异常处理

在上面的切面类中，如果没有权限是直接抛出的异常，所以这里定义一个全局异常对异常进行统一的处理。都比较简单，理解即可。

@RestControllerAdvice
public class GlobalExceptionAdvice {
  
  @ExceptionHandler({Exception.class})
  public Object exceptionProcess(Exception e) {
    return e.getMessage() ;
  }
}

测试接口

@RestController
@RequestMapping("/api")
public class ApiController {


  @GetMapping("/save")
  @PreAuthority("api:save")
  public Object save(HttpServletResponse response) throws Exception {
    return "save method invoke..." ;
  }
  
  @GetMapping("/{id}")
  @PreAuthority("api:query")
  public Object query(@PathVariable("id") Integer id) {
    return "query method invoke..." ;
  }
  
}

测试用户

Map map = new HashMap<>() ;
map.put("userId", "888888") ;
map.put("authorities", List.of("api:create", "api:query", "api:update", "api:delete")) ;
String token = createToken(map) ;
System.out.println(token) ;
String content = parseToken(token);
System.out.println(content) ;
System.out.println(">>>>>>>>>>>>>>>>>>>>>") ;
System.out.println(parseAuthority(token)) ;

这里模拟了一个用户信息，设置了权限集合，通过这些信息生成JWT信息。如下：

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI4ODg4ODgiLCJhdXRob3JpdGllcyI6WyJhcGk6Y3JlYXRlIiwiYXBpOnF1ZXJ5IiwiYXBpOnVwZGF0ZSIsImFwaTpkZWxldGUiXSwiZXhwIjoxNjk5NjE3NTM3fQ.GGLYIP2g5RZZkBoLnyQ_NWOQq_NUQylr5iZH9ouDiCM

测试结果

通过Spring AOP结合SpEL表达式：构建强大且灵活的权限控制体系图片

/api/save接口配置的权限是api:save，实际模拟的用户是没有这个权限的，所以这里看到的是切面中抛出的异常信息。

通过Spring AOP结合SpEL表达式：构建强大且灵活的权限控制体系图片

查询接口正常访问。

以上是简单的示例，实际你应该会使用Spring Security结合数据库一起来验证管理用户的。

通过本文的介绍，我们了解了如何使用Spring AOP和Spring Security的组合来实现权限验证。通过这种方式，我们可以提高应用程序的安全性，并降低代码的耦合度，提高代码的可重用性和可维护性。希望本文能够帮助读者更好地理解和应用Spring AOP和Spring Security，为他们的应用程序开发提供有益的参考。

思考：

在上面的Controller中直接通过@PreAuthority('xxx')进行权限的设置，那我们是不是可以实现类似Spring Security提供@PreAuthorize("hasRole('xxx')")注解的功能，其中hasRole('xxx')是SpEL表达式。其实这里我们可以对切面稍加修改即可实现，部分代码如下：

初始化SpEL上下文：

@PostConstruct
public void init() {
  SpelParserConfiguration config = new SpelParserConfiguration(true, true);
  parser = new SpelExpressionParser(config) ;
  context = new StandardEvaluationContext() ;
  context.setRootObject(this.authorityVerify) ;
}

修改切面

@Around("authority(auth)")
public Object test(ProceedingJoinPoint pjp, PreAuthority auth) throws Throwable {
  String authority = auth.value() ;
  boolean permit = this.parser.parseExpression(authority).getValue(this.context, Boolean.class) ;
  if (!permit) {
    throw new RuntimeException("不具备对应角色") ;
  }
  Object ret = pjp.proceed() ;
  return ret ;
}

修改接口

@GetMapping("/save")
@PreAuthority("hasRole({'ADMIN', 'MGR'})")
public Object save(HttpServletResponse response) throws Exception {
  return "save method invoke..." ;
}

该接口只要具有ADMIN或者MGR角色的都可以访问。

原文地址：https://mp.weixin.qq.com/s/M0_jsS6AyDuQyRGa8Bf_Bg