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

# SCIM

## Visão geral

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

## Pré-requisitos

* Um espaço de trabalho Enterprise da ElevenLabs.
* Acesso de administrador do espaço de trabalho na ElevenLabs.
* [SSO configurado](/docs/pt/overview/administration/workspaces/sso) para seu espaço de trabalho. A maioria dos provedores
  de identidade exige uma integração de aplicativo SSO existente à qual vincular o provisionamento SCIM.

## Configurar o SCIM

#### Abra as configurações de SCIM

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

#### Gere um token

Clique em **Generate Token**. Copie imediatamente a **URL base** e o **token Bearer**.

> **Warning**
>
> O token é exibido apenas uma vez. Se você perdê-lo, deverá gerar um novo, o que
> invalidará o token anterior e desconectará qualquer provisionamento de IdP configurado atualmente.

#### Configure seu provedor de identidade

Na configuração de SCIM/provisionamento do seu IdP:

* Defina a **URL do endpoint/conector SCIM** como a URL base copiada da ElevenLabs.
* Defina o modo de autenticação como **HTTP Bearer Token** e cole seu token.

Para instruções específicas de cada provedor, consulte [Configuração por provedor de identidade](#setup-by-identity-provider).

> **Note**
>
> Quando um usuário é removido ou desativado no seu IdP, seu acesso ao espaço de trabalho da ElevenLabs é revogado.
> A atividade histórica dele no espaço de trabalho é mantida.

## Recursos

A ElevenLabs é compatível com o protocolo SCIM 2.0 e os seguintes recursos:

| Recurso                                                       | Compatível? | Detalhes                                                                    |
| :------------------------------------------------------------ | :---------- | :-------------------------------------------------------------------------- |
| **Endpoints de descoberta**                                   | ✅ Sim       | `/ServiceProviderConfig`, `/Schemas`, `/ResourceTypes`                      |
| **Usuários**                                                  | ✅ Sim       | `GET`, `POST`, `PUT`, `PATCH`, `DELETE`                                     |
| **Atualização do endereço de e-mail principal de um usuário** | ❌ Não       |                                                                             |
| **Grupos**                                                    | ✅ Sim       | `GET`, `POST`, `PUT`, `PATCH`, `DELETE`                                     |
| **Busca**                                                     | ✅ Sim       | `GET` com `?filter` ou `POST` para `/.search`                               |
| **Paginação**                                                 | ✅ Sim       | Compatível com `startIndex` e `count`                                       |
| **Operações em massa**                                        | ✅ Sim       | `Máximo de operações por solicitação: 100`, `Tamanho máximo da carga: 1 MB` |
| **Filtragem de atributos**                                    | ✅ Sim       | Compatível com `attributes` e `excludedAttributes`                          |
| **Ordenação**                                                 | ❌ Não       | `sortBy` e `sortOrder` são ignorados durante a consulta                     |

## Atributos compatíveis

* **Usuários**: `userName`, `name`, `emails`, `active`, `externalId`
* **Grupos**: `displayName`, `members`, `externalId`

> **Warning**
>
> Não há suporte a alterações de endereço de e-mail pelo SCIM. Atualizar o e-mail principal de um usuário no seu IdP
> pode causar falhas de sincronização do SCIM para esse usuário.

## Configuração por provedor de identidade

#### Configuração do Microsoft Entra ID

#### Abra as configurações de provisionamento

No centro de administração do Microsoft Entra, selecione seu aplicativo
da ElevenLabs e abra **Provisioning**.

#### Defina o modo de provisionamento

Defina **Provisioning Mode** como **Automatic**.

#### Adicione as credenciais do SCIM

Em **Admin Credentials**:

* Defina **Tenant URL** como sua URL base do SCIM da ElevenLabs.
* Defina **Secret Token** como seu token Bearer da ElevenLabs.

#### Teste e ative o provisionamento

Clique em **Test Connection**, salve a configuração e defina **Provisioning Status** como
**On** quando estiver tudo pronto.

#### Configuração do Okta

#### Crie ou abra uma integração de aplicativo personalizada

Abra o aplicativo da ElevenLabs usado para login via SSO e acesse **General**.

#### Ative o SCIM no aplicativo

Clique em **Edit** em **App Settings** e defina **Provisioning** como **SCIM**.

#### Configure a conexão SCIM

Em **Provisioning** > **Settings** > **Integration**:

* Defina a **SCIM connector base URL** como sua URL base do SCIM da ElevenLabs.
* Escolha as ações de provisionamento necessárias para seu espaço de trabalho (por exemplo, enviar novos usuários, enviar
  atualizações de perfil e enviar grupos), execute **Test Connector Configuration** e salve.
* Defina **Authentication Mode** como **HTTP Header**.
* Cole seu token Bearer da ElevenLabs no campo **Authorization**.
* Clique em **Save**

#### Configuração do OneLogin

#### Abra as configurações do seu aplicativo

No OneLogin Admin, abra seu aplicativo da ElevenLabs.

#### Adicione as credenciais do SCIM em Configuration

Na aba **Configuration**:

* Defina **SCIM Base URL** como sua URL base do SCIM da ElevenLabs.
* Defina **SCIM Bearer token** como seu token Bearer da ElevenLabs.

#### Ative a conexão com a API

Acesse **Provisioning** e marque "Enable provisioning" para o aplicativo.