> 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.

# SSO SAML do Okta

O SSO SAML do Okta permite que membros do espaço de trabalho façam login na ElevenLabs por uma integração de aplicativo Okta SAML 2.0.

> **Info**
>
> O SSO está disponível para espaços de trabalho Enterprise. Apenas administradores do espaço de trabalho podem configurar as definições de SSO.

> **Warning**
>
> A ElevenLabs é compatível com SSO SAML iniciado pelo Provedor de Serviços (SP). Para iniciar o login, use
> `https://elevenlabs.io/app/sign-in?use_sso=true`. Você pode adicionar `email=user@example.com` como um parâmetro
> de consulta para preencher previamente o campo de e-mail.

## Pré-requisitos

* Um espaço de trabalho Enterprise da ElevenLabs.
* Acesso de administrador do espaço de trabalho na ElevenLabs.
* Acesso de administrador no Okta.
* Um domínio de e-mail verificado na ElevenLabs para os usuários que farão login pelo Okta.

## Configurar o SSO SAML do Okta

#### Abra as configurações de SSO na ElevenLabs

Acesse **Configurações do espaço de trabalho** > **Segurança e SSO**.

![Aba Segurança e SSO das configurações do espaço de trabalho da ElevenLabs](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp)

#### Selecione SAML como provedor de SSO

Em **Provedor de SSO**, selecione **SAML**. Copie os valores de **ID da entidade do provedor de
serviços** e \*\*URL de redirecionamento \*\*. Você usará esses valores no Okta.

![Configurações do provedor SAML da ElevenLabs](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp)

#### Crie uma integração de aplicativo no Okta

No Console de Administração do Okta, acesse **Applications** > **Applications** e clique em \*\*Create App
Integration \*\*.

![Página Applications do Okta com Create App Integration](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp)

Selecione **SAML 2.0** e clique em **Next**.

![Caixa de diálogo Create a new app integration do Okta com SAML 2.0 selecionado](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp)

#### Adicione o nome do aplicativo

Em **General Settings**, defina **App name** como `ElevenLabs` e clique em **Next**.

![Configurações gerais de Create SAML Integration do Okta](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp)

#### Configure as definições de SAML no Okta

Em **SAML Settings**, configure o aplicativo com os valores da ElevenLabs:

* Defina **Single sign-on URL** como a **URL de redirecionamento** da ElevenLabs.
* Selecione **Use this for Recipient URL and Destination URL**.
* Defina **Audience URI (SP Entity ID)** como o **ID da entidade do provedor de serviços** da ElevenLabs.
* Defina **Name ID format** como **EmailAddress**.
* Defina **Application username** como **Email**.

![Configurações de SAML do Okta para a ElevenLabs](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp)

#### Atribua usuários ou grupos

Abra a aba **Assignments** do aplicativo no Okta e atribua os usuários ou grupos que poderão
fazer login na ElevenLabs.

![Aba Assignments do aplicativo do Okta](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp)

#### Adicione o certificado do Okta à ElevenLabs

No Okta, abra **SAML Signing Certificates** e use **Actions** > **Download certificate** para
o certificado ativo.

![Ação de download de certificado em SAML Signing Certificates do Okta](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp)

Abra o arquivo do certificado e copie o certificado PEM completo, incluindo
`-----BEGIN CERTIFICATE-----` e `-----END CERTIFICATE-----`.

![Arquivo de certificado do Okta em formato PEM](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp)

Na ElevenLabs, clique em **Add Certificate**, cole o certificado do Okta e clique em **Add**.

![Caixa de diálogo Add X509 Certificate da ElevenLabs](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp)

#### Copie os valores de metadados do Okta para a ElevenLabs

No Okta, abra o XML de metadados do IdP. Copie os valores de metadados para a ElevenLabs:

* Use `entityID` para **ID da entidade do provedor de identidade**.
* Use a URL `SingleSignOnService Location` que termina em `/sso/saml` para a \*\*URL de login do provedor
  de identidade \*\*.

