> 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 Mit Microsoft Entra SAML SSO können sich Workspace-Mitglieder über eine Microsoft Entra ID- Unternehmensanwendung (früher Azure AD) bei ElevenLabs anmelden. > **Info** > > SSO ist für Enterprise-Workspaces verfügbar. Nur Workspace-Admins können SSO-Einstellungen konfigurieren. > **Warning** > > ElevenLabs unterstützt Service-Provider-initiierte (SP-initiated) SAML SSO. Verwenden Sie zum Starten der > Anmeldung `https://elevenlabs.io/app/sign-in?use_sso=true`. Sie können `email=user@example.com` als Query- > Parameter hinzufügen, um das E-Mail-Feld vorab auszufüllen. > **Note** > > Microsoft Entra wird nur über SAML unterstützt. OIDC mit Microsoft Entra wird nicht empfohlen und > kann Anmeldeprobleme verursachen. ## Voraussetzungen * Ein Enterprise-Workspace von ElevenLabs. * Workspace-Admin-Zugriff in ElevenLabs. * Admin-Zugriff im Microsoft Entra Admin Center. * Eine verifizierte E-Mail-Domain in ElevenLabs für die Nutzer, die sich über Microsoft Entra anmelden. ## Microsoft Entra SAML SSO einrichten #### SSO-Einstellungen in ElevenLabs öffnen Gehen Sie zu **Workspace-Einstellungen** > **Sicherheit & SSO**. #### E-Mail-Domain verifizieren Verifizieren Sie unter **Automatische Nutzerbereitstellung** die E-Mail-Domain, über die sich Ihre Microsoft-Entra-Nutzer anmelden. Geben Sie die Domain ein (Subdomains sind zulässig) und folgen Sie dann den Anweisungen, um die Inhaberschaft zu bestätigen. Aktivieren Sie optional die automatische Bereitstellung, damit Nutzer mit einer passenden E-Mail-Domain Ihrem Workspace automatisch beitreten. ![Dialog zur Massenverifizierung von Domains in ElevenLabs](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp) #### SAML als SSO-Anbieter auswählen Wählen Sie unter **SSO-Anbieter** die Option **SAML**. Kopieren Sie die Werte für **Service Provider Entity Id** und **Redirect URL**. Sie verwenden diese Werte in Microsoft Entra. #### Microsoft-Entra-Unternehmensanwendung erstellen Öffnen Sie im Microsoft Entra Admin Center die **Übersicht** Ihres Verzeichnisses und klicken Sie dann auf **Hinzufügen** > **Unternehmensanwendung**. ![Microsoft-Entra-Menü „Übersicht“ > „Hinzufügen“ mit ausgewählter Unternehmensanwendung](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp) Klicken Sie unter **Microsoft Entra App-Katalog durchsuchen** auf **Eigene Anwendung erstellen**. ![Microsoft Entra App-Katalog mit „Eigene Anwendung erstellen“](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp) #### Anwendung benennen Geben Sie einen Namen ein, zum Beispiel `ElevenLabs`, wählen Sie **Jede andere Anwendung integrieren, die nicht im Katalog enthalten ist (Nicht-Kataloganwendung)**, und klicken Sie dann auf \*\*Erstellen \*\*. ![Bereich „Eigene Anwendung erstellen“ in Microsoft Entra mit einer Nicht-Kataloganwendung](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp) #### Single-Sign-On-Einrichtung starten Wählen Sie in der **Übersicht** der Anwendung unter **Erste Schritte** die Option **Single Sign-On einrichten** > **Erste Schritte**. ![„Erste Schritte“ einer Microsoft-Entra-Unternehmensanwendung mit „Single Sign-On einrichten“](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp) Wählen Sie **SAML** als Single-Sign-On-Methode aus. ![Microsoft Entra „Single Sign-On-Methode auswählen“ mit SAML](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp) #### Grundlegende SAML-Einstellungen konfigurieren Konfigurieren Sie die Anwendung unter **Grundlegende SAML-Konfiguration** mit den Werten aus ElevenLabs: * Setzen Sie **Bezeichner (Entitäts-ID)** auf die **Service Provider Entity Id** von ElevenLabs. * Setzen Sie **Antwort-URL (Assertion Consumer Service URL)** auf die **Redirect URL** von ElevenLabs. * Lassen Sie **Anmelde-URL** leer. ElevenLabs verwendet SP-initiierte SSO. Klicken Sie auf **Speichern**. ![Grundlegende SAML-Konfiguration in Microsoft Entra mit Bezeichner und Antwort-URL](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp) > **Note** > > Verwenden Sie für Umgebungen mit [Datenresidenz](/docs/de/overview/administration/data-residency) > `https://.residency.elevenlabs.io/__/auth/handler` als Antwort-URL und ersetzen Sie > `` durch Ihren Regionscode. #### Name-ID-Anspruch konfigurieren Bearbeiten Sie unter **Attribute & Ansprüche** den Anspruch **Eindeutiger Benutzerbezeichner (Name ID)**: * Setzen Sie **Format des Namensbezeichners** auf **E-Mail-Adresse**. * Setzen Sie **Quelle** auf **Attribut**. * Setzen Sie **Quellattribut** auf das Feld, das die E-Mail-Adresse aller Nutzer enthält. Das ist normalerweise `user.mail`, kann aber auch `user.userprincipalname` sein. Klicken Sie auf **Speichern**. > **Note** > > Wählen Sie das Attribut, das für jeden Nutzer eine E-Mail-Adresse enthält. Wenn `user.mail` nicht für > alle Ihre Nutzer ausgefüllt ist, verwenden Sie stattdessen `user.userprincipalname`. ![Microsoft Entra „Anspruch verwalten“ mit E-Mail-Adressformat und dem Quellattribut user.mail](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp) #### Signaturzertifikat herunterladen Klicken Sie unter **SAML-Zertifikate** neben **Zertifikat (Base64)** auf **Herunterladen**. Öffnen Sie die heruntergeladene Datei in einem Texteditor. ![Microsoft Entra SAML-Zertifikate mit Download für Zertifikat Base64](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp) #### Nutzer oder Gruppen zuweisen Öffnen Sie **Nutzer und Gruppen** der Anwendung und weisen Sie dann die Nutzer oder Gruppen zu, die sich bei ElevenLabs anmelden können sollen. ![Nutzerliste „Zuweisung hinzufügen“ in Microsoft Entra](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp) #### Entra-Zertifikat zu ElevenLabs hinzufügen Klicken Sie in ElevenLabs auf **Zertifikat hinzufügen**. Fügen Sie das vollständige PEM-Zertifikat aus der Base64-Datei ein, einschließlich `-----BEGIN CERTIFICATE-----` und `-----END CERTIFICATE-----`, und klicken Sie dann auf **Hinzufügen**. ![Dialog „X509-Zertifikat hinzufügen“ in ElevenLabs](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp) #### Werte des Entra-Identitätsanbieters in ElevenLabs kopieren Kopieren Sie im Bereich **Einrichten** von Microsoft Entra die Werte des Identitätsanbieters in ElevenLabs: * Verwenden Sie den **Microsoft Entra-Bezeichner** für **Identity Provider Entity Id**. * Verwenden Sie die **Anmelde-URL** für **Identity Provider Sign-In URL**. ![Einrichtungswerte in Microsoft Entra mit Anmelde-URL und Microsoft Entra-Bezeichner](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp) #### Zulässige E-Mail-Domain hinzufügen Klicken Sie in ElevenLabs auf **Domain hinzufügen** und wählen Sie die verifizierte Domain aus, die der E-Mail-Domain Ihrer Microsoft-Entra-Nutzer entspricht. ![Dialog „Zulässige E-Mail-Domains hinzufügen“ in ElevenLabs](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp) #### SSO-Anbieter speichern Prüfen Sie die Konfiguration, wählen Sie \*\*Ich bestätige, dass diese Änderung Nutzer abmeldet, die derzeit SSO verwenden \*\*, und klicken Sie dann auf \*\*SSO aktualisieren \*\*. ## Feldzuordnungen Verwenden Sie diese Tabelle, um Microsoft Entra SAML-Einstellungen den ElevenLabs-SSO-Feldern zuzuordnen. | Microsoft-Entra-Feld oder -Ort | ElevenLabs-Feld | Zu verwendender Wert | | -------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------ | | **Anmeldemethode** | **SSO-Anbieter** | `SAML` | | **Bezeichner (Entitäts-ID)** | **Service Provider Entity Id** | Verwenden Sie den ElevenLabs-Wert, zum Beispiel `https://elevenlabs.io` | | **Antwort-URL (Assertion Consumer Service URL)** | **Redirect URL** | Verwenden Sie den ElevenLabs-Wert, zum Beispiel `https://elevenlabs.io/__/auth/handler` | | **Microsoft Entra-Bezeichner** | **Identity Provider Entity Id** | Entra-Aussteller, zum Beispiel `https://sts.windows.net/{tenant-id}/` | | **Anmelde-URL** | **Identity Provider Sign-In URL** | Entra-SAML-Anmelde-URL, zum Beispiel `https://login.microsoftonline.com/{tenant-id}/saml2` | | **Zertifikat (Base64)** | **Zertifikat** | Entra-Token-Signaturzertifikat im gültigen PEM-Format | | **Name-ID-Format** | Keine manuelle Konfiguration erforderlich | Auf **E-Mail-Adresse** setzen | | **Name-ID-Quellattribut** | Keine manuelle Konfiguration erforderlich | Feld mit der E-Mail-Adresse des Nutzers, meist `user.mail` (oder `user.userprincipalname`) | | Nutzer- oder Anwendungs-E-Mail-Domain in Microsoft Entra | **Domain** | Muss einer verifizierten ElevenLabs-Domain entsprechen, zum Beispiel `company.com` | ## Fehlerbehebung #### Microsoft Entra zeigt eine erfolgreiche Anmeldung an, aber ElevenLabs meldet, dass die Anmeldung nicht möglich ist Prüfen Sie die Browser-Netzwerkantwort auf `accounts:signInWithIdp`. Die Anmeldeprotokolle von Microsoft Entra bestätigen nur, dass Entra den Nutzer authentifiziert hat. ElevenLabs kann die SAML-Antwort dennoch ablehnen, wenn die Assertion-Werte nicht mit der SSO-Konfiguration übereinstimmen. #### INVALID_IDP_RESPONSE: Fehler beim Parsen des Zertifikats Die Browser-Netzwerkantwort kann `INVALID_IDP_RESPONSE: Error when parsing certificate` anzeigen. Entfernen Sie das Zertifikat aus ElevenLabs und fügen Sie dann das Entra-**Zertifikat (Base64)** erneut im gültigen PEM-Format hinzu. Verwenden Sie kein LLM, um das Zertifikat zu formatieren. Öffnen Sie das Base64-Zertifikat in einem Texteditor und kopieren Sie es exakt, einschließlich `-----BEGIN CERTIFICATE-----` und `-----END CERTIFICATE-----`. #### Anmeldung mit saml.workspace... nicht möglich oder Fehler bei nicht übereinstimmendem Nutzer Stellen Sie sicher, dass Microsoft Entra die E-Mail-Adresse des Nutzers als `NameID` sendet. Setzen Sie unter **Attribute & Ansprüche** beim Anspruch **Eindeutiger Benutzerbezeichner (Name ID)** das **Format des Namensbezeichners** auf **E-Mail- Adresse** und **Quellattribut** auf das Feld, das die E-Mail-Adresse aller Nutzer enthält (normalerweise `user.mail` oder `user.userprincipalname`, falls `user.mail` nicht ausgefüllt ist). Im Feld `` der SAML-Antwort muss `` die E-Mail-Adresse des Nutzers enthalten. #### Welche Microsoft-Entra-Werte sollte ich verwenden? Verwenden Sie den **Microsoft Entra-Bezeichner** für **Identity Provider Entity Id**, die **Anmelde-URL** für **Identity Provider Sign-In URL** und das **Zertifikat (Base64)** für **Zertifikat**.