基于三段式命令及筛选器的rbac权限控制方案
admin
2024-04-05 19:38:52
0次

引用自 摸鱼wiki

1. 权限命令的表示

1.1 权限命令

采用三段式设计,将命令划分为类型、操作、属性/对象三个层级。相较于采用常量声明,这样的写法可以支持使用通配符进行设置,减少调用时的代码量。

// 常量
File_Add
File_Delete
File_Switch_Page
File_Switch_Step// 三段式
File::Add
File::Delete
File::Switch::Page
File::Switch::Step// 通配符(常量无法做到)
File::Switch::* = [File::Switch::Page,File::Switch::Step
]
File::*::* = [File::Add,File::Delete,File::Switch::Page,File::Switch::Step
]

1.2 权限作用域筛选器

形如 属性名/满足条件的属性值 结构,表示允许通过当前权限的必要属性以及对应的属性值。

// 属性名/满足条件的值
creator/user1  仅允许具有creator属性,且值为user1的对象进行操作
operator/user2  仅允许操作者为user2进行操作
color/red,black 仅允许具有color属性,且值为red或者black##的对象进行操作

2. 权限校验模块

该模块主要分为五大功能:权限命令解析,权限作用域筛选器解析,添加权限命令,移除权限命令以及权限校验。

2.1 权限命令解析

权限命令是三段式命令,中间采用 :: 隔开。因此只要按照规范进行字符串分拆即可。

/*** 权限命令解析器* @param permissionName 权限命令*/
function _cmdParser(permissionName: string) {const [type, action = '*', attr = '*'] = permissionName.split('::');return [type, action, attr];
}

由于允许用户传入通配符格式的权限命令,为了方便计算,内部需要把通配符命令转换成具名命令,方便内部进行匹配

/*** 预定义的权限命令表*/
PermissionHandler.PermissionMap: { [type: string]: { [action: string]: { [attr: string]: boolean } } } = {};/*** 判断命令是否合法* @param cmd 解析后的命令*/
function _valid(cmd: string[]) {const [type, action, attr] = cmd;if (type === '*' || action == '*') {return true;}return !!(PermissionHandler.PermissionMap[type] &&PermissionHandler.PermissionMap[type][action] &&PermissionHandler.PermissionMap[type][action][attr]);
}/*** 获取显式权限命令(Type和Action不能为*)* @param cmd 权限命令* @returns*/
function _extractExplicitPermission(cmd: readonly string[]) {let typeKeys: string[] = [];let actionKeys: string[][] = [];let explicitPermission: string[] = [];if (cmd[0] === '*') {typeKeys = Object.keys(PermissionHandler.PermissionMap);} else {typeKeys = [cmd[0]];}if (cmd[1] === '*') {typeKeys.forEach((typeKey) => {actionKeys.push(Object.keys(PermissionHandler.PermissionMap[typeKey]));});} else {typeKeys.forEach((typeKey) => {actionKeys.push([cmd[1]]);});}for (let i = 0; i < typeKeys.length; i++) {for (let j = 0; j < actionKeys[i].length; j++) {const newCmd = [typeKeys[i], actionKeys[i][j], cmd[2]];if (_valid(newCmd)) {explicitPermission.push(newCmd.join('::'));}}}return explicitPermission;
}

2.2 权限作用域筛选器解析

权限作用域筛选器的格式形如 x/y,z,而且输入可能出现 [x/y, x/z],因此需要把相同属性名进行聚合,并且保证满足条件的属性值不重复。为了提高查找时的性能,这里采用了 Map + Set 结构进行存储,保证在查找时满足 O(1) 时间复杂度。

/*** 筛选器解析器* @param filters 筛选器列表(形如:creator/xxx)*/
function _filterParser(filters: readonly string[]): Map> {const filterMap = new Map>();for (const filter of filters) {const [attr, conditions] = filter.split('/');const nSet = new Set(conditions.split(','));const oSet = filterMap.get(attr);if (oSet) {filterMap.set(attr, new Set([...oSet, ...nSet]));} else {filterMap.set(attr, nSet);}}return filterMap;
}

2.3 添加权限命令

这一模块用于批量添加权限命令及其对应的筛选器。主要工作流程如下:

  1. 解析作用域筛选器
  2. 解析命令,并提取具名权限命令
  3. 具名权限命令设置作用域筛选器
