> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/okta.md).
# Okta
Usa Okta como tu proveedor de identidad para que los usuarios inicien sesión en Dispel con sus credenciales de Okta mediante OAuth (OIDC) o SAML.
## Descripción general
Conecta Okta — la plataforma de identidad empresarial de Okta — como proveedor de identidad de tu organización. Una vez conectado, tus usuarios inician sesión en Dispel con sus credenciales de Okta mediante inicio de sesión único. Puedes conectar Okta mediante **OAuth (OIDC)** o **SAML**.
Esta página cubre la configuración específica de Okta. Para el comportamiento compartido que se aplica a todos los proveedores — cómo inician sesión los usuarios, el mapeo de grupos, la MFA y la desconexión — consulta [Proveedores de identidad](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md).
{% hint style="info" %}
**Dónde encontrarlo.** Inicia sesión como administrador de la organización y abre **Configuración → Integraciones** (o la **Configuración → Autenticación** página). Okta aparece en la **Identidad y autenticación (IdP / SSO)** Haz clic en **Conectar** en su tarjeta para comenzar.
{% endhint %}
## Antes de comenzar
* Configurarás la parte del IdP en el **Consola de administración de Okta**, así que necesitarás acceso administrativo allí.
* Decide un protocolo — **OAuth (OIDC)** o **SAML**. Consulta [Elegir un protocolo](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#choosing-a-protocol).
* Asegúrate de que los usuarios que iniciarán sesión mediante Okta ya estén **invitados a tu organización** en Dispel. El SSO autentica a los usuarios, pero no crea acceso por sí solo.
{% hint style="warning" %}
**Un proveedor a la vez.** Si tu organización ya está conectada a otro proveedor de identidad, desconéctalo antes de conectar Okta.
{% endhint %}
## Conectar con OAuth (OIDC)
#### En Okta
1. En la Consola de administración de Okta, ve a **Aplicaciones → Crear integración de aplicación** y elige **OIDC — OpenID Connect**.
2. Configura la **URI de redirección de inicio de sesión** en tu dirección de Dispel seguida de `/oauth/login-callback` — por ejemplo `https://app.dispel.com/oauth/login-callback`. Confirma la dirección exacta para tu entorno con tu representante de Dispel si no estás seguro.
3. Asigna la aplicación a los usuarios o grupos que deban tener acceso.
4. Desde la pestaña de **General** , copia el **ID de cliente** y **secreto de cliente**, y anota tu dominio / emisor de Okta.
#### En Dispel
1. Haz clic en **Conectar** en la tarjeta de Okta y **Selecciona Protocolo de autenticación → OAuth**.
2. Completa los campos:
| Campo | Valor de Okta |
| --------------------------------- | ----------------------------------------------------------------------------------------------- |
| **URL del cliente** | Tu endpoint OAuth/OIDC de Okta (emisor), p. ej. `https://your-org.okta.com`. |
| **ID de cliente** | El **ID de cliente**. |
| **Secreto de cliente** | El **secreto de cliente**. |
| **Identificador de organización** | Un identificador único que elijas; los usuarios lo escriben en la pantalla de inicio de sesión. |
3. Haz clic en **Guardar configuración**.
## Conectar con SAML
#### En Okta
1. En la Consola de administración de Okta, ve a **Aplicaciones → Crear integración de aplicación** y elige **SAML 2.0**.
2. En la configuración de SAML, pega los valores que Dispel muestra en la parte superior de su formulario SAML:
* **URL de inicio de sesión único / Receptor / Destino** ← de Dispel **URL del servicio consumidor de aserciones**.
* **URI de audiencia (ID de entidad del SP)** ← de Dispel **ID de entidad del proveedor de servicios (SP)**.
3. Termina de crear la aplicación y luego abre su **Inicio de sesión** pestaña y recopila:
* **URL de inicio de sesión único del proveedor de identidad** → de Dispel **URL de SSO**.
* **Emisor del proveedor de identidad** → de Dispel **ID de entidad del proveedor de identidad**.
* El **Certificado X.509 / de firma** → de Dispel **Certificado de firma Base64**.
4. Asigna la aplicación a los usuarios o grupos que deban tener acceso.
#### En Dispel
1. Haz clic en **Conectar** en la tarjeta de Okta y **Selecciona Protocolo de autenticación → SAML**.
2. Copia el **ID de entidad del proveedor de servicios (SP)** y **URL del servicio consumidor de aserciones** mostrados en la parte superior del formulario (usa **Copiar ID** / **Copiar URL**) en Okta, como se indicó arriba.
3. Completa los campos:
| Campo | Valor de Okta |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **URL de SSO** | El **URL de inicio de sesión único del proveedor de identidad**. |
| **ID de entidad del proveedor de identidad** | El **Emisor del proveedor de identidad**. |
| **Certificado de firma Base64** | El certificado de firma de Okta. Pégalo o usa **Cargar certificado**. |
| **Identificador de organización** | Un identificador único que elijas; los usuarios lo escriben en la pantalla de inicio de sesión. |
4. Haz clic en **Guardar configuración**.
5. Haz clic en **Probar conexión**. Dispel te redirige a Okta para iniciar sesión y luego muestra el correo electrónico y el nombre que recibió. Si la prueba falla, confirma que los valores coincidan con tu aplicación de Okta y que el usuario de prueba esté invitado a tu organización.
## Después de conectar
* **Los usuarios inician sesión** introduciendo tu identificador de organización en la pantalla de inicio de sesión de Dispel y autenticándote con Okta. Consulta [Cómo inician sesión los usuarios](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#how-users-sign-in).
* **Mapear grupos de Okta a grupos de Dispel** para que la membresía se mantenga sincronizada — consulta [Asignación de grupos OIDC](/documentation/documentation-es/integrar-y-administrar/integrations/oidc-group-mapping.md).
* **MFA** aplicado en Okta se aplica durante el inicio de sesión; los códigos de un solo uso por correo electrónico de Dispel no se aplican a los usuarios de SSO. Consulta [SSO y autenticación multifactor](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#sso-and-multi-factor-authentication).
* **Para cambiar de protocolo o de proveedor**, desconéctalo primero. Consulta [Cambiar o desconectar un proveedor](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#switching-or-disconnecting-a-provider).
## Preguntas frecuentes
¿Qué protocolo debo usar con Okta?
Ambos funcionan. Usa el que coincida con la aplicación que crees en Okta — una integración de aplicación OIDC para OAuth, o una integración de aplicación SAML 2.0 para SAML.
¿Necesito asignar usuarios a la aplicación de Okta?
Sí. Solo los usuarios (o grupos) asignados a la aplicación de Okta pueden autenticarse a través de ella. También deben estar invitados a tu organización de Dispel.
Falló mi prueba de conexión SAML. ¿Qué debo comprobar?
Confirma que la URL de SSO, el emisor y el certificado coincidan con la configuración de Inicio de sesión de tu aplicación de Okta, que hayas pegado el ID de entidad del SP y la URL de ACS de Dispel en la configuración SAML de Okta, y que el usuario de prueba esté asignado a la aplicación de Okta e invitado a tu organización de Dispel.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/okta.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.