Configurar SAML SSO con Okta

Conecta Okta a Document360 con SAML para que tus usuarios y lectores inicien sesión en Document360 con sus credenciales Okta en lugar de una contraseña separada. La configuración incluye aprovisionamiento SCIM opcional para mantener a usuarios y lectores sincronizados automáticamente.

Con Okta y SAML, puedes:

• Permite que los usuarios inicien sesión en el portal de la base de conocimientos y los lectores en el sitio de la base de conocimientos.
• Permite que la gente inicie sesión directamente desde el panel de control de Okta.
• Añade, actualiza y desactiva usuarios y lectores en Okta, y sincroniza los grupos de Okta con SCIM.
• Reutiliza la configuración de SCIM desde una configuración SSO en un proyecto padre.

Antes de que empieces

• Necesitas una cuenta de Okta con acceso de administrador. Si no tienes una, regístrate en Okta.
• Necesitas el rol de Propietario o Administrador en tu proyecto de Document360.
• Abre Document360 y Okta en dos pestañas del navegador. Tendrás que cambiar entre ellas durante la configuración.
• Si planeas configurar SCIM, ten un lugar seguro preparado, como un gestor de contraseñas, para almacenar dos tokens secretos.

Paso 1: Inicia la configuración SSO en Document360

1. Ve a Configuración () > Usuarios y permisos > SSO empresarial.

2. Selecciona Crear SSO y luego SAML.

3. En el paso Elegir IDP , selecciona Okta.

   

El paso Configurar SP muestra los parámetros que vas a introducir en Okta. Mantén esta pestaña abierta.

Paso 2: Crear la app SAML en Okta

Crear la integración de la app

1. Inicia sesión en Okta y luego selecciona Administrador en la esquina superior derecha para abrir la Consola de Administración.

2. En la navegación de la izquierda, expande Aplicaciones y Recursos y luego selecciona Aplicaciones.

   

3. Selecciona Crear integración de aplicaciones.

4. Selecciona SAML 2.0 y luego selecciona Siguiente.

   

Entra en la configuración general

1. En la pestaña de Configuración General , introduce el nombre de una aplicación, como Document360 SSO.

2. (Opcional) Sube un logo y configura la visibilidad de la app.

3. Selecciona Siguiente. Se abre la pestaña Configurar SAML .

   

Introduce los parámetros de Document360

1. En la pestaña Configurar SAML , copie estos valores del paso Configurar SP de Document360:

   Copia de Document360	Pegar en Okta
   Ruta de retrollamada	URL de inicio de sesión único
   ID de entidad del proveedor de servicios	URI de audiencia (ID de entidad SP)

2. Configura el formato del ID de Nombre a Dirección de Correo Electrónico.

3. Configura el nombre de usuario de la aplicación como Correo electrónico.

4. Selecciona Mostrar Configuración Avanzada, activa Activar Cierre de sesión Único y pega la ruta de callback Desconectado de Document360 en URL de Cierre de sesión Único.

5. Selecciona Siguiente.

   

Completa la página de comentarios

1. Selecciona Esta es una aplicación interna que hemos creado.

2. Selecciona Terminar.

   

Okta crea la app.

Añadir sentencias de atributo

Las sentencias de atributo indican a Okta qué datos de usuario enviar a Document360.

1. En la app, selecciona la pestaña Iniciar sesión y desplázate hasta las sentencias de atributo.

   

2. Expande Mostrar configuración heredada y luego selecciona Editar junto a Sentencias de atributo del perfil.

   

3. Añade estas tres sentencias de atributo. Selecciona Añadir Otro para añadir la segunda y tercera fila.

   Nombre	Formato del nombre	Valor
   urn:oasis:names:tc:SAML:2.0:nameid	Referencia URI	user.email
   name	No especificado	user.email
   email	No especificado	user.email

4. Selecciona guardar.

Asigna personas a la app

Solo las personas asignadas a la app en Okta pueden iniciar sesión en Document360 con Okta.

1. En la app, selecciona la pestaña Asignaciones .
2. Selecciona Asignar y luego selecciona Asignar a personas o Asignar a grupos.
3. Selecciona Asignar junto a cada persona o grupo que deba iniciar sesión en Document360, selecciona Guardar y Volver, y luego selecciona Hecho.

Paso 3: Introduce los datos de Okta en Document360

Obtén los valores de configuración en Okta

En la pestaña de Inicio de sesión de la app, selecciona Ver instrucciones de configuración SAML. Los valores que necesitas se abren en una nueva página.

Completar el paso Configurar IdP

1. Cambia a la pestaña Document360 y luego selecciona Siguiente para ir al paso Configurar IdP .

2. (Opcional) Para reutilizar la configuración SCIM de un proyecto padre, selecciona una configuración SSO con SCIM activado en Configurar una conexión existente. Esta configuración se convierte en una configuración hija y hereda la configuración SCIM del padre, y el paso SCIM queda bloqueado. Para saber más, lee Heredar desde otra aplicación.

3. Copia estos valores de las instrucciones de configuración de Okta:

   Copiado de Okta	Pegar en Document360
   URL de inicio de sesión único del proveedor de identidad	URL de inicio de sesión
   Proveedor de Identidad Emisor	ID de entidad

