> 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.

# SSO SAML Okta

Le SSO SAML d’Okta permet aux membres du Workspace de se connecter à ElevenLabs via une intégration d’application Okta SAML 2.0.

> **Info**
>
> Le SSO est disponible pour les Workspaces Enterprise. Seuls les administrateurs du Workspace peuvent configurer les paramètres SSO.

> **Warning**
>
> ElevenLabs prend en charge le SSO SAML initié par le fournisseur de services (SP). Pour commencer la connexion, utilisez
> `https://elevenlabs.io/app/sign-in?use_sso=true`. Vous pouvez ajouter `email=user@example.com` comme paramètre de requête
> pour préremplir le champ d’email.

## Prérequis

* Un Workspace ElevenLabs Enterprise.
* Un accès administrateur au Workspace dans ElevenLabs.
* Un accès administrateur dans Okta.
* Un domaine d’email vérifié dans ElevenLabs pour les utilisateurs qui se connecteront via Okta.

## Configurer le SSO SAML d’Okta

#### Ouvrir les paramètres SSO dans ElevenLabs

Accédez à **Paramètres du Workspace** > **Sécurité et SSO**.

![Onglet Sécurité et SSO des paramètres du Workspace ElevenLabs](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp)

#### Sélectionner SAML comme fournisseur SSO

Dans **Fournisseur SSO**, sélectionnez **SAML**. Copiez les valeurs **Service Provider Entity Id** et \*\*Redirect
URL \*\*. Vous les utiliserez dans Okta.

![Paramètres du fournisseur SAML ElevenLabs](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp)

#### Créer une intégration d’application Okta

Dans la console d’administration Okta, accédez à **Applications** > **Applications**, puis cliquez sur \*\*Create App
Integration \*\*.

![Page Applications d’Okta avec Create App Integration](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp)

Sélectionnez **SAML 2.0**, puis cliquez sur **Next**.

![Boîte de dialogue Okta Create a new app integration avec SAML 2.0 sélectionné](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp)

#### Ajouter le nom de l’application

Dans **General Settings**, définissez **App name** sur `ElevenLabs`, puis cliquez sur **Next**.

![Paramètres généraux d’Okta Create SAML Integration](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp)

#### Configurer les paramètres SAML dans Okta

Dans **SAML Settings**, configurez l’application avec les valeurs d’ElevenLabs :

* Définissez **Single sign-on URL** sur l’**URL de redirection** d’ElevenLabs.
* Sélectionnez **Use this for Recipient URL and Destination URL**.
* Définissez **Audience URI (SP Entity ID)** sur le **Service Provider Entity Id** d’ElevenLabs.
* Définissez **Name ID format** sur **EmailAddress**.
* Définissez **Application username** sur **Email**.

![Paramètres SAML Okta pour ElevenLabs](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp)

#### Attribuer des utilisateurs ou des groupes

Ouvrez l’onglet **Assignments** de l’application Okta et attribuez les utilisateurs ou les groupes qui doivent pouvoir
se connecter à ElevenLabs.

![Onglet Assignments de l’application Okta](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp)

#### Ajouter le certificat Okta à ElevenLabs

Dans Okta, ouvrez **SAML Signing Certificates** et utilisez **Actions** > **Download certificate** pour
le certificat actif.

![Action Download certificate dans Okta SAML Signing Certificates](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp)

Ouvrez le fichier de certificat et copiez l’intégralité du certificat PEM, y compris
`-----BEGIN CERTIFICATE-----` et `-----END CERTIFICATE-----`.

![Fichier de certificat Okta au format PEM](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp)

Dans ElevenLabs, cliquez sur **Add Certificate**, collez le certificat Okta, puis cliquez sur **Add**.

![Boîte de dialogue ElevenLabs Add X509 Certificate](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp)

#### Copier les valeurs de métadonnées Okta dans ElevenLabs

Dans Okta, ouvrez le XML de métadonnées IdP. Copiez les valeurs de métadonnées dans ElevenLabs :

* Utilisez `entityID` pour **Identity Provider Entity Id**.
* Utilisez l’URL `SingleSignOnService Location` qui se termine par `/sso/saml` pour \*\*Identity Provider
  Sign-In URL \*\*.

