ruoyi接口权限校验 - allworldg - JOYK Joy of Geek, Geek News, Link all geek

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匿名请求

Login请求路径是/login,在过滤器链中被AnnoymousAuthenticationFilter添加匿名authentication到Spring上下文里。由于/login请求在SecurityConfig.java里设置成匿名请求，所以可以成功到达SysLoginController。
调用SysLoginService.login方法，关键的一行命令：
```
Authentication authentication = authenticationManager  
.authenticate(new UsernamePasswordAuthenticationToken(username, password));
```
authenticationManager.authenticate()是钩子方法，在AbstractUserDetailsAuthenticationProvider中实现，会根据传入的token类型来自动选择，此处UsernamePasswordAuthenticationToken将由DaoAuthenticationProvider来处理（不清楚的话可以前后打两个断点看调用栈）。
在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());  
}
```
生成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());  
            }  
        }  
    }  
}

ruoyi接口权限校验 - allworldg

@PreAuthorize使用

接口权限校验流程

Login匿名请求

已登录请求

曾纠结踩坑的点

Recommend

ruoyi-react

ruoyi-cloud 实施部署

零成本搭建个人博客搭建篇 - allworldg

若依（RuoYi ）权限管理设计 - 萌猫他爸

为什么方法断点那么慢 - allworldg

优维低代码：Permissions 权限校验

Kubuesphere部署Ruoyi（二）：部署kubesphere - BelChance

Kubuesphere部署Ruoyi（三）：持久化存储配置 - BelChance

一日一技：分布式系统的低成本权限校验机制

使用RFC跳过权限校验的方法 - 斌将军

About Joyk