使用ruoyi-vue控制数据权限

小灰灰 2024-03-29 16:14 94阅读 0赞

### 说在前面 ###

啥是数据权限?

例如校长可以看到全部学生的信息,系主任可以看到该院系的学生信息,老师可以看到本班的学生信息,学生自己只能查看自己的信息

对于ruoyi的角色,我们只能控制用户可以访问那些菜单以及接口,而不能控制接口返回的数据

假如有这样一个需求,不同用户上传各自的图片,如果都是普通用户,那么他们可能都可以看到关于图片上传的菜单,也就相当于可以看到别人上传的图片,这是不合理的,所以我们需要分配数据权限,来进行控制

### 1.ruoyi实现数据权限原理 ###

ruoyi中数据权限是通过AOP切入,修改SQL实现的,让SQL中拼接一些关于权限的SQL来实现的

关键类: DataScopeAspect

可以看到ruoyi分为了5类权限级别

全部数据权限 1  
自定数据权限 2 用户指定对应的部门 对应到sql其实就是 in (指定的部门)  
部门数据权限 3 直接使用部门查 =  
部门及以下数据权限 4 通过find\_in\_set(101,ancestor)实现找到该部门下的所有子部门  
仅本人数据权限 5 直接使用用户表查 =

/**
     * 数据过滤处理
     *
     * @author ruoyi
     */
    @Aspect
    @Component
    public class DataScopeAspect
    {
        
        /**
         * 全部数据权限
         */
        public static final String DATA_SCOPE_ALL = "1";
     
        /**
         * 自定数据权限
         */
        public static final String DATA_SCOPE_CUSTOM = "2";
     
        /**
         * 部门数据权限
         */
        public static final String DATA_SCOPE_DEPT = "3";
     
        /**
         * 部门及以下数据权限
         */
        public static final String DATA_SCOPE_DEPT_AND_CHILD = "4";
     
        /**
         * 仅本人数据权限
         */
        public static final String DATA_SCOPE_SELF = "5";
     
        /**
         * 数据权限过滤关键字
         */
        public static final String DATA_SCOPE = "dataScope";
     
        @Before("@annotation(controllerDataScope)")
        public void doBefore(JoinPoint point, DataScope controllerDataScope) throws Throwable
        {
        
            clearDataScope(point);
            handleDataScope(point, controllerDataScope);
        }
     
        protected void handleDataScope(final JoinPoint joinPoint, DataScope controllerDataScope)
        {
        
            // 获取当前的用户
            LoginUser loginUser = SecurityUtils.getLoginUser();
            if (StringUtils.isNotNull(loginUser))
            {
        
                SysUser currentUser = loginUser.getUser();
                // 如果是超级管理员，则不过滤数据
                if (StringUtils.isNotNull(currentUser) && !currentUser.isAdmin())
                {
        
                    String permission = StringUtils.defaultIfEmpty(controllerDataScope.permission(), PermissionContextHolder.getContext());
                    dataScopeFilter(joinPoint, currentUser, controllerDataScope.deptAlias(),
                            controllerDataScope.userAlias(), permission);
                }
            }
        }
     
        /**
         * 数据范围过滤
         *
         * @param joinPoint 切点
         * @param user 用户
         * @param deptAlias 部门别名
         * @param userAlias 用户别名
         * @param permission 权限字符
         */
        public static void dataScopeFilter(JoinPoint joinPoint, SysUser user, String deptAlias, String userAlias, String permission)
        {
        
            StringBuilder sqlString = new StringBuilder();
            List<String> conditions = new ArrayList<String>();
     
            for (SysRole role : user.getRoles())
            {
        
                String dataScope = role.getDataScope();
                if (!DATA_SCOPE_CUSTOM.equals(dataScope) && conditions.contains(dataScope))
                {
        
                    continue;
                }
                if (StringUtils.isNotEmpty(permission) && StringUtils.isNotEmpty(role.getPermissions())
                        && !StringUtils.containsAny(role.getPermissions(), Convert.toStrArray(permission)))
                {
        
                    continue;
                }
                if (DATA_SCOPE_ALL.equals(dataScope))
                {
        
                    sqlString = new StringBuilder();
                    break;
                }
                else if (DATA_SCOPE_CUSTOM.equals(dataScope))
                {
        
                    sqlString.append(StringUtils.format(
                            " OR {}.dept_id IN ( SELECT dept_id FROM sys_role_dept WHERE role_id = {} ) ", deptAlias,
                            role.getRoleId()));
                }
                else if (DATA_SCOPE_DEPT.equals(dataScope))
                {
        
                    sqlString.append(StringUtils.format(" OR {}.dept_id = {} ", deptAlias, user.getDeptId()));
                }
                else if (DATA_SCOPE_DEPT_AND_CHILD.equals(dataScope))
                {
        
                    sqlString.append(StringUtils.format(
                            " OR {}.dept_id IN ( SELECT dept_id FROM sys_dept WHERE dept_id = {} or find_in_set( {} , ancestors ) )",
                            deptAlias, user.getDeptId(), user.getDeptId()));
                }
                else if (DATA_SCOPE_SELF.equals(dataScope))
                {
        
                    if (StringUtils.isNotBlank(userAlias))
                    {
        
                        sqlString.append(StringUtils.format(" OR {}.user_id = {} ", userAlias, user.getUserId()));
                    }
                    else
                    {
        
                        // 数据权限为仅本人且没有userAlias别名不查询任何数据
                        sqlString.append(StringUtils.format(" OR {}.dept_id = 0 ", deptAlias));
                    }
                }
                conditions.add(dataScope);
            }
     
            if (StringUtils.isNotBlank(sqlString.toString()))
            {
        
                Object params = joinPoint.getArgs()[0];
                if (StringUtils.isNotNull(params) && params instanceof BaseEntity)
                {
        
                    BaseEntity baseEntity = (BaseEntity) params;
                    baseEntity.getParams().put(DATA_SCOPE, " AND (" + sqlString.substring(4) + ")");
                }
            }
        }
     
        /**
         * 拼接权限sql前先清空params.dataScope参数防止注入
         */
        private void clearDataScope(final JoinPoint joinPoint)
        {
        
            Object params = joinPoint.getArgs()[0];
            if (StringUtils.isNotNull(params) && params instanceof BaseEntity)
            {
        
                BaseEntity baseEntity = (BaseEntity) params;
                baseEntity.getParams().put(DATA_SCOPE, "");
            }
        }
    }

