使用 Microsoft Entra ID 配置 InstaVR Viewer 进行单一登录

2025-04-30

本文介绍如何将 InstaVR Viewer 与 Microsoft Entra ID 集成。将 InstaVR Viewer 与 Microsoft Entra ID 相集成可提供以下优势：

可以在 Microsoft Entra ID 中控制谁有权访问 InstaVR Viewer。
可让用户使用其 Microsoft Entra 帐户自动登录到 InstaVR Viewer（单一登录）。
可以在一个中心位置管理帐户。

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

先决条件

本文中概述的方案假定你已具备以下先决条件：

具有活动订阅的 Microsoft Entra 用户帐户。如果还没有帐户，可以免费创建帐户。
以下角色之一：

启用了 InstaVR Viewer 单一登录的订阅

方案说明

本文中，您将在测试环境中配置和测试 Microsoft Entra 的单一登录功能。

InstaVR Viewer 支持 SP 发起的 SSO
InstaVR Viewer 支持实时用户预配

从库中添加 InstaVR Viewer

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

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

以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>企业应用程序>新建应用程序。
在搜索框中键入 InstaVR Viewer，在结果面板中选择 InstaVR Viewer ，然后选择“ 添加 ”按钮添加该应用程序。

配置和测试 Microsoft Entra 单一登录

在本部分中，您将配置和测试使用名为 Britta Simon 的测试用户的 Microsoft Entra 与 InstaVR Viewer 的单点登录。若要运行单一登录，需要在 Microsoft Entra 用户与 InstaVR Viewer 中的相关用户之间建立关联。

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

配置 Microsoft Entra 单一登录 - 使用户能够使用此功能。
配置 InstaVR Viewer 单一登录 - 在应用程序端配置单 Sign-On 设置。
创建 Microsoft Entra 测试用户 - 测试 britta Simon 的 Microsoft Entra 单一登录。
分配 Microsoft Entra 测试用户 - 使 Britta Simon 能够使用 Microsoft Entra 单一登录。
创建 InstaVR Viewer 测试用户 - 以在 InstaVR Viewer 中创建与 Britta Simon 对应的用户，该用户链接到 Microsoft Entra 上的用户表示形式。
测试单一登录 - 验证配置是否正常工作。

配置 Microsoft Entra 单一登录

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

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

以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>Enterprise 应用>InstaVR Viewer 应用程序集成页，选择 “单一登录”。
在 “选择单一登录方法 ”对话框中，选择 SAML/WS-Fed 模式以启用单一登录。
在使用 SAML 设置单 Sign-On页面上，选择编辑图标以打开基本 SAML 配置对话框。
在 “基本 SAML 配置 ”部分中，执行以下步骤：

a。在 “登录 URL ”文本框中，使用以下模式键入 URL： https://console.instavr.co/auth/saml/login/<WEBPackagedURL>

注释

登录 URL 没有固定模式。当 InstaVR Viewer 客户进行 Web 打包时，会生成它。它对于每位客户和每个包裹都是独一无二的。若要获取确切的登录 URL，需要登录到 InstaVR Viewer 实例并执行 Web 打包。

b. 在 “标识符”（实体 ID） 文本框中，使用以下模式键入 URL： https://console.instavr.co/auth/saml/sp/<WEBPackagedURL>

注释

标识符值不是实际值。使用本文稍后介绍的实际标识符值更新此值。
在“ 使用 SAML 设置单 Sign-On ”页上的 “SAML 签名证书 ”部分中，选择“ 下载 ”以根据要求从给定选项下载 证书（Base64） 和 联合元数据文件 ，并将其保存在计算机上。
在“设置 InstaVR Viewer”部分，根据要求复制相应的 URL 。

a。登录网址

b. Microsoft Entra 标识符

选项c. 登出 URL

配置 InstaVR Viewer 单一登录

打开新的 Web 浏览器窗口，以管理员身份登录到 InstaVR Viewer 公司站点。
选择 “用户图标 ”，然后选择“ 帐户”。
向下滚动到“SAML 身份验证”并执行以下步骤：

a。在“SSO URL”文本框中，粘贴之前复制的“登录 URL”值。

b. 在“退出登录 URL”文本框中，粘贴之前复制的“退出登录 URL”值。

选项c. 在 实体 ID 文本框中，粘贴你之前复制的 Microsoft Entra Identifier 的值。

d。若要上传下载的证书文件，请选择“ 更新”。

e。若要上传下载的联合元数据文件，请选择“ 更新”。

f。复制“实体 ID”值，并将其粘贴到“基本 SAML 配置”部分的“标识符(实体 ID)”文本框中。

创建和分配 Microsoft Entra 测试用户

遵循创建并分配用户帐户的快速入门中的准则，来创建名为 B.Simon 的测试用户帐户。

创建 InstaVR Viewer 测试用户

在本部分，我们将在 InstaVR Viewer 中创建名为 Britta Simon 的用户。 InstaVR Viewer 支持默认启用的实时用户预配。本节中没有需要你完成的事项。如果 InstaVR Viewer 中不存在用户，则会在身份验证后创建一个新用户。如果遇到任何问题，请联系 InstaVR Viewer 支持团队。