多个租户
面向有多个客户的部署,看清一份文档的作用范围到哪里为止。本页在一个平台上放三个租户,演示三件事,每件事都是一个在每次构建时运行的场景:平台策略作用于每个租户,租户的绑定只作用于它自己的主体,边界可以限制一个租户最多能被放行什么。
你需要什么
| 多个租户 | |
|---|---|
| 文档 | 一份平台文档,以及 acme、globex 和 initech 各一份租户文档 |
| 令牌 | 每个主体的令牌带着它的 tenantId:主体只会对照它自己租户的文档求值 |
| 概念 | 租户、平台边界、租户隔离 |
文档
平台文档放所有租户共享的内容:一条绑定给所有人的策略,以及两个边界。boundary-standard 是默认边界,允许 /api/** 上的 GET 和 POST 成立;boundary-read-only 只允许 GET 成立。
json
{
"schema": 2,
"revision": 1,
"publishedAt": "2026-11-01T08:00:00Z",
"boundaries": {
"default": "boundary-standard"
},
"policies": [
{
"id": "read-orders",
"statements": [
{
"name": "read-orders",
"effect": "allow",
"action": "http:GET",
"resource": "http:path:/api/orders"
}
]
},
{
"id": "boundary-standard",
"boundary": true,
"statements": [
{
"effect": "allow",
"action": [
"http:GET",
"http:POST"
],
"resource": "http:path:/api/**"
}
]
},
{
"id": "boundary-read-only",
"boundary": true,
"statements": [
{
"effect": "allow",
"action": "http:GET",
"resource": "http:path:/api/**"
}
]
}
],
"bindings": [
{
"id": "read-orders",
"subject": "*",
"app": "*",
"space": "*",
"policy": "read-orders"
}
]
}acme 在自己的文档里把自己的策略绑定给所有人。它让 acme 的主体可以 POST /api/export:
json
{
"schema": 2,
"revision": 1,
"publishedAt": "2026-11-01T08:00:00Z",
"policies": [
{
"id": "acme-export",
"statements": [
{
"name": "export",
"effect": "allow",
"action": "http:POST",
"resource": "http:path:/api/export"
}
]
}
],
"bindings": [
{
"id": "acme-export",
"subject": "*",
"app": "*",
"space": "*",
"policy": "acme-export"
}
]
}globex 绑定同样的策略,并指明 boundary-read-only 是约束它的边界:
json
{
"schema": 2,
"revision": 1,
"publishedAt": "2026-11-01T08:00:00Z",
"boundary": "boundary-read-only",
"policies": [
{
"id": "globex-export",
"statements": [
{
"name": "export",
"effect": "allow",
"action": "http:POST",
"resource": "http:path:/api/export"
}
]
}
],
"bindings": [
{
"id": "globex-export",
"subject": "*",
"app": "*",
"space": "*",
"policy": "globex-export"
}
]
}initech 有一份文档,里面什么都没有,所以只有平台授予所有人的内容才会到达它:
json
{
"schema": 2,
"revision": 1,
"publishedAt": "2026-11-01T08:00:00Z"
}验证
wiki/examples/several-tenants 中的场景在每次构建时运行:
| 调用方 | 请求 | 结果 |
|---|---|---|
acme 的 alice | GET /api/orders | Permit:平台策略 read-orders 绑定给所有人 |
globex 的 gina | GET /api/orders | Permit:同一条策略,另一个租户 |
acme 的 alice | POST /api/export | Permit:acme 自己的绑定 |
initech 的 ivan | POST /api/export | Deny,隐式:绑定在 acme 的文档里,initech 的文档没有 |
globex 的 gina | POST /api/export | 被边界 Deny:globex 绑定了这个放行,但 boundary-read-only 没有针对 POST 的语句 |
每一行说明什么:
- **平台绑定是每个租户的。**平台文档作用于所有主体,不论它们属于哪个租户;只把每个租户都可以拥有的内容放进去。
- **租户的绑定只留在它的租户里。**主体只对照它自己租户的文档求值,所以
acme的Anyone绑定意思是“acme里的任何人”,从不是initech里的任何人。租户之间看不到也改不了彼此的文档(租户隔离)。 - **边界只限制,从不授予。**只有租户的边界里也有语句匹配,放行才成立。把它用于平台无论租户怎么写都要设的上限,例如只读套餐的租户。