> 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. # Microsoft Entra SAML SSO Met Microsoft Entra SAML SSO kunnen workspaceleden inloggen bij ElevenLabs via een Microsoft Entra ID- enterprise-applicatie (voorheen Azure AD). > **Info** > > SSO is beschikbaar voor Enterprise-workspaces. Alleen workspacebeheerders kunnen SSO-instellingen configureren. > **Warning** > > ElevenLabs ondersteunt door de Service Provider (SP) gestarte SAML SSO. Gebruik > `https://elevenlabs.io/app/sign-in?use_sso=true` om het inloggen te starten. Je kunt `email=user@example.com` als query- > parameter toevoegen om het e-mailveld vooraf in te vullen. > **Note** > > Microsoft Entra wordt alleen ondersteund via SAML. OIDC met Microsoft Entra wordt niet aanbevolen en > kan inlogproblemen veroorzaken. ## Vereisten * Een Enterprise ElevenLabs-workspace. * Toegang als workspacebeheerder in ElevenLabs. * Beheerderstoegang in het Microsoft Entra-beheercentrum. * Een geverifieerd e-maildomein in ElevenLabs voor de gebruikers die via Microsoft Entra inloggen. ## Microsoft Entra SAML SSO instellen #### Open de SSO-instellingen in ElevenLabs Ga naar **Workspace settings** > **Security & SSO**. #### Verifieer je e-maildomein Onder **User Auto Provisioning** verifieer je het e-maildomein waarmee je Microsoft Entra-gebruikers inloggen. Voer het domein in (subdomeinen zijn toegestaan) en volg vervolgens de aanwijzingen om het eigendom te bevestigen. Schakel eventueel automatische provisioning in, zodat gebruikers met een overeenkomend e-maildomein automatisch lid worden van je workspace. ![Dialoogvenster voor bulkdomeinverificatie van ElevenLabs](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp) #### Selecteer SAML als SSO-provider Selecteer **SAML** in **SSO Provider**. Kopieer de waarden **Service Provider Entity Id** en **Redirect URL**. Je gebruikt deze waarden in Microsoft Entra. #### Maak een Microsoft Entra-enterprise-applicatie Open in het Microsoft Entra-beheercentrum het **Overview** van je directory en klik vervolgens op **Add** > **Enterprise application**. ![Microsoft Entra Overview-menu Add met Enterprise application geselecteerd](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp) Klik in **Browse Microsoft Entra App Gallery** op **Create your own application**. ![Microsoft Entra App Gallery met Create your own application](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp) #### Geef de applicatie een naam Voer een naam in (bijvoorbeeld `ElevenLabs`), selecteer **Integrate any other application you don't find in the gallery (Non-gallery)** en klik vervolgens op \*\*Create \*\*. ![Microsoft Entra-paneel Create your own application met een niet-galerij-app](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp) #### Start de installatie van eenmalig inloggen Selecteer in het **Overview** van de applicatie onder **Getting Started** **Set up single sign on** > **Get started**. ![Microsoft Entra-enterprise-applicatie Getting Started met Set up single sign on](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp) Selecteer **SAML** als methode voor eenmalig inloggen. ![Microsoft Entra Select a single sign-on method met SAML](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp) #### Configureer de basisinstellingen voor SAML Configureer de app in **Basic SAML Configuration** met de waarden van ElevenLabs: * Stel **Identifier (Entity ID)** in op de **Service Provider Entity Id** van ElevenLabs. * Stel **Reply URL (Assertion Consumer Service URL)** in op de **Redirect URL** van ElevenLabs. * Laat **Sign on URL** leeg. ElevenLabs gebruikt door de SP gestarte SSO. Klik op **Save**. ![Microsoft Entra Basic SAML Configuration met Identifier en Reply URL](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp) > **Note** > > Gebruik voor omgevingen met [data residency](/docs/nl/overview/administration/data-residency) > `https://.residency.elevenlabs.io/__/auth/handler` als Reply URL, waarbij je > `` vervangt door je regiocode. #### Configureer de Name ID-claim Bewerk in **Attributes & Claims** de claim **Unique User Identifier (Name ID)**: * Stel **Name identifier format** in op **Email address**. * Stel **Source** in op **Attribute**. * Stel **Source attribute** in op het veld dat het e-mailadres voor alle gebruikers bevat. Dit is meestal `user.mail`, maar kan `user.userprincipalname` zijn. Klik op **Save**. > **Note** > > Kies het attribuut met een e-mailadres voor elke gebruiker. Als `user.mail` niet is ingevuld > voor al je gebruikers, gebruik dan `user.userprincipalname`. ![Microsoft Entra Manage claim met Email address-indeling en user.mail als bronattribuut](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp) #### Download het ondertekeningscertificaat Klik in **SAML Certificates**, naast **Certificate (Base64)**, op **Download**. Open het gedownloade bestand in een teksteditor. ![Microsoft Entra SAML Certificates met download van Certificate Base64](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp) #### Wijs gebruikers of groepen toe Open **Users and groups** van de app en wijs vervolgens de gebruikers of groepen toe die moeten kunnen inloggen bij ElevenLabs. ![Microsoft Entra Add Assignment-gebruikerslijst](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp) #### Voeg het Entra-certificaat toe aan ElevenLabs Klik in ElevenLabs op **Add Certificate**. Plak het volledige PEM-certificaat uit het Base64-bestand, inclusief `-----BEGIN CERTIFICATE-----` en `-----END CERTIFICATE-----`, en klik vervolgens op **Add**. ![Dialoogvenster Add X509 Certificate van ElevenLabs](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp) #### Kopieer de waarden van de Entra-identiteitsprovider naar ElevenLabs Kopieer in het onderdeel **Set up** van Microsoft Entra de waarden van de identiteitsprovider naar ElevenLabs: * Gebruik de **Microsoft Entra Identifier** voor **Identity Provider Entity Id**. * Gebruik de **Login URL** voor **Identity Provider Sign-In URL**. ![Microsoft Entra Set up-waarden met Login URL en Microsoft Entra Identifier](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.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 Microsoft Entra-gebruikers. ![Dialoogvenster Add allowed email domains van ElevenLabs](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.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 Microsoft Entra SAML-instellingen te koppelen aan ElevenLabs SSO-velden. | Microsoft Entra-veld of -locatie | ElevenLabs-veld | Te gebruiken waarde | | ---------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------- | | **Sign-in method** | **SSO Provider** | `SAML` | | **Identifier (Entity ID)** | **Service Provider Entity Id** | Gebruik de ElevenLabs-waarde, bijvoorbeeld `https://elevenlabs.io` | | **Reply URL (Assertion Consumer Service URL)** | **Redirect URL** | Gebruik de ElevenLabs-waarde, bijvoorbeeld `https://elevenlabs.io/__/auth/handler` | | **Microsoft Entra Identifier** | **Identity Provider Entity Id** | Entra-uitgever, bijvoorbeeld `https://sts.windows.net/{tenant-id}/` | | **Login URL** | **Identity Provider Sign-In URL** | Entra SAML-inlog-URL, bijvoorbeeld `https://login.microsoftonline.com/{tenant-id}/saml2` | | **Certificate (Base64)** | **Certificate** | Entra-certificaat voor tokenondertekening in geldig PEM-formaat | | **Name ID format** | Geen handmatige configuratie nodig | Instellen op **Email address** | | **Name ID source attribute** | Geen handmatige configuratie nodig | Veld met het e-mailadres van de gebruiker, meestal `user.mail` (of `user.userprincipalname`) | | E-maildomein van gebruiker of app in Microsoft Entra | **Domain** | Moet overeenkomen met een geverifieerd ElevenLabs-domein, bijvoorbeeld `company.com` | ## Problemen oplossen #### Microsoft Entra toont een geslaagde aanmelding, maar ElevenLabs zegt dat inloggen niet mogelijk is Controleer de Network-response van de browser voor `accounts:signInWithIdp`. Microsoft Entra-inloglogs bevestigen alleen dat Entra de gebruiker heeft geauthenticeerd. ElevenLabs kan de SAML-response nog steeds afwijzen als de assertion-waarden niet overeenkomen met de SSO-configuratie. #### INVALID\_IDP\_RESPONSE: Error when parsing certificate De Network-response van de browser kan `INVALID_IDP_RESPONSE: Error when parsing certificate` weergeven. Verwijder het certificaat uit ElevenLabs en voeg vervolgens het Entra-**Certificate (Base64)** opnieuw toe in geldig PEM-formaat. Gebruik geen LLM om het certificaat te formatteren. Open het Base64-certificaat in een tekst- editor en kopieer het precies, inclusief `-----BEGIN CERTIFICATE-----` en `-----END CERTIFICATE-----`. #### Unable to login with saml.workspace... of fouten door een afwijkende gebruiker Zorg dat Microsoft Entra het e-mailadres van de gebruiker als `NameID` verstuurt. Stel in **Attributes & Claims** voor de claim **Unique User Identifier (Name ID)** **Name identifier format** in op **Email address** en **Source attribute** op het veld dat het e-mailadres voor alle gebruikers bevat (meestal `user.mail`, of `user.userprincipalname` als `user.mail` niet is ingevuld). In het veld `` van de SAML-response moet `` het e-mailadres van de gebruiker zijn. #### Welke Microsoft Entra-waarden moet ik gebruiken? Gebruik de **Microsoft Entra Identifier** voor **Identity Provider Entity Id**, de **Login URL** voor **Identity Provider Sign-In URL** en het **Certificate (Base64)** voor **Certificate**.