通过

Couchbase Server - SSO 的 Microsoft Entra SSO 集成

  • 项目

本教程介绍如何将 Couchbase Server - SSO 与 Microsoft Entra ID 集成。 将 Couchbase Server - SSO 与 Microsoft Entra ID 集成后，可以：

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

先决条件

若要将 Microsoft Entra ID 与 Couchbase Server - SSO 集成，需要：

  • 一个 Microsoft Entra 订阅。 如果没有订阅，可以获取一个免费帐户。
  • 已启用 Couchbase Server - SSO 单一登录 (SSO) 的订阅。

方案描述

在本教程中，将在测试环境中配置并测试 Microsoft Entra SSO。

  • Couchbase Server - SSO 仅支持 SP 启动的 SSO。
  • Couchbase Server - SSO 支持即时用户预配。

从库中添加 Couchbase Server - SSO

若要配置将 Couchbase Server - SSO 集成到 Microsoft Entra ID 中的操作，需要从库中将 Couchbase Server - SSO 添加到托管 SaaS 应用列表。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
  3. 在“从库中添加”部分的搜索框中键入“Couchbase Server - SSO”。
  4. 从结果面板中选择“Couchbase Server - SSO”，然后添加该应用。 在该应用添加到租户时等待几秒钟。

或者，也可以使用企业应用配置向导。 在此向导中，可以将应用程序添加到租户，将用户/组添加到应用，分配角色，并逐步完成 SSO 配置。 详细了解 Microsoft 365 向导。

配置并测试 Couchbase Server - SSO 的 Microsoft Entra SSO

使用名为“B.Simon”的测试用户配置并测试 Couchbase Server - SSO 的 Microsoft Entra SSO。 为了正常使用 SSO，需要在 Microsoft Entra 用户与 Couchbase Server - SSO 中的相关用户之间建立关联关系。

若要配置并测试 Couchbase Server - SSO 的 Microsoft Entra SSO，请执行以下步骤：

  1. 配置 Microsoft Entra SSO - 使用户能够使用此功能。
    1. 创建 Microsoft Entra ID 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
    2. 分配 Microsoft Entra ID 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
  2. 配置 Couchbase Server - SSO - 在应用程序端配置单一登录设置。
    1. 创建 Couchbase Server - SSO 测试用户 - 在 Couchbase Server - SSO 中创建 B.Simon 的对应用户，并将其关联到该用户的 Microsoft Entra ID 表示形式。
  3. 测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

按照以下步骤在 Microsoft Entra 管理中心启用 Microsoft Entra SSO。

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

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

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

  4. 在“设置 SAML 单一登录”页面上，单击“基本 SAML 配置”旁边的铅笔图标以编辑设置 。

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

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

    a. 在“标识符(实体 ID)”文本框中，键入使用以下模式的值：<your_couchbase_entityID>

    b. 在“回复 URL”文本框中，使用以下模式键入 URL：

    c. 在“登录 URL”文本框中，使用以下模式键入 URL：

    注意

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

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

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

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

    名称 源属性
    groups user.groups

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

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

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

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

创建 Microsoft Entra ID 测试用户

在本部分中，你将在 Microsoft Entra 管理中心创建名为 B.Simon 的测试用户。

  1. 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“用户”>“所有用户”。
  3. 选择屏幕顶部的“新建用户”>“创建新用户”。
  4. 在“用户”属性中执行以下步骤：
    1. 在“显示名称”字段中输入 B.Simon。
    2. 在“用户主体名称”字段中，输入 username@companydomain.extension。 例如 B.Simon@contoso.com。
    3. 选中“显示密码”复选框，然后记下“密码”框中显示的值。
    4. 选择“查看 + 创建”。
  5. 选择“创建”。

分配 Microsoft Entra ID 测试用户

在本部分，将通过授予 B.Simon 访问 Couchbase Server - SSO 的权限，使其能够使用 Microsoft Entra 单一登录。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“应用程序”>“企业应用程序”>“Couchbase Server - SSO”。
  3. 在应用的概述页中，选择“用户和组”。
  4. 选择“添加用户/组”，然后在“添加分配”对话框中选择“用户和组” 。
    1. 在“用户和组”对话框中，从“用户”列表中选择“B.Simon”，然后单击屏幕底部的“选择”按钮。
    2. 如果你希望将某角色分配给用户，可以从“选择角色”下拉列表中选择该角色。 如果尚未为此应用设置任何角色，你将看到选择了“默认访问权限”角色。
    3. 在“添加分配”对话框中，单击“分配”按钮。

配置 Couchbase Server - SSO

若要在 Couchbase Server - SSO 端配置单一登录，需要将下载的证书 (Raw) 以及从 Microsoft Entra 管理中心复制的相应 URL 发送给 Couchbase Server - SSO 支持团队。 他们会对此进行设置，使两端的 SAML SSO 连接均正确设置。

创建 Couchbase Server - SSO 测试用户

在本部分中，将在 Couchbase Server - SSO 中创建名为 Britta Simon 的用户。 Couchbase Server - SSO 支持默认启用的即时用户预配。 此部分不存在任何操作项。 如果用户在 Couchbase Server - SSO 中尚不存在，则会在身份验证后创建一个新用户。

测试 SSO

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

  • 点击 Microsoft Entra 管理中心中的“测试此应用程序”。 这会重定向到 Couchbase Server - SSO 登录 URL，你可以在其中启动登录流。

  • 直接转到 Couchbase Server - SSO 登录 URL，然后启动登录流。

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

后续步骤

配置 Couchbase Server - SSO，即可强制实施会话控制，这会实时防止组织的敏感数据发生外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。