Configuración de Auth0 en Jitterbit App Builder

Auth0 es un Proveedor de Identidad (IdP) que admite varios protocolos de autenticación, incluida la autenticación SAML de Inicio de Sesión Único (SSO). App Builder se integra con Auth0 como Proveedor de Servicios (SP). Cada instancia de App Builder debe integrarse individualmente con Auth0 y viceversa. Hay tres tareas principales involucradas:

1. Registrar App Builder como cliente Auth0.
2. Configurar Auth0 como Proveedor de Seguridad en App Builder.
3. Asignar usuarios de App Builder a identidades Auth0.

Se asume que tu organización ya tiene una cuenta Auth0 existente.

Las instrucciones a continuación harán referencia a las siguientes propiedades:

Registrar App Builder como cliente Auth0

Para registrar App Builder como cliente Auth0, comienza por iniciar sesión en el panel de Auth0 como Administrador del Panel.

1. Selecciona el enlace de menú Clientes.

   

2. Haz clic en el botón Crear Cliente.

   

3. Proporciona el Nombre del cliente.

4. Para el Tipo de Cliente, elige Aplicaciones Web Regulares.
5. Haz clic en el botón Crear.
6. Haz clic en la pestaña Complementos.

7. Selecciona la opción Aplicación Web SAML2.

   

8. Para la URL de Devolución de Llamada de la Aplicación, proporciona la URL del Servicio de Consumidor de Aserciones.

   Ejemplo: https://example.com/Vinyl/signin-Auth0

9. Haz clic en la pestaña Uso.

10. Anota la URL de Metadatos del Proveedor de Identidad, es decir, haz clic derecho en el enlace de Descargar y elige Copiar dirección del enlace.

    https://example.auth0.com/samlp/metadata/aBcDeFgHiJkLmNoPqRsTuVwXyZ

11. Haz clic en el botón Guardar.

    Nota que el inicio de sesión único (SSO) no está habilitado por defecto. Si requieres inicio de sesión único:

12. Haz clic en la pestaña Configuración.

13. Habilita la opción Usar Auth0 en lugar del IdP para hacer Inicio de Sesión Único.

    

14. Haz clic en el botón Guardar.

Configurar Auth0 como Proveedor de Seguridad en App Builder

Para configurar Auth0 como Proveedor de Seguridad en App Builder, comienza por iniciar sesión en App Builder como administrador.

1. Navega al IDE
2. Selecciona el botón Proveedores de Seguridad
3. Haz clic en el botón + Proveedor de Seguridad

4. Proporciona lo siguiente:

5. Nombre: {Security Provider Name}

   Ejemplo: Auth0

6. Tipo: SAML

7. Prioridad: Un número entero único entre 10 y 100. Ten en cuenta que este valor debe ser único.

   Ejemplo: 50

8. Habilitado: Marcar

9. Aprovisionamiento de usuarios: Marcar para habilitar el aprovisionamiento de usuarios justo a tiempo
10. Proporciona pertenencia a grupos: Marcar si Auth0 ha sido configurado para pasar la pertenencia a grupos de usuarios.
11. Redirigir al desafío: Si se habilita, el cliente web omitirá el formulario de inicio de sesión, redirigiendo al usuario al proveedor OAuth

12. Mostrar en formulario de inicio de sesión: Marcar

13. Haz clic en el botón Guardar

14. En el panel Propiedades, haz clic en el botón + Propiedad
15. De la lista de selección de parámetros, selecciona MetadataEndpoint

16. Para el valor, proporciona el enlace {Identity Provider Metadata} (consulta arriba).

    Ejemplo: https://example.auth0.com/samlp/metadata/aBcDeFgHiJkLmNoPqRsTuVwXyZ

17. Haz clic en el icono Guardar (Marcar)

Asigna usuarios de App Builder a identidades de Auth0

Con aprovisionamiento de usuarios

Si has habilitado el aprovisionamiento de usuarios tal como se describió anteriormente e intentas iniciar sesión, es posible que se te redirija de vuelta al formulario de inicio de sesión de App Builder con el siguiente mensaje:

La cuenta de usuario (arthur.dent@example.com) no ha recibido acceso a una aplicación.

