> 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

Met Okta SAML SSO kunnen workspaceleden zich via een Okta SAML 2.0-appintegratie aanmelden bij ElevenLabs.

> **Info**
>
> SSO is beschikbaar voor Enterprise-workspaces. Alleen workspacebeheerders kunnen SSO-instellingen configureren.

> **Warning**
>
> ElevenLabs ondersteunt door de serviceprovider (SP) geïnitieerde SAML SSO. Gebruik om de aanmelding te starten
> `https://elevenlabs.io/app/sign-in?use_sso=true`. Je kunt `email=user@example.com` als queryparameter toevoegen
> om het e-mailveld vooraf in te vullen.

## Vereisten

* Een Enterprise ElevenLabs-workspace.
* Toegang als workspacebeheerder in ElevenLabs.
* Beheerderstoegang in Okta.
* Een geverifieerd e-maildomein in ElevenLabs voor de gebruikers die zich via Okta gaan aanmelden.

## Okta SAML SSO instellen

#### Open SSO-instellingen in ElevenLabs

Ga naar **Workspace-instellingen** > **Beveiliging & SSO**.

![Tabblad Beveiliging en SSO in ElevenLabs-workspace-instellingen](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp)

#### Selecteer SAML als SSO-provider

Selecteer **SAML** bij **SSO-provider**. Kopieer de waarden voor **Service Provider Entity Id** en \*\*Redirect
URL \*\*. Je gebruikt deze waarden in Okta.

![Instellingen voor ElevenLabs SAML-provider](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp)

#### Maak een Okta-appintegratie

Ga in de Okta Admin Console naar **Applications** > **Applications** en klik vervolgens op \*\*Create App
Integration \*\*.

![Okta-pagina Applications met Create App Integration](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp)

Selecteer **SAML 2.0** en klik vervolgens op **Next**.

![Okta-dialoogvenster Create a new app integration met SAML 2.0 geselecteerd](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp)

#### Voeg de appnaam toe

Stel bij **General Settings** **App name** in op `ElevenLabs` en klik vervolgens op **Next**.

![Algemene instellingen voor Okta Create SAML Integration](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp)

#### Configureer SAML-instellingen in Okta

Configureer de app bij **SAML Settings** met de waarden uit ElevenLabs:

* Stel **Single sign-on URL** in op de ElevenLabs-**Redirect URL**.
* Selecteer **Use this for Recipient URL and Destination URL**.
* Stel **Audience URI (SP Entity ID)** in op de ElevenLabs-**Service Provider Entity Id**.
* Stel **Name ID format** in op **EmailAddress**.
* Stel **Application username** in op **Email**.

![Okta SAML-instellingen voor ElevenLabs](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp)

#### Wijs gebruikers of groepen toe

Open het tabblad **Assignments** van de Okta-app en wijs de gebruikers of groepen toe die zich
bij ElevenLabs moeten kunnen aanmelden.

![Tabblad Assignments van Okta-app](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp)

#### Voeg het Okta-certificaat toe aan ElevenLabs

Open in Okta **SAML Signing Certificates** en gebruik **Actions** > **Download certificate** voor
het actieve certificaat.

![Actie voor het downloaden van een certificaat in Okta SAML Signing Certificates](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp)

Open het certificaatbestand en kopieer het volledige PEM-certificaat, inclusief
`-----BEGIN CERTIFICATE-----` en `-----END CERTIFICATE-----`.

![Okta-certificaatbestand in PEM-indeling](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp)

Klik in ElevenLabs op **Add Certificate**, plak het Okta-certificaat en klik vervolgens op **Add**.

![Dialoogvenster ElevenLabs Add X509 Certificate](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp)

#### Kopieer Okta-metagegevenswaarden naar ElevenLabs

Open in Okta de IdP-metagegevens-XML. Kopieer de metagegevenswaarden naar ElevenLabs:

* Gebruik `entityID` voor **Identity Provider Entity Id**.
* Gebruik de URL voor `SingleSignOnService Location` die eindigt op `/sso/saml` voor \*\*Identity Provider
  Sign-In URL \*\*.

