> 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 Microsoft Entra

O SSO SAML do Microsoft Entra permite que membros do workspace façam login na ElevenLabs por meio de um aplicativo empresarial do Microsoft Entra ID
(anteriormente Azure AD).

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

> **Warning**
>
> A ElevenLabs oferece suporte a 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.

> **Note**
>
> O Microsoft Entra é compatível apenas por meio de SAML. O uso de OIDC com o Microsoft Entra não é recomendado e
> pode causar problemas de login.

## Pré-requisitos

* Um workspace Enterprise da ElevenLabs.
* Acesso de administrador do workspace na ElevenLabs.
* Acesso de administrador ao centro de administração do Microsoft Entra.
* Um domínio de e-mail verificado na ElevenLabs para os usuários que farão login pelo Microsoft Entra.

## Configurar o SSO SAML do Microsoft Entra

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

Acesse **Configurações do workspace** > **Segurança e SSO**.

#### Verificar seu domínio de e-mail

Em **Provisionamento automático de usuários**, verifique o domínio de e-mail que seus usuários do Microsoft Entra usarão para fazer login.
Insira o domínio (subdomínios são permitidos) e siga as instruções para confirmar a propriedade.
Opcionalmente, ative o provisionamento automático para que usuários com um domínio de e-mail correspondente entrem automaticamente no seu
workspace.

![Caixa de diálogo de verificação em massa de domínio da ElevenLabs](/docs/_fern-img/9b471a5441feffcb2f57e3e1ee85bafdccf687bfbe61e6cfb89234f38bc5821d.webp)

#### Selecionar SAML como provedor de SSO

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

#### Criar um aplicativo empresarial do Microsoft Entra

No centro de administração do Microsoft Entra, abra a **Visão geral** do seu diretório e clique em **Adicionar** >
**Aplicativo empresarial**.

![Menu Adicionar da Visão geral do Microsoft Entra com Aplicativo empresarial selecionado](/docs/_fern-img/3d80c303777e59820fc3e9240368ffaf6fd5af53279f5ce574b21d57f4433cff.webp)

Em **Procurar na Galeria de Aplicativos do Microsoft Entra**, clique em **Criar seu próprio aplicativo**.

![Galeria de Aplicativos do Microsoft Entra com Criar seu próprio aplicativo](/docs/_fern-img/e78db7434ea9a3b210ef75544126423d1a55fb04aa6e08408dc0abaed1aa2fb2.webp)

#### Nomear o aplicativo

Insira um nome (por exemplo, `ElevenLabs`), selecione **Integrar qualquer outro aplicativo que você não encontrar
na galeria (Não presente na galeria)** e clique em \*\*Criar \*\*.

![Painel Criar seu próprio aplicativo do Microsoft Entra com um aplicativo não presente na galeria](/docs/_fern-img/4ab66649e94c88812f19c55412be1370aa3d8d7a9249f55576dfd62c3cb33558.webp)

#### Iniciar a configuração de logon único

Na **Visão geral** do aplicativo, em **Introdução**, selecione **Configurar logon único** >
**Começar**.

![Introdução do aplicativo empresarial do Microsoft Entra com Configurar logon único](/docs/_fern-img/1fcee15188b6ebc3c5773af4fd1ffb0dd9ff986821a57702b9b4ae876b8e26cf.webp)

Selecione **SAML** como método de logon único.

![Selecionar um método de logon único no Microsoft Entra com SAML](/docs/_fern-img/e0a67bdc3f893e3d00fefc2531db05e2ae5db569821ab59479f629bf9619d6e9.webp)

#### Configurar as definições básicas de SAML

Em **Configuração Básica do SAML**, configure o aplicativo com os valores da ElevenLabs:

* Defina **Identificador (ID da Entidade)** como o **ID de entidade do provedor de serviços** da ElevenLabs.
* Defina **URL de Resposta (URL do Serviço de Consumidor de Asserção)** como a **URL de redirecionamento** da ElevenLabs.
* Deixe a **URL de logon** em branco. A ElevenLabs usa SSO iniciado pelo SP.

Clique em **Salvar**.

![Configuração Básica do SAML do Microsoft Entra com Identificador e URL de Resposta](/docs/_fern-img/9961d266eb4ccb0bd4b6aa6f2d9a3322b059322fa7b933fe2741ca2c2ac2edb9.webp)

> **Note**
>
> Em ambientes de [residência de dados](/docs/pt/overview/administration/data-residency), use
> `https://<region>.residency.elevenlabs.io/__/auth/handler` como URL de Resposta, substituindo
> `<region>` pelo código da sua região.

#### Configurar a declaração de Name ID

Em **Atributos e Declarações**, edite a declaração **Identificador Exclusivo do Usuário (Name ID)**:

* Defina **Formato do identificador de nome** como **Endereço de e-mail**.
* Defina **Fonte** como **Atributo**.
* Defina **Atributo de origem** como o campo que contém o endereço de e-mail de todos os usuários. Normalmente, é
  `user.mail`, mas pode ser `user.userprincipalname`.

Clique em **Salvar**.

> **Note**
>
> Escolha o atributo que contém um endereço de e-mail para todos os usuários. Se `user.mail` não estiver preenchido
> para todos os seus usuários, use `user.userprincipalname`.

![Gerenciar declaração do Microsoft Entra com formato Endereço de e-mail e atributo de origem user.mail](/docs/_fern-img/1d94d0fecd19d9ca30ff5cce93294fda6a8c84ed98837ea89549f79b97ae153d.webp)

#### Baixar o certificado de assinatura

