配置 Couchbase Server - SSO 以使用 Microsoft Entra ID 进行单一登录

2025-05-03

本文介绍如何将 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 用户帐户。如果还没有帐户，可以免费创建一个帐户。
以下角色之一：

支持单一登录（SSO）的 Couchbase Server 订阅。

方案说明

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

Couchbase Server - SSO 仅支持 SP 发起的 SSO。
Couchbase Server - SSO 支持实时用户预配。

从图库中添加 Couchbase Server - SSO

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

至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
请导航到 Entra ID>企业应用>新应用。
在 “从库中添加 ”部分中，在搜索框中键入 Couchbase Server - SSO 。
从结果面板中选择 “Couchbase Server - SSO ”，然后添加该应用。请稍等几秒钟，应用程序将被添加到您的租户中。

或者，也可以使用企业应用配置向导。在此向导中，还可以将应用程序添加到租户、将用户/组添加到应用、分配角色以及演练 SSO 配置。详细了解 Microsoft 365 向导。

配置并测试 Microsoft Entra SSO 以支持 Couchbase Server - SSO

使用名为 B.Simon 的测试用户配置和测试 Couchbase Server 的 Microsoft Entra SSO。若要正常使用 SSO，需要在 Microsoft Entra 用户与 Couchbase Server - SSO 中的相关用户之间建立链接关系。

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

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

配置 Microsoft Entra SSO

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

至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>企业应用>Couchbase Server - SSO>单点登录。
在“选择单一登录方法”页上选择“SAML” 。
在 “使用 SAML 设置单一登录 ”页上，选择 基本 SAML 配置的 铅笔图标以编辑设置。
在 “基本 SAML 配置 ”部分中，执行以下步骤：

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

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

选项c. 在 “登录 URL ”文本框中，使用以下模式键入 URL： https://<your_couchbase_server>/<ID>

注释

这些值不是真实的。请使用实际的标识符、回复 URL 和登录 URL 来更新这些值。请联系 Couchbase Server - SSO 支持团队获取这些值。还可参考 Microsoft Entra 管理中心的“基本 SAML 配置”部分中显示的模式。
Couchbase Server - SSO 应用程序需要特定格式的 SAML 断言，这要求向 SAML 令牌属性配置添加自定义属性映射。以下屏幕截图显示了默认属性的列表。
除了上述属性，Couchbase Server - SSO 应用程序还要求在 SAML 响应中传回其他几个属性，如下所示。这些属性也是预先填充的，但可以根据要求查看它们。

名称源属性

群组用户组
在 “使用 SAML 设置单一登录 ”页上的 “SAML 签名证书 ”部分中，找到 “证书”（原始）， 然后选择“ 下载 ”以下载证书并将其保存在计算机上。
在 “设置 Couchbase 服务器 - SSO ”部分中，根据要求复制相应的 URL。

名称	源属性
群组	用户组

创建和分配 Microsoft Entra 测试用户

请遵循创建和分配用户帐户快速指南中的指引，创建一个名为 B.Simon 的测试用户帐户。