4. Leave Binding type configurado en Httppost, que coincide con el valor predeterminado de Okta.

5. Descarga el certificado X.509 de Okta y luego súbelo en un certificado SAML. Puedes subir un archivo PEM, CRT o CER de hasta 10 MB.

6. Para permitir que la gente inicie sesión desde el panel de control de Okta, activa Permitir inicio de sesión iniciado por IDP. Para saber más, lee Permitir que la gente inicie sesión desde tu panel de IdP.

   

7. Selecciona Siguiente. Se abre el paso SCIM .

Paso 4: (Opcional) Configurar el aprovisionamiento SCIM

SCIM mantiene Document360 sincronizado con Okta: cuando añades, actualizas o desactivas usuarios y lectores en Okta, Document360 se actualiza automáticamente. Ahora configurarás SCIM en ambas pestañas y lo probarás en el Paso 6 después de crear la configuración.

Si no necesitas SCIM, deja desactivado Habilitar provisionamiento SCIM y ve al Paso 5.

Activa SCIM en Document360

1. En el paso SCIM , activa Habilitar provisión SCIM.

   

2. En el cuadro de confirmación, revisa los términos, selecciona la casilla y luego selecciona Aceptar. Aparecen la URL base de SCIM y los tokens secretos principal y secundario.

   

3. Copia ambos tokens secretos y guárdalos de forma segura.

Activa SCIM en la app de Okta

1. En la Consola de Administración de Okta, expande Aplicaciones y Recursos, selecciona Aplicaciones y luego abre tu aplicación Document360.

2. En la pestaña General , selecciona Editar junto a Configuración de la aplicación.

3. En Provisionamiento, selecciona SCIM y luego selecciona Guardar.

   

Conecta Okta con Document360

1. En la pestaña de Provisionamiento , selecciona Editar junto a Conexión SCIM.

   

2. En la URL base del conector SCIM, pega la URL base SCIM desde Document360.

3. En el campo de identificador único para usuarios, introduzca userName.

4. En acciones de aprovisionamiento soportadas, selecciona solo Enviar nuevos usuarios, Enviar actualizaciones de perfil y Grupos de empujar.

5. En modo Autenticación, selecciona Encabezado HTTP.

6. En la cabecera HTTP, pega el token secreto principal de Document360 en Autorización.

   

7. Selecciona guardar.

Establece el rol y los grupos por defecto en Document360

1. Cambia a la pestaña Document360. Para asignar usuarios y lectores según sus grupos de Okta, activa Habilitar sincronización de grupos.

2. En el rol predeterminado, mantén Colaborador o selecciona otro rol. Este rol se aplica solo a los usuarios. Los lectores no reciben un rol.

3. En los grupos de usuarios y grupos de lectores, selecciona los grupos a los que añadir nuevos usuarios y lectores. Estos grupos se aplican tanto si la sincronización de grupo está activada como si no.

   

4. Selecciona Siguiente.

Para aprender sobre mapeo, aprovisionamiento y desaprovisionamiento de atributos, lee Gestionar usuarios y lectores con SCIM en Okta.

Paso 5: Nombra la configuración y créala

1. En el nombre SSO, introduce un nombre para esta configuración.

2. En el texto del botón Inicio de sesión, introduce el texto del botón de iniciar sesión.

3. (Opcional) Para cerrar sesión de usuarios tras un periodo de inactividad, activa el tiempo de espera SSO de la sesión inactiva y establece la duración del tiempo de espera (HH:MM).

4. En Convertir cuentas existentes del equipo y lectores a SSO, en Enviar invitación a, selecciona Todos los usuarios o Usuarios seleccionados. Consulta la advertencia en Antes de comenzar.

   

5. Selecciona Crear.

La configuración aparece en la lista de SSO de la Empresa . Para confirmar que funciona, inicia sesión en Document360 con una cuenta de Okta que hayas asignado a la app. Si configuras SCIM, completa el Paso 6.

Paso 6: Prueba la conexión SCIM en Okta

Sáltate este paso si no configuraste SCIM.

1. En la Consola de Administración de Okta, abre la app de Document360 y ve a la pestaña de Provisionamiento .

2. Seleccione Editar junto a Conexión SCIM y luego seleccione Configuración del Conector de Prueba. Un cuadro de diálogo de confirmación muestra que la prueba ha sido exitosa.

   

3. Selecciona Cerrar y luego selecciona Guardar.

Okta no impulsa ningún cambio en Document360 hasta que activas Crear usuarios, actualizar atributos de usuario y desactivar usuarios en Provisionamiento > a la aplicación. Para ello, lee Provisión de Okta a Document360. Para asignar usuarios, lectores y grupos, lee Gestionar usuarios y lectores con SCIM en Okta.

Mejores prácticas

• Prueba primero con un grupo pequeño. Antes de desplegar SSO a todos, inicia sesión con algunas cuentas de prueba para detectar problemas de mapeo de atributos o acceso.
• Guarda tanto tokens secretos como contraseñas. Guárdalos en un gestor de contraseñas o en una bóveda secreta, nunca en archivos de texto plano o repositorios de código.
• Ajusta el tiempo de espera de inactividad a tu política de seguridad. Establece la duración del tiempo de espera a las reglas de sesión de tu organización.

Preguntas frecuentes