Em **Certificados SAML**, ao lado de **Certificado (Base64)**, clique em **Baixar**. Abra o arquivo
baixado em um editor de texto.

![Certificados SAML do Microsoft Entra com download de Certificado Base64](/docs/_fern-img/684fac9e520103b4c6978ef8dd3e95ea30d04a34e31b6ec7d13d97128492af07.webp)

#### Atribuir usuários ou grupos

Abra **Usuários e grupos** do aplicativo e atribua os usuários ou grupos que poderão fazer login
na ElevenLabs.

![Lista de usuários de Adicionar atribuição do Microsoft Entra](/docs/_fern-img/c07ddb7a33eb511ada81ce437cdf468aecbfb83ef11a5c3a25f3fa6c87f5afcc.webp)

#### Adicionar o certificado do Entra à ElevenLabs

Na ElevenLabs, clique em **Adicionar certificado**. Cole o certificado PEM completo do arquivo Base64,
incluindo `-----BEGIN CERTIFICATE-----` e `-----END CERTIFICATE-----`, e clique em **Adicionar**.

![Caixa de diálogo Adicionar certificado X509 da ElevenLabs](/docs/_fern-img/bd8d3e047624b0c8f5b119d77e79ef4b721ef2917ad9049a2a44b36b6016201b.webp)

#### Copiar os valores do provedor de identidade do Entra para a ElevenLabs

Na seção **Configurar** do Microsoft Entra, copie os valores do provedor de identidade para a ElevenLabs:

* Use o **Identificador do Microsoft Entra** como **ID de entidade do provedor de identidade**.
* Use a **URL de logon** como **URL de login do provedor de identidade**.

![Valores de configuração do Microsoft Entra mostrando URL de logon e Identificador do Microsoft Entra](/docs/_fern-img/abddc7178305f0c220d6b9ad92d21320859824c024a84506933fd67a9045144e.webp)

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

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

![Caixa de diálogo Adicionar domínios de e-mail permitidos da ElevenLabs](/docs/_fern-img/3039fce378edac35eaeab847e55a99ec82a241d7fc3bc46be24b23ec52e4a2bf.webp)

#### Salvar o provedor de SSO

Revise a configuração, selecione **Reconheço que essa alteração desconectará os usuários que estão usando
SSO** e clique em \*\*Atualizar SSO \*\*.

## Mapeamentos de campos

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

| Campo ou local do Microsoft Entra                              | Campo da ElevenLabs                          | Valor a usar                                                                                   |
| -------------------------------------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Método de login**                                            | **Provedor de SSO**                          | `SAML`                                                                                         |
| **Identificador (ID da Entidade)**                             | **ID de entidade do provedor de serviços**   | Use o valor da ElevenLabs, por exemplo, `https://elevenlabs.io`                                |
| **URL de Resposta (URL do Serviço de Consumidor de Asserção)** | **URL de redirecionamento**                  | Use o valor da ElevenLabs, por exemplo, `https://elevenlabs.io/__/auth/handler`                |
| **Identificador do Microsoft Entra**                           | **ID de entidade do provedor de identidade** | Emissor do Entra, por exemplo, `https://sts.windows.net/{tenant-id}/`                          |
| **URL de logon**                                               | **URL de login do provedor de identidade**   | URL de login SAML do Entra, por exemplo, `https://login.microsoftonline.com/{tenant-id}/saml2` |
| **Certificado (Base64)**                                       | **Certificado**                              | Certificado de assinatura de token do Entra em formato PEM válido                              |
| **Formato de Name ID**                                         | Nenhuma configuração manual necessária       | Defina como **Endereço de e-mail**                                                             |
| **Atributo de origem de Name ID**                              | Nenhuma configuração manual necessária       | Campo que contém o e-mail do usuário, geralmente `user.mail` (ou `user.userprincipalname`)     |
| Domínio de e-mail do usuário ou aplicativo no Microsoft Entra  | **Domínio**                                  | Deve corresponder a um domínio verificado da ElevenLabs, por exemplo, `company.com`            |

## Solução de problemas

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

Verifique a resposta de Rede do navegador para `accounts:signInWithIdp`. Os logs de login do Microsoft Entra apenas
confirmam que o Entra 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 Rede do navegador pode mostrar `INVALID_IDP_RESPONSE: Error when parsing certificate`.
Remova o certificado da ElevenLabs e adicione novamente o **Certificado (Base64)** do Entra em formato
PEM válido. Não use um LLM para formatar o certificado. Abra o certificado Base64 em um editor de texto
e copie-o exatamente, incluindo `-----BEGIN CERTIFICATE-----` e
`-----END CERTIFICATE-----`.

#### Não é possível fazer login com saml.workspace... ou erros de incompatibilidade de usuário

Verifique se o Microsoft Entra envia o endereço de e-mail do usuário como `NameID`. Em \*\*Atributos e
Declarações \*\*, defina o **Formato do identificador de nome** da declaração **Identificador Exclusivo do Usuário (Name ID)** como **Endereço de e-mail**
e o **Atributo de origem** como o campo que contém o endereço de e-mail de todos os usuários
(normalmente `user.mail`, ou `user.userprincipalname` se `user.mail` não estiver preenchido). Dentro do campo
`<saml:Subject>` da resposta SAML, `<saml:NameID>` deve ser o endereço de e-mail do usuário.

#### Quais valores do Microsoft Entra devo usar?

Use o **Identificador do Microsoft Entra** como **ID de entidade do provedor de identidade**, a **URL de logon** como
**URL de login do provedor de identidade** e o **Certificado (Base64)** como **Certificado**.