跳到主要内容

RBAC with Domains API

Convenience API for RBAC with domains:按域限定的用户-角色和权限操作。它是 Management API 的子集。在下文中,e 是一个加载了支持域的模型的 Enforcer 实例。

参考​

e, err := NewEnforcer("examples/rbac_with_domains_model.conf", "examples/rbac_with_domains_policy.csv")

GetUsersForRoleInDomain​

返回在给定域中拥有指定角色的所有用户。

res := e.GetUsersForRoleInDomain("admin", "domain1")

GetRolesForUserInDomain​

返回在给定域中分配给该用户的所有角色。

res := e.GetRolesForUserInDomain("alice", "domain1")

GetPermissionsForUserInDomain​

返回在给定域中该用户或角色的所有权限(策略规则)。

res := e.GetPermissionsForUserInDomain("alice", "domain1")

AddRoleForUserInDomain​

在域中将角色分配给用户。如果分配已存在,则返回 false。

ok, err := e.AddRoleForUserInDomain("alice", "admin", "domain1")

DeleteRoleForUserInDomain​

从域中的用户移除角色。如果链接不存在,则返回 false。

ok, err := e.DeleteRoleForUserInDomain("alice", "admin", "domain1")

DeleteRolesForUserInDomain​

移除域中用户的所有角色。如果用户在该域中没有角色,则返回 false。

ok, err := e.DeleteRolesForUserInDomain("alice", "domain1")

GetAllUsersByDomain​

返回在给定域中至少拥有一个角色的所有用户。如果模型没有域,则返回空。

res := e.GetAllUsersByDomain("domain1")

DeleteAllUsersByDomain​

移除给定域中的所有用户-角色分配。如果模型没有域,则返回 false。

ok, err := e.DeleteAllUsersByDomain("domain1")

DeleteDomains​

移除给定域的所有用户和角色。如果没有参数,则清除所有域。

ok, err := e.DeleteDomains("domain1", "domain2")

GetAllDomains​

返回策略中出现的所有域。

res, _ := e.GetAllDomains()
警告

请勿在域名中使用 ::;它在 Casbin 的表达式语法中是保留字符。

GetAllRolesByDomain​

返回给定域中出现的所有角色。

res := e.GetAllRolesByDomain("domain1")
备注

不包含通过层次结构继承的角色(隐式角色);仅包含域中的直接分配。

GetImplicitUsersForResourceByDomain​

返回给定资源和域的隐式用户(及其权限)——即通过其角色在该域中对资源拥有权限的用户。

p, admin, domain1, data1, read
p, admin, domain1, data1, write
p, admin, domain2, data2, read
p, admin, domain2, data2, write
g, alice, admin, domain1
g, bob, admin, domain2

示例:对于以下策略,GetImplicitUsersForResourceByDomain("data1", "domain1") 返回可以在 domain1 中访问 data1 的用户的权限(例如,alice 通过 role admin)。

ImplicitUsers, err := e.GetImplicitUsersForResourceByDomain("data1", "domain1")
备注

仅返回用户级别的结果;不会列出角色名称(g 规则中的第二个元素)。

Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.