> 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 Okta SAML SSO ermöglicht Workspace-Mitgliedern die Anmeldung bei ElevenLabs über eine Okta-SAML-2.0-App-Integration. > **Info** > > SSO ist für Enterprise-Workspaces verfügbar. Nur Workspace-Admins können SSO-Einstellungen konfigurieren. > **Warning** > > ElevenLabs unterstützt vom Service Provider (SP) initiiertes 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. ## Voraussetzungen * Ein Enterprise-Workspace von ElevenLabs. * Workspace-Adminzugriff in ElevenLabs. * Adminzugriff in Okta. * Eine verifizierte E-Mail-Domain in ElevenLabs für die Nutzer, die sich über Okta anmelden. ## Okta SAML SSO einrichten #### SSO-Einstellungen in ElevenLabs öffnen Gehen Sie zu **Workspace settings** > **Security & SSO**. ![Tab „Security & SSO“ in den ElevenLabs-Workspace-Einstellungen](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp) #### SAML als SSO-Anbieter auswählen Wählen Sie unter **SSO Provider** die Option **SAML**. Kopieren Sie die Werte für **Service Provider Entity Id** und \*\*Redirect URL \*\*. Sie verwenden diese Werte in Okta. ![Einstellungen für den ElevenLabs-SAML-Anbieter](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp) #### Eine Okta-App-Integration erstellen Gehen Sie in der Okta Admin Console zu **Applications** > **Applications** und klicken Sie dann auf \*\*Create App Integration \*\*. ![Okta-Seite „Applications“ mit „Create App Integration“](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp) Wählen Sie **SAML 2.0** und klicken Sie dann auf **Next**. ![Okta-Dialog „Create a new app integration“ mit ausgewähltem SAML 2.0](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp) #### App-Namen hinzufügen Setzen Sie unter **General Settings** den **App name** auf `ElevenLabs` und klicken Sie dann auf **Next**. ![Allgemeine Einstellungen für „Create SAML Integration“ in Okta](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp) #### SAML-Einstellungen in Okta konfigurieren Konfigurieren Sie die App unter **SAML Settings** mit den Werten aus ElevenLabs: * Setzen Sie **Single sign-on URL** auf die ElevenLabs-**Redirect URL**. * Wählen Sie **Use this for Recipient URL and Destination URL**. * Setzen Sie **Audience URI (SP Entity ID)** auf die ElevenLabs-**Service Provider Entity Id**. * Setzen Sie **Name ID format** auf **EmailAddress**. * Setzen Sie **Application username** auf **Email**. ![Okta-SAML-Einstellungen für ElevenLabs](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp) #### Nutzer oder Gruppen zuweisen Öffnen Sie den Tab **Assignments** der Okta-App und weisen Sie die Nutzer oder Gruppen zu, die sich bei ElevenLabs anmelden können sollen. ![Tab „Assignments“ der Okta-App](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp) #### Okta-Zertifikat zu ElevenLabs hinzufügen Öffnen Sie in Okta **SAML Signing Certificates** und wählen Sie für das aktive Zertifikat **Actions** > **Download certificate**. ![Aktion „Download certificate“ unter Okta SAML Signing Certificates](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp) Öffnen Sie die Zertifikatsdatei und kopieren Sie das vollständige PEM-Zertifikat, einschließlich `-----BEGIN CERTIFICATE-----` und `-----END CERTIFICATE-----`. ![Okta-Zertifikatsdatei im PEM-Format](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp) Klicken Sie in ElevenLabs auf **Add Certificate**, fügen Sie das Okta-Zertifikat ein und klicken Sie dann auf **Add**. ![Dialog „Add X509 Certificate“ in ElevenLabs](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp) #### Okta-Metadatenwerte in ElevenLabs kopieren Öffnen Sie in Okta die IdP-Metadaten-XML. Kopieren Sie die Metadatenwerte in ElevenLabs: * Verwenden Sie `entityID` für **Identity Provider Entity Id**. * Verwenden Sie die mit `/sso/saml` endende URL für `SingleSignOnService Location` als \*\*Identity Provider Sign-In URL \*\*. ![Okta-IdP-Metadaten-XML mit entityID und SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp) #### Zulässige E-Mail-Domain hinzufügen Klicken Sie in ElevenLabs auf **Add Domain** und wählen Sie die verifizierte Domain aus, die der E-Mail- Domain Ihrer Okta-Nutzer entspricht. ![Dialog „Add allowed email domains“ in ElevenLabs](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp) #### SSO-Anbieter speichern Prüfen Sie die Konfiguration, wählen Sie **I acknowledge this change will log out users currently using SSO** und klicken Sie dann auf \*\*Update SSO \*\*. ## Feldzuordnungen Verwenden Sie diese Tabelle, um Okta-SAML-Einstellungen den ElevenLabs-SSO-Feldern zuzuordnen. | Okta-Feld oder Speicherort | ElevenLabs-Feld | Zu verwendender Wert | | ------------------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------------------- | | **Sign-in method** | **SSO Provider** | `SAML` | | **Audience URI (SP Entity ID)** | **Service Provider Entity Id** | Verwenden Sie den ElevenLabs-Wert, z. B. `https://elevenlabs.io` | | **Single sign-on URL** | **Redirect URL** | Verwenden Sie den ElevenLabs-Wert, z. B. `https://elevenlabs.io/__/auth/handler` | | **Recipient URL** | **Redirect URL** | Wie **Single sign-on URL** | | **Destination URL** | **Redirect URL** | Wie **Single sign-on URL** | | **SAML Issuer ID** oder Metadaten-`entityID` | **Identity Provider Entity Id** | Okta-Aussteller, z. B. `http://www.okta.com/exk...` | | **Sign On URL** oder Metadaten-`SingleSignOnService Location` | **Identity Provider Sign-In URL** | Mit `/sso/saml` endende Okta-SAML-URL | | **X.509 Certificate** oder Metadaten-`ds:X509Certificate` | **Certificate** | Okta-Signaturzertifikat im gültigen PEM-Format | | **Application username** | Keine manuelle Konfiguration nötig | Auf **Email** setzen | | **Name ID format** | Keine manuelle Konfiguration nötig | Auf **EmailAddress** setzen | | Nutzer- oder App-E-Mail-Domain in Okta | **Domain** | Muss einer verifizierten ElevenLabs-Domain entsprechen, z. B. `company.com` | ## Fehlerbehebung #### Okta zeigt eine erfolgreiche Anmeldung, aber ElevenLabs meldet, dass die Anmeldung nicht möglich ist Prüfen Sie die Browser-Netzwerkantwort für `accounts:signInWithIdp`. Okta-Systemprotokolleinträge wie `User single sign on to app SUCCESS` bestätigen nur, dass Okta 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 Okta-X.509-Zertifikat erneut im gültigen PEM- Format hinzu. Verwenden Sie kein LLM, um das Zertifikat zu formatieren. Kopieren Sie das Zertifikat exakt, einschließlich `-----BEGIN CERTIFICATE-----` und `-----END CERTIFICATE-----`. #### Fehler aufgrund nicht übereinstimmender Nutzer oder Authentifizierung Stellen Sie sicher, dass Okta die E-Mail-Adresse des Nutzers als `NameID` sendet. Setzen Sie in Okta **Name ID format** auf **EmailAddress** und **Application username** auf **Email**. #### Welche Okta-Metadatenwerte soll ich verwenden? Verwenden Sie die Metadaten-`entityID` für **Identity Provider Entity Id**, `SingleSignOnService Location` für **Identity Provider Sign-In URL** und `ds:X509Certificate` für **Certificate**.