/*** 权限拦截器存储结构*/
const interceptorMap = new Map>>();/*** 添加权限拦截器* @param permissions 权限名称* @param filter 筛选器*/
function setInterceptor(permissions: string[], filter: readonly string[]) {let explicitCmds: string[] = [];// 解析作用域筛选器const filters = _filterParser(filter);// 解析命令,并提取具名权限命令permissions.forEach((permissionName: string) => {const cmd = _cmdParser(permissionName);if (!_valid(cmd)) {return;}const explicitCmd = _extractExplicitPermission(cmd);explicitCmds = explicitCmds.concat(explicitCmd);});// 具名权限命令设置作用域筛选器explicitCmds.forEach((dCmd) => {const newFilters = filters;if (interceptorMap.has(dCmd)) {const old = interceptorMap.get(dCmd);old?.forEach((val, key) => {if (!newFilters.has(key)) {newFilters.set(key, val);}})}interceptorMap.set(dCmd, newFilters);});
}

2.4 移除权限命令

这一模块用于批量删除权限命令及其对应的筛选器。主要工作流程如下:

  1. 解析命令,并提取具名权限命令
  2. 移除对应权限命令
/*** 移除权限拦截器* @param permissions 权限名称*/
removeInterceptor(permissions: string[]) {let explicitCmds: string[] = [];permissions.forEach((permissionName: string) => {const cmd = _cmdParser(permissionName);if (!_valid(cmd)) {return;}const explicitCmd = _extractExplicitPermission(cmd);explicitCmds = explicitCmds.concat(explicitCmd);});explicitCmds.forEach((dCmd) => {interceptorMap.delete(dCmd);});
}

2.5 权限校验

这个功能是整个模块的灵魂,前面的所有功能都是为其服务的。其主要工作流程可划分为下列模块:

2.5.1 解析命令

const cmd = _cmdParser(permissionName);
// 命令不合法,跳过权限校验
if (!_valid(cmd)) {return true;
}

2.5.2 获取最高权限对应的作用域筛选器

由于权限命令是三段命令式,用户可能在不同的层级上设置了不同的权限作用域筛选器。因此,需要给各个层级定义筛选器生效的优先级。

本方案的优先级定义是:

三级具名命令 > 三级模糊命令 > 二级具名命令 > 二级模糊命令 > 一级具名命令 > 一级模糊命令

// 以 File::Switch::Page 举例
// 优先级从高到低依次为File::Switch::Page
File::Switch::*
File::*::*
*::*::*

对应的代码实现为:

/*** 获取最高权限的筛选器* @param cmd 权限命令*/
function getHighestAuthorityFilter(cmd: readonly string[]) {const realCmd = cmd.concat([]);let loop = 3;let cmdStr = '';while (loop) {cmdStr = realCmd.join('::');if (interceptorMap.has(cmdStr)) {return interceptorMap.get(cmdStr);}realCmd[--loop] = '*';}return undefined;
}

2.5.3 权限可通过性判断

conditions 为待判断的对象,通过遍历对象上与作用域筛选器相同的字段,检测对象上的对应值是否在筛选器的可通过条件列表中。如是,返回校验通过,否则,返回校验不通过。