Aunque App Builder logró aprovisionar al usuario exitosamente, el usuario no tiene acceso a ninguna aplicación de App Builder de forma predeterminada. Suponiendo que el usuario de Auth0 ha sido agregado a uno o más grupos y que Proporciona pertenencia a grupos está habilitado (tal como se describió anteriormente), deberás asignar los grupos de seguridad de Auth0 a los grupos de seguridad de App Builder.

Para asignar grupos de seguridad de Auth0 a grupos de seguridad de App Builder, comienza iniciando sesión en App Builder como administrador.

1. Navega a IDE
2. Selecciona el botón Gestión de usuarios
3. Haz clic en la pestaña Identidades
4. En el panel Proveedores, localiza y selecciona el proveedor de seguridad Auth0
5. En el panel Grupos de proveedores, localiza un grupo de Auth0 que desees asignar y haz clic en el icono Editar (Lápiz). Si no aparece, haz clic en + Grupo y configura un registro en consecuencia.
6. Selecciona el Grupo de seguridad de App Builder al cual se asignará el grupo de Auth0
7. Haz clic en el botón Guardar

Consulta la sección sobre asignación de identidades y grupos para obtener más información.

Sin aprovisionamiento de usuarios

Si no has habilitado el aprovisionamiento de usuarios, la autenticación habrá fallado con un mensaje similar al siguiente:

Aunque te has autenticado exitosamente con Auth0, la cuenta arthur.dent@example.com (auth0|aBcDeFgHiJkLmNoPqRsTuVwZyZ) no está asociada a una cuenta local.

En el mensaje anterior, arthur.dent@example.com es el nombre de usuario (llamado "nombre" en la autenticación de reclamaciones). La parte entre paréntesis es el identificador único (llamado "identificador de nombre" en la autenticación de reclamaciones). Necesitarás estas dos piezas de información para el siguiente paso.

Para asignar una cuenta de usuario de App Builder a una identidad de Auth0, comienza iniciando sesión en App Builder como administrador:

1. Navega a IDE
2. Selecciona el botón Gestión de usuarios
3. Selecciona Usuarios del menú
4. En el panel Usuarios, localiza y selecciona el usuario que desees asignar
5. En el panel Identidades, haz clic en el botón + Identidad

6. Proporciona lo siguiente:

   • Proveedor: Auth0 (o el nombre elegido en la sección anterior)
   • Nombre: El nombre de usuario de Auth0 (consulta arriba)
   • Identificador: El identificador de nombre de Auth0 (consulta arriba)

7. Haz clic en el icono Guardar (Marcar)

Solución de problemas

El usuario es redirigido de vuelta a la página de inicio de sesión después de iniciar sesión.

1. Si Aprovisionamiento ha sido habilitado, entonces es posible que el usuario haya sido creado pero no asignado a ningún grupo, o los grupos a los cuales se ha asignado el usuario no han recibido acceso a ninguna aplicación de App Builder. El único grupo asignado a nuevos usuarios de forma predeterminada (es decir, tiene la opción Otorgar al crear usuario habilitada) es el grupo Usuarios. Este grupo no recibe acceso a ninguna aplicación de forma predeterminada.

2. Si la opción Supplies Group Membership se ha habilitado, App Builder habrá registrado cualquier grupo de Auth0 pasado a través de una afirmación SAML. Inicia sesión como administrador y asigna los grupos de Auth0 a los grupos de seguridad de App Builder.

3. Si la opción Supplies Group Membership no se ha habilitado, el proveedor de seguridad de Auth0 no tendrá ningún grupo. Inicia sesión como administrador y define uno o más grupos de proveedor de Auth0 con la opción Grant On Identity Create habilitada y asigna los grupos del proveedor a los grupos de seguridad de App Builder.

4. Si el proveedor de seguridad Require HTTPS no se ha habilitado, el usuario puede iniciar el proceso de SSO de SAML desde una URL no segura (por ejemplo, http://example.com/). Sin embargo, Auth0 puede devolver el usuario a la URL del Servicio de Consumo de Afirmaciones (ACS) segura (https://example.com/signin-Auth0). App Builder autentica al usuario en el contexto de la URL segura antes de devolverlo a la URL no segura. En efecto, el usuario tiene dos sesiones separadas. Para resolver este problema, habilita el proveedor de seguridad Require HTTPS.