--- title: "Configurar SAML SSO con Okta" slug: "saml-sso-with-okta" updated: 2026-10-12T08:20:46Z published: 2026-10-12T08:20:46Z canonical: "docs.document360.com/saml-sso-with-okta" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://developer.okta.com/signup/). - 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. ADVERTENCIA Dos opciones en esta configuración no se pueden deshacer: - **Proveedor de identidad**: No puedes cambiar el IdP después de crear la configuración. - **Convertir cuentas existentes a SSO**: Los usuarios y lectores convertidos pierden el inicio de sesión con contraseña de inmediato y deben iniciar sesión a través de Okta. Cada uno recibe un correo electrónico sobre el cambio. --- ## 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**. ![The Choose IDP step showing the identity provider options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SAML-create-sso-step-1.png) El **paso Configurar SP** muestra los parámetros que vas a introducir en Okta. Mantén esta pestaña abierta. ![The Configure SP step showing the callback path, service provider entity ID, and signed out callback path](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SP-Okta.png) --- ## 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**. ![The Applications page in the Okta Admin Console](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-applications.png) 3. **Selecciona Crear integración de aplicaciones**. 4. Selecciona **SAML 2.0** y luego **selecciona Siguiente**. ![The Create app integration dialog with SAML 2.0 selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-create-app-integration.png) ### 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** . ![The General Settings tab for the SAML app in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-saml-general-setting.png) ### 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**. ![The Configure SAML tab in Okta with the single sign-on URL and audience URI filled in](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-okta-saml-settings.png) ### Completa la página de comentarios 1. Selecciona **Esta es una aplicación interna que hemos creado**. 2. Selecciona **Terminar**. ![The Feedback page in Okta with the internal app option selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-feedback.png) Okta crea la app. ### Añadir sentencias de atributo Las sentencias de atributo indican a Okta qué datos de usuario enviar a Document360. NOTA Los nombres de atributos son sensibles a mayúsculas y mayúsculas. Introdúcelos exactamente como se muestra. 1. En la app, selecciona la pestaña **Iniciar sesión** y desplázate hasta **las sentencias de atributo**. ![The Sign On tab of the Okta app, showing the Attribute statements section](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-sign-on.png) 2. Expande **Mostrar configuración heredada** y luego selecciona **Editar** junto a **Sentencias de atributo del perfil**. ![The Edit option for profile attribute statements under Show legacy configuration](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-attribute-statements.png) 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. ![Opening View SAML setup instructions from the Sign On tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/6_GIF-Okta_app_signon_setup_instructions.gif) ![The Okta SAML setup instructions page showing the sign-on URL, issuer, and X.509 certificate](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta_setup_instructions_page.png) ### 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](/help/docs/es/scim-with-okta#inherit-from-another-application). 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](/help/docs/es/saml#let-people-sign-in-from-your-idp-dashboard). ![The Configure IdP step in Document360 with the Okta sign-on URL, entity ID, and certificate entered](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-IdP-Okta.png) 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](/docs/es/saml-sso-with-okta#step-5-name-the-configuration-and-create-it). ADVERTENCIA Document360 muestra los tokens secretos primario y secundario solo una vez. Copia ambos y guárdalos de forma segura antes de crear la configuración. Después de eso, se enmascaran y no se pueden recuperar. Si regeneras un token, el antiguo deja de funcionar y debes actualizarlo en Okta para que siga sincronizado. ### Activa SCIM en Document360 1. En el paso **SCIM** , activa **Habilitar provisión SCIM**. ![The Enable SCIM provisioning toggle on the SCIM step in Document360](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta.png) 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. ![The SCIM base URL and secret tokens shown after SCIM provisioning is turned on](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Enable%20SCIM%20provisioning.png) 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**. ![The SCIM option selected under Provisioning in the Okta app settings](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enable_scim_provisioning.png) ### Conecta Okta con Document360 1. En la pestaña **de Provisionamiento** , selecciona **Editar** junto a **Conexión SCIM**. ![The Edit option for the SCIM connection on the Provisioning tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/edit-provisioning.png) 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**. ![The SCIM connection settings in Okta with the base URL, unique identifier, provisioning actions, and authorization header](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/scim-connection.png) 7. **Selecciona guardar**. NOTA No selecciones aún **Configuración del Conector de Prueba** . La prueba falla hasta que creas la configuración en Document360 en el Paso 5. ### 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. ![The group sync toggle, default role, and user and reader group fields on the SCIM step](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta-Group-Sync.png) 4. Selecciona **Siguiente**. Para aprender sobre mapeo, aprovisionamiento y desaprovisionamiento de atributos, lee [Gestionar usuarios y lectores con SCIM en Okta](/help/docs/es/scim-with-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](/docs/es/saml-sso-with-okta#before-you-begin). ![The final setup step with SSO name, login button text, idle timeout, and account conversion options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-Okta-more-settings.png) 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. ![The Okta confirmation dialog showing a successful connector test and the detected provisioning features](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test%20confirmation.png) 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](/help/docs/es/scim-with-okta#provision-okta-to-document360). Para asignar usuarios, lectores y grupos, lee [Gestionar usuarios y lectores con SCIM en Okta](/help/docs/es/scim-with-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 **¿Por qué hay dos tokens secretos SCIM?** Dos tokens te permiten reemplazar uno sin romper la sincronización. Si el token principal está expuesto, cambia Okta al token secundario primero y luego regenera el token principal. El provisionamiento sigue ejecutándose mientras lo reemplazas. **¿Puedo usar la misma app de Okta para el aprovisionamiento SAML SSO y SCIM?** Sí. Con SAML, activas SCIM en la misma app de Okta. Con OpenID Connect, SCIM necesita una app OAuth Bearer Token separada del catálogo de Okta. **¿Qué ocurre con los usuarios y lectores existentes de Document360 cuando configuro SSO?** Nada, a menos que decidas convertir sus cuentas en el Paso 5. Los usuarios y lectores convertidos mantienen sus roles y permisos. Para ver cómo cambia su inicio de sesión, consulta la advertencia en [Antes de empezar](/docs/es/saml-sso-with-okta#before-you-begin).