RBAC - 简单的并发角色权限控制（GO）

RBAC - 简单的并发角色权限控制（GO）

RBAC（Role-Based Access Control）是一个基于角色的权限控制库，用于GO语言。该项目在核心上使用sync.Map，因此它可以从多个goroutines并发使用。项目的核心理念是“保持简单”，支持角色继承，并且可以用于中间件（例如，为echo框架提供的示例）。

主要编程语言

该项目主要使用GO语言编写。

新手常见问题及解决步骤

问题一：如何安装和使用RBAC库？

解决步骤：

1. 首先，确保您的开发环境中已经安装了GO语言环境，版本至少是1.9+。
2. 使用go get命令获取RBAC库：

   go get github.com/euroteltr/rbac
   

3. 在您的项目中导入github.com/euroteltr/rbac库。
4. 创建一个RBAC实例，可以传递一个日志器到构造函数中（可选）：

   R := rbac.New(nil) // 或者使用自定义日志器：R := rbac.New(rbac.ConsoleLogger)
   

5. 在开发阶段，注册资源权限和有效操作：

   usersPerm, err := R.RegisterPermission("users", "User resource", rbac.Create, rbac.Read, rbac.Update, rbac.Delete)
   if err != nil {
       panic(err)
   }
   

问题二：如何定义角色并分配权限？

解决步骤：

1. 在运行时，定义角色并分配权限：

   adminRole, err := R.RegisterRole("admin", "Admin role")
   if err != nil {
       fmt.Printf("can not add admin role, err: %v\n", err)
   }
   

2. 允许角色拥有特定权限：

   if err = R.Permit(adminRole.ID, usersPerm, rbac.CRUD, ApproveAction); err != nil {
       fmt.Errorf("can not permit CRUD and ApproveAction actions to role %s\n", adminRole.ID)
   }
   

问题三：如何检查角色是否具有特定权限？

解决步骤：

1. 使用IsGranted方法检查角色是否具有特定权限：

   if !R.IsGranted(adminRole.ID, usersPerm, rbac.Write) {
       fmt.Printf("admin role does not have write grant on users\n")
   } else {
       fmt.Printf("admin role does have write grant on users\n")
   }
   

2. 也可以通过权限ID进行检查：

   if !R.IsGrantedStr("admin", "users", rbac.CRUD) {
       fmt.Printf("admin role does not have CRUD grant on users\n")
   } else {
       fmt.Printf("admin role does have CRUD grant on users\n")
   }