组织、工作区、RBAC/ABAC 与身份治理

权限层级

一个用户有一个 Organization role，并在每个加入的 Workspace 中有一个 Workspace role。Organization role 管组织配置、成员、计费与 Workspace；Workspace role 管具体资源。

层级	内置角色	关键语义
Organization	Admin、Operator、User、Viewer	Admin 可管理全部并进入所有 Workspace；Viewer 不可建 PAT
Workspace	Admin、Editor、Viewer	Admin 管成员/Key；Editor 管大部分资源；Viewer 只读

Enterprise 才有 Workspace RBAC 与自定义角色；其他计划常把成员视为 Admin。Organization Admin 的权限会向全部 Workspace 提升，不能用 Workspace Viewer 降低它。限制高权限角色时先保留至少两个 break-glass 管理员。

PAT 继承用户权限，适合个人工具；生产服务优先 Service Key。
Workspace-scoped Service Key 只能访问指定 Workspace。
Organization-scoped Service Key 访问 Workspace resource 时必须带 X-Tenant-Id，否则 403。
管理 Organization API 还应带 X-Organization-Id；不要依赖“Key 默认 Workspace”这种隐式行为。

API、Terraform 与 UI 都能改资源，生产应确定一个权威控制面并用 drift 检测，避免权限被交替覆盖。

ABAC 求值模型

ABAC 以 Resource Tag 补充 RBAC，目前唯一支持的 attribute_name 是 resource_tag_key。Policy 结构为：

多个 condition group 之间是 OR；
同一 group 内 conditions 是 AND；
deny 永远优先；
匹配的 allow 可在 RBAC 不允许时额外授权；
没有 ABAC match 时回退 RBAC。

*_if_exists 在 tag 不存在时也匹配，放在 allow 会放行未标记资源，放在 deny 会拦截未标记资源，风险很高。更安全的生产模式是先强制资源创建时打 Application/Environment/客户边界标签，再用明确 deny 保护敏感 tag。

Self-hosted ABAC 要求 Helm chart 0.11.28+、应用 0.12.1+；开启组织 feature flag 涉及直改 PostgreSQL 或全局环境变量，必须备份、审批并先在测试组织验证。

Resource Tag

Tag 是 Workspace 内 key-value，用于组织和 ABAC。Application 与 Environment 为默认 key。它不同于 Prompt commit tag：Resource Tag 组织/授权资源，commit tag 指向 Prompt 历史版本。

只有 Workspace-scoped resource 可标记。创建 tag key、普通 tag 赋值通常需要 workspaces:manage；Editor 仅可对有更新权的资源应用 Application tag。删除 tag 前先检查 ABAC Policy，否则可能改变授权结果。

SSO、JIT、Invite 与 SCIM

SSO Organization 有两个独立开关：

JIT	Invite	结果
开	开	登录自动加入，也可预邀请
开	关	仅通过 SSO 登录自动加入
关	开	仅预邀请用户可加入
关	关	关闭自助入口，只能 SCIM/管理员流程

SAML-only 前必须由 SAML 会话中的管理员操作，避免 IdP 配置错误锁死组织。JIT 只作用于首次加入的用户；已有成员角色不会每次登录自动重置。

SCIM 适合主动 provisioning/deprovisioning 和近实时 group push，通常应关闭 JIT 以避免冲突。SCIM group membership 会覆盖手工/JIT role。NameID、OAuth sub 与 SCIM identity 要稳定一致。

SSO Groups Sync 从登录 token 的 group claim 同步，部署更轻，但用户被移出 IdP group 后要到下次登录才撤权。它与 SCIM 技术上可共存，官方建议每 Organization 选择一种，避免 precedence 难以解释。禁用 Groups Sync 不会立即移除现有 access。

审计

Enterprise Audit Log 记录 actor、时间、operation、resource 与成功状态，保留最长 400 天。Organization Admin/Operator 才能查看；Self-hosted 需满足版本/开关要求。对接 SIEM 时使用增量 cursor、幂等 event ID、时钟同步和传输失败告警，不能只定期手工导出。

重点审计事件：成员/角色、API Key、SSO/SCIM、ABAC Policy、数据留存、Deployment、Dataset、Prompt webhook 与删除操作。

自托管用户管理开关

Self-hosted 可允许 Workspace Admin 邀请组织用户、设置默认 Organization/Workspace/Role、启用 SSO group sync、禁止创建 Organization/Personal Organization/PAT。Feature flag 变更要验证已有用户和新用户两条路径，不能只测管理员账号。

删除 Organization/Workspace 的高风险边界

新版本 Workspace 删除已有原生能力；旧版脚本和 Organization 删除脚本会直接删除 ClickHouse materialized views/table 数据并修改 PostgreSQL tenant 记录。此操作跨多个数据库、不可逆且可能长时间占用资源。

执行前必须：完整备份、停止相关写入、精确核对 ID、导出资源清单、在相同版本副本演练；执行后校验 PostgreSQL、ClickHouse、Blob、API key、成员与 UI。禁止把“脚本退出 0”当作数据一致性证明。