--- title: "Okta con OpenID SSO" slug: "okta-with-openid-sso" updated: 2026-10-12T08:20:46Z published: 2026-10-12T08:20:46Z canonical: "docs.document360.com/okta-with-openid-sso" --- > ## 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. # Okta con OpenID SSO **Okta** es un Proveedor de Identidad (IdP) que gestiona el acceso de los usuarios a través de múltiples aplicaciones desde una sola plataforma. Con OpenID Connect SSO configurado entre Okta y Document360, tus usuarios y lectores pueden iniciar sesión en Document360 usando sus credenciales Okta existentes. NOTA Solo los usuarios con los roles **de proyecto Propietario** o **Administrador** pueden configurar SSO en Document360. ## Qué puedes hacer con Okta como tu IDP | Capacidad | Apoyado | | --- | --- | | Autenticación por usuarios (portales) | Sí | | Autenticación de lector (sitio de la base de conocimiento) | Sí | | Provisión de usuarios SCIM | Sí | | Provisión de lectores SCIM | Sí | | Sincronización de grupo SCIM | Sí | | Herencia de configuración SSO (proyectos padre-hijo) | Sí | NOTA Al usar Okta con OpenID Connect, la provisión SCIM requiere una **aplicación OAuth Bearer Token separada** del catálogo de aplicaciones Okta. A diferencia de la configuración SAML, SCIM no puede activarse dentro de la misma aplicación OIDC. --- ## Antes de que empieces - Tienes una cuenta activa en Okta con acceso de administrador. Si necesitas crear una, regístrate en [developer.okta.com/signup](https://developer.okta.com/signup/). - Tienes acceso **de Propietario** o **Administrador** en tu proyecto de Document360. - Abre Document360 y Okta en dos pestañas separadas del navegador. Tendrás que cambiar entre ellas varias veces durante la configuración. --- ## Paso 1: Crear una aplicación OpenID Connect en Okta 1. Inicia sesión en tu cuenta de Okta y haz clic **en Administrador** en la esquina superior derecha para cambiar a la consola de administración. 2. En la navegación de la izquierda, expande **Aplicaciones y Recursos** y haz clic **en Aplicaciones**. 3. Haz **clic en Crear integración de app**. 4. Selecciona **OIDC - OpenID Connect** como método de inicio de sesión. 5. Elige **Aplicación Web** como tipo de aplicación y haz clic **en Siguiente**. 6. En la página **de Integración de Nueva Aplicación Web** , introduce un nombre para tu aplicación en el campo **de nombre de Integración de Aplicaciones** . ![Creating an OIDC web application integration in Okta.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/creating application(1).gif) --- ## Paso 2: Obtener los parámetros SP de Document360 1. Abre Document360 en una pestaña separada. 2. Navega a **Configuración** () > **Usuarios y permisos** > **SSO empresarial**. 3. Haz clic **en Crear SSO** > **OpenID Conectar**. ![SSO configuration settings for users and permissions in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) 1. En el paso **Elegir IdP** , selecciona **Okta** como tu proveedor de identidad. Document360 navega automáticamente al **paso Configurar SP** (Proveedor de Servicios). ![Select an Identity Provider for Single Sign-On configuration, highlighting Okta option.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-okta.png) 1. En el cuadro **de diálogo Configurar SP** , selecciona el botón **de opción OpenID** . 2. Se mostrará un conjunto de parámetros. ![Configuration settings for OpenID in the Okta application setup process.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/OIDC-okta-SP(1).png) --- ## Paso 3: Introduce los parámetros de Document360 en Okta 1. Cambia a la pestaña Okta en la página **de Integración de Nueva App** Web. 2. Introduce los parámetros de Document360 usando el mapeo que aparece a continuación. | Document360 | Okta | | --- | --- | | URL de redirección de inicio de sesión | URI de redirección de inicio de sesión | | Ruta de devolución de llamada desconectada | Cerrar sesión con el URI de redirección | ![Okta Admin Console displaying sign-in and sign-out redirect URIs for user authentication.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/sign in(1).png) 1. Desplázate hacia abajo hasta **Asignaciones** y selecciona la opción **de acceso controlado** deseada. ![Options for app access control and immediate access settings in the application interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/assigned.png) 1. Haz clic **en Guardar**. Serás redirigido a la página **General** de la solicitud. --- ## Paso 4: Configurar el proveedor de identidad en Document360 1. Vuelve a Document360 en la página **Configurar el Proveedor de Servicios (SP)** y haz clic en **Siguiente** para navegar a la página **Configurar el Proveedor de Identidad (IdP** ). ![Configure the Identity Provider page for OpenID Connect in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/OIDC-okta-idp.png) 1. Introduce los valores correspondientes de tu aplicación Okta usando el mapeo que aparece a continuación. | Okta | Document360 | | --- | --- | | ID de cliente | ID de cliente | | Secreto del cliente | Secreto del cliente | | URI del emisor | Autoridad | NOTA Para encontrar el URI del Emisor en Okta, navega a **Security** > **API**. 1. En el campo **Scope** (opcional), escribe un valor de scope y haz **clic en +** para añadirlo como chip. Esto define qué información de usuario o permisos solicita Document360 a Okta. Puedes sumar hasta 3 scopes. 2. Asegúrate de que el **ID del cliente** y el **secreto del cliente** coincidan con los valores generados en Okta. ![Okta Admin Console displaying client credentials and authentication options for applications.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/client id.png) 1. Haz clic **en Siguiente** para acceder a la página **de aprovisionamiento SCIM** . --- ## Paso 5: Configurar el aprovisionamiento SCIM La provisión SCIM automatiza la gestión del ciclo de vida del usuario y del lector entre Okta y Document360. Al usar OpenID Connect, SCIM requiere una aplicación separada **de OAuth Bearer Token** en el catálogo Okta. No puede habilitarse dentro de la misma aplicación OIDC. Si no necesitas aprovisionamiento SCIM, desactiva **Activar aprovisionamiento SCIM** y salta a **Configurar nombre SSO y opciones de inicio de** sesión 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 y haz clic **en Aceptar**. 3. A continuación, se mostrarán los parámetros necesarios para completar la configuración SCIM en Okta. ![Configuration settings for SCIM provisioning and identity provider setup in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-okta-scim.png) #### Añadir la aplicación SCIM OAuth Bearer Token en Okta 1. En Okta, expande **Aplicaciones** en la navegación izquierda y haz clic **en Aplicaciones**. 2. Haz clic **en Explorar catálogo de aplicaciones** y busca **SCIM 2.0 (OAuth Bearer Token)**, luego selecciona **Ver todos los resultados**. ![Okta Admin Console displaying applications with options to create and browse app integrations.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/browse.png) 1. En los resultados de búsqueda, selecciona **(OAuth Bearer Token) Gobernanza con SCIM 2.0** y haz clic en **Añadir integración**. ![Okta Admin Console displaying OAuth Bearer Token integration options with SCIM 2.0.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/add integration.png) NOTA Asegúrate de seleccionar la app correcta. No selecciones la versión de la app de prueba. 1. En la página **de Configuración General** , puedes cambiar la **etiqueta de la Aplicación** si lo necesitas y hacer clic **en Siguiente**. ![Okta Admin Console showing application settings and OAuth Bearer Token information.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/general(1).png) 1. Haz clic **en Terminado** en la página **de opciones de Inicio** de sesión. NOTA No se necesita ninguna configuración en la página de opciones de Inicio de Sesión. Esta aplicación está creada únicamente para el aprovisionamiento SCIM — la configuración de OpenID Enterprise SSO ya se había completado en los pasos anteriores. #### Configurar la conexión de la API SCIM en Okta 1. En la app SCIM, ve a la pestaña **de Aprovisionamiento** y **selecciona Configurar integración con la API**. 2. Seleccione la casilla **de verificación Habilitar integración de la API** . Se mostrará un conjunto de campos. 3. Introduce los parámetros de Document360 usando el mapeo que aparece a continuación. | Document360 | Okta | | --- | --- | | SCIM Base URL | Base URL | | Ficha secreta principal | Ficha portadora OAuth | ![Okta Admin Console displaying OAuth Bearer Token verification and API integration options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test api(2).png) NOTA No hagas clic **en Configuración del Conector de Prueba** todavía. En esta fase, la provisión SCIM no funcionará con Document360 porque la configuración SSO aún no está completada en Document360. 1. Una vez terminado, vuelve a Document360 para completar la configuración. #### Asignar roles y grupos por defecto en Document360 1. Activa el **interruptor de Activar sincronización de grupo** si es necesario. 2. En el campo **del rol por defecto** , el rol está configurado como **Contribuyente** por defecto. Puedes cambiar esto desde el desplegable si es necesario. 3. 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. 4. Haz clic **en Siguiente** para continuar con los campos de configuración final. #### 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 campo **de texto del botón 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](https://docs.document360.com/docs/es/auto-assign-reader-group). 4. Activa **el tiempo de espera SSO de la sesión inactiva** si es necesario y establece la **duración del tiempo de espera (HH:MM),** tras lo cual un usuario SSO inactivo desconectará automáticamente sesión. 5. Elige si invitas a cuentas de usuarios y lectores existentes a SSO. ![Settings for creating a new SSO with OpenID Okta configuration options displayed.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-okta-more-settings.png) 1. Haz **clic en Crear** para completar la configuración de OpenID SSO. --- ## Paso 6: Completa la integración de SCIM en Okta 1. Vuelve a la app Okta SCIM. 2. Haz clic en **Probar credenciales de la API**. Aparecerá un mensaje de éxito confirmando que la aplicación SCIM está integrada correctamente. ![Okta Admin Console displaying successful OAuth Bearer Token verification.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test api(2).png) 1. Haz clic **en Guardar**. 2. Ve a la pestaña **de Provisionamiento** , **selecciona Para la aplicación** y haz clic **en Editar** en la sección **Aprovisionamiento en la App** . 3. Selecciona solo las siguientes acciones compatibles: - Crear usuarios - Actualizar atributos de usuario - Desactivar usuarios ![Okta Admin Console showing provisioning settings for SCIM 2.0 application integration.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/supported actions.png) 1. Haz clic **en Guardar**. La provisión SCIM con Okta OpenID Connect ya está configurada con éxito. La configuración SSO basada en el protocolo OpenID se ha configurado con éxito usando Okta. NOTA Para más detalles sobre cómo gestionar usuarios, lectores y grupos, consulta [Gestión de usuarios y lectores con SCIM en Okta](https://docs.document360.com/docs/es/scim-with-okta). --- ## Mejores prácticas - **Utiliza una aplicación SCIM separada para el aprovisionamiento.** Al usar OpenID Connect con Okta, SCIM requiere su propia app OAuth Bearer Token del catálogo de Okta. No intentes habilitar SCIM dentro de la app OIDC. - **Selecciona la aplicación SCIM correcta.** Busca **(OAuth Bearer Token) Gobernanza con SCIM 2.0** específicamente. No selecciones la versión de la app de prueba. - **Completa la configuración SSO de Document360 Enterprise antes de probar SCIM.** Hacer clic **en Configuración del Conector de Prueba** antes de guardar la configuración de Document360 fallará. Guarda siempre primero la configuración de Document360 y luego vuelve a Okta para probar. - **Seleccione solo las tres acciones de aprovisionamiento soportadas.** Habilitar acciones no soportadas puede causar errores de aprovisionamiento. Limitar la selección para crear usuarios, actualizar atributos de usuario y desactivar usuarios. --- ## Preguntas frecuentes **¿Por qué necesito una app separada para SCIM cuando uso OpenID Connect con Okta?** La integración de la app OIDC en Okta solo gestiona la autenticación. No soporta provisión SCIM de forma nativa. Se necesita una aplicación separada de OAuth Bearer Token para establecer la conexión SCIM entre Okta y Document360. Esto es diferente de la configuración SAML, donde SCIM puede activarse dentro de la misma aplicación Okta. **¿Dónde encuentro el URI del Emisor en Okta?** En Okta, navega a **Security** > **API**. El URI del emisor está listado allí y se corresponde con el campo **Authority** en la página de configuración IdP de Document360. **¿Qué son los endoscopios y necesito añadirlos?** Los ámbitos definen qué información de usuario o permisos solicita Document360 a Okta durante la autenticación. El campo de alcance es opcional: puedes añadir hasta 3 ámbitos escribiendo un valor y haciendo clic en el **botón +** . Si no tienes claro si se necesitan ámbitos, consulta con tu administrador de Okta.