OneLogin con SAML SSO

OneLogin es un Proveedor de Identidad (IdP) que simplifica la gestión de acceso de usuarios al permitir que los usuarios inicien sesión en múltiples aplicaciones con un único conjunto de credenciales. Con el SSO SAML configurado entre OneLogin y Document360, los miembros de tu equipo y lectores pueden acceder a Document360 usando sus credenciales OneLogin existentes.

Qué puedes hacer con OneLogin como tu IDP

Antes de que empieces

• Tienes una cuenta activa de OneLogin con acceso de administrador.
• Tienes acceso de Propietario o Administrador en tu proyecto de Document360.
• Abre Document360 y OneLogin en dos pestañas separadas del navegador. Tendrás que cambiar entre ellas varias veces durante la configuración.

Paso 1: Inicia la configuración SSO en Document360

Crear SSO en Document360

1. En Document360, navega a Configuración () > Usuarios y permisos > SSO empresarial.
2. Haz clic en Crear SSO > SAML.

3. Selecciona OneLogin como tu proveedor de identidad en el paso Elegir IdP .

Paso 2: Crear una aplicación SAML en OneLogin

Añadir el SCIM Provisioner con la aplicación SAML

1. Inicia sesión en tu Portal de Administración de OneLogin.
2. En el menú superior, selecciona Aplicaciones.
3. Haz clic en Añadir app.

4. En la barra de búsqueda, escribe SCIM y selecciona SCIM Provisioner con SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) desde la lista y haz clic en Guardar.

Descargar el certificado X.509

1. En tu aplicación OneLogin, navega a la pestaña SSO .
2. Haz clic en Ver detalles para descargar el certificado X.509.

Paso 3: Configurar el proveedor de servicios en OneLogin

Copia los parámetros de SP de Document360 e introduce OneLogin

1. En Document360, ve al paso Configurar SP y copia los parámetros que necesites.

2. Ve a OneLogin y navega a la pestaña de Configuración . Introduce los parámetros de Document360 usando el mapeo que aparece a continuación.

Paso 4: Completar la configuración SSO en Document360

Configurar el proveedor de identidad en Document360

1. En OneLogin, navega a la pestaña SSO y copia los parámetros que se muestran allí.

2. En Document360, haz clic en Siguiente para ir al paso Configurar IdP .
3. En el campo Configurar una conexión existente , puedes heredar de una configuración SSO ya creada que tenga SCIM activado en un proyecto padre. Al seleccionar y heredar esta conexión, la configuración actual del SSO se establecerá como la configuración SSO heredada por hijo y heredará automáticamente la configuración SCIM del padre.

4. Introduce los parámetros de OneLogin en Document360 usando el mapeo que aparece a continuación.

5. Adjunta el certificado X.509 descargado previamente en el campo del certificado SAML en Document360.
6. Activa o desactiva el interruptor de inicio de sesión iniciado por Permitir IdP según los requisitos de tu proyecto.

7. Haz clic en Siguiente para acceder al paso de aprovisionamiento SCIM .

Paso 5: Configurar el aprovisionamiento SCIM

El aprovisionamiento SCIM automatiza la gestión del ciclo de vida del lector entre OneLogin y Document360. Cuando está habilitado, los lectores añadidos o desactivados en OneLogin se sincronizan automáticamente con Document360.

Si no necesitas aprovisionamiento SCIM, haz clic en Siguiente y salta a Configurar el nombre SSO y las opciones de acceso a continuación.

Activar SCIM en Document360

1. Activa el interruptor Habilitar provisión SCIM .

2. Aparece un cuadro de confirmación. Revisa los términos, selecciona la casilla y haz clic en Aceptar.
3. A continuación, se mostrarán los parámetros necesarios para completar la configuración SCIM en OneLogin.

Configurar SCIM en OneLogin

1. En OneLogin, ve a la pestaña de Configuración y desplázate hacia abajo hasta la sección de Conexión a la API .
2. Introduce los parámetros de Document360 usando el mapeo que aparece a continuación.

3. Haz clic en Habilitar para habilitar la provisión SCIM en OneLogin.
4. Haz clic en Guardar para crear correctamente la aplicación SAML con SCIM activado.

Habilitar la provisión SCIM en OneLogin

1. En OneLogin, ve a la pestaña de Provisión .
2. Selecciona la casilla Habilitar aprovisionamiento y haz clic en Guardar.

El SCIM Provisioner con aplicación SAML ha sido creado con éxito.

Asignar roles y grupos por defecto en Document360

1. Vuelve a Document360. En el campo de rol por defecto , el rol está configurado como Contribuyente por defecto. Puedes cambiar esto desde el desplegable si es necesario.
2. En los campos de grupos de usuarios y grupos de lectores , selecciona los grupos que quieres añadir. Se pueden añadir varios grupos y heredarán el rol predeterminado que seleccionaste antes.

3. Haz clic en Siguiente para continuar.

Configurar el nombre del SSO y las opciones de inicio de sesión

1. En el campo de nombre de SSO , introduce un nombre para la configuración SSO.
2. En el texto del botón de Inicio de sesión, introduce el texto del botón de inicio de sesión que se muestra a los usuarios.
3. Asignar automáticamente el grupo de lectores — esta opción solo está disponible para configuraciones SSO existentes. Para configuraciones de SSO recién creadas, este interruptor no se mostrará ya que SCIM provisiona automáticamente usuarios y grupos. Obtenga más información sobre el grupo de lectores de asignación automática.
4. Activa el tiempo de espera SSO de la sesión de reposo si es necesario y establece la duración del tiempo de espera (HH:MM).
5. Elige si invitar a Todos los usuarios o solo a los usuarios seleccionados a SSO usando los botones de radio.

