组织

什么是组织？

通过组织，您可以在与团队共享应用的同时，精确控制每个人的权限。每个 Capgo 账户都至少属于一个组织，您可以根据需要创建多个组织。

访问权限通过以下方式进行管理： 基于角色的访问控制 (RBAC)每位团队成员都会被分配一个角色（可在组织级别或针对特定应用进行分配），从而决定其可见内容和操作权限。您还可以通过针对特定 Channel 的权限覆盖来实现更精细的访问控制。

---

组织设置概览

点击以下图标即可进入组织设置页面： 设置 位于左侧边栏，然后选择顶部的 组织 选项卡。在此页面中，您可以切换以下板块：

选项卡	描述
常规	查看并编辑组织名称、Logo 及管理邮箱
成员	管理团队成员及其权限
分组	创建并管理用户组，实现批量角色分配
API 密钥	管理用于程序化访问的 API 密钥
套餐	查看并管理您的订阅方案
额度	查看并购买额外额度
安全	配置安全策略（2FA、密码强度要求）
使用情况	监控您组织的用量统计数据
审计日志	查看组织的活动日志
Webhooks	配置 Webhook 集成
计费	管理账单信息与发票

如何切换组织

点击 组织选择器 侧边栏左上角的下拉菜单，用于查看并切换你有权访问的组织。

---

管理成员

查看成员

Members 区块显示了所有拥有组织访问权限的用户，并包含以下信息：

• 成员：头像与姓名
• 角色：当前角色（Super Admin、Admin、Billing Manager 或 Member）以及 活跃 或 待处理 徽章
• 操作: 编辑角色、管理应用级权限或将其从组织中移除

活跃成员按角色优先级排序。待处理的邀请会显示橙色 待处理 徽章。

邀请成员

1. 点击 + 添加 Members 区域中的按钮
2. 一套 选择角色 将弹出模态框 — 请为新成员选择组织级角色：

可选的组织级角色如下：

• 成员 — 只读权限
• 账单管理 — 仅限账单权限
• 管理员 — 完全管理权限（无账单及删除权限）
• 超级管理员 — 完全控制权限

3. 点击 确认，然后填写邀请表单（邮箱、可选的姓氏/名字、验证码）并点击 发送邀请.

受邀用户将收到一封包含魔术链接的邮件。接受后，他们将以所选角色加入该组织。

分配应用级角色

除了组织级角色外，您还可以通过更精准的角色，授予成员对特定应用的访问权限。点击 访问控制 成员旁边的按钮（盾牌图标）以打开应用访问模态框：

通过此模态框，您可以：

1. 搜索并选择应用
2. 从下拉菜单中选择应用级角色

可用的应用级角色包括：

• 应用管理员 — 应用的全权管理权限
• 应用开发者 — 可上传 bundle、管理设备，但无法执行破坏性操作
• App 上传器 — 读取应用数据并上传 bundle
• App 阅读器 — 应用的只读权限

3. 点击 分配 以授予该角色。

编辑成员角色

点击成员旁边的编辑按钮（扳手图标）来更改其组织级角色。同样的 选择一个角色 弹窗将会出现，并预选当前角色。

限制条件：

• 您无法更改组织创建者的角色
• 您无法移除最后一个 Super Admin —— 必须始终保留至少一个
• 提升或降级 Super Admin 需要您本人也是 Super Admin

移除成员

点击成员旁边的删除按钮（垃圾桶图标）。随后会弹出确认对话框，提示此操作不可逆。点击 删除 以确认。这将立即撤销其对组织、旗下应用及频道的所有访问权限。

---

角色概览

Capgo 使用 基于角色的访问控制 角色按作用域进行组织。您可以在 组织 级别分配角色（拥有全部访问权限），也可以将其缩小到单个 应用可以通过针对特定 Channel 的权限覆盖来实现更细粒度的访问控制。

组织角色

在邀请成员时分配。这些角色适用于整个 Organization。

角色	内部名称	描述
超级管理员	org_super_admin	完全控制权 — 包含账单、删除和转移权限。创建 Organization 时自动授予。
管理员	org_admin	全面管理权 — 管理成员、App 和 Channel。不具备账单和删除权限。
账单管理员	org_billing_admin	仅限账单权限 — 查看/更新付款、发票及账单审计。无法访问应用或成员。
成员	org_member	对整个组织及其所有应用拥有只读权限。

App 角色

权限范围仅限单个应用。当团队成员仅需负责某个特定应用而非整个组织时，请使用此类角色。

角色	内部名称	描述
应用管理员	app_admin	拥有单个应用的完整控制权 — 包括 channels、devices 和团队。无法删除或转移该应用。
应用开发者	app_developer	上传 bundle、管理设备、触发 build、更新 channel。无法删除或更改设置。
App 上传器	app_uploader	读取权限 + 上传新的 bundle 版本。
App 阅读器	app_reader	只读权限 — 统计数据、bundles、channels、logs、设备。

Channel 权限覆盖

默认情况下，channel 访问权限继承自 App 角色。您可以针对特定用户或组覆盖特定的 channel 权限 —— 例如，允许 App Reader 也能在 staging channel 上关联 bundle。请参阅 App 级访问管理 下方了解如何进行配置。

提示

如需查看各角色的详细权限说明、角色层级以及 API/CLI 的使用方法，请参阅 访问控制参考.

---

应用级访问管理

每个应用都有一个专属的 访问权 标签页，您可以在其中管理用户对应用的访问权限及其操作范围——包括应用角色和针对特定 Channel 的权限覆盖。

查看应用访问权限

导航至您的应用并点击 访问权 选项卡。访问列表会显示每个用户或组及其：

• 邮箱 — 用户邮箱（或组名）
• 角色 — 应用级角色（App Admin、App Developer、App Uploader 或 App Reader）
• 授予时间 — 角色分配的时间
• 操作 — channel 权限（盾牌图标）、编辑角色（扳手图标）以及移除（垃圾桶图标）

更改应用角色

点击 编辑 用户旁边的按钮（扳手图标），用于更改其应用级角色：

选择新角色并点击 确认。可选角色如下：

• 应用开发者 — 可上传 bundle、管理设备，但无法执行破坏性操作
• App 上传器 — 可读取应用数据并上传 bundle
• App 阅读器 — 只读权限

注意

应用管理员 不会在此模态框中显示，因为它是在组织级 Members 页面分配的。请参阅 分配应用级角色 以上内容。

覆盖 channel 权限

点击 channel 权限 用户旁边的按钮（盾牌图标），用于覆盖其默认的 Channel 权限：

该模态框显示用户当前的 App 角色，并列出所有 Channel 及其可单独覆盖的三项权限：

权限	描述
读取	查看 Channel 及其当前 Bundle
历史记录	查看 Bundle 分配历史
关联 Bundle	设置或更改 Channel 的当前活跃 Bundle

每项权限默认设为 默认（允许） — 表示它继承自应用角色。你可以将任意权限显式改为 允许 或 拒绝 针对特定 channel，让你无需更改用户的整体应用角色即可精细控制。

---

分组

分组让你可以一次性为一组用户分配角色，而不用逐个管理成员。分组属于一个组织，可在任意范围（组织或 app）持有角色绑定。

示例： 创建一个“QA Team”分组，并为其分配 应用开发者 在您的生产应用中分配角色，该组的所有成员都会立即获得该应用的 Developer 权限。当成员加入或退出团队时，只需将其从组中添加或移除即可 —— 无需修改单个角色的绑定关系。

分组机制

• 分组是指 组织范围内的 —— 它属于一个特定的组织，不能跨越多个组织。
• 您为分组分配角色的方式与为用户分配角色相同 —— 在角色绑定中，该分组会被视为一个主体 (principal)。
• 当检查用户的权限时，系统会自动解析其所属的所有分组。如果其任何一个分组拥有的角色具备所需的权限，则授予访问权限。
• 用户可以属于多个分组，所有分组的权限将会进行合并。

查看分组

前往 分组 选项卡，在组织设置中。分组列表会显示每个分组的 名称, 描述, 角色, 创建日期，以及 操作 （编辑或删除）。

创建分组

点击 + 添加 打开创建分组页面的按钮：

填写以下内容：

1. 名称 （必填）以及 描述 (可选)
2. 组织角色 — 可选：分配组织级角色（None、Admin、Billing Manager 或 Member）
3. 访问控制 标签页 — 通过点击来分配应用级角色 + 添加应用，选择一个应用并指定角色（例如 App Uploader、App Developer）

您需要 超级管理员 或 管理员 创建分组。

管理组成员

点击分组以打开详情视图。切换到 成员 标签页：

在这里可以查看当前成员及其邮箱。点击 + 添加 即可添加成员：

弹窗中会显示所有组织成员。按姓名搜索，勾选要添加的成员，然后点击 添加成员.

提示

有关 API 的使用方法及群组的技术细节，请参阅 访问控制参考 — 群组.

---

计费

仅 超级管理员 (org_super_admin) 以及 账单管理员 (org_billing_admin) 可以管理账单。订阅方案与组织绑定，而非您的个人账户。

危险

购买方案仅会影响当前选中的组织。

---

常见问题

我可以创建多个组织吗？

可以。您可以根据需要创建任意数量的组织，并使用侧边栏中的组织选择器进行切换。

如何配置安全策略？

超级管理员可以在 API 选项卡中配置 2FA 强制执行、密码策略以及密钥安全。 安全 选项卡。详情请参阅 组织安全 。

我可以只给某人访问单个 App 或 Channel 的权限吗？

可以 —— 为其分配应用级角色（例如 应用开发者 或 App 阅读器），可通过 Members 页面或应用的 Access 标签页操作。你还可以按 channel 进一步微调其访问权限，使用 渠道权限覆盖。请参阅 访问控制参考 查看完整角色列表。

Admin 和 App Admin 有什么区别？

管理员 (org_admin) 拥有整个组织的最高权限 —— 涵盖所有 App、所有 Channel 以及所有成员。 应用管理员 (app_admin) 拥有同级别的控制权，但仅限于特定的 App 及其 Channel。如果您想在不授予组织其他部分访问权限的情况下，委派某个 App 的完整控制权，请使用 App Admin。

继续探索 Organization

如果你正在使用 组织 要规划 dashboard 和 API 操作，请将其连接到 API 概览 关于 API Overview 中的实现细节， 简介 关于 Introduction 中的实现细节， API 密钥 有关 API Keys 的实现细节， 设备 有关 Devices 的实现细节，以及 Bundle 有关 Bundles 中的实现细节。