跳到正文
V2EX·· 1 小时前AI 评分25

内容管理门户的二进制权限系统设计复盘

[技术复盘] 内容管理门户的权限系统设计

AI 导读

作者复盘了内容管理门户的权限系统设计,针对项目不需要按钮级和数据级权限的需求,选择用整数的二进制位表示权限,并通过按位与判断用户是否拥有某项权限。相比 RBAC 三表关联查询,这种实现更简单;但单个 32 位整型可表示的权限有限,作者认为权限超过 32 个时可考虑改用 RBAC。

正文

故事背景+环境吐槽

本人在去年的十月份,被公司裁员了。感觉现在广州这边的环境真的越来越差,大多数都是小公司,而且很多都风气不正,“扁平化”+加班+PUA。

BOSS 直骗更是过分,已读不回+非得拉我线下面试刷 KPI 的更是数不胜数(这里点名天河科韵路那边的科技城,更是没个正经的),这里也奉劝各位在广州的大佬们注意,不要被不做人事的 HR 忽悠了。

在家呆久了真的很焦虑,虽然经济不至于影响生活,但总归每天都要支出,十年全栈的手艺活我不想就这么放下,所以就想着能不能接单做远程办公。

运气不错,在 12 月的时候接到了一个内容管理门户网站的项目,开发期 6k 维护期 1k,开发期 2 个月维护期 4 个月,毕竟新手刚上路,收入总的来说虽然比上班少很多,但也是个不错的开始,准备试试看能不能一点点的增加单量。

项目简介

项目是一个内容管理门户,主要功能包括文章发布、评论管理、用户管理、权限管理、角色管理、菜单管理、日志管理等。

项目采用前后端分离的方式,前端 react,后端 python,数据库 mysql,部署在阿里云服务器上。

我这个帖子只做技术复盘,我不敢将人家的项目里的完整代码放到 github 上公开。所以这里就只贴一部分的代码,做技术复盘的思路示例。

技术复盘

这次我想复盘的是权限系统设计。大佬们都知道一般提到权限系统就直接上 RBAC。

但我看这次的项目需求里并没有要求细分到某个用户要有哪个按钮的点击/查看/编辑权限,没有按钮级和数据级的权限。

我觉得直接上 RBAC 有点过于复杂了,尤其是外包接单的这种快速交付的情况下。

所以这里我选择了一个相对简单,但是又能够满足需求的权限系统设计。

二进制权限设计

RBAC 的设计里绕不开的是对权限的判断,比如某个角色里对某个模块的查看权限,这样就需要创建角色表、权限表和这两者的中间关联表了。

然后每次判断都需要联查拿出来做判断,这样我觉得显然是不太合适的。所以这里我选择了一个二进制权限的设计,将权限的判断简化为二进制判断。

假设如果一个人拥有读和写的权限,现在他的权限值为 6,当需要判断他是否拥有写权限时,只需要用 6 和 2 进行按位与运算(6 & 2 = 2),结果非 0 ,所以可以判断拥有此权限。当需要判断他是否拥有可执行权限时,同样只需要用 6 和 1 进行按位与运算 (6 & 1 = 0 ),结果为 0,所以可以判断不拥有此权限

那么我其实只需要将用户所属的角色的十进制权限值转换成二进制,然后进行按位与运算,就可以判断用户是否拥有某个权限了。

对查询来说,只需要查询用户所属的角色的权限值,然后进行按位与运算即可,不需要联查,甚至可以少一张中间表,大大提高了查询效率。

代码实现

from enum import Enum

