設定驗證

發行項
12/18/2024

若要存取指定的 Azure 遠端轉譯帳戶，客戶端必須從 Azure Mixed Reality Security Token Service （STS）取得存取令牌。從 STS 取得的令牌存留期為 24 小時。客戶端必須設定 下列其中一項 ，才能成功呼叫 REST API：

AccountKey：可以在 Azure 入口網站上遠端轉譯帳戶的 [密鑰] 索引卷標中取得。帳戶金鑰僅供開發/原型設計使用。
AccountDomain：可以在 Azure 入口網站上遠端轉譯帳戶的 [概觀] 索引標籤中取得。
AuthenticationToken：是一種Microsoft Entra 令牌，可使用 MSAL 連結庫取得。有多個不同的流程可用來接受用戶認證，並使用這些認證來取得存取令牌。

MRAccessToken：是 MR 令牌，可從 Azure Mixed Reality Security Token Service （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 用戶驗證。

在 entra 識別碼Microsoft註冊您的應用程式。在註冊時，您必須判斷您的應用程式是否應該是多租使用者。您也必須在 [驗證] 刀鋒視窗中提供應用程式允許的重新導向 URL。
在 [API 許可權] 索引標籤中，針對 mixedreality.signin 範圍在 mixedreality 下要求委派的許可權。
在 [安全性 -> 許可權] 索引標籤中授與系統管理員同意。
然後，流覽至您的 Azure 遠端轉譯資源。在 [存取控制] 面板中，代表您想要對 Azure 遠端轉譯資源使用委派訪問許可權的應用程式和使用者授與所需的角色。