![XML de métadonnées IdP Okta affichant entityID et SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp)

#### Ajouter votre domaine d’email autorisé

Dans ElevenLabs, cliquez sur **Add Domain** et sélectionnez le domaine vérifié correspondant au domaine
d’email de vos utilisateurs Okta.

![Boîte de dialogue ElevenLabs Add allowed email domains](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp)

#### Enregistrer le fournisseur SSO

Vérifiez la configuration, sélectionnez \*\*I acknowledge this change will log out users currently using
SSO \*\*, puis cliquez sur \*\*Update SSO \*\*.

## Correspondance des champs

Utilisez ce tableau pour faire correspondre les paramètres SAML Okta aux champs SSO ElevenLabs.

| Champ ou emplacement Okta                                    | Champ ElevenLabs                      | Valeur à utiliser                                                                  |
| ------------------------------------------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------- |
| **Sign-in method**                                           | **SSO Provider**                      | `SAML`                                                                             |
| **Audience URI (SP Entity ID)**                              | **Service Provider Entity Id**        | Utilisez la valeur ElevenLabs, par exemple `https://elevenlabs.io`                 |
| **Single sign-on URL**                                       | **Redirect URL**                      | Utilisez la valeur ElevenLabs, par exemple `https://elevenlabs.io/__/auth/handler` |
| **Recipient URL**                                            | **Redirect URL**                      | Identique à **Single sign-on URL**                                                 |
| **Destination URL**                                          | **Redirect URL**                      | Identique à **Single sign-on URL**                                                 |
| **SAML Issuer ID** ou métadonnée `entityID`                  | **Identity Provider Entity Id**       | Émetteur Okta, par exemple `http://www.okta.com/exk...`                            |
| **Sign On URL** ou métadonnée `SingleSignOnService Location` | **Identity Provider Sign-In URL**     | URL SAML Okta se terminant par `/sso/saml`                                         |
| **X.509 Certificate** ou métadonnée `ds:X509Certificate`     | **Certificate**                       | Certificat de signature Okta au format PEM valide                                  |
| **Application username**                                     | Aucune configuration manuelle requise | Définir sur **Email**                                                              |
| **Name ID format**                                           | Aucune configuration manuelle requise | Définir sur **EmailAddress**                                                       |
| Domaine d’email utilisateur ou d’application dans Okta       | **Domain**                            | Doit correspondre à un domaine ElevenLabs vérifié, par exemple `company.com`       |

## Résolution des problèmes

#### Okta indique une connexion réussie, mais ElevenLabs ne parvient pas à vous connecter

Vérifiez la réponse Network du navigateur pour `accounts:signInWithIdp`. Les entrées du journal système Okta telles que
`User single sign on to app SUCCESS` confirment uniquement qu’Okta a authentifié l’utilisateur. ElevenLabs
peut toujours rejeter la réponse SAML si les valeurs d’assertion ne correspondent pas à la configuration SSO.

#### INVALID_IDP_RESPONSE: Erreur lors de l’analyse du certificat

La réponse Network du navigateur peut afficher `INVALID_IDP_RESPONSE: Error when parsing certificate`.
Supprimez le certificat d’ElevenLabs, puis ajoutez à nouveau le certificat X.509 Okta au format PEM
valide. N’utilisez pas de LLM pour formater le certificat. Copiez le certificat exactement, y compris
`-----BEGIN CERTIFICATE-----` et `-----END CERTIFICATE-----`.

#### Erreurs de non-correspondance d’utilisateur ou d’authentification

Assurez-vous qu’Okta envoie l’adresse email de l’utilisateur comme `NameID`. Dans Okta, définissez **Name ID format** sur
**EmailAddress** et **Application username** sur **Email**.

#### Quelles valeurs de métadonnées Okta dois-je utiliser ?

Utilisez la métadonnée `entityID` pour **Identity Provider Entity Id**, `SingleSignOnService Location` pour
**Identity Provider Sign-In URL**, et `ds:X509Certificate` pour **Certificate**.