> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Okta SAML SSO

El SSO de SAML de Okta permite a miembros del espacio de trabajo iniciar sesión en ElevenLabs mediante una integración de aplicación SAML 2.0 de Okta.

> **Info**
>
> El SSO está disponible para espacios de trabajo Enterprise. Solo administradores del espacio de trabajo pueden configurar los ajustes de SSO.

> **Warning**
>
> ElevenLabs admite SSO de SAML iniciado por el proveedor de servicios (SP). Para iniciar sesión, usa
> `https://elevenlabs.io/app/sign-in?use_sso=true`. Puedes añadir `email=user@example.com` como parámetro
> de consulta para rellenar previamente el campo de correo electrónico.

## Requisitos previos

* Un espacio de trabajo Enterprise de ElevenLabs.
* Acceso de administrador del espacio de trabajo en ElevenLabs.
* Acceso de administrador en Okta.
* Un dominio de correo electrónico verificado en ElevenLabs para usuarios que iniciarán sesión mediante Okta.

## Configurar SSO de SAML de Okta

#### Abrir los ajustes de SSO en ElevenLabs

Ve a **Ajustes del espacio de trabajo** > **Seguridad y SSO**.

![Pestaña Seguridad y SSO de los ajustes del espacio de trabajo de ElevenLabs](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp)

#### Seleccionar SAML como proveedor de SSO

En **Proveedor de SSO**, selecciona **SAML**. Copia los valores de **ID de entidad del proveedor
de servicios** y \*\*URL de redirección \*\*. Usarás estos valores en Okta.

![Ajustes del proveedor SAML de ElevenLabs](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp)

#### Crear una integración de aplicación de Okta

En la consola de administración de Okta, ve a **Applications** > **Applications** y haz clic en
**Create App Integration**.

![Página Applications de Okta con Create App Integration](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp)

Selecciona **SAML 2.0** y, a continuación, haz clic en **Next**.

![Cuadro de diálogo Create a new app integration de Okta con SAML 2.0 seleccionado](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp)

#### Añadir el nombre de la aplicación

En **General Settings**, establece **App name** como `ElevenLabs` y, a continuación, haz clic en **Next**.

![Ajustes generales de Create SAML Integration de Okta](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp)

#### Configurar los ajustes de SAML en Okta

En **SAML Settings**, configura la aplicación con los valores de ElevenLabs:

* Establece **Single sign-on URL** como la **URL de redirección** de ElevenLabs.
* Selecciona **Use this for Recipient URL and Destination URL**.
* Establece **Audience URI (SP Entity ID)** como el **ID de entidad del proveedor de servicios** de ElevenLabs.
* Establece **Name ID format** como **EmailAddress**.
* Establece **Application username** como **Email**.

![Ajustes de SAML de Okta para ElevenLabs](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp)

#### Asignar usuarios o grupos

Abre la pestaña **Assignments** de la aplicación de Okta y asigna los usuarios o grupos que deberían poder
iniciar sesión en ElevenLabs.

![Pestaña Assignments de la aplicación de Okta](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp)

#### Añadir el certificado de Okta a ElevenLabs

En Okta, abre **SAML Signing Certificates** y usa **Actions** > **Download certificate** para
el certificado activo.

![Acción Download certificate en SAML Signing Certificates de Okta](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp)

Abre el archivo del certificado y copia el certificado PEM completo, incluidos
`-----BEGIN CERTIFICATE-----` y `-----END CERTIFICATE-----`.

![Archivo de certificado de Okta en formato PEM](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp)

En ElevenLabs, haz clic en **Add Certificate**, pega el certificado de Okta y, a continuación, haz clic en **Add**.

![Cuadro de diálogo Add X509 Certificate de ElevenLabs](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp)

#### Copiar los valores de metadatos de Okta en ElevenLabs

En Okta, abre el XML de metadatos del IdP. Copia los valores de metadatos en ElevenLabs:

* Usa `entityID` para el **ID de entidad del proveedor de identidad**.
* Usa la URL de `SingleSignOnService Location` que termina en `/sso/saml` para la \*\*URL de inicio
  de sesión del proveedor de identidad \*\*.

