RBAC with Domains

带域的角色定义

在 Casbin 中，角色可以 按域划分：同一个用户在不同的域（租户）中可以有不同的角色。这适合一个用户在多个租户中工作的多租户和云系统。

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

[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）。

匹配器：在 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。

名称与位置

# 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