Skip to content

多个租户 ​

面向有多个客户的部署,看清一份文档的作用范围到哪里为止。本页在一个平台上放三个租户,演示三件事,每件事都是一个在每次构建时运行的场景:平台策略作用于每个租户,租户的绑定只作用于它自己的主体,边界可以限制一个租户最多能被放行什么。

你需要什么 ​

多个租户
文档一份平台文档,以及 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 的 aliceGET /api/ordersPermit:平台策略 read-orders 绑定给所有人
globex 的 ginaGET /api/ordersPermit:同一条策略,另一个租户
acme 的 alicePOST /api/exportPermit:acme 自己的绑定
initech 的 ivanPOST /api/exportDeny,隐式:绑定在 acme 的文档里,initech 的文档没有
globex 的 ginaPOST /api/export被边界 Deny:globex 绑定了这个放行,但 boundary-read-only 没有针对 POST 的语句

每一行说明什么:

  • **平台绑定是每个租户的。**平台文档作用于所有主体,不论它们属于哪个租户;只把每个租户都可以拥有的内容放进去。
  • **租户的绑定只留在它的租户里。**主体只对照它自己租户的文档求值,所以 acme 的 Anyone 绑定意思是“acme 里的任何人”,从不是 initech 里的任何人。租户之间看不到也改不了彼此的文档(租户隔离)。
  • **边界只限制,从不授予。**只有租户的边界里也有语句匹配,放行才成立。把它用于平台无论租户怎么写都要设的上限,例如只读套餐的租户。

基于 Apache License 2.0 发布