ruoyi接口权限校验

此文章属于ruoyi项目实战系列

ruoyi系统在前端主要通过权限字符包含与否来动态显示目录和按钮。为了防止通过http请求绕过权限限制，后端接口也需要进行相关权限设计。

@PreAuthorize使用

由于对@PreAuthorize原理还不够深入了解，所以此处只粗浅讲解在ruoyi项目是如何应用的。
在请求调用接口前，被@preAuthorize注解的接口需要首先通过验证。通过注解参数value()返回值true和false来判断是否有权限。

public @interface PreAuthorize {  
    String value();  
}

Ruoyi并没有使用原生的Spel表达式，而是使用了自定义的PermissionService类，通过其中自定义方法hasPermi(String Permission) 来进行权限判断。注解使用举例：@PreAuthorize("@ss.hasPermi('system:menu:list')")

public boolean hasPermi(String permission)  
{  
    if (StringUtils.isEmpty(permission))//用注解就必须有permission值  
    {  
        return false;  
    }  
    LoginUser loginUser = SecurityUtils.getLoginUser();  
    if (StringUtils.isNull(loginUser) ||
     CollectionUtils.isEmpty(loginUser.getPermissions()))  
    {  
        return false;  
    }  
    return hasPermissions(loginUser.getPermissions(), permission);

private boolean hasPermissions(Set<String> permissions, String permission)  
{  
    return permissions.contains(ALL_PERMISSION) ||
     permissions.contains(StringUtils.trim(permission)); //判断是否持有"所有权限”字符，或者持有该权限 
}

接口权限校验流程

粗略用两个例子来讲解前端请求如何经过后端接口权限校验。

Login匿名请求

1. Login请求路径是/login,在过滤器链中被AnnoymousAuthenticationFilter添加匿名authentication到Spring上下文里。由于/login请求在SecurityConfig.java里设置成匿名请求，所以可以成功到达SysLoginController。

2. 调用SysLoginService.login方法，关键的一行命令：

   Authentication authentication = authenticationManager  
   .authenticate(new UsernamePasswordAuthenticationToken(username, password));
   

   authenticationManager.authenticate()是钩子方法，在AbstractUserDetailsAuthenticationProvider中实现，会根据传入的token类型来自动选择，此处UsernamePasswordAuthenticationToken将由DaoAuthenticationProvider来处理（不清楚的话可以前后打两个断点看调用栈）。

3. 在DaoAuthenticationProvider中可以看到关键的一行：

   UserDetails loadedUser = this.getUserDetailsService()
   .loadUserByUsername(username);
   

   这会调用我们自定义实现的UserDetailsServiceImpl#loadUserByUsername方法（如流程图所示），获得user信息。至于为什么会使用自定义方法，因为在SecurityConfig.java中进行了配置

   @Override  
   protected void configure(AuthenticationManagerBuilder auth) throws Exception  
   {  
       auth.userDetailsService(userDetailsService).passwordEncoder(bCryptPasswordEncoder());  
   }
   

4. 生成token，然后返回。

已登录请求

已登录请求流程较简单，在流程图里的some filters里会通过自定义的JwtAuthenticationFilter,其中会通过token获得user信息，然后装入Spring的上下文，方便提取使用。

曾纠结踩坑的点

由于对SpringSecurity较陌生，虽然功能强大，但其复杂性也是大大提高，所以调试项目的同时翻看了很多入门博客文章，其中都不约而同的提到了UsernamePasswordAuthenticationFilter，可是我在实战项目中反复调试都没有看到这个过滤器的调用。

原因：Security配置文件需要添加httpSecurity.formLogin()启用表单登录才会使用该filter。查看项目使用的所有filter可以使用以下测试代码：

class RuoYiApplicationTest {  
    @Autowired  
    private FilterChainProxy filterChainProxy;  
    @Test  
    public void test() {  
        List<SecurityFilterChain> filterChains = filterChainProxy.getFilterChains();  
        for(SecurityFilterChain sfc:filterChains){  
            for(Filter filter:sfc.getFilters()){  
                System.out.println(filter.getClass().getName());  
            }  
        }  
    }  
}