**代码的具体逻辑**

前置通知
    清理请求参数的DataScope防止SQL注入 (其实就是sql拼接如 … where … OR 1 = 1 这样就可以无视条件访问数据)
    获取到当前登录的用户的所有角色对象
    遍历角色获取角色上的dataScope (普通用户默认为5)
    然后根据不同的dataScope拼接不同的sql,查出来的结果也不同
    最后在mapper里的sql添加上${params.dataScope}变量

### 2. 定义自己的数据权限 ###

我们要定义自己的表要和数据权限联动的话,就需要user\_id字段

现在有这样一个需求,就是用户上传图片,不同用户只能看到自己的图片

CREATE TABLE `ruoyi-vue`.`picture`  (
      `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
      `URI` varchar(500) NULL COMMENT '若干图片URI',
      `user_id` bigint(20) NULL COMMENT '关联用户user_id',
      `create_by` varchar(50) NULL COMMENT '创建人',
      `create_time` datetime NULL COMMENT '创建时间',
      `update_by` varchar(50) NULL COMMENT '更新人',
      `update_time` datetime NULL COMMENT '更新时间',
      `remark` varchar(500) NULL COMMENT '备注',
      PRIMARY KEY (`id`)
    );

使用ruoyi自动生成前后端代码  
直接看页面成果  
![在这里插入图片描述][4e22d593e0634bc69245bf301639d3e3.png]

2.2 数据权限的问题  
创建两个普通用户,由于系统内置了一个ry普通用户所以只需要添加一个普通用户即可  
![在这里插入图片描述][d0fc99fe671643369c043b849617d459.png]  
用不同的普通用户上传图片, 然后就可以发现一个很神奇的问题,该用户可以看到所有的图片

dearth用户

![在这里插入图片描述][5d8a571ba2a541068b7c7c8d7b278e1f.png]  
ry用户

![在这里插入图片描述][7bc68070a79c4b83865e57d4d9c80b50.png]  
从上图可以看出自己可以看到其他用户上传的所有图片

2.3 设置数据权限  
设置角色的数据权限类型  
![在这里插入图片描述][220d41ee764b4f7c9c2f1688340f65f6.png]

service

把创建人和user\_id添加到表中

/**
     * 新增图片管理
     *
     * @param picture 图片管理
     * @return 结果
     */
    @Override
    public int insertPicture(Picture picture)
    {
        
        picture.setCreateTime(DateUtils.getNowDate());
        picture.setCreateBy(SecurityUtils.getUsername());
        picture.setUserId(SecurityUtils.getUserId());
        return pictureMapper.insertPicture(picture);
    }

PictureMapper.xml

修改该查询的sql,拼接两个条件,并且把 $\{params.dataScope\} 添加上去

<select id="selectPictureList" parameterType="Picture" resultMap="PictureResult">
        select
            p.id, p.URI, p.user_id, p.create_by, p.create_time, p.update_by, p.update_time, p.remark
        from
            picture p
        left join sys_user u on u.user_id = p.user_id
        left join sys_dept d on d.dept_id = u.dept_id
        <where>
            <if test="uri != null  and uri != ''"> and URI = #{uri}</if>
            <if test="userId != null "> and user_id = #{userId}</if>
            ${params.dataScope}
        </where>
    </select>

添加@DateScope注解启用数据权限

/**
         * 查询图片管理列表
         *
         * @param picture 图片管理
         * @return 图片管理
         */
        @Override
        @DataScope(deptAlias = "d", userAlias = "u")
        public List<Picture> selectPictureList(Picture picture)
        {
        
            return pictureMapper.selectPictureList(picture);
        }

2.4 查看是否生效  
dearth用户  
![在这里插入图片描述][4775846e0dc445258e6808f4bfdf2e2d.png]  
ry用户  
![在这里插入图片描述][be2c6a8c75784f58873cd1a2bf1deaa1.png]  
说明已经生效

[4e22d593e0634bc69245bf301639d3e3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/7ba14690833c4da78e67361da3685fa8.png
[d0fc99fe671643369c043b849617d459.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/105d9054dd684c0a903f5a05202d2b04.png
[5d8a571ba2a541068b7c7c8d7b278e1f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/c9a77db76fc7459c8bdc3cdd82fd2b9b.png
[7bc68070a79c4b83865e57d4d9c80b50.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/47fe7d5425a3496da5a917e4128b4fcb.png
[220d41ee764b4f7c9c2f1688340f65f6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/baeeb87e9eda4732a83109ec932c0057.png
[4775846e0dc445258e6808f4bfdf2e2d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/127de4f8db314fb088acc9fafcd6c40d.png
[be2c6a8c75784f58873cd1a2bf1deaa1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/430213b71bf942389a8bee1f62855872.png