6. Haz clic en Crear para completar la configuración del SSO.

SAML SSO con SCIM ha sido configurado con éxito. Ahora puedes gestionar los lectores directamente desde tu IdP de OneLogin.

Heredar de otra aplicación

Al crear una nueva configuración SSO en Document360, puedes heredar la configuración SCIM de una conexión SSO existente. Esto simplifica el proceso de configuración, evita repetir los pasos de configuración y ayuda a los administradores a ahorrar tiempo asegurando la coherencia entre integraciones.

Configuración SSO heredada por hijo

En la página Configurar IdP , selecciona el campo Configurar una conexión existente y elige la aplicación principal habilitada con SSO SCIM de la que quieres heredar. Seleccionar esta opción designa el proyecto actual como proyecto hijo, heredando todas las propiedades relevantes del padre.

Configuración SSO heredada por padre

La aplicación principal mostrará una lista de todos los proyectos que han heredado su configuración. Cualquier cambio realizado en la aplicación principal se reflejará automáticamente en la aplicación hija.

• Si SCIM está habilitado en el proyecto padre después de que los proyectos hijos ya lo hayan heredado, los usuarios y grupos se aprovisionarán automáticamente a todos los proyectos hijos en segundo plano.
• Habilitar la herencia facilita la gestión de múltiples configuraciones SSO con SCIM activado, ya que todos los ajustes se controlan desde una única aplicación principal. Esto ahorra tiempo y reduce el esfuerzo necesario para gestionar cada configuración individualmente.

Gestión de Document360 con OneLogin

Una vez que hayas configurado con éxito la aplicación SAML con SCIM en Document360 usando OneLogin, puedes gestionar los lectores directamente desde OneLogin, con todos los cambios reflejados automáticamente en Document360.

Añadir un lector

1. En el menú superior de OneLogin, amplía el desplegable Usuarios y selecciona Usuarios.
2. Haz clic en Nuevo usuario, introduce los datos de usuario requeridos y haz clic en Guardar.

Ahora se crea con éxito un nuevo usuario.

Asignar aplicación al usuario

1. Después de crear al usuario, ve a Aplicación en el menú izquierdo.
2. Haz clic en el icono + en la esquina superior derecha para añadir una aplicación.
3. Selecciona la aplicación con SAML aprovisionado por SCIM activado y haz clic en Continuar.

4. Introduce la dirección de correo electrónico del usuario en el campo de nombre de usuario SCIM y haz clic en Guardar.

El usuario ahora se asigna correctamente a la aplicación.

Aprobar estado de usuario

1. En el menú superior de OneLogin, haz clic en Aplicaciones y selecciona Aplicaciones.
2. Elige la aplicación SAML provisionada por SCIM y abre la pestaña Usuarios .
3. Haz clic en el estado del usuario, que aparece como Pendiente, y luego selecciona Aprobar en el cuadro de confirmación.

El usuario ahora está aprobado y se ha añadido con éxito a Document360.

Verificar en Document360

Para verificar que el usuario ha sido añadido correctamente a Document360:

1. En Document360, navega a Configuración () > Usuarios y permisos > Lectores y grupos.

El lector se añade automáticamente en Document360. La insignia SSO-SCIM junto a su nombre indica que SCIM está habilitado.

Gestionar usuarios en Document360

Cuando SCIM está habilitado, se desactiva editar el nombre de un usuario o eliminar directamente a un usuario en Document360. Estas acciones deben gestionarse a través de tu IdP para mantener ambas plataformas sincronizadas.

Sin embargo, aún puedes gestionar el acceso al contenido dentro de Document360.

Gestionar el acceso al contenido

1. En Document360, navega a Configuración () > Usuarios y permisos > Lectores y grupos.
2. Selecciona al usuario deseado y haz clic en Gestionar acceso al contenido.
3. Asigna el nivel de acceso al contenido desde el desplegable y haz clic en Actualizar.

El acceso al contenido ahora se asigna correctamente al usuario.

Eliminar un usuario

1. En el menú superior de OneLogin, haz clic en Usuarios y selecciona el usuario que quieres eliminar.
2. Amplía el desplegable Más acciones y haz clic en Eliminar.

3. En el cuadro de confirmación, haz clic en Borrar de nuevo.

El usuario es eliminado con éxito y dejará de aparecer en OneLogin.

Mejores prácticas

• Usa la aplicación SCIM correcta en OneLogin. Busca y selecciona SCIM Provisioner con SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) específicamente. Usar una app diferente no funcionará con Document360.
• Gestiona solo lectores a través de OneLogin SCIM. No se soportan atributos de usuario ni mapeo de grupos. Planifica tu flujo de trabajo de gestión de usuarios en consecuencia.
• Aprobar los usuarios provisionados rápidamente. Los usuarios añadidos en OneLogin aparecen en Document360 con un estado Pendiente. Apruébalos en OneLogin para activar el acceso.
• No elimines usuarios en Document360 cuando SCIM esté habilitado. Eliminar un usuario directamente en Document360 está deshabilitado cuando SCIM está activo. Gestiona las eliminaciones de OneLogin. Ten en cuenta que los usuarios eliminados en OneLogin se vuelven inactivos en Document360, no eliminados.
• Usa la herencia para configuraciones de varios proyectos. Si tienes varios proyectos de Document360 que comparten la misma configuración SSO, usa herencia padre-hijo para gestionar todas las configuraciones desde un solo lugar.

Preguntas frecuentes