class PermissionEnum(Enum):
    """ 权限枚举类 """
    
    PERMISSION_ORG = 1 # 组织权限
    """ 组织权限 """
    PERMISSION_USER = 2 # 用户权限
    """ 用户权限 """
    PERMISSION_ROLE = 4 # 角色权限
    """ 角色权限 """
    PERMISSION_KEYWORD = 8 # 关键词权限
    """ 关键词权限 """
    PERMISSION_SENSITIVE = 16 # 敏感词权限
    """ 敏感词权限 """
    PERMISSION_TAG = 32 # 标签权限
    """ 标签权限 """
    PERMISSION_LOG = 64 # 日志权限
    """ 日志权限 """
    PERMISSION_POSITION = 128 # 岗位权限
    """ 岗位权限 """
    PERMISSION_ALERT = 256 # 预警权限
    """ 预警权限 """
    PERMISSION_ARTICLE = 512 # 文章权限
    """文章权限"""

    """以此类推"""

    def to_str(self) -> str:
        """ 权限编码转换为字符串
        :return: 权限字符串
        """
        switch = {
            self.PERMISSION_ORG: "组织权限",
            self.PERMISSION_USER: "用户权限",
            self.PERMISSION_ROLE: "角色权限",
            self.PERMISSION_KEYWORD: "关键词权限",
            self.PERMISSION_SENSITIVE: "敏感词权限",
            self.PERMISSION_TAG: "标签权限",
            self.PERMISSION_LOG: "日志权限",
            self.PERMISSION_POSITION: "岗位权限",
            self.PERMISSION_ALERT: "预警权限",
            self.PERMISSION_ARTICLE:"文章管理"
        }
        return switch.get(self, self.value)

    @staticmethod
    def path_to_permission(path: str) -> int:
        """ 根据路径转换为模型列表
        :param path: 路径
        """
        switch = {
            "org": PermissionEnum.PERMISSION_ORG, 
            "user": PermissionEnum.PERMISSION_USER,
            "role": PermissionEnum.PERMISSION_ROLE,
            "keyword": PermissionEnum.PERMISSION_KEYWORD,
            "sensitive": PermissionEnum.PERMISSION_SENSITIVE,
            "tag": PermissionEnum.PERMISSION_TAG,
            "log": PermissionEnum.PERMISSION_LOG,
            "position": PermissionEnum.PERMISSION_POSITION,
            "alert": PermissionEnum.PERMISSION_ALERT,
            "article" :PermissionEnum.PERMISSION_ARTICLE
        }
        return switch.get(path, None)

    @staticmethod
    def get_all_permission() -> list:
        """ 获取所有权限
        :return: 所有权限列表
        """
        permission_list = []
        for permission in PermissionEnum:
            permission_list.append({
                "code" : permission.value,
                "name" : permission.to_str(),
            })
        return permission_list

class Permission:
    """ 权限控制类 """

    def __init__(self, user_permission_code: int):
        self.user_permission_code = user_permission_code

    def has_permission(self, permission: PermissionEnum) -> bool:
        """ 检查是否有指定权限
        :param permission: 权限编码项
        :return: 是否有指定权限
        """
        if permission is None:
            return False
        return ((self.user_permission_code & permission.value) != 0)
        
    def add_permission(self, permission: PermissionEnum):
        """ 添加权限
        :param permission: 权限编码
        """
        self.user_permission_code |= permission.value
        return self.user_permission_code

    def remove_permission(self, permission: PermissionEnum):
        """ 移除权限
        :param permission: 权限编码
        """
        self.user_permission_code &= ~permission.value
        return self.user_permission_code

    def set_permission_list(self, permission_list:list[PermissionEnum]) -> int:
        """ 设置权限
        :param permission_list: 权限列表
        """
        self.user_permission_code = 0
        for permission in permission_list:
            self.add_permission(permission)
        return self.user_permission_code

    def get_permission_list(self) -> list:
        """ 获取权限列表
        :return: 权限列表
        """
        permission_list = []
        for permission in PermissionEnum:
            if self.has_permission(permission):
                permission_list.append({
                    "code" : permission.value,
                    "name" : permission.to_str(),
                })
        return permission_list

使用示例

# 创建权限对象
permission = Permission(0)

# 添加权限
permission.add_permission(PermissionEnum.PERMISSION_ORG)
permission.add_permission(PermissionEnum.PERMISSION_USER)
permission.add_permission(PermissionEnum.PERMISSION_ROLE)

# 获取权限列表
permission_list = permission.get_permission_list()
print(permission_list)

# 检查是否有指定权限
has_permission = permission.has_permission(PermissionEnum.PERMISSION_USER)
print(has_permission)

# 移除权限
permission.remove_permission(PermissionEnum.PERMISSION_USER)

# 检查是否有指定权限
has_permission = permission.has_permission(PermissionEnum.PERMISSION_USER)
print(has_permission)

限制

但是这种设计方式存在一些限制,例如:一个整型32bit 所对应的权限是有限的,如果权限数量超过32个,那么就需要使用多个整型来表示权限,这样会增加代码的复杂度。

但其实我并没有遇到过有超过32个权限的情况,所以这种设计方式对于我来说已经足够了。

假设各位大佬们真的有这个情况,这里我建议比起网上说的需要加权限位或者分组权限位什么的,其实我觉得还是转回RBAC的方式会更舒服,因为RBAC的权限管理方式更加灵活,而且更加符合我们的业务需求。

一些总结

通过上面的方法,我们可以很方便地管理权限,并且可以很方便地扩展权限,只需要添加新的权限枚举项即可。

这套核心逻辑几十行,比搭完整 RBAC 三表 + 联查省不少事,外包这种场景完全够用。

有类似后台需求的朋友,欢迎一起交流。

来源:V2EX · v2ex.com