Compartir a través de

Configurar la autenticación

  • Artículo

Para acceder a una determinada cuenta de Azure Remote Rendering, los clientes deben obtener un token de acceso del servicio de token de seguridad (STS) de Azure Mixed Reality. Los tokens obtenidos de STS tienen una duración de 24 horas. Los clientes deben establecer una de las siguientes para llamar a las API de REST correctamente:

  • AccountKey: se puede obtener en la pestaña "Claves" de la cuenta de Remote Rendering de Azure Portal. Las claves de cuenta solo se recomiendan para el desarrollo o la creación de prototipos. Id. de cuenta

  • AccountDomain: se puede obtener en la pestaña "Información general" de la cuenta de Remote Rendering de Azure Portal. Dominio de cuenta

  • AuthenticationToken es un token de Microsoft Entra, que se puede obtener mediante la biblioteca MSAL. Hay varios flujos diferentes disponibles para aceptar las credenciales de usuario y usar esas credenciales para obtener un token de acceso.

  • MRAccessToken es un token de MR, que se puede obtener del servicio de token de seguridad (STS) de Azure Mixed Reality. Recuperado del punto de conexión https://sts.<accountDomain> mediante una llamada REST similar a lo siguiente:

    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"}

    El encabezado de autorización tiene el formato siguiente: Bearer <Azure_AD_token> o Bearer <accountId>:<accountKey>. Es preferible el primero por seguridad. El token que devuelve esta llamada REST es el token de acceso de MR.

Autenticación para aplicaciones implementadas

Se recomiendan las claves de cuenta para la creación rápida de prototipos solo durante la fase de desarrollo. Se recomienda no enviar su aplicación a producción con una clave de cuenta insertada en ella. El enfoque recomendado es usar un enfoque de autenticación de Microsoft Entra basado en el usuario o en el servicio.

Autenticación de usuarios de Microsoft Entra ID

Siga los pasos para configurar la autenticación de usuario de Microsoft Entra en Azure Portal.

  1. Registro de la aplicación en Microsoft Entra ID. Como parte del registro, deberá determinar si la aplicación debe ser multiinquilino. También deberá proporcionar las direcciones URL de redireccionamiento que se permiten para la aplicación en la hoja Autenticación. Configuración de autenticación

  2. En la pestaña Permisos de API, solicite Permisos delegados para el ámbito mixedreality.signin en mixedreality. Permisos de API

  3. Conceda permiso de administrador en la pestaña Seguridad -> Permisos. Consentimiento de administrador

  4. A continuación, vaya al recurso de Azure Remote Rendering. En el panel Control de acceso, conceda los roles deseados para las aplicaciones y el usuario en nombre de los que desea usar permisos de acceso delegados para el recurso de Azure Remote Rendering. Agregar permisosAsignaciones de roles

Para obtener información sobre el uso de la autenticación de usuario de Microsoft Entra en el código de la aplicación, consulte el Tutorial: Protección de Azure Remote Rendering y el almacenamiento de modelos: Autenticación de Microsoft Entra

Control de acceso basado en rol de Azure

Para ayudar a controlar el nivel de acceso concedido al servicio, use los siguientes roles al conceder el acceso basado en roles:

  • Administrador de Remote Rendering: Proporciona al usuario funcionalidades de conversión, administración de sesiones, representación y diagnóstico para Azure Remote Rendering.
  • Cliente de Remote Rendering: Proporciona al usuario funcionalidades de administración de sesiones, representación y diagnóstico para Azure Remote Rendering.

Pasos siguientes