跳到主要内容

RBAC with Domains

带域的角色定义​

在 Casbin 中,角色可以是 domain-scoped(域范围)的:同一用户可以在不同的域(租户)中拥有不同的角色。这适用于多租户和云系统,其中单个用户在多个租户中工作。

使用包含 三个 元素的角色的定义;第三个元素是域:

[role_definition]
g = _, _, _

第三个字段是域。示例策略:

p, admin, tenant1, data1, read
p, admin, tenant2, data2, read

g, alice, admin, tenant1
g, alice, user, tenant2

因此:tenant1 中的 admin 可以读取 data1。Alice 在 tenant1 中是 admin,在 tenant2 中是 user;她可以读取 data1 但不能读取 data2(只有 tenant2 中的 admin 可以读取 data2)。

Matcher:在 g 中包含域并要求其匹配:

[matchers]
m = g(r.sub, p.sub, r.dom) && r.dom == p.dom && r.obj == p.obj && r.act == p.act

自定义域令牌名称​

按照惯例,域命名为 dom,但你可以在请求和策略定义中使用任何名称(如 tenant, workspace 等):

[request_definition]
r = sub, tenant, obj, act

[policy_definition]
p = sub, tenant, obj, act

[role_definition]
g = _, _, _

[matchers]
m = g(r.sub, p.sub, r.tenant) && r.tenant == p.tenant && r.obj == p.obj && r.act == p.act

对于域的匹配模式(例如 keyMatch),只要域在请求和策略中都位于索引 1,Casbin 就会从模型中推断出域令牌:

[matchers]
m = g(r.sub, p.sub, r.tenant) && keyMatch(r.tenant, p.tenant) && r.obj == p.obj && r.act == p.act

对于具有 自定义 域令牌名称或位置的域 API(例如 GetAllUsersByDomain()),请在创建 enforcer 后设置索引。完整示例:rbac_with_domains_model.conf。

令牌名称和位置

域通常命名为 dom 并放置在第二位(sub, dom, obj, act)。在 Go Casbin 中,你可以使用其他名称或位置;然后在初始化后调用 e.SetFieldIndex("p", constant.DomainIndex, index),以便像 GetAllUsersByDomain() 这样的 API 能正常工作。

# Using `domain` instead of `dom`
[policy_definition]
p = sub, obj, act, domain
e.SetFieldIndex("p", constant.DomainIndex, 3) // index starts from 0
users := e.GetAllUsersByDomain("domain1") // without SetFieldIndex, this will raise an error

嵌套单元​

如果域形成树状结构(公司包含部门和科室),并且在某个单元授予的角色应适用于其整个子树,请参阅 Nested Organizations。

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