Configurar SAML con JumpCloud

Antes de que empieces

Antes de comenzar, debe generar certificados digitales para cifrar la conexión SAML y cargarlos en LogicalDOC.

1. Puede utilizar el script Bash del repositorio logicaldoc/scripts en GitHub, o cualquier otro método adecuado.
2. Guarde los dos archivos que se generan. Son la clave privada y la clave pública. En el panel de configuración de SAML, se los denomina Clave privada del SP y Certificado del SP, respectivamente.

Preparar LogicalDOC

1. Habilite el Single Sign-On SAML en Administración > Seguridad > Single Sign-On SAML.
2. En el campo Entity ID del SP, coloque un identificador único (puede colocar aquí la misma URL que usa normalmente para conectarse a LogicalDOC, por ejemplo, http://localhost:8080).
3. Habilite tanto la firma de los mensajes AuthnRequest como el cifrado de las aserciones recibidas.
4. Elija SHA-256 como Algoritmo de la firma.
5. Cargue el Certificado del SP y la Clave privada del SP generados antes, en los campos correspondientes.
6. En el formulario Asignaciones de atributos, prepare las siguientes asignaciones:
   • En Nombre usuario, escriba username
   • En Nombre, escriba firstName
   • En Apellido, escriba lastName
   • En Email, escriba email
   • En Grupos, escriba groups

   Haga clic en Guardar para confirmar toda la configuración.

   

7. Exporte el archivo de metadatos del Proveedor de Servicios haciendo clic en la URL que se muestra en el campo Metadatos del SP. Luego utilizará este archivo en JumpCloud más adelante.

Ahora ha completado la configuración de LogicalDOC y puede abordar la configuración de JumpCloud.

Configurar una aplicación SSO para el Single Sign-On de LogicalDOC

1. Ingrese JumpCloud como administrador.

2. Vaya a SSO Applications > Add New Application.

3. Seleccione Custom Application y haga click en Next.

   

4. Elija solo la función Manage Single Sign-On (SSO) y luego Configure SSO with SAML.

   

5. Ingrese información general para la aplicación, incluyendo la etiqueta de visualización y el logotipo (opcional). Se recomienda mostrar el ícono de la aplicación a los usuarios. Si desea utilizar un logotipo de LogicalDOC para la aplicación, puede descargar uno desde nuestra página.

   

6. En la siguiente pantalla, seleccione Configure Application.

7. Cargue los metadatos del proveedor de servicios que obtuvo en el paso 7 de la preparación de LogicalDOC.

   

8. Un IdP Entity ID único.

   

9. Marque la opción Sign Assertion.

   

10. En la sección de atributos, haga clic en add attribute e inserte las siguientes asignaciones de atributos:

    • Asigne Service Provider Attribute Name username a JumpCloud Attribute Name username
    • Asigne Service Provider Attribute Name firstName a JumpCloud Attribute Name firstname
    • Asigne Service Provider Attribute Name lastName a JumpCloud Attribute Name lastname
    • Asigne Service Provider Attribute Name email a JumpCloud Attribute Name email

    

11. Habilite Include group attribute y ponga groups

12. Asignar los grupos de usuarios a esta nueva aplicación.

    

13. Seleccione Save para completar.

Exportar metadatos del proveedor de identidad

A continuación, exporte los metadatos del proveedor de identidad, que luego se cargarán en LogicalDOC para finalizar la configuración de SAML.

1. En JumpCloud, vaya a SSO Applications y aquí haga clic en la entrada LogicalDOC.

2. Abra la pestaña SSO y haga clic en Export Metadata.

   

3. Vaya a LogicalDOC en Administración > Seguridad > Single Sign-On SAML y cargue el archivo de metadatos del proveedor de identidad en el campo de Metadatos del IdP.

   Haga clic en el botón Guardar para confirmar todo.

Pruebe el login

Para comprobar si todo estaba configurado correctamente, puede intentar iniciar sesión desde LogicalDOC actuando como proveedor de servicios.

1. Vaya a LogicalDOC en Administración > Seguridad > Single Sign-On SAML y copie el enlace del campo Ingresar (es la URL base de LogicalDOC seguida de /saml/login).
2. Abra un navegador diferente y pegue la URL y será redirigido a la página de inicio de sesión de JumpCloud.
3. Aquí ingrese las credenciales de un usuario en su JumpCloudy debería iniciar sesión directamente en LogicalDOC.