> 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 umożliwia członkom workspace'u logowanie do ElevenLabs przez integrację aplikacji Okta SAML 2.0.

> **Info**
>
> SSO jest dostępne w workspace'ach Enterprise. Ustawienia SSO mogą konfigurować tylko administratorzy workspace'u.

> **Warning**
>
> ElevenLabs obsługuje SAML SSO inicjowane przez Service Provider (SP). 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.

## Wymagania wstępne

* Workspace ElevenLabs Enterprise.
* Dostęp administratora workspace'u w ElevenLabs.
* Dostęp administratora w Okta.
* Zweryfikowana domena e-mail w ElevenLabs dla użytkowników, którzy będą logować się przez Okta.

## Konfiguracja Okta SAML SSO

#### Otwórz ustawienia SSO w ElevenLabs

Przejdź do **Ustawienia workspace'u** > **Bezpieczeństwo i SSO**.

![Karta Bezpieczeństwo i SSO w ustawieniach workspace'u ElevenLabs](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp)

#### Wybierz SAML jako dostawcę SSO

W sekcji **Dostawca SSO** wybierz **SAML**. Skopiuj wartości **Identyfikator jednostki Service Provider** i \*\*Adres
URL przekierowania \*\*. Użyjesz ich w Okta.

![Ustawienia dostawcy SAML w ElevenLabs](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp)

#### Utwórz integrację aplikacji Okta

W konsoli administratora Okta przejdź do **Applications** > **Applications**, a potem kliknij \*\*Create App
Integration \*\*.

![Strona Applications w Okta z opcją Create App Integration](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp)

Wybierz **SAML 2.0**, a potem kliknij **Next**.

![Okno Create a new app integration w Okta z wybranym SAML 2.0](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp)

#### Dodaj nazwę aplikacji

W sekcji **General Settings** ustaw **App name** na `ElevenLabs`, a potem kliknij **Next**.

![Ustawienia ogólne Create SAML Integration w Okta](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp)

#### Skonfiguruj ustawienia SAML w Okta

W sekcji **SAML Settings** skonfiguruj aplikację, używając wartości z ElevenLabs:

* Ustaw **Single sign-on URL** na **Adres URL przekierowania** z ElevenLabs.
* Wybierz **Use this for Recipient URL and Destination URL**.
* Ustaw **Audience URI (SP Entity ID)** na **Identyfikator jednostki Service Provider** z ElevenLabs.
* Ustaw **Name ID format** na **EmailAddress**.
* Ustaw **Application username** na **Email**.

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

#### Przypisz użytkowników lub grupy

Otwórz kartę **Assignments** aplikacji Okta i przypisz użytkowników lub grupy, które powinny móc
logować się do ElevenLabs.

![Karta Assignments aplikacji Okta](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp)

#### Dodaj certyfikat Okta do ElevenLabs

W Okta otwórz **SAML Signing Certificates** i dla aktywnego certyfikatu wybierz **Actions** > **Download certificate**.

![Opcja pobierania certyfikatu w SAML Signing Certificates w Okta](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp)

Otwórz plik certyfikatu i skopiuj cały certyfikat PEM, wraz z
`-----BEGIN CERTIFICATE-----` i `-----END CERTIFICATE-----`.

![Plik certyfikatu Okta w formacie PEM](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp)

W ElevenLabs kliknij **Add Certificate**, wklej certyfikat Okta, a potem kliknij **Add**.

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

#### Skopiuj wartości metadanych Okta do ElevenLabs

W Okta otwórz XML metadanych IdP. Skopiuj wartości metadanych do ElevenLabs:

* Użyj `entityID` jako **Identyfikatora jednostki Identity Provider**.
* Użyj adresu URL `SingleSignOnService Location`, który kończy się na `/sso/saml`, jako \*\*Adresu URL
  logowania Identity Provider \*\*.

![XML metadanych IdP Okta z wartościami entityID i SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp)

#### Dodaj dozwoloną domenę e-mail

W ElevenLabs kliknij **Add Domain** i wybierz zweryfikowaną domenę zgodną z domeną e-mail
użytkowników Okta.

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

#### Zapisz dostawcę SSO

Sprawdź konfigurację, wybierz \*\*I acknowledge this change will log out users currently using
SSO \*\*, a potem kliknij \*\*Update SSO \*\*.

## Mapowanie pól

Użyj tej tabeli, aby dopasować ustawienia Okta SAML do pól SSO ElevenLabs.

| Pole lub lokalizacja w Okta                                     | Pole ElevenLabs                               | Wartość do użycia                                                               |
| --------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------- |
| **Sign-in method**                                              | **Dostawca SSO**                              | `SAML`                                                                          |
| **Audience URI (SP Entity ID)**                                 | **Identyfikator jednostki Service Provider**  | Użyj wartości z ElevenLabs, na przykład `https://elevenlabs.io`                 |
| **Single sign-on URL**                                          | **Adres URL przekierowania**                  | Użyj wartości z ElevenLabs, na przykład `https://elevenlabs.io/__/auth/handler` |
| **Recipient URL**                                               | **Adres URL przekierowania**                  | Taki sam jak **Single sign-on URL**                                             |
| **Destination URL**                                             | **Adres URL przekierowania**                  | Taki sam jak **Single sign-on URL**                                             |
| **SAML Issuer ID** lub `entityID` w metadanych                  | **Identyfikator jednostki Identity Provider** | Wystawca Okta, na przykład `http://www.okta.com/exk...`                         |
| **Sign On URL** lub `SingleSignOnService Location` w metadanych | **Adres URL logowania Identity Provider**     | Adres URL Okta SAML kończący się na `/sso/saml`                                 |
| **X.509 Certificate** lub `ds:X509Certificate` w metadanych     | **Certyfikat**                                | Certyfikat podpisu Okta w prawidłowym formacie PEM                              |
| **Application username**                                        | Nie wymaga ręcznej konfiguracji               | Ustaw na **Email**                                                              |
| **Name ID format**                                              | Nie wymaga ręcznej konfiguracji               | Ustaw na **EmailAddress**                                                       |
| Domena e-mail użytkownika lub aplikacji w Okta                  | **Domena**                                    | Musi odpowiadać zweryfikowanej domenie ElevenLabs, na przykład `company.com`    |

## Rozwiązywanie problemów

#### Okta pokazuje udane logowanie, ale ElevenLabs informuje, że nie można się zalogować

Sprawdź odpowiedź Network w przeglądarce dla `accounts:signInWithIdp`. Wpisy w Okta System Log, takie jak
`User single sign on to app SUCCESS`, potwierdzają tylko, że Okta uwierzytelniła użytkownika. ElevenLabs
może nadal odrzucić odpowiedź SAML, jeśli wartości asercji nie pasują do konfiguracji SSO.

#### INVALID_IDP_RESPONSE: Error when parsing certificate

Odpowiedź Network w przeglądarce może zawierać `INVALID_IDP_RESPONSE: Error when parsing certificate`.
Usuń certyfikat z ElevenLabs, a następnie dodaj ponownie certyfikat X.509 Okta w prawidłowym formacie PEM.
Nie używaj LLM do formatowania certyfikatu. Skopiuj certyfikat dokładnie, wraz z
`-----BEGIN CERTIFICATE-----` i `-----END CERTIFICATE-----`.

#### Błędy niezgodności użytkownika lub uwierzytelniania

Upewnij się, że Okta wysyła adres e-mail użytkownika jako `NameID`. W Okta ustaw **Name ID format** na
**EmailAddress**, a **Application username** na **Email**.

#### Których wartości metadanych Okta użyć?

Użyj `entityID` z metadanych jako **Identyfikatora jednostki Identity Provider**, `SingleSignOnService Location` jako
**Adresu URL logowania Identity Provider**, a `ds:X509Certificate` jako **Certyfikatu**.