大话设计，没有模式—通用权限设计与实现

当代码写多了，总有些是经验，但经验是什么呢？if…else用的次数比别人多？显然不是。有些超棒的设计可以谓之经验！

功能权限

网络上流行的经典的权限设计是【主体】- 【领域】 - 【权限】( who、what、how问题原型 ) 的设计思想，其中：

【主体】可以是用户，可以是角色，也可以是一个部门

【领域】可以是一个模块，可以是一个页面，也可以是页面上的按钮

【权限】可以是“可见”，可以是“只读”，也可以是“可用”(如按钮可以点击)

为了简化程序开发，在OpenAuth.Core中去掉了权限的控制，简化为【主体】- 【领域】的模式，且【主体】限定为角色。即只能给角色分配模块和按钮，不能直接分配给用户账号或部门。且一旦分配即表示该角色拥有操作该模块（按钮）的权限。

大道至简，标准的RBAC规范比这个还要简洁，所以它的生命力才最顽强。在此基础上，如果进行二次开发，进行更详细的功能权限控制，可以按照上面的思想进行改造。

数据权限

数据权限是在功能权限的基础上面进一步的扩展，比如可以查看订单属于【功能权限】的范围，但是可以查看哪些订单就是【数据权限】的工作了。

这里面的几个概念：

【资源】：数据权限的控制对象，业务系统中的各种资源。比如订单单据、销售单等。

【数据规则】：用于数据权限的条件规则 。

应用场景

• 销售单，可以由本人查看
• 销售单，测试角色能看到自己的订单
• 销售单，测试角色能看到自己的订单，管理员角色可以看到所有订单
• 销售单，测试角色能看到自己的订单，管理员角色可以看到所有订单，账号test3可以看到应用名称为"xxx管理系统"的订单

我们能想到直接的方法，在访问数据的入口加入SQL Where条件来实现，以上4种情况对应的sql语句：

  1 where CreateUserID = {loginUser}
  2 where CreateUserID = {loginUser} and {loginRole} in (测试）
  3 where CreateUserID = ({loginUser} and {loginRole} in (测试)) or {loginRole} in (管理员)
  4 where CreateUserID = ({loginUser} and {loginRole} in (测试)) or {loginRole} in (管理员) or ({loginUser}==test3 and 应用名称==XXX管理系统)

这些一个一个的"条件"，简单理解为一个【数据规则】，通常会与原来我们前台的业务过滤条件合并再检索出数据。

每一个角色有不一样的【数据规则】，那么数据权限设计就变成

　　【资源】 - 【数据规则】

在数据库记录中存放为资源ID+规则的形式，如下：

为了简化程序开发，在开发过程中可以做出以下约定：

• 所有需要进行数据权限控制功能的表，在设计时必须包含字段CreateUserId（创建用户Id)。
• 【资源】的名称限定为模块名称。如部门管理，用户管理，那么资源就是对应的部门列表，用户列表。
• 如果【资源】没有设置数据规则，那么视为该资源允许被任何主体查看。
• 数据规则中授权的对象限定为角色、用户。即不能设定为某个部门所有，如果想实现类似的功能，通过角色间接实现。例如：资源属于角色“开发组成员”，“开发组组长”。

核心实现--查询对象模式

权限控制总离不开一些条件的限制，如果没有完善的查询机制，那么在做权限条件过滤的时候你会觉得很别扭。马丁在《企业应用架构模式》第13章对象-关系元数据映射模式中提出查询对象模式(Query Object Pattern)。该模式核心结构如下：

该结构为【数据规则】的建立提供了理论基础。在设计数据权限的时候，可以照搬该思想。上面例子中的规则，数据规则展开如下：

  1 {
  2 	"Operation": "or",
  3 	"Filters": [{
  4 		"Key": "{loginRole}",
  5 		"Value": "09ee2ffa-7463-4938-ae0b-1cb4e80c7c13",
  6 		"Contrast": "contains",
  7 		"Text": "管理员"
  8 	}],
  9 	"Children": [{
 10 		"Operation": "and",
 11 		"Filters": [{
 12 			"Key": "{loginRole}",
 13 			"Value": "0a7ebd0c-78d6-4fbc-8fbe-6fc25c3a932d",
 14 			"Contrast": "contains",
 15 			"Text": "测试"
 16 		}, {
 17 			"Key": "CreateUserId",
 18 			"Value": "{loginUser}",
 19 			"Contrast": "==",
 20 			"Text": ""
 21 		}]
 22 	}, {
 23 		"Operation": "and",
 24 		"Filters": [{
 25 			"Key": "AppName",
 26 			"Value": "XXX管理平台",
 27 			"Contrast": "==",
 28 			"Text": ""
 29 		}, {
 30 			"Key": "{loginUser}",
 31 			"Value": "229f3a49-ab27-49ce-b383-9f10ca23a9d5,1df68dfd-3b6d-4491-872f-00a0fc6c5a64",
 32 			"Contrast": "in",
 33 			"Text": "test3,test4"
 34 		}]
 35 	}]
 36 }