![Okta IdP-metagegevens-XML met entityID en SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp)

#### Voeg je toegestane e-maildomein toe

Klik in ElevenLabs op **Add Domain** en selecteer het geverifieerde domein dat overeenkomt met het e-maildomein
van je Okta-gebruikers.

![Dialoogvenster ElevenLabs Add allowed email domains](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp)

#### Sla de SSO-provider op

Controleer de configuratie, selecteer **I acknowledge this change will log out users currently using
SSO** en klik vervolgens op \*\*Update SSO \*\*.

## Veldkoppelingen

Gebruik deze tabel om Okta SAML-instellingen te koppelen aan ElevenLabs SSO-velden.

| Okta-veld of -locatie                                          | ElevenLabs-veld                    | Te gebruiken waarde                                                                  |
| -------------------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------ |
| **Sign-in method**                                             | **SSO Provider**                   | `SAML`                                                                               |
| **Audience URI (SP Entity ID)**                                | **Service Provider Entity Id**     | Gebruik de ElevenLabs-waarde, bijvoorbeeld `https://elevenlabs.io`                   |
| **Single sign-on URL**                                         | **Redirect URL**                   | Gebruik de ElevenLabs-waarde, bijvoorbeeld `https://elevenlabs.io/__/auth/handler`   |
| **Recipient URL**                                              | **Redirect URL**                   | Zelfde als **Single sign-on URL**                                                    |
| **Destination URL**                                            | **Redirect URL**                   | Zelfde als **Single sign-on URL**                                                    |
| **SAML Issuer ID** of metagegevens `entityID`                  | **Identity Provider Entity Id**    | Okta-issuer, bijvoorbeeld `http://www.okta.com/exk...`                               |
| **Sign On URL** of metagegevens `SingleSignOnService Location` | **Identity Provider Sign-In URL**  | Okta SAML-URL die eindigt op `/sso/saml`                                             |
| **X.509 Certificate** of metagegevens `ds:X509Certificate`     | **Certificate**                    | Okta-ondertekeningscertificaat in geldige PEM-indeling                               |
| **Application username**                                       | Geen handmatige configuratie nodig | Stel in op **Email**                                                                 |
| **Name ID format**                                             | Geen handmatige configuratie nodig | Stel in op **EmailAddress**                                                          |
| E-maildomein van gebruiker of app in Okta                      | **Domain**                         | Moet overeenkomen met een geverifieerd ElevenLabs-domein, bijvoorbeeld `company.com` |

## Problemen oplossen

#### Okta toont een geslaagde aanmelding, maar ElevenLabs meldt dat aanmelden niet mogelijk is

Controleer de Network-respons in de browser voor `accounts:signInWithIdp`. Okta System Log-items zoals
`User single sign on to app SUCCESS` bevestigen alleen dat Okta de gebruiker heeft geauthenticeerd. ElevenLabs
kan de SAML-respons nog steeds afwijzen als de assertion-waarden niet overeenkomen met de SSO-configuratie.

#### INVALID\_IDP\_RESPONSE: Fout bij het parseren van certificaat

De Network-respons in de browser kan `INVALID_IDP_RESPONSE: Error when parsing certificate` tonen.
Verwijder het certificaat uit ElevenLabs en voeg vervolgens het Okta X.509-certificaat opnieuw toe in geldige PEM-
indeling. Gebruik geen LLM om het certificaat te formatteren. Kopieer het certificaat exact, inclusief
`-----BEGIN CERTIFICATE-----` en `-----END CERTIFICATE-----`.

#### Fouten door een mismatch van gebruiker of authenticatie

Zorg dat Okta het e-mailadres van de gebruiker als `NameID` verstuurt. Stel in Okta **Name ID format** in op
**EmailAddress** en **Application username** op **Email**.

#### Welke Okta-metagegevenswaarden moet ik gebruiken?

Gebruik metagegevens `entityID` voor **Identity Provider Entity Id**, `SingleSignOnService Location` voor
**Identity Provider Sign-In URL** en `ds:X509Certificate` voor **Certificate**.