![XML de metadados do IdP do Okta mostrando entityID e SingleSignOnService Location](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp)

#### Adicione seu domínio de e-mail permitido

Na ElevenLabs, clique em **Add Domain** e selecione o domínio verificado que corresponde ao domínio
de e-mail dos seus usuários do Okta.

![Caixa de diálogo Add allowed email domains da ElevenLabs](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp)

#### Salve o provedor de SSO

Revise a configuração, selecione **I acknowledge this change will log out users currently using
SSO** e clique em \*\*Update SSO \*\*.

## Mapeamento de campos

Use esta tabela para mapear as configurações SAML do Okta aos campos de SSO da ElevenLabs.

| Campo ou local do Okta                                          | Campo da ElevenLabs                          | Valor a usar                                                                        |
| --------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Método de login**                                             | **Provedor de SSO**                          | `SAML`                                                                              |
| **Audience URI (SP Entity ID)**                                 | **ID da entidade do provedor de serviços**   | Use o valor da ElevenLabs, por exemplo, `https://elevenlabs.io`                     |
| **Single sign-on URL**                                          | **URL de redirecionamento**                  | Use o valor da ElevenLabs, por exemplo, `https://elevenlabs.io/__/auth/handler`     |
| **Recipient URL**                                               | **URL de redirecionamento**                  | Igual a **Single sign-on URL**                                                      |
| **Destination URL**                                             | **URL de redirecionamento**                  | Igual a **Single sign-on URL**                                                      |
| **SAML Issuer ID** ou `entityID` dos metadados                  | **ID da entidade do provedor de identidade** | Emissor do Okta, por exemplo, `http://www.okta.com/exk...`                          |
| **Sign On URL** ou `SingleSignOnService Location` dos metadados | **URL de login do provedor de identidade**   | URL SAML do Okta terminada em `/sso/saml`                                           |
| **X.509 Certificate** ou `ds:X509Certificate` dos metadados     | **Certificado**                              | Certificado de assinatura do Okta em formato PEM válido                             |
| **Application username**                                        | Não requer configuração manual               | Defina como **Email**                                                               |
| **Name ID format**                                              | Não requer configuração manual               | Defina como **EmailAddress**                                                        |
| Domínio de e-mail do usuário ou aplicativo no Okta              | **Domínio**                                  | Deve corresponder a um domínio verificado da ElevenLabs, por exemplo, `company.com` |

## Solução de problemas

#### O Okta mostra um login bem-sucedido, mas a ElevenLabs informa que não foi possível fazer login

Verifique a resposta de Network do navegador para `accounts:signInWithIdp`. Entradas do Okta System Log como
`User single sign on to app SUCCESS` confirmam apenas que o Okta autenticou o usuário. A ElevenLabs
ainda pode rejeitar a resposta SAML se os valores da asserção não corresponderem à configuração de SSO.

#### INVALID_IDP_RESPONSE: Erro ao analisar o certificado

A resposta de Network do navegador pode mostrar `INVALID_IDP_RESPONSE: Error when parsing certificate`.
Remova o certificado da ElevenLabs e adicione novamente o certificado X.509 do Okta em formato PEM
válido. Não use um LLM para formatar o certificado. Copie o certificado exatamente, incluindo
`-----BEGIN CERTIFICATE-----` e `-----END CERTIFICATE-----`.

#### Erros de incompatibilidade de usuário ou autenticação

Verifique se o Okta envia o endereço de e-mail do usuário como `NameID`. No Okta, defina **Name ID format** como
**EmailAddress** e **Application username** como **Email**.

#### Quais valores de metadados do Okta devo usar?

Use o `entityID` dos metadados para **ID da entidade do provedor de identidade**, `SingleSignOnService Location` para
**URL de login do provedor de identidade** e `ds:X509Certificate` para **Certificado**.