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

配置身份验证

项目
12/18/2024

若要访问给定的 Azure 远程渲染帐户，客户端需要从 Azure 混合现实安全令牌服务 (STS) 获取访问令牌。从 STS 获取的令牌的生存期为 24 小时。客户端需要设置以下项之一才能成功调用 REST API：

AccountKey：可以在 Azure 门户上远程渲染帐户的“密钥”选项卡中获得。建议仅将帐户密钥用于开发/原型制作。
AccountDomain：可以在 Azure 门户上远程渲染帐户的“概述”选项卡中获得。
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 <accountId>:<accountKey>。从安全角度来看，前者更可取。从此 REST 调用返回的令牌为 MR 访问令牌。

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

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

Microsoft Entra 用户身份验证

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

在 Microsoft Entra ID 中注册应用程序。在注册过程中，需要确定应用程序是否应为多租户应用程序。还需要在“身份验证”边栏选项卡中提供应用程序允许的重定向 URL。
在“API 权限”选项卡中，在“mixedreality”下请求“mixedreality.signin”范围的“委托权限”。
在“安全性”>“权限”选项卡中授予管理员同意。
然后，导航到 Azure 远程渲染资源。在“访问控制”面板中，为应用程序和用户授予所需的角色，代表他们使用对 Azure 远程渲染资源的委托访问权限。