function checkHasPermission(conditions: any[], filters: Map>) {let hasPermission = true;if (filters) {filters.forEach((valSet, attr) => {// 短路运算(已评为不满足/属性值带有*)if (!hasPermission || valSet.has('*')) return;// 任意属性均需要满足条件if (attr === '*') {for (const obj of conditions) {for (const attrKey of Object.keys(obj)) {if (!valSet.has(obj[attrKey])) {hasPermission = false;break;}}if (!hasPermission) {break;}}} else {for (const obj of conditions) {if (!valSet.has(obj[attr])) {hasPermission = false;break;}}}});}return hasPermission;
}

2.5.4 模块代码总览

/*** 判断是否具有操作权限* @param permissionName 权限名称* @param conditions 受影响的对象*/
function checkPermission(permissionCmd: string, conditions: readonly { [key: string]: any }[]): boolean {// 解析命令const cmd = _cmdParser(permissionCmd);if (!_valid(cmd)) {return true;}// 获取最高权限对应的作用域筛选器const filters = getHighestAuthorityFilter(cmd);// 权限可通过性判断return checkHasPermission(conditions, filters);
}

3. 使用案例

// 禁用全部操作权限setInterceptor(['*::*::*'], ['operator/']);
// 'operator/' 表示对于操作者(operator)这个条件,符合的值是空的,意味着没有操作者能够被允许通过这个权限校验checkPermission('File::Switch::Page', [{ operator: 'xxx' }])
// false
// 启用全部操作权限setInterceptor(['*::*::*'], ['operator/*']);
// 'operator/*' 表示对于操作者(operator)这个条件,符合的值是任意的,意味着所有操作者能够被允许通过这个权限校验checkPermission('File::Switch::Page', [{ operator: 'xxx' }])
// true

相关内容

热门资讯

蜻蜓订购APP贵金属订购非法期...   蜻蜓订购APP以"投资平台"名义对外宣传,主打贵金属期货(订购)交易。该平台一方面强调自身"正规...
悟空订购APP非法期货交易欺骗...   近期,有投资者反映,“悟空订购APP”等平台以白银、贵金属订购为名,宣传所谓“高收益”“低门槛”...
小赢淘金APP期货投资骗局,平...   “小赢淘金”之流,最擅长的就是用“注册送现金”、“充值返券”的糖衣炮弹来引流。别天真地以为那是福...
八方淘金APP非法期货交易欺骗...   警惕!八方生财、每日淘金、小赢淘金、悟空订购、蜻蜓订购、斗金订购等APP均涉嫌非法期货交易!  ...
智易购APP贵金属订购交易骗局...   很多人看到“3元起投”“充值送福利”“操作简单”“随时提现”这类宣传,很容易把智易购APP当成普...
喜玛银庄APP商品订购投资骗局...   喜玛银庄APP白银、铂金“现货订购”骗局警示:无资质平台涉嫌非法期货交易,投资者爆仓后如何维权?...
吉鑫乐享APP炒贵金属订购交易...   近期,多名投资者反映在“吉鑫乐享APP”进行贵金属投资时遭遇严重亏损,甚至血本无归。看似正规的“...
易掘金APP虚假期货投资骗局,...   “易掘金”的APP它打着“高收益、灵活投资”的旗号,宣称通过“商品订购”就能轻松赚钱,吸引了不少...
在大吉订购APP订购交易亏损被...   近期,不少投资者反映在“大吉订购App”上投资白银、铂金等商品遭遇严重亏损。该平台宣称提供现货订...
铂银壹号APP商品订购交易亏损...   许多中小投资者误以为网上的“商品现货订购”是合规合法的理财渠道,殊不知这背后隐藏着巨大的合规风险...
兴鑫淘金APP贵金属订购交易亏...   白银、贵金属或其他商品类投资,除国家批准的正规期货交易场所及持牌期货公司外,市面上大量第三方交易...
铂银掘金APP无资质的违规平台...   铂银掘金等平台的投资者,往往是被“注册送现金”“充值返现券”“首单免亏”等广告话术吸引,进而下载...
八方淘金APP订购交易不合规,...   “八方淘金APP”“铂银掘金APP”“铂银壹号APP”等软件被指以“现货订购”为名,实际采用高杠...
在指尖订购APP订购商品亏损被...   指尖订购APP这类平台,表面是“订购交易”,实则是披着电商外衣的非法期货陷阱。绝大多数投资者被蒙...
在犀贝易购APP做商品订购交易...   市面上打着“现货投资”“贵金属交易”旗号的APP并不少,但真正合规、受监管的平台并不多。犀贝易购...
易达淘金APP虚假商品订购交易...   易达淘金APP存在严重的虚假宣传与违规交易行为。该平台打着“商品订购”的旗号,实则通过不合规的交...
大浪淘金APP白银订购亏损被骗...   大浪淘金APP最隐蔽的套路,在于其完全封闭的内盘交易系统。表面上,它宣称与国际贵金属市场接轨;实...
一品好购APP上订购白银出现亏...   一品好购APP原名“一品订购”,运营方为上海宝智未来信息技术有限公司。近期不少投资者反映在该平台...
九州订购APP贵金属订购投资骗...   九州订购APP正通过抖.音、快手、今日头条等平台大量投放投资广告,用“5元起投”“充值返现”“0...
坚锅淘金APP交易软件并不正规...   当前,市面上大量所谓的“现货商城订购”交易软件,早已偏离了正常的实物商品买卖,演变为高杠杆、高手...