你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

配置身份验证

  • 项目

Azure 远程渲染使用与 Azure 空间定位点 (ASA) 相同的身份验证机制。 若要访问给定的 Azure 远程渲染帐户，客户端需要从 Azure 混合现实安全令牌服务 (STS) 获取访问令牌。 从 STS 获取的令牌的生存期为 24 小时。 客户端需要设置以下项之一才能成功调用 REST API：

  • AccountKey：可以在 Azure 门户上远程渲染帐户的“密钥”选项卡中获得。 建议仅将帐户密钥用于开发/原型制作。 Account ID

  • AccountDomain：可以在 Azure 门户上远程渲染帐户的“概述”选项卡中获得。 Account Domain

  • AuthenticationToken：是一个 Microsoft Entra 令牌，可以使用 MSAL 库获取。 可以通过多个不同的流来接受用户凭据并使用这些凭据获取访问令牌。

  • MRAccessToken：MR 令牌，可从 Azure 混合现实安全令牌服务 (STS) 中获取。 使用类似以下的 REST 调用从 https://sts.<accountDomain> 终结点检索：

    GET https://sts.southcentralus.mixedreality.azure.com/Accounts/35d830cb-f062-4062-9792-d6316039df56/token HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1Ni<truncated>FL8Hq5aaOqZQnJr1koaQ
Host: sts.southcentralus.mixedreality.azure.com
Connection: Keep-Alive

HTTP/1.1 200 OK
Date: Tue, 24 Mar 2020 09:09:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 1153
Accept: application/json
MS-CV: 05JLqWeKFkWpbdY944yl7A.0
{"AccessToken":"eyJhbGciOiJSUzI1<truncated>uLkO2FvA"}

    其中的 Authorization 标头的格式如下所示：Bearer <Azure_AD_token> 或 Bearer <accoundId>:<accountKey>。 从安全角度来看，前者更可取。 从此 REST 调用返回的令牌为 MR 访问令牌。

已部署应用程序的身份验证

建议仅在开发期间使用帐户密钥进行快速原型制作。 建议不要使用应用程序中的嵌入式帐户密钥将应用程序交付到生产环境。 建议的方法是使用基于用户的 Microsoft Entra 身份验证方法或基于服务的 Microsoft Entra 身份验证方法。

Microsoft Entra 用户身份验证

Azure 空间定位点文档中介绍了 Microsoft Entra 身份验证。

按照步骤在Azure 门户中配置 Microsoft Entra 用户身份验证。

  1. 在 Microsoft Entra ID 中注册应用程序。 在注册过程中，需要确定应用程序是否应为多租户应用程序。 还需要在“身份验证”边栏选项卡中提供应用程序允许的重定向 URL。 Authentication setup

  2. 在“API 权限”选项卡中，在“mixedreality”下请求“mixedreality.signin”范围的“委托权限”。 Api permissions

  3. 在“安全性 -> 权限”选项卡中授予管理员同意。 Admin consent

  4. 然后，导航到 Azure 远程渲染资源。 在“访问控制”面板中，为应用程序和用户授予所需的角色，代表他们使用对 Azure 远程渲染资源的委托访问权限。 Add permissionsRole assignments

有关在应用程序代码中使用 Microsoft Entra 用户身份验证的信息，请参阅教程：保护 Azure 远程渲染 和模型存储 - Microsoft Entra 身份验证

Azure 基于角色的访问控制

请在授予基于角色的访问权限时使用以下角色，这有助于控制授予服务的访问级别：

  • 远程渲染 管理员istrator：为用户提供 Azure 远程渲染的转换、管理会话、呈现和诊断功能。
  • 远程渲染客户端：为用户提供 Azure 远程渲染的管理会话、呈现和诊断功能。

后续步骤