> 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 Microsoft Entra SAML SSO umożliwia członkom workspace'u logowanie się do ElevenLabs przez aplikację firmową Microsoft Entra ID (dawniej Azure AD). > **Info** > > SSO jest dostępne w workspace'ach Enterprise. Ustawienia SSO mogą konfigurować tylko administratorzy workspace'u. > **Warning** > > ElevenLabs obsługuje inicjowane przez dostawcę usług (SP) logowanie SAML SSO. Aby rozpocząć logowanie, użyj > `https://elevenlabs.io/app/sign-in?use_sso=true`. Możesz dodać `email=user@example.com` jako parametr > zapytania, aby wstępnie wypełnić pole e-mail. > **Note** > > Microsoft Entra jest obsługiwany tylko przez SAML. Nie zalecamy OIDC z Microsoft Entra, ponieważ > może powodować problemy z logowaniem. ## Wymagania wstępne * Workspace ElevenLabs Enterprise. * Dostęp administratora workspace'u w ElevenLabs. * Dostęp administratora do centrum administracyjnego Microsoft Entra. * Zweryfikowana domena e-mail w ElevenLabs dla użytkowników, którzy będą logować się przez Microsoft Entra. ## Konfiguracja Microsoft Entra SAML SSO #### Otwórz ustawienia SSO w ElevenLabs Przejdź do **Ustawienia workspace'u** > **Bezpieczeństwo i SSO**. #### Zweryfikuj swoją domenę e-mail W sekcji **Automatyczne tworzenie użytkowników** zweryfikuj domenę e-mail, której będą używać do logowania użytkownicy Microsoft Entra. Wpisz domenę (subdomeny są dozwolone), a następnie postępuj zgodnie z instrukcjami, by potwierdzić własność. Opcjonalnie włącz automatyczne tworzenie użytkowników, aby osoby z pasującą domeną e-mail automatycznie dołączały do workspace'u. ![Okno zbiorczej weryfikacji domeny w ElevenLabs](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp) #### Wybierz SAML jako dostawcę SSO W **Dostawca SSO** wybierz **SAML**. Skopiuj wartości **Identyfikator podmiotu dostawcy usług** i **URL przekierowania**. Użyjesz ich w Microsoft Entra. #### Utwórz aplikację firmową Microsoft Entra W centrum administracyjnym Microsoft Entra otwórz **Przegląd** katalogu, a następnie kliknij **Dodaj** > **Aplikacja firmowa**. ![Menu Dodaj w widoku Przegląd Microsoft Entra z wybraną aplikacją firmową](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp) W **Przeglądaj galerię aplikacji Microsoft Entra** kliknij **Utwórz własną aplikację**. ![Galeria aplikacji Microsoft Entra z opcją Utwórz własną aplikację](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp) #### Nazwij aplikację Wpisz nazwę (na przykład `ElevenLabs`), wybierz **Zintegruj dowolną inną aplikację, której nie znajdziesz w galerii (poza galerią)**, a następnie kliknij \*\*Utwórz \*\*. ![Panel Utwórz własną aplikację Microsoft Entra z aplikacją spoza galerii](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp) #### Rozpocznij konfigurację pojedynczego logowania W **Przeglądzie** aplikacji, w sekcji **Pierwsze kroki**, wybierz **Skonfiguruj pojedyncze logowanie** > **Rozpocznij**. ![Sekcja Pierwsze kroki aplikacji firmowej Microsoft Entra z opcją Skonfiguruj pojedyncze logowanie](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp) Wybierz **SAML** jako metodę pojedynczego logowania. ![Wybór metody pojedynczego logowania w Microsoft Entra z SAML](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp) #### Skonfiguruj podstawowe ustawienia SAML W sekcji **Podstawowa konfiguracja SAML** skonfiguruj aplikację, używając wartości z ElevenLabs: * Ustaw **Identyfikator (ID jednostki)** na wartość **Identyfikator podmiotu dostawcy usług** z ElevenLabs. * Ustaw **Adres URL odpowiedzi (adres URL usługi Assertion Consumer Service)** na wartość **URL przekierowania** z ElevenLabs. * Pozostaw **Adres URL logowania** pusty. ElevenLabs używa SSO inicjowanego przez SP. Kliknij **Zapisz**. ![Podstawowa konfiguracja SAML Microsoft Entra z identyfikatorem i adresem URL odpowiedzi](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp) > **Note** > > W środowiskach [rezydencji danych](/docs/pl/overview/administration/data-residency) użyj > `https://.residency.elevenlabs.io/__/auth/handler` jako adresu URL odpowiedzi, zastępując > `` kodem swojego regionu. #### Skonfiguruj oświadczenie Name ID W sekcji **Atrybuty i oświadczenia** edytuj oświadczenie **Unikatowy identyfikator użytkownika (Name ID)**: * Ustaw **Format identyfikatora nazwy** na **Adres e-mail**. * Ustaw **Źródło** na **Atrybut**. * Ustaw **Atrybut źródłowy** na pole zawierające adres e-mail wszystkich użytkowników. Zwykle jest to `user.mail`, ale może to być `user.userprincipalname`. Kliknij **Zapisz**. > **Note** > > Wybierz atrybut zawierający adres e-mail każdego użytkownika. Jeśli `user.mail` nie jest uzupełniony > dla wszystkich użytkowników, użyj zamiast niego `user.userprincipalname`. ![Zarządzanie oświadczeniem Microsoft Entra z formatem Adres e-mail i atrybutem źródłowym user.mail](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp) #### Pobierz certyfikat podpisywania W sekcji **Certyfikaty SAML**, obok **Certyfikat (Base64)**, kliknij **Pobierz**. Otwórz pobrany plik w edytorze tekstu. ![Certyfikaty SAML Microsoft Entra z pobieraniem certyfikatu Base64](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp) #### Przypisz użytkowników lub grupy Otwórz **Użytkownicy i grupy** aplikacji, a następnie przypisz użytkowników lub grupy, które powinny móc się logować do ElevenLabs. ![Lista użytkowników Dodaj przypisanie w Microsoft Entra](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp) #### Dodaj certyfikat Entra do ElevenLabs W ElevenLabs kliknij **Dodaj certyfikat**. Wklej cały certyfikat PEM z pliku Base64, w tym `-----BEGIN CERTIFICATE-----` i `-----END CERTIFICATE-----`, a następnie kliknij **Dodaj**. ![Okno Dodaj certyfikat X509 w ElevenLabs](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp) #### Skopiuj wartości dostawcy tożsamości Entra do ElevenLabs W sekcji **Konfiguracja** Microsoft Entra skopiuj wartości dostawcy tożsamości do ElevenLabs: * Użyj **Identyfikatora Microsoft Entra** jako **Identyfikatora podmiotu dostawcy tożsamości**. * Użyj **Adresu URL logowania** jako **Adresu URL logowania dostawcy tożsamości**. ![Wartości konfiguracji Microsoft Entra z adresem URL logowania i identyfikatorem Microsoft Entra](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp) #### Dodaj dozwoloną domenę e-mail W ElevenLabs kliknij **Dodaj domenę** i wybierz zweryfikowaną domenę zgodną z domeną e-mail użytkowników Microsoft Entra. ![Okno Dodaj dozwolone domeny e-mail w ElevenLabs](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp) #### Zapisz dostawcę SSO Sprawdź konfigurację, wybierz \*\*Potwierdzam, że ta zmiana wyloguje użytkowników obecnie korzystających z SSO \*\*, a następnie kliknij \*\*Zaktualizuj SSO \*\*. ## Mapowanie pól Użyj tej tabeli, aby przypisać ustawienia SAML Microsoft Entra do pól SSO ElevenLabs. | Pole lub lokalizacja Microsoft Entra | Pole ElevenLabs | Wartość do użycia | | ---------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------- | | **Metoda logowania** | **Dostawca SSO** | `SAML` | | **Identyfikator (ID jednostki)** | **Identyfikator podmiotu dostawcy usług** | Użyj wartości ElevenLabs, na przykład `https://elevenlabs.io` | | **Adres URL odpowiedzi (adres URL usługi Assertion Consumer Service)** | **URL przekierowania** | Użyj wartości ElevenLabs, na przykład `https://elevenlabs.io/__/auth/handler` | | **Identyfikator Microsoft Entra** | **Identyfikator podmiotu dostawcy tożsamości** | Wystawca Entra, na przykład `https://sts.windows.net/{tenant-id}/` | | **Adres URL logowania** | **Adres URL logowania dostawcy tożsamości** | Adres URL logowania Entra SAML, na przykład `https://login.microsoftonline.com/{tenant-id}/saml2` | | **Certyfikat (Base64)** | **Certyfikat** | Certyfikat podpisywania tokenów Entra w prawidłowym formacie PEM | | **Format Name ID** | Nie wymaga ręcznej konfiguracji | Ustaw na **Adres e-mail** | | **Atrybut źródłowy Name ID** | Nie wymaga ręcznej konfiguracji | Pole zawierające e-mail użytkownika, zwykle `user.mail` (lub `user.userprincipalname`) | | Domena e-mail użytkownika lub aplikacji w Microsoft Entra | **Domena** | Musi pasować do zweryfikowanej domeny ElevenLabs, na przykład `company.com` | ## Rozwiązywanie problemów #### Microsoft Entra pokazuje udane logowanie, ale ElevenLabs informuje, że nie można się zalogować Sprawdź odpowiedź Network przeglądarki dla `accounts:signInWithIdp`. Dzienniki logowania Microsoft Entra tylko potwierdzają, że Entra uwierzytelnił użytkownika. ElevenLabs może nadal odrzucić odpowiedź SAML, jeśli wartości asercji nie pasują do konfiguracji SSO. #### INVALID_IDP_RESPONSE: Błąd podczas analizowania certyfikatu Odpowiedź Network przeglądarki może pokazywać `INVALID_IDP_RESPONSE: Error when parsing certificate`. Usuń certyfikat z ElevenLabs, a następnie ponownie dodaj **Certyfikat (Base64)** Entra w prawidłowym formacie PEM. Nie używaj LLM do formatowania certyfikatu. Otwórz certyfikat Base64 w edytorze tekstu i skopiuj go dokładnie, w tym `-----BEGIN CERTIFICATE-----` oraz `-----END CERTIFICATE-----`. #### Nie można zalogować się przez saml.workspace... lub błędy niezgodności użytkownika Upewnij się, że Microsoft Entra wysyła adres e-mail użytkownika jako `NameID`. W sekcji **Atrybuty i oświadczenia** ustaw w oświadczeniu **Unikatowy identyfikator użytkownika (Name ID)** opcję **Format identyfikatora nazwy** na \*\*Adres e-mail \*\*, a **Atrybut źródłowy** na pole zawierające adres e-mail wszystkich użytkowników (zwykle `user.mail` lub `user.userprincipalname`, jeśli `user.mail` nie jest uzupełniony). W polu `` odpowiedzi SAML element `` musi zawierać adres e-mail użytkownika. #### Których wartości Microsoft Entra użyć? Użyj **Identyfikatora Microsoft Entra** jako **Identyfikatora podmiotu dostawcy tożsamości**, **Adresu URL logowania** jako **Adresu URL logowania dostawcy tożsamości**, a **Certyfikatu (Base64)** jako **Certyfikatu**.