Configurar Auth0 para la autenticación SAML

Esta guía explica cómo configurar Auth0 para trabajar con SAML Single Sign-On para Aircall. Crearás una Aplicación de Página Única en Auth0, habilitarás el complemento SAML2 Web App, aplicarás la configuración requerida y exportarás los Metadatos del Proveedor de Identidad para Aircall.

Importante: El inicio de sesión único SAML debe estar activado para tu empresa por Aircall antes de seguir estos pasos. Para solicitar la activación, contacta con nuestro equipo de Customer Success. Actualmente, esta funcionalidad está disponible solo para un número limitado de clientes.

Crear una Aplicación de Página Única

Pasos:

1. Abre la consola de administración de Auth0: https://manage.auth0.com/
2. En la navegación izquierda, expande Aplicaciones, luego haz clic en Aplicaciones.
3. Haz clic en Crear Aplicación.
4. En el modal:
   • Introduce un nombre, por ejemplo acme-saml@aircall.
   • Selecciona Aplicaciones Web de Página Única.
   • Haz clic en Crear.

Configurar SAML

Pasos:

1. En la página de Aplicaciones, abre tu aplicación, por ejemplo acme-saml@aircall.
2. Ve a la pestaña Complementos.
3. Activa SAML2 Web App.
4. En el modal Complemento: SAML2 Web App, abre la pestaña Configuración.
5. En URL de devolución de llamada de la aplicación, introduce:
   • https://sso.aircall.io/saml2/idpresponse

6. En el editor JSON de Configuración, elimina el contenido existente y pega lo siguiente:

   {
     "audience": "urn:amazon:cognito:sp:us-west-2_hZkGBmIsz",
     "mappings": {
       "email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
     },
     "nameIdentifierFormat": "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
   }
   

7. Haz clic en Habilitar, luego en Guardar.
8. Abre la pestaña Uso y haz clic en Descargar bajo Metadatos del Proveedor de Identidad para exportar el archivo XML.

Nota: La URL de devolución de llamada de la aplicación y el JSON de Configuración deben coincidir exactamente.

Exportar los metadatos

Pasos:

1. Abre tu aplicación, por ejemplo acme-saml@aircall.
2. Ve a la pestaña Complementos y abre SAML2 Web App.
3. En el modal Complemento: SAML2 Web App, elige una de las siguientes opciones:
   • Haz clic derecho en la descarga de Metadatos del Proveedor de Identidad y copia la URL.
   • Haz clic en Descargar para guardar el archivo Metadatos del Proveedor de Identidad .xml.

Para más información sobre SAML, por favor lee más en Aircall y la Autenticación SAML o contacta con nuestro equipo de Customer Success.