规则分为三个部分：【分组】(Children)、【规则】(Filter)、【操作符】(and or)，而规则自身就是一个分组。这种简单的结构就可以满足全部的情况。看不懂啥意思？

这样理解起来就比较简单了。

还不懂？？我们从简单的开始：

数据权限实例--按角色

某一角色只能看到自己创建的信息。如：针对资源列表，我们设置了【测试】角色可以看到自己创建的资源。

这时如果用一个拥有测试角色的账号（test）登录，那么他只能看到自己创建的资源：

其他角色的账号登录时，会出现无法看到任何信息。我们稍做调整：【管理员】角色可以看到所有资源，【测试】角色只能看到自己创建的资源。

这时如果用一个拥有管理员角色的账号（admin）登录，那么他就可以看到全部资源：

以此为基础，我们可以扩展非常复杂的数据权限控制。最终形成最后的复杂规则：【管理员】角色可以看到所有资源，【测试】角色只能看到自己创建的资源。账号test3/test4只能看到应用名称等于“XXX管理平台”的资源。

数据权限实例--按部门

 

管理员】可以看到所管辖部门的所有数据，其他角色只能看到自己的。

代码解析

可以在应用层基类BaseApp中，定义一个通用函数，根据当前即将访问的资源Id获取相应的访问【数据规则】，并把当前登录的用户信息注入到该规则中，最终转换成针对数据库的查询，如下：（不想看这个？直接跳过吧，看看如何使用也没有问题）

  1         protected IQueryable<T> GetDataPrivilege(string parametername)
  2         {
  3             var loginUser = _auth.GetCurrentUser();
  4             if (loginUser.User.Account == Define.SYSTEM_USERNAME) return UnitWork.Find<T>(null);  //超级管理员特权
  5 
  6             var moduleName = typeof(T).Name;
  7             var rule = UnitWork.FindSingle<DataPrivilegeRule>(u => u.SourceCode == moduleName);
  8             if (rule == null) return UnitWork.Find<T>(null); //没有设置数据规则，那么视为该资源允许被任何主体查看
  9             if (rule.PrivilegeRules.Contains(Define.DATAPRIVILEGE_LOGINUSER) ||
 10                                              rule.PrivilegeRules.Contains(Define.DATAPRIVILEGE_LOGINROLE))
 11             {
 12 
 13                 //即把{loginUser} =='xxxxxxx'换为 loginUser.User.Id =='xxxxxxx'，从而把当前登录的用户名与当时设计规则时选定的用户id对比
 14                 rule.PrivilegeRules = rule.PrivilegeRules.Replace(Define.DATAPRIVILEGE_LOGINUSER, loginUser.User.Id);
 15                 var roles = loginUser.Roles.Select(u => u.Id).ToList();
 16                 roles.Sort(); //按字母排序,这样可以进行like操作
 17                 rule.PrivilegeRules = rule.PrivilegeRules.Replace(Define.DATAPRIVILEGE_LOGINROLE,
 18                     string.Join(',',roles));
 19             }
 20             return UnitWork.Find<T>(null).GenerateFilter(parametername,
 21                 JsonHelper.Instance.Deserialize<FilterGroup>(rule.PrivilegeRules));
 22         }

这样在我们自己的应用中，使用上面的函数创建一个基础查询，再加上自定义的查询条件即可轻松实现数据权限的控制。

  1             var result = new TableData();
  2             var objs = GetDataPrivilege("u");
  3             if (!string.IsNullOrEmpty(request.key))
  4             {
  5                 objs = objs.Where(u => u.Id.Contains(request.key));
  6             }
  7 
  8             result.data = objs.OrderBy(u => u.Id)
  9                 .Skip((request.page - 1) * request.limit)
 10                 .Take(request.limit);

最后

以上所有代码均已实现并开源（配置数据规则的界面可以自己画，layui的前端画起来实在太费力），OpenAuth.Core秉承代码之美，为.net core添砖加瓦，喜欢的star一下！

 

 

来源：oschina

链接：https://my.oschina.net/u/4334340/blog/3227726