跳转到正文

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/安全团队的联系人。
  1. 打开 https://console.capgo.app/
  2. 点击 设置 在左侧边栏中
  3. 选择 组织 选项卡
  4. 选择 安全 选项卡
  5. 滚动到 SSO 配置。仅当组织使用 Enterprise 套餐时,此表单才可用。

在你的身份提供商中新建一个 SAML 2.0 应用。你需要以下内容 服务提供商 在 Capgo SSO 配置面板中显示的值:

字段使用位置
ACS URLIdP SAML 应用中的断言消费者服务 URL
实体 ID服务提供方实体标识符
SP 元数据 URL可选:如果 IdP 支持通过 URL 导入 SP 元数据,请导入
NameID 格式SAML 名称标识符的预期格式

您的 IdP 必须发布用户的 电子邮件地址 在断言中。Capgo 使用邮箱域名来解析当前活动的 SSO 提供商并匹配现有账户。

第 2 步 - 在 Capgo 中添加 SSO 提供商

章节标题:“第 2 步 - 在 Capgo 中添加 SSO 提供商”
  1. 在 SSO 配置面板中,点击添加新的提供商
  2. 输入 邮箱域名 (例如 company.com)。它必须与用户登录邮箱的域名部分匹配
  3. 输入你的 IdP 元数据 URL (HTTPS)
  4. 提交

提供商已创建,状态为 待验证.

Capgo 会在 SSO 生效前验证您是否控制该域名。

添加一个 TXT 记录到您的 DNS 提供商:

字段值
类型TXT
名称 / 主机_capgo-sso.<your-domain> (例如 _capgo-sso.company.com)
值dashboard 面板中显示的验证 token

记录发布后(DNS TTL 传播通常需要几分钟到一小时),点击 验证 DNS 在 dashboard 中。成功后,提供商将移至 已验证.

DNS 验证后,点击 激活。提供商状态变为 活跃. 仅 活跃 提供商用于 SSO 登录流程。

您可以随时在 dashboard 中选择 停用 。这会将该提供商移至 已禁用,从而暂停该域名的 SSO,但不会删除配置。

当用户首次通过 SSO 登录且在该组织中尚无成员身份时,Capgo 会为其分配 读取权限 角色。

试点用户登录后:

  1. 前往 设置 → 组织 → 成员
  2. 找到每个由 SSO 预配的用户
  3. 把他们的角色调整到合适级别(上传, 写入, 管理员等)

请参阅 完整权限明细 了解各角色的权限。

在 活跃 提供商上,您可以切换 强制 SSO。启用后,Capgo 会将该邮箱域名的现有认证用户标记为仅限 SSO,并且该域名的登录流程要求通过 IdP 进行身份验证。将提供商设置为 已禁用 (停用) 或关闭强制执行,会移除该域名的 SSO-only 标记。

状态含义
待验证DNS TXT 记录尚未验证
已验证域名所有权已确认,准备激活
活跃该域名的 SSO 已启用
已禁用由 停用 在 dashboard 中设置;该域名未使用 SSO;请使用 重新激活 以返回到 活跃
  • 已确认企业版套餐
  • 已在 IdP 中创建 SAML 应用,并配置了来自 Capgo 的 ACS URL 和 Entity ID
  • IdP 已配置为发布稳定的 email 声明
  • DNS TXT 记录已发布且 验证 DNS 验证成功
  • 提供商已激活
  • 试点用户已成功登录
  • 角色已从默认权限提升 读取权限 (视需要而定)
  • 已做出强制执行决策(若已启用,则已通知)

如果你正在使用 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 个步骤》,了解实际背景。