인증 구성
Azure Remote Rendering은 ASA(Azure Spatial Anchors)와 동일한 인증 메커니즘을 사용합니다. 지정된 Azure Remote Rendering 계정에 액세스하려면 클라이언트는 Azure Mixed Reality STS(Security Token Service)에서 액세스 토큰을 가져와야 합니다. STS에서 가져온 토큰의 수명은 24시간입니다. 클라이언트는 REST API를 성공적으로 호출하기 위해 다음 중 하나를 설정해야 합니다.
AccountKey: Azure Portal의 Remote Rendering 계정에 대한 "키" 탭에서 가져올 수 있습니다. 계정 키는 개발/프로토타이핑에만 권장됩니다.
AccountDomain: Azure Portal의 Remote Rendering 계정에 대한 "개요" 탭에서 가져올 수 있습니다.
AuthenticationToken: MSAL 라이브러리를 사용하여 가져올 수 있는 Microsoft Entra 토큰입니다. 사용자 자격 증명을 수락하고 이러한 자격 증명을 사용하여 액세스 토큰을 가져오는 데 사용할 수 있는 여러 가지 흐름이 있습니다.
MRAccessToken: Azure Mixed Reality STS(보안 토큰 서비스)에서 가져올 수 있는 MR 토큰입니다. 아래와 유사한 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"}
권한 부여 헤더의 형식은
Bearer <Azure_AD_token>
또는Bearer <accountId>:<accountKey>
입니다. 전자는 보안을 위해 선호됩니다. 이 REST 호출에서 반환된 토큰은 MR 액세스 토큰입니다.
배포된 애플리케이션에 대한 인증
계정 키는 개발 중에만 빠른 프로토타입을 위해 권장됩니다. 포함된 계정 키를 사용하여 애플리케이션을 프로덕션에 제공하지 않는 것이 좋습니다. 권장되는 접근 방식은 사용자 기반 또는 서비스 기반 Microsoft Entra 인증 방식을 사용하는 것입니다.
Microsoft Entra 사용자 인증
Microsoft Entra 인증은 Azure Spatial Anchors 설명서에 설명되어 있습니다.
단계에 따라 Azure Portal에서 Microsoft Entra 사용자 인증을 구성합니다.
Microsoft Entra ID에 애플리케이션을 등록합니다. 등록하는 과정에서 애플리케이션이 다중 테넌트인지 여부를 확인해야 합니다. 또한 인증 블레이드에서 애플리케이션에 허용되는 리디렉션 URL을 제공해야 합니다.
API 권한 탭의 mixedreality에서 mixedreality.signin 범위에 대한 위임된 권한을 요청합니다.
보안 -> 권한 탭에서 관리자 동의를 부여합니다.
그런 다음, Azure Remote Rendering 리소스로 이동합니다. 액세스 제어 패널에서 Azure Remote Rendering 리소스에 대한 위임된 액세스 권한을 사용하는 대신 애플리케이션과 사용자에 대해 원하는 역할을 부여합니다.
애플리케이션 코드에서 Microsoft Entra 사용자 인증을 사용하는 방법에 대한 내용은 자습서: Azure Remote Rendering 및 모델 스토리지 보안 - Microsoft Entra 인증을 참조하세요.
Azure 역할 기반 액세스 제어
서비스에 부여된 액세스 수준을 제어하려면 역할 기반 액세스 권한을 부여할 때 다음 역할을 사용합니다.
- Remote Rendering 관리자: 사용자에게 Azure Remote Rendering에 대한 변환, 세션 관리, 렌더링, 진단 기능을 제공합니다.
- Remote Rendering 클라이언트: 사용자에게 Azure Remote Rendering에 대한 세션 관리, 렌더링, 진단 기능을 제공합니다.