通过

Microsoft Entra SSO 与 Couchbase Capella - SSO 的集成

  • 项目

本教程介绍如何将 Couchbase Capella - SSO 与 Microsoft Entra ID 相集成。 此应用的目的是将 Couchbase 的 Capella 云数据库平台与 Azure SSO 集成。 这是开始使用 Couchbase 的最简单、最快的方法。 将 Couchbase Capella - SSO 与 Microsoft Entra ID 集成时，可以：

  • 在 Microsoft Entra ID 中控制谁有权访问 Couchbase Capella - SSO。
  • 让用户使用其 Microsoft Entra 帐户自动登录到 Couchbase Capella - SSO。
  • 在中心位置管理帐户。

我们将在测试环境中配置和测试 Couchbase Capella - SSO 的 Microsoft Entra 单一登录。 Couchbase Capella - SSO 支持 SP 发起的单一登录和即时用户预配。

先决条件

若要配置 Couchbase Capella - SSO 与 Microsoft Entra ID 的集成，需要：

添加应用程序并分配测试用户

在开始配置单一登录之前，需要从 Microsoft Entra 库添加 Couchbase Capella - SSO 应用程序。 需要将测试用户帐户分配给应用程序并测试单一登录配置。

从 Microsoft Entra 库添加 Couchbase Capella - SSO

从 Microsoft Entra 应用程序库添加 Couchbase Capella - SSO，以配置 Couchbase Capella - SSO 的单一登录。 有关如何从库添加应用程序的详细信息，请参阅快速入门：从库添加应用程序。

创建并分配 Microsoft Entra 测试用户

按照创建和分配用户帐户一文中的指南创建一个名为 B.Simon 的测试用户帐户。

或者，也可以使用企业应用配置向导。 在此向导中，可以将应用程序添加到租户，将用户/组添加到应用，并分配角色。 该向导还提供了单一登录配置窗格的链接。 详细了解 Microsoft 365 向导。

配置 Microsoft Entra SSO

完成以下步骤以启用 Microsoft Entra 单一登录。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。

  2. 浏览到“标识”>“应用程序”>“企业应用程序”>“Couchbase Capella - SSO”>“单一登录”。

  3. 在“选择单一登录方法”页上选择“SAML” 。

  4. 在“设置 SAML 单一登录”页上，选择“基本 SAML 配置”对应的笔形图标以编辑设置 。

    显示如何编辑基本 SAML 配置的屏幕截图。

  5. 在“基本 SAML 配置” 部分中，按照以下步骤操作：

    a. 在“标识符”文本框中，使用以下模式键入值：urn:auth0:couchbase-capella:<Connection_UUID>

    b. 在“回复 URL”文本框中，输入以下某个 URL/模式：

    回复 URL
    https://couchbase-capella.us.auth0.com/login/callback
    https://couchbase-capella.us.auth0.com/login/callback?connection=<Connection_UUID>

    c. 在“登录 URL”文本框中，键入 URL： https://cloud.couchbase.com/enterprise-sso

    注意

    这些不是实际值。 请使用实际标识符和回复 URL 更新这些值。 请联系 Couchbase Capella - SSO 支持团队以获取这些值。 还可参考“基本 SAML 配置”部分中显示的模式。

  6. Couchbase Capella - SSO 应用程序需要特定格式的 SAML 断言，因此，需要在 SAML 令牌属性配置中添加自定义属性映射。 以下屏幕截图显示了默认属性的列表。

    显示属性配置映像的屏幕截图。

  7. 除上述属性以外，Couchbase Capella - SSO 应用程序还要求在 SAML 响应中传回其他几个属性，如下所示。 这些属性也是预先填充的，但可以根据要求查看它们。

    名称 源属性
    电子邮件 user.mail
    family_name user.surname

  8. 在“使用 SAML 设置单一登录”页的“SAML 签名证书”部分中，找到“证书（原始）”，选择“下载”以下载该证书并将其保存到计算机上。

    显示证书下载链接的屏幕截图。

  9. 在“设置 Couchbase Capella - SSO”部分，根据需要复制相应的 URL。

    显示复制配置相应的 URL 的屏幕截图。

配置 Couchbase Capella - SSO

若要在 Couchbase Capella - SSO 端配置单一登录，需要将下载的“证书(原始)”以及从应用程序配置复制的相应 URL 发送给 Couchbase Capella - SSO 支持团队。 他们会对此进行设置，使两端的 SAML SSO 连接均正确设置

创建 Couchbase Capella - SSO 测试用户

在本部分中，我们将在 Couchbase Capella - SSO 中创建名为 B.Simon 的用户。 Couchbase Capella - SSO 支持默认启用的即时用户预配。 此部分不存在任何操作项。 如果某个用户尚不存在于 Couchbase Capella - SSO 中，则通常会在对其进行身份验证后新建此用户。

测试 SSO

在本部分，你将使用以下选项测试 Microsoft Entra 单一登录配置。

  • 单击“测试此应用程序”，这会重定向到 Couchbase Capella - SSO 登录 URL，可以从那里启动登录流。

  • 直接转到 Couchbase Capella - SSO 登录 URL，并从中启动登录流。

  • 你可使用 Microsoft 的“我的应用”。 单击“我的应用”中的 Couchbase Capella - SSO 磁贴时，会重定向到 Couchbase Capella - SSO 登录 URL。 有关详细信息，请参阅 Microsoft Entra 我的应用。

其他资源

后续步骤

配置 Couchbase Capella - SSO 后，可以强制实施会话控制，实时防止组织的敏感数据外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Cloud App Security 强制实施会话控制。