SSO (企业版)
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
什么是 SSO?
“什么是 SSO?”章节单点登录 (SSO) 让您的团队可以使用公司的身份提供商 (IdP) 登录 Capgo。Capgo 通过 Supabase Auth 使用 SAML 2.0。当用户的邮箱域名匹配已启用的 SSO 提供商时,他们可以通过您的 IdP 进行身份验证,并在 SSO 回调期间自动加入组织。
SSO 不会改变用户能做什么。权限由 组织角色控制。SSO 只改变他们的身份验证方式。
前提条件
“前提条件”章节开始之前:
- 企业版订阅已在 Capgo 组织生效。
- 身份提供商需支持 SAML 2.0 并提供 IdP 元数据 URL (HTTPS)。
- 能够发布 DNS TXT 记录 用于邮箱域名(例如
company.com用于以以下身份登录的用户user@company.com). - 拥有更新组织设置权限的 Capgo 组织成员。
- 一次 IdP 管理员 您 IT/安全团队的联系人。
SSO 设置在哪里
标题为“在哪里找到 SSO 设置”的部分- 打开 https://console.capgo.app/
- 点击 设置 在左侧边栏中
- 选择 组织 选项卡
- 选择 安全 选项卡
- 滚动到 SSO 配置。仅当组织使用 Enterprise 套餐时,此表单才可用。
第 1 步 - 配置你的 IdP
标题为“第 1 步 - 配置你的 IdP”的章节在你的身份提供商中新建一个 SAML 2.0 应用。你需要以下内容 服务提供商 在 Capgo SSO 配置面板中显示的值:
| 字段 | 使用位置 |
|---|---|
| ACS URL | IdP SAML 应用中的断言消费者服务 URL |
| 实体 ID | 服务提供方实体标识符 |
| SP 元数据 URL | 可选:如果 IdP 支持通过 URL 导入 SP 元数据,请导入 |
| NameID 格式 | SAML 名称标识符的预期格式 |
您的 IdP 必须发布用户的 电子邮件地址 在断言中。Capgo 使用邮箱域名来解析当前活动的 SSO 提供商并匹配现有账户。
第 2 步 - 在 Capgo 中添加 SSO 提供商
章节标题:“第 2 步 - 在 Capgo 中添加 SSO 提供商”- 在 SSO 配置面板中,点击添加新的提供商
- 输入 邮箱域名 (例如
company.com)。它必须与用户登录邮箱的域名部分匹配 - 输入你的 IdP 元数据 URL (HTTPS)
- 提交
提供商已创建,状态为 待验证.
第 3 步 - DNS 域名验证
标题为“步骤 3 - DNS 域名验证”的章节Capgo 会在 SSO 生效前验证您是否控制该域名。
添加一个 TXT 记录到您的 DNS 提供商:
| 字段 | 值 |
|---|---|
| 类型 | TXT |
| 名称 / 主机 | _capgo-sso.<your-domain> (例如 _capgo-sso.company.com) |
| 值 | dashboard 面板中显示的验证 token |
记录发布后(DNS TTL 传播通常需要几分钟到一小时),点击 验证 DNS 在 dashboard 中。成功后,提供商将移至 已验证.
第 4 步 - 启用提供商
标题为“第 4 步 - 激活提供商”的章节DNS 验证后,点击 激活。提供商状态变为 活跃. 仅 活跃 提供商用于 SSO 登录流程。
您可以随时在 dashboard 中选择 停用 。这会将该提供商移至 已禁用,从而暂停该域名的 SSO,但不会删除配置。
第 5 步 - 测试并分配角色
标题为“第 5 步 - 测试并分配角色”的章节当用户首次通过 SSO 登录且在该组织中尚无成员身份时,Capgo 会为其分配 读取权限 角色。
试点用户登录后:
- 前往 设置 → 组织 → 成员
- 找到每个由 SSO 预配的用户
- 把他们的角色调整到合适级别(上传, 写入, 管理员等)
请参阅 完整权限明细 了解各角色的权限。
可选 - 强制启用 SSO
章节标题:“可选 - 强制 SSO”在 活跃 提供商上,您可以切换 强制 SSO。启用后,Capgo 会将该邮箱域名的现有认证用户标记为仅限 SSO,并且该域名的登录流程要求通过 IdP 进行身份验证。将提供商设置为 已禁用 (停用) 或关闭强制执行,会移除该域名的 SSO-only 标记。
提供商状态参考
标题为“提供商状态参考”的章节| 状态 | 含义 |
|---|---|
| 待验证 | DNS TXT 记录尚未验证 |
| 已验证 | 域名所有权已确认,准备激活 |
| 活跃 | 该域名的 SSO 已启用 |
| 已禁用 | 由 停用 在 dashboard 中设置;该域名未使用 SSO;请使用 重新激活 以返回到 活跃 |
上线检查清单
“Rollout checklist” 部分标题- 已确认企业版套餐
- 已在 IdP 中创建 SAML 应用,并配置了来自 Capgo 的 ACS URL 和 Entity ID
- IdP 已配置为发布稳定的 email 声明
- DNS TXT 记录已发布且 验证 DNS 验证成功
- 提供商已激活
- 试点用户已成功登录
- 角色已从默认权限提升 读取权限 (视需要而定)
- 已做出强制执行决策(若已启用,则已通知)
相关文档
标题为“相关文档”的章节从 SSO(企业版)继续
标题为“从 SSO(企业版)继续”的章节如果你正在使用 SSO (企业版) 用来规划身份验证和账户流程,并将它与 @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 有关 @capgo/capacitor-native-biometric 的实现细节, 双因素认证 有关双因素认证的实现细节,以及 在 Capacitor 应用中实现 OAuth2 的 5 个步骤 查看《在 Capacitor 应用中实现 OAuth2 的 5 个步骤》,了解实际背景。