Compartir a través de


Configurar el inicio de sesión único con Microsoft Entra ID

Copilot Studio admite el inicio de sesión único (SSO). SSO permite a los agentes de su sitio web registrar a los clientes si ya han iniciado sesión en la página o aplicación donde se implementa el agente.

Por ejemplo, el agente está hospedado en la intranet corporativa o en una aplicación en la que el usuario ya ha iniciado sesión.

Hay cinco pasos principales para configurar el SSO para Copilot Studio:

  1. Habilite la autenticación manual para su agente con Microsoft Entra ID

  2. Cree un registro de aplicación en Microsoft Entra ID para el lienzo personalizado.

  3. Defina un ámbito personalizado para su agente en Microsoft Entra ID:

  4. Agregue el ámbito personalizado a la configuración del agente.

  5. Configure el código del lado del cliente de su lienzo personalizado para habilitar SSO.

Requisitos previos

Nota

Para configurar SSO utilizando otros proveedores de OAuth 2.0, consulte Configurar el inicio de sesión único con proveedores de OAuth genéricos.

Canales admitidos

La siguiente tabla detalla los canales que actualmente admiten SSO. Puede sugerir la compatibilidad para canales extra en el foro de ideas de Copilot Studio.

Canal Addmitido
Canales de Azure Bot Service No admitido
Sitio web personalizado Addmitido
Sitio web de demostración No admitido
Facebook No admitido
Microsoft Teams1 Addmitido
Aplicación móvil No admitido
Plataforma omnicanal para Customer Service2 Addmitido
SharePoint1 Addmitido

1 Si también tiene el canal de Teams habilitado, debe seguir las instrucciones de configuración incluidas en la documentación Configurar el inicio de sesión único con Microsoft Entra ID para agentes en la documentación de Microsoft Teams. Si no configura los ajustes de SSO de Teams como se indica en esa página, sus usuarios siempre fallarán en la autenticación al usar el canal de Teams.

2 Solo se admite el canal de chat en vivo. Para más información, consulte Configurar la transferencia a Dynamics 365 Customer Service.

Importante

Actualmente, el inicio de sesión único no se admite cuando un agente ha sido:

Sin embargo, SSO es compatible con un agente que se ha publicado en un sitio web de SharePoint como un componente SPFx.

Crer registros de aplicación para el sitio web personalizado

Para habilitar SSO, necesitará crear dos registros de aplicaciones separados:

  • Un registro de aplicación de autenticación, que habilita la autenticación de usuario de Microsoft Entra ID para su agente
  • Un registro de la aplicación de lienzo que habilita SSO para su página web personalizada

Por razones de seguridad, no se recomienda volver a utilizar el mismo registro de aplicación para el agente y su sitio web personalizado.

  1. Siga las instrucciones en Configurar la autenticación de usuarios con Microsoft Entra ID para crear un registro de aplicación de autenticación.

  2. Cree un segundo registro de aplicación para que sirva como su registro de aplicación de lienzo.

Agregar URL de intercambio de token

Para actualizar la configuración de autenticación de Microsoft Entra ID en Copilot Studio, debe agregar la URL de intercambio de token para permitir su aplicación y Copilot Studio para compartir la información.

  1. En Azure Portal, en la página de registro de la aplicación de autenticación, vaya a Exponer una API.

  2. En Ámbitos, seleccione el icono Copiar al portapapeles.

  3. En Copilot Studio, en el menú de navegación en Configuración, seleccione Seguridad y, a continuación, seleccione el mosaico Autenticación.

  4. Para URL de intercambio de tokens (obligatorio para SSO), pegue el alcance que copió anteriormente.

  5. Seleccione Guardar.

Configura el identificador de cliente de tu aplicación Canvas para mostrar un menú de API

  1. En Azure Portal, en la página de registro de la aplicación de autenticación, vaya a Información general.

  2. Copie el valor de Id. de aplicación (cliente) en Elementos esenciales.

  3. En la barra de navegación, seleccione Administrar>exponer una API.

  4. En Aplicaciones cliente autorizadas, seleccione + Agregar una aplicación cliente y pegue el identificador de cliente copiado.

  5. Seleccione Guardar.

Configure el registro de su aplicación de lienzo

  1. Una vez ha creado su registro de aplicación de lienzo, vaya a Autenticación y luego seleccione Agregar una plataforma.

  2. Debajo de Configuraciones de plataforma, seleccione Agregar una plataforma, luego seleccione SPA.

  3. En URI de redireccionamiento, introduzca la URL de su página web; por ejemplo, http://contoso.com/index.html.

    Captura de pantalla de la página web Configurar.

  4. En la sección Concesión implícita y flujos híbridos, active tanto Tokens de acceso (utilizados para flujos implícitos e híbridos) como Tokens de acceso (utilizados para flujos implícitos).

  5. Seleccione Configurar.

Buscar la URL del punto de conexión del token del agente

  1. En Copilot Studio, abra su agente y seleccione Canales.

  2. Seleccione Aplicación móvil.

  3. En Extremo de token, seleccione Copiar.

    Captura de pantalla de la copia de la URL de punto de conexión de token en Copilot Studio.

Configurar SSO en su página web

Use el código proporcionado en el repositorio de GitHub de Copilot Studio para crear una página web para la URL de redireccionamiento. Copie el código del repositorio de GitHub y modifíquelo siguiendo las siguientes instrucciones.

  1. Vaya a la página Descripción general en el portal de Azure y copie el Id. de aplicación (cliente) y Id. de directorio (inquilino) en el registro de la aplicación de lienzo.

    Captura de pantalla de la página Descripción general del registro de la aplicación en Azure Portal, con Descripción general, Id. de la aplicación y el Id. del directorio resaltados.

  2. Para configurar la Microsoft Authentication Library (MSAL):

    • Asigne clientId para su Id. de la aplicación (cliente).
    • Asigne authority a https://login.microsoftonline.com/ y agregue su Id. de directorio (inquilino) al final.

    Por ejemplo:

    var clientApplication;
        (function (){
        var msalConfig = {
            auth: {
                clientId: '00001111-aaaa-2222-bbbb-3333cccc4444',
                authority: 'https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'     
            },
    
  3. Establezca la variable theURL en la URL del token punto de conexión que copió anteriormente. Por ejemplo:

    (async function main() {
    
        var theURL = "https://<token endpoint URL>"
    
  4. Edite el valor de userId para incluir un prefijo personalizado. Por ejemplo:

    var userId = clientApplication.account?.accountIdentifier != null ? 
            ("My-custom-prefix" + clientApplication.account.accountIdentifier).substr(0, 64) 
            : (Math.random().toString() + Date.now().toString()).substr(0,64);
    
  5. Guarda los cambios.

  6. Verifique que ha configurado correctamente el SSO.

    Al probar su agente, si SSO no está configurado correctamente, se le pedirá que inicie sesión, lo que le brinda un código de validación que debe copiar en la ventana de chat.

    Si ve un mensaje de inicio de sesión, verifique que completó correctamente los pasos 1 a 5 de este procedimiento. Si el inicio de sesión único se configura correctamente, no se le pedirá que inicie sesión.

    Nota

    El código del repositorio de GitHub requiere que los usuarios seleccionen el botón de inicio de sesión. En producción, es posible que quiera reemplazar la funcionalidad del botón por un evento más adecuado, como navegar a una página.