![XML de metadatos de IdP de Okta que muestra entityID y SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp)

#### Añadir tu dominio de correo electrónico permitido

En ElevenLabs, haz clic en **Add Domain** y selecciona el dominio verificado que coincida con el dominio
de correo electrónico de tus usuarios de Okta.

![Cuadro de diálogo Add allowed email domains de ElevenLabs](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp)

#### Guardar el proveedor de SSO

Revisa la configuración, selecciona **I acknowledge this change will log out users currently using
SSO** y, a continuación, haz clic en \*\*Update SSO \*\*.

## Asignación de campos

Usa esta tabla para asignar los ajustes de SAML de Okta a los campos de SSO de ElevenLabs.

| Campo o ubicación de Okta                                         | Campo de ElevenLabs                                    | Valor que debes usar                                                              |
| ----------------------------------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------- |
| **Sign-in method**                                                | **Proveedor de SSO**                                   | `SAML`                                                                            |
| **Audience URI (SP Entity ID)**                                   | **ID de entidad del proveedor de servicios**           | Usa el valor de ElevenLabs, por ejemplo `https://elevenlabs.io`                   |
| **Single sign-on URL**                                            | **URL de redirección**                                 | Usa el valor de ElevenLabs, por ejemplo `https://elevenlabs.io/__/auth/handler`   |
| **Recipient URL**                                                 | **URL de redirección**                                 | Igual que **Single sign-on URL**                                                  |
| **Destination URL**                                               | **URL de redirección**                                 | Igual que **Single sign-on URL**                                                  |
| **SAML Issuer ID** o `entityID` de metadatos                      | **ID de entidad del proveedor de identidad**           | Emisor de Okta, por ejemplo `http://www.okta.com/exk...`                          |
| **Sign On URL** o `SingleSignOnService Location` de metadatos     | **URL de inicio de sesión del proveedor de identidad** | URL SAML de Okta que termina en `/sso/saml`                                       |
| **X.509 Certificate** o `ds:X509Certificate` de metadatos         | **Certificado**                                        | Certificado de firma de Okta en formato PEM válido                                |
| **Application username**                                          | No requiere configuración manual                       | Establécelo como **Email**                                                        |
| **Name ID format**                                                | No requiere configuración manual                       | Establécelo como **EmailAddress**                                                 |
| Dominio de correo electrónico del usuario o la aplicación en Okta | **Dominio**                                            | Debe coincidir con un dominio verificado de ElevenLabs, por ejemplo `company.com` |

## Resolución de problemas

#### Okta muestra que el inicio de sesión se ha realizado correctamente, pero ElevenLabs indica que no se puede iniciar sesión

Comprueba la respuesta de Network del navegador para `accounts:signInWithIdp`. Las entradas del registro del sistema de Okta, como
`User single sign on to app SUCCESS`, solo confirman que Okta ha autenticado al usuario. ElevenLabs
aún puede rechazar la respuesta SAML si los valores de la aserción no coinciden con la configuración de SSO.

#### INVALID_IDP_RESPONSE: Error al analizar el certificado

La respuesta de Network del navegador puede mostrar `INVALID_IDP_RESPONSE: Error when parsing certificate`.
Elimina el certificado de ElevenLabs y vuelve a añadir el certificado X.509 de Okta en formato PEM
válido. No uses un LLM para formatear el certificado. Copia el certificado exactamente, incluidos
`-----BEGIN CERTIFICATE-----` y `-----END CERTIFICATE-----`.

#### Errores de discrepancia de usuario o autenticación

Asegúrate de que Okta envía la dirección de correo electrónico del usuario como `NameID`. En Okta, establece **Name ID format** como
**EmailAddress** y **Application username** como **Email**.

#### ¿Qué valores de metadatos de Okta debo usar?

Usa `entityID` de metadatos para el **ID de entidad del proveedor de identidad**, `SingleSignOnService Location` para
la **URL de inicio de sesión del proveedor de identidad** y `ds:X509Certificate` para el **certificado**.