教程：Microsoft Entra 与 Voyance 集成

本教程介绍如何将 Voyance 与 Microsoft Entra ID 集成。 将 Voyance 与 Microsoft Entra ID 相集成可提供以下优势：

• 可以在 Microsoft Entra ID 中控制谁有权访问 Voyance。
• 支持用户使用其 Microsoft Entra 帐户自动登录到 Voyance（单一登录）。
• 可以在一个集中位置管理帐户。

如果要了解有关 SaaS 应用与 Microsoft Entra ID 集成的更多详细信息，请参阅 Microsoft Entra ID 的应用程序访问与单一登录是什么。 如果没有 Azure 订阅，可以在开始前创建一个免费帐户。

先决条件

要配置 Microsoft Entra 与 Voyance 的集成，需要以下项：

• 一个 Microsoft Entra 订阅。 如果没有 Microsoft Entra 环境，可以获取一个免费帐户
• 已启用 Voyance 单一登录的订阅

方案描述

在本教程中，你将在测试环境中配置并测试 Microsoft Entra 单一登录。

• Voyance 支持 SP 和 IDP 发起的 SSO

• Voyance 支持实时用户预配

从库中添加 Voyance

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

若要从库中添加 Voyance，请执行以下步骤：

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

2. 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。

3. 在搜索框中键入“Voyance”，在结果面板中选择“Voyance”，然后单击“添加”按钮添加该应用程序。

   

配置并测试 Microsoft Entra 单一登录

在本部分中，你将基于名为 Britta Simon 的测试用户配置并测试 Voyance 的 Microsoft Entra 单一登录。 要正常运行单一登录，需要在 Microsoft Entra 用户与 Voyance 中的相关用户之间建立链接关系。

要配置和测试 Voyance 的 Microsoft Entra 单一登录，需要完成以下构建基块：

1. 配置 Microsoft Entra 单一登录 - 使用户能够使用此功能。
2. 配置 Voyance 单一登录 - 在应用程序端配置单一登录设置。
3. 创建 Microsoft Entra 测试用户 - 使用 Britta Simon 测试 Microsoft Entra 单一登录。
4. 分配 Microsoft Entra 测试用户 - 使 Britta Simon 能够使用 Microsoft Entra 单一登录。
5. 创建 Voyance 测试用户 - 在 Voyance 中创建 Britta Simon 的对应用户，并将其链接到该用户的 Microsoft Entra 表示形式。
6. 测试单一登录 - 验证配置是否正常工作。

配置 Microsoft Entra 单一登录

在本部分中，将启用 Microsoft Entra 单一登录。

要配置 Voyance 的 Microsoft Entra 单一登录，请执行以下步骤：

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

2. 浏览至“标识”>“应用程序”>“企业应用程序”>“Voyance”应用程序集成页，选择“单一登录”。

   

3. 在“选择单一登录方法”对话框中，选择“SAML/WS-Fed”模式以启用单一登录。

   

4. 在“使用 SAML 设置单一登录”页上，单击“编辑”图标以打开“基本 SAML 配置”对话框 。

   

5. 如果要在 IDP 发起的模式下配置应用程序，请在“基本 SAML 配置”部分执行以下步骤：

   

   a. 在“标识符”文本框中，使用以下模式键入 URL：

   b. 在“回复 URL”文本框中，使用以下模式键入 URL：https://<companyname>.nyansa.com/saml/create/

6. 如果要在 SP 发起的模式下配置应用程序，请单击“设置其他 URL” ，并执行以下步骤：

   

   在“登录 URL” 文本框中，使用以下模式键入 URL：https://<companyname>.nyansa.com/。

   注意

   这些不是实际值。 请使用实际的“标识符”、“回复 URL”和“登录 URL”更新这些值。 请联系 Voyance 客户支持团队，获取这些值。 还可参考“基本 SAML 配置”部分中显示的模式。

7. 在“使用 SAML 设置单一登录” 页上，在“SAML 签名证书” 部分中，单击“下载” 以根据要求从给定的选项下载证书(Base64) 并将其保存在计算机上。

   

8. 在“设置 Voyance”部分中，根据要求复制相应的 URL。

   

   a. 登录 URL

   b. Microsoft Entra 标识符

   c. 注销 URL

配置 Voyance 单一登录

1. 在另一个 Web 浏览器窗口中，以管理员身份登录 Voyance 租户。

2. 转到导航栏的右上角，单击“配置文件”。

   

3. 单击“管理员设置”。

   

4. 单击“用户访问”选项卡。

   

5. 单击“禁用 SSO”按钮，使用 SAML 2.0 将 Microsoft Entra ID 配置为 IdP。

   

6. 转到“SAML v2”部分，并执行以下步骤：

   

   a. 选择“启用”。

   b. 将“登录 URL”粘贴到“IdP Login URL”文本框中。

   c. 在记事本中打开下载的 Base64 编码证书，将其内容复制到剪贴板，并粘贴到“IdP 证书”文本框中。

   d. 单击“ 保存”。

创建 Microsoft Entra 测试用户

本部分的目标是创建名为 Britta Simon 的测试用户。

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

分配 Microsoft Entra 测试用户

在本部分中，通过授予 Britta Simon 访问 Voyance 的权限，允许使用 Azure 单一登录。

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

2. 浏览至“标识”>“应用程序”>“企业应用程序”>”“Voyance”。

   

3. 在应用程序列表中，选择“Voyance”。

   

4. 在应用的概述页面中，选择“用户和组”。

5. 选择“添加用户/组”，然后在“添加分配”对话框中选择“用户和组” 。

   1. 在“用户和组”对话框中，从“用户”列表中选择“B.Simon”，然后单击屏幕底部的“选择”按钮。
   2. 如果你希望将某角色分配给用户，可以从“选择角色”下拉列表中选择该角色。 如果尚未为此应用设置任何角色，你将看到选择了“默认访问权限”角色。
   3. 在“添加分配”对话框中，单击“分配”按钮。

创建 Voyance 测试用户

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

注意

如果需要手动创建用户，则需联系 Voyance 支持团队。

测试单一登录

本部分需使用访问面板测试 Microsoft Entra 单一登录配置。

单击访问面板中的 Voyance 磁贴时，应当会自动登录到为其设置了 SSO 的 Voyance。 有关访问面板的详细信息，请参阅 Introduction to the Access Panel（访问面板简介）。

其他资源

• 有关如何将 SaaS 应用与 Microsoft Entra ID 集成的教程列表

• 什么是使用 Microsoft Entra ID 进行应用程序访问和单一登录？

• 什么是 Microsoft Entra ID 中的条件访问？