Configuración de la autenticación de usuario con Microsoft Entra ID

Cuando añades autenticación a tu agente, los usuarios pueden iniciar sesión y darle acceso a un recurso o información restringida.

En este artículo se explica cómo configurar Microsoft Entra ID como proveedor de servicios. Para obtener información sobre otros proveedores de servicios y la autenticación de usuarios, consulte Configurar la autenticación de usuario en Copilot Studio.

Si tiene derechos de administración de inquilinos, puede configurar los permisos de la API. De lo contrario, pide a un administrador de inquilinos que conceda estos permisos.

Requisitos previos

Más información sobre cómo agregar autenticación de usuario a un tema

Complete los primeros pasos en el portal de Azure y complete los dos pasos finales en Copilot Studio.

Crear un registro de aplicación

1. Inicia sesión en el portal de Azure utilizando una cuenta de administrador en el mismo directorio que tu agente.

2. Vaya a App registrations.

3. Seleccione Nuevo registro y escriba un nombre para el registro. No alterar registros de aplicaciones existentes.

   Puede ser útil posteriormente usar el nombre de su agente. Por ejemplo, si su agente se llama "Ayuda de ventas de Contoso", podría nombrar el registro de aplicación "ContosoSalesReg".

4. En Tipos de cuenta admitidos, seleccione Solo cuentas en este directorio organizativo (Solo Contoso - Inquilino único).

5. Deje la sección URI de redireccionamiento en blanco por ahora. Introduzca esa información en los siguientes pasos.

6. Seleccione Registrar.

7. Cuando termine la inscripción, ve a Resumen.

8. Copie el ID de la aplicación (cliente) y péguelo en un archivo temporal. Lo necesitará en pasos posteriores.

Agregar la URL de redireccionamiento

1. En Administrar, seleccione Autenticación.

2. Debajo de Configuraciones de plataforma, seleccione Agregar una plataforma y luego seleccione Web.

3. En URI de redirección, escriba https://token.botframework.com/.auth/web/redirect o https://europe.token.botframework.com/.auth/web/redirect para Europa. También puede copiar el URI del cuadro de texto Redirect URL en la página de configuración de Seguridad de Copilot Studio, en la sección Autenticar manualmente.

   Esta acción le lleva de vuelta a la página de configuraciones de la plataforma.

   Para obtener una lista de los servicios necesarios a los que se conecta Copilot Studio, incluido token.botframework.com, consulte Servicios .

4. Seleccione tokens de acceso (usados para flujos implícitos) y tokens de identificador (usados para flujos implícitos e híbridos).

5. Seleccione Configurar.

Configuración manual de la autenticación

A continuación, configure la autenticación manual. Puede elegir entre varias opciones para su proveedor. Sin embargo, use Microsoft Entra ID V2 con credenciales federadas. También puede usar secretos de cliente si no puede usar credenciales federadas.

Configurar permisos de API

1. Vaya a Permisos de API.

2. Seleccione Otorgar consentimiento de administrador para <su nombre de inquilino> y después seleccione Sí. Si el botón no está disponible, es posible que tenga que pedir a un administrador del arrendatario que lo introduzca por usted.

   

   Importante

   Para evitar que los usuarios tengan que dar su consentimiento a cada aplicación, alguien asignado con al menos el rol de Administrador de Aplicaciones o Administrador de Aplicaciones en la Nube puede conceder el consentimiento a nivel de inquilino para los registros de sus aplicaciones.

3. Seleccione Agregar un permiso y, a continuación, seleccione Microsoft Graph.

   

4. Seleccione Permisos delegados.

   

5. Expanda OpenId permissions y active openid y perfil.

   

6. Seleccione Agregar permisos.

Definir un ámbito personalizado para su agente

Los ámbitos determinan los roles de usuario y administrador, así como los derechos de acceso. Crea un ámbito personalizado para el registro de la aplicación Canvas.

1. Vaya a Exponer una API y seleccione Agregar un ámbito.

   

2. Configure las siguientes propiedades. Puede dejar las otras propiedades en blanco.

   Propiedad	valor
   Nombre del ámbito	Escriba un nombre que tenga sentido en su entorno, como Test.Read
   ¿Quién puede consentir?	Seleccione Administradores y usuarios
   Nombre para mostrar el consentimiento administrativo	Escriba un nombre que tenga sentido en su entorno, como Test.Read
   Descripción del consentimiento del administrador	Escriba Allows the app to sign the user in..
   Estado	Seleccione habilitado

3. Selecciona la opción Agregar un ámbito.

Configuración de la autenticación en Copilot Studio

1. En Copilot Studio, en Settings, seleccione Security>Authentication.

2. Seleccione Autenticar manualmente.

3. Deje Requerir que los usuarios inicien sesión activado.

4. Seleccione un proveedor de servicios y proporcione los valores requeridos. Consulte Configurar la autenticación manual en Copilot Studio.

5. Haga clic en Guardar.

Pruebe el agente

1. Publique su agente.

2. En el panel Probar el agente, envíe un mensaje a su agente.

3. Cuando el agente responda seleccione Iniciar sesión.

   Se abre una nueva pestaña del navegador, pidiéndote que inicies sesión.

4. Inicie sesión y luego copie el código de validación que se muestra.

5. Pegue el código en el chat del agente para completar el proceso de inicio de sesión.