成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Clerk Organizations 多租户角色权限简报

按 Organization/Active Organization、默认 Roles、Role Sets 与会话上下文,整理 B2B 多租户 RBAC 简报;不代改生产 Role、不代持密钥。

场景说明

面向独立开发者与轻量企业:把「用户多组织切换与角色鉴权」写成可对账步骤,区别于 Clerk 用户事件 Webhooks 与泛 OIDC 登录报错。

案例叙事

01他们做了什么

做类 Slack/Linear 的多工作区产品时,常见卡点是:用户属于多个组织,却在后台请求里串用了错误的组织上下文,或默认把所有成员当成管理员。

Clerk Docs《Organizations》(dateModified 可核)说明:Organizations 用于按 Roles 与 Permissions 分组用户,以构建多租户 B2B 应用;用户可属于多个 Organization,Clerk 在每个会话中提供 Organization 上下文(成员关系、Roles、Active Organization),据此控制展示数据与允许操作。Organization 位于 Clerk 应用内;Roles 与 Permissions 在应用级定义一次,作用于该应用下全部 Organization。用户当前查看的 Organization 称为 Active Organization,决定其可访问的组织数据及在该组织内的 Role/Permissions。用量以 Monthly Retained Organizations(MRO)计量;免费套餐在开发/生产有 MRO 上限。多浏览器标签下,各标签独立维护自己的 Active Organization;但会话 token cookie 是浏览器级单例,始终反映当前活动标签的 Active Organization,因此后台 fetch 若跨标签共享会话,可能读到「错误组织」的上下文。配套《Roles and Permissions》给出默认 Role:org:admin(完整系统权限)与 org:member(默认偏只读成员/账单等有限权限);创建组织的用户会被赋 Creator Role(默认 org:admin),且用作 Creator Role 的 Role 不可直接删除。本场景据此输出多租户 RBAC 简报。禁止声称「生产 Role 已改好」或回显密钥。

02实际效果

  • 源未披露量化「越权事件下降」;公开文只描述 Org 模型、Active Organization、默认 Roles 与多标签会话注意点。
  • 能把「串组织上下文 / 全员 admin / 与用户 Webhook 同步壳混淆」拆开。
  • 为 B2B 工作区切换与鉴权提供可落地的核对清单。

03值得知道

  • MRO 与套餐限额以定价页为准;本条不解读计费报价。
  • 自定义 Permission 命名与校验 API 以 Roles and Permissions 页为准。
  • 上面写的是产品机制,不是你实例下现有 Organization 列表。

04可复制提示词

Clerk Organizations RBAC 简报

你是 Clerk Organizations 助手。只给多租户角色权限核对简报,不要编造已配置完成。

产品形态:{{product_shape}}
成员是否多组织:{{multi_org}}
需要的角色:{{roles_needed}}
跨标签/后台请求症状:{{symptom}}

输出 Markdown:
1. Org / Active Organization 模型
2. 默认 Roles 与 Creator Role 提问
3. 多标签会话 cookie 注意点
4. Dashboard/SDK 验收步骤
禁止索要 Secret Key;禁止代改生产 Role Set。

串组织/越权排查提纲

用户看到错误工作区数据或权限过大,请写排查提纲。

复现步骤:{{repro}}
当前 Active Organization 认知:{{active_org}}
角色摘要:{{role_brief}}

输出:
1. 是否多标签导致会话 cookie 与 UI 不一致
2. 是否误用 org:admin 作默认成员角色
3. 后端是否未校验 Active Organization
4. 下一步人工验证
不要伪造「越权已消除」。

05一手来源

Clerk Documentation · Organizations ↗

文档更新

怎么做

  1. 粘贴应用是否 B2B 多工作区、现有成员模型、需要的默认/自定义角色,以及跨标签页串组织症状
  2. Agent 按官方 Organizations 与 Roles and Permissions 要点输出:Org 模型→Active Organization→默认 Roles/Creator Role→会话上下文与多标签提问清单
  3. 人工在 Clerk Dashboard/SDK 配置;Agent 不代改生产 Role Set、不代持 API 密钥

实用提示

  • Roles/Permissions 在应用级定义,再经 Role Sets 供给各 Organization;Active Organization 决定当前可见数据与权限
  • 与 clerk-webhooks-user-events-brief 不同:本条是会话内多租户 RBAC 模型,不是用户生命周期出站 Webhook
#Clerk#Organizations#RBAC#多租户#独立开发者