前端权限控制

一、前言

在成熟的电商系统中，权限管理是不可或缺的一个环节。灵活的权限管理有助于管理员对不同的人员分配不同的权限，在满足业务需要的同时保证敏感数据只对有权限的人开放。笔者最近对系统的权限管理做了一次改造，在此分享一些经验以供参考。

二、权限管理基础

权限管理一般分以下 3 个基础概念：

功能点
角色
用户

它们之间的关系一句话就能说清楚：一个用户可以拥有多个角色，而一个角色可以包含多个功能。比如一个员工可以既有收银员的角色，也有库管员的角色。对于收银员这个角色，可以有开单收银、查看订单、查看会员信息等功能点。

此外还有 2 个概念：

功能权限
数据权限

它们之间的关系举例来说明：

想象一个连锁店的场景，某个门店的管理员具有查看营收的功能权限，和查看自己门店数据的数据权限；高级管理员同样拥有查看营收的功能权限，并且有更高的数据权限，可以查看所有门店数据的数据。

三、前端权限控制

下面我们聚焦到前端领域，聊聊前端应该怎么做权限设计。前端本质上只有 1 种权限类型：组件权限。为了更好的理解和管理，又将组件权限拆分为以下 3 类：

每一个权限最终都会落到权限点上。权限点可以理解为一个数据编码，有这个权限点就说明有对应的功能权限。权限点的编码要注意 2 点：

全局唯一
尽量短小（减少带宽消耗，因为一个用户可能会有很多权限点）

需要控制权限的地方，都要定义一个权限点，然后告诉后端。一个用户所有的权限点会以数组的形式返回。判断是否有权限就是从数组中匹配一个元素。下面以 React 为例，聊聊具体的实现方式。

对于页面的权限判断，可以在 React Router 的 onEnter 回调中判断：

// 编码映射，下面的 getUrlCodeByName 会用到
export default {
    order_list:          'zaq0', // 订单列表
    order_detail:        'xsw1', // 订单详情
    order_refund_list:   'cde2', // 订单退款列表
    order_refund_detail: 'vfr3', // 订单退款详情
    order_deduct_modify: 'bgt4', // 订单修改业绩
};

function canAccessUrl(urlName) {
    const moduleCode = getUrlCodeByName(urlName); // 权限点一般是一个没意义的编码，为了易于理解，前端做了一个编码映射
    return accesses.u.indexOf(moduleCode) > -1;   // accesses.u 数组是后端返回的所有 url 权限点
}

function routerOnEnterCheck(urlName) {
    return function routerOnEnter(nextState, replace) {
        if (!canAccessUrl(urlName)) {
            replace('/unauthorized');
        }
    };
}

...

{
    path: 'list',
    getComponent: loadAsync(() => import(/* webpackChunkName: "order" */ '../../order/List')),
    onEnter: routerOnEnterCheck('order_list'),
}

...

复制

对于菜单和组件的权限判断，大体上长这样：

// 用以缓存是否有权限访问组件
const componentAccessCache = {};

/**
 * 检查访问组件的权限
 * 一个组件可能会重复 render 多次，而组件权限的数量可能会超多（上百个），因此将权限缓存起来以提高性能
 */
function canAccessComponent(module, componentName) {
    if (!module || !componentName) {
        console.error(`canAccessComponent ${module} ${componentName} 缺参数`);
    }

    const key = `${module}.${componentName}`;

    let result = componentAccessCache[key];

    if (result !== undefined) {
        return result;
    }

    const moduleCode = getComponentCodeByModuleAndName(module, componentName);  // 权限点一般是一个没意义的编码，为了更易于理解，前端做了一个编码映射

    result = accesses.c.indexOf(moduleCode) > -1;    // accesses.c 数组是后端返回的所有组件权限点

    componentAccessCache[key] = result;

    return result;
}

class SomeComponent extends PureComponent {

    ...
    
    render() {
        return (
            ...
            {
                canAccessComponent('asset', 'buy_pay') &&
                <Button
                    type="primary"
                    className="btn-buy"
                    onClick={() => (buy(num))}
                >
                立即订购
                </Button>
            }
            ...
        )
    }
}

复制

组件权限点的判断也可以封装成高阶组件的形式，这样看起来会舒服一点，但本质上是一样的，不再赘述。

权限点的获取笔者放在了 node 端，通过全局变量的形式注入到页面中，保证首屏的时候呈现的页面是由权限点过滤过的。此外接口返回的权限点是一个一维数组，为了加快前端检索速度，在 node 端根据编码规则将权限点分为 3 类（菜单/页面/组件），具体细节就不细说了。

四、总结

本文介绍了权限管理的基础知识，还结合 React 讲解了前端权限控制的一些细节。技术方案比较简单，真正麻烦的是每一个权限点的定义及录入，以及对现有系统的改造。改造过程中可以分模块进行迭代，毕竟罗马不是一天就能建成。