---
title: "Como configurar o provisionamento de usuários SCIM"
description: "Saiba como configurar um sistema de provisionamento de usuários de gerenciamento de identidade entre domínios (SCIM) em uma conta ou portfólio."
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/10952782535579"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/10952782535579.md"
locale: "pt-br"
category: "Conta e cobranças"
section: "Segurança"
updated: "2026-03-24"
---

# Como configurar o provisionamento de usuários SCIM

## O que você vai aprender

Saiba como configurar um sistema de provisionamento de usuários de gerenciamento de identidade entre domínios (SCIM) em uma conta ou portfólio.

**📝 Note:** O SCIM está disponível para contas com um plano pago e para portfólios. Para configurá-lo, use a função Administrador ou Proprietário em uma conta ou a função Administrador de portfólio ou Proprietário de portfólio em um portfólio.

## Antes de começar

Você também precisa ter o [SSO ativado no Klaviyo](https://help.klaviyo.com/hc/pt-br/articles/9353860331035.md) antes de configurar o SCIM. 

Observe que o provisionamento SCIM geralmente é um complemento para provedores de identidade (IdPs). Por exemplo, os IdPs geralmente exigem um plano SCIM separado, além de um plano SSO. Se você não vir as etapas a seguir no seu IdP, confirme se você tem o plano correto. 

Para cada usuário, seu IdP precisa enviar uma função e um endereço de e-mail como `userName`. O nome de usuário precisa corresponder a um valor de e-mail enviado para esse usuário.

Para um portfólio, use `portfolio_admin`, `portfolio_manager` ou `portfolio_analyst`. Funções da conta, como `admin`, não se aplicam a portfólios. O SCIM não pode criar usuários com a função de Proprietário ou Proprietário do portfólio.

A Klaviyo oferece suporte ao provisionamento de usuários, não de objetos de grupo. Você pode atribuir um grupo do IdP para selecionar usuários para provisionamento, mas deixe o provisionamento de grupo desativado.

## Ative o provisionamento de usuários do SCIM

1. Clique no nome de sua organização no canto inferior esquerdo.

2. Clique em **Configurações > Segurança**.




![Security tab in Account settings](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/cef6afb13607301495acb496c60f6033570a87cb-1840x1290.png?auto=format)

3. Marque a caixa *Provisionamento SCIM* . 

4. Clique em **Copiar** ou **Baixar (.txt)** para salvar a chave de acesso conforme mostrado.
Esta chave só é exibida uma vez, então armazene-a em um local seguro antes de fechar a caixa de diálogo.



![Example of an access key](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/88216ff532f9abb275bb8396c9f0e153ff414ba0-1350x692.png?auto=format)

5. Clique em **Concluído**. 

6. Copie a base URL e cole em algum lugar, de preferência onde você armazenou a chave de acesso.



Substituir uma Chave SCIM invalida imediatamente a chave anterior. Se você perder sua chave, clique em **Substituir Chave SCIM** e, em seguida, em **Confirmar**. Salve a nova chave e atualize-a no seu IdP.

Em seguida, acesse seu provedor de identidade para concluir o processo. A seguir, veja as instruções para Okta, OneLogin e Microsoft Entra ID. Outros provedores precisam oferecer suporte ao provisionamento de usuários SCIM 2.0 compatível.

**▸ Okta**

Para ver como navegar na configuração atual, consulte [o guia de configuração de SCIM da Okta](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_scim.htm). Use as configurações de conexão do Klaviyo abaixo.

1. Navegue até **Aplicativo > Aplicativos**. 

2. Selecione o app da Klaviyo. 

3. Vá até a aba **Fazer login** .




![Four tabs for an app with SSO: General, Sign On, Import, and Assignments](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/ac73931a94d04b7eeb401325862f42fa9076759f-1166x372.png?auto=format)

1. Em *Detalhes das credenciais*, verifique se:

   - O *formato do nome de usuário do aplicativo* está definido como **E-mail**.

   - *Atualizar nome de usuário do aplicativo em* está definido como **Criar e atualizar**.




![Credental Details section in the Sign On tab](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/fab91a4f794cfa454df0c0b9b07d9b99fc647f05-1416x468.jpg?auto=format)

1. Clique na aba **Geral** . 




![General tab for app, when there's no provisioning](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/cd0ae780addb61eb3338a764f17363eaebda4707-1532x1064.jpg?auto=format)

1. Selecione **Editar**. 

2. Em *provisionamento*, selecione SCIM. 




![Selecting SCIM for the provisioning](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/32f4f3517f3c122f95206f875fc1a633da4f363c-1402x932.jpg?auto=format)

1. Clique em **Save**. 

2. Clique na guia **Provisionamento** . 

3. Selecione **Editar** para abrir a página *Conexão SCIM* (mostrada abaixo).




![SCIM Connection page with no information](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/bf2ed2bdecfe32dac1a0d3a6f205207550e0b9ec-1504x936.jpg?auto=format)

1. Em *base URL do conector SCIM*, cole a base URL da Klaviyo.

2. Em **Campo de identificador exclusivo para usuários**, insira `userName`.

3. Em *Ações de provisionamento compatíveis*, marque as seguintes caixas de seleção: 

   - Importar Novos Usuários e Atualizações de Perfil

   - Enviar por push novos usuários

   - Atualização de perfil por push

4. Altere a opção *Modo de autenticação* para Cabeçalho HTTP. 

5. Cole a chave de acesso em *Authorization*. 




![How the SCIM Connection should look once filled out](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/ee81dac0340dad5f05f67737b2d05c906b5caf3d-1370x1240.jpg?auto=format)

1. Clique em **Testar configuração do conector**. 

2. Clique em **Save**.

3. Ao lado de *Provisionamento para o aplicativo*, clique em **Editar**. 

4. Marque **Ativar** para os seguintes recursos:

   - *Criar usuários*.

   - *Atualizar atributo do usuário*.

   - *Desativar usuários.*




![Enabled features in the Provisioning to App page](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5cc58663e58852e2823099e7b26fc72e7ec152ab-1432x1030.jpg?auto=format)

1. Clique em **Save**. 

2. Role para baixo até a seção de mapeamentos de atributos do seu app. 

3. Clique em **Ir para o Editor de Perfil**. 

4. Clique em **Adicionar atributo**. 




![Top of the Profile Editor page in Okta, showing the button to add an attribute](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/dbf24920acf9064d8ec7051ddbbd827843f964fe-1902x990.jpg?auto=format)

1. Digite "role" em *Nome de exibição*, *Nome da variável* e *Nome externo*.

2. Em *Namespace externo*, insira o seguinte:
urn:ietf:params:scim:schemas:core:2.0:User

3. Marque a caixa para **Definir lista enumerada de valores**.




![The first of the required settings for the role attribute](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/0e5af7589c743dacfba059e0ca3c60248dc713fe-1206x1182.jpg?auto=format)

1. Para uma conta, adicione os valores de função padrão abaixo. Para um portfólio, use `portfolio_admin`, `portfolio_manager` e `portfolio_analyst`.

   - Administrador

   - Gerente

   - Analista

   - campaign_coordinator

   - content_creator

   - `social_media_manager`

   - Suporte



![All roles with the correct values for the role attribute](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/6eda8fdb14d554a973b664f10a37db4187e0fbab-1218x700.jpg?auto=format)

1. Role até *Atributo obrigatório* e marque **Sim**. 

2. Escolha o tipo de atributo (pessoal ou de grupo).

3. Recomendado: deixe a *permissão do usuário* como **Somente leitura**. 




![The rest of the required settings for the role attribute](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5f9b2415437bc851d3bcee4641ec82af25d9e651-1226x1084.jpg?auto=format)

1. Clique em **Save**. 

2. Vá para **Aplicativos > Aplicativos** e selecione o seu app. 

3. Clique em **Atribuir**.

4. Escolha se deseja atribuir o aplicativo a um indivíduo (ou seja, pessoas) ou a um grupo.




![Assignments tab showing the Assign dropdown](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/f8ac7eddfee80113ff4d842487933254f46c9122-1528x648.jpg?auto=format)

1. Encontre as pessoas ou os grupos aos quais você quer atribuir o Klaviyo e clique em **Atribuir** ao lado do(s) nome(s) deles.




![Example of searching for a user to assign to an app](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/39a3d77341742a0cc06d5b2f5ea6114befecccbd-1386x1204.jpg?auto=format)

1. Role a página para baixo até o campo *função* e atribua a ela a função correta. 




![Role dropdown, showing all the values for roles within Klaviyo](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/f0f8e1554a5a688effe6a81c06b475f91ddffd95-1246x1162.jpg?auto=format)

1. Clique em **Salvar e voltar**.

**▸ OneLogin**

1. No Portal do Administrador, clique em **Aplicativos**.

2. Clique em **Adicionar aplicativo**.

3. Pesquise "Klaviyo."

4. Clique em **Klaviyo** para adicioná-lo. 

5. Opcional: renomeie a conexão.

6. Clique em **Configuração.**

7. No campo Token do *Portador SCIM* , cole sua chave de acesso SCIM.

8. Clique em **Ativar** em *Conexão de API*. 

9. Clique em **Save**.

10. Acesse **Provisionamento** na barra lateral esquerda. 

11. Marque a caixa **Ativar provisionamento** . 

12. Não desmarque as caixas *Criar usuário*, *Excluir usuário* ou *Atualizar usuário*.




![Credential details section with the correct settings](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/4b1d052204480c1b7fbe1afc37c5ac38bfa9ea08-1999x886.png?auto=format)

1. Recomendado: selecione **Excluir** no menu suspenso para *Quando os usuários forem excluídos no OneLogin, ou o acesso do usuário ao app for removido, execute a ação abaixo*.

2. Clique em **Save**.

**▸ Microsoft Entra ID (antes Azure AD)**

Para navegar pela configuração atual, consulte o [guia de provisionamento SCIM da Microsoft](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/use-scim-to-provision-users-and-groups#integrate-your-scim-endpoint-with-the-microsoft-entra-provisioning-service). Use o URL do Klaviyo, a chave de acesso e os mapeamentos abaixo.

1. Faça login no [Microsoft Entra ID](https://portal.azure.com/#home.).

2. Clique em **Microsoft Entra ID** (antes chamado de “Azure Active Directory”)

3. Clique em **Enterprise Applications** no lado esquerdo.




![The Enterprise applications option in the left sidebar](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7ef2e67f17ae3b691ad6c44c432f8c2d684e9d52-554x1074.png?auto=format)

1. Selecione seu aplicativo. 

   - Se você ainda não criou seu aplicativo, siga as etapas no [guia de SSO](https://help.klaviyo.com/hc/en-us/articles/9353860331035.md).

2. Clique em **Provisionamento** à esquerda e selecione **Começar**.




![Left sidebar for app when Provisioning is highlighted](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/2e95755be0e4880159fb79bb73f68696a1e1ebce-522x1034.png?auto=format)

1. No campo chamado *Modo de provisionamento*, selecione **Automático**.




![Changing the Provisioning mode to automatic](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/6190e3793cfb042ded8c5b1273698d1bdbcd3ee2-1458x1106.png?auto=format)

1. Acesse *Credenciais do Administrador*.

2. Cole a base URL do SCIM do Klaviyo no campo *URL do locatário*.

3. Cole a chave de API do SCIM no campo *Token secreto*. Observe que esse token deve ser colado sem nenhum prefixo (por exemplo, não inclua "Bearer" ou "Klaviyo-chave de API").

4. Teste a conexão.

5. Depois que a conexão for bem-sucedida, clique em **Salvar** no canto superior esquerdo.

6. Nessa mesma página, role para baixo e abra o menu suspenso **Mapeamentos** .  




![Mappings dropdown to provision (in order) Azure AD groups or users](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/80bcde2e560948a3dbb3d4a327cef66832d15a65-1470x508.png?auto=format)

1. Selecione **Provisionamento de usuários do Azure Active Directory**. 

2. Opcional: exclua mapeamentos não compatíveis. A Klaviyo oferece suporte aos seguintes atributos de destino para atualizações de usuário:

   - `userName`

   - `active`

   - `emails[type eq "work"].value`

   - `name.givenName`

   - `name.familyName`

   - `emails[primary eq "True"].value`

   - `roles[primary eq "True"].value`

3. Para mapear uma função de app atribuída, use `SingleAppRoleAssignment([appRoleAssignments])` como um mapeamento de **Expressão** para `roles[primary eq "True"].value`.

   - Não mapeie `appRoleAssignments` diretamente para a Klaviyo.

   - Atribua 1 função do aplicativo por usuário e limite o provisionamento aos usuários e grupos atribuídos. Esta expressão não oferece suporte à sincronização de todos os usuários e grupos. Veja a [orientação da Microsoft sobre mapeamento de funções](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/customize-application-attributes#provisioning-a-role-to-a-scim-app).

4. Clique em **Salvar** e depois clique em **Início**. 

5. Volte para **Microsoft Entra ID > Enterprise applications > Klaviyo > provisionamento**. 

6. Selecione **Iniciar provisionamento**.




![Provisioning tab, showing the start provisioning button](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/b24b25acb81ce55111edb8dab37cec92e15b2bf6-1136x388.png?auto=format)

Agora, o Microsoft Entra ID vai começar a fazer o provisionamento dos seus usuários em uma programação. Para ter mais insights sobre quais usuários ele provisionou, selecione **Ver logs de provisionamento**.

## Recursos adicionais

- [Como configurar o logon único (SSO)](https://help.klaviyo.com/hc/pt-br/articles/9353860331035.md)
  Saiba como configurar o logon único (SSO) para sua conta ou portfólio da Klaviyo. No momento, apenas o logon único do provedor de identidade (IdP) é compatível com a Klaviyo.
- [Solucione problemas de erros de SSO e SCIM](https://help.klaviyo.com/hc/pt-br/articles/9674090873883.md)
  Saiba como solucionar problemas de erros de logon único (SSO) com a Klaviyo. Este artigo é destinado a quem tem familiaridade com SSO, como profissionais de TI. 
- [Como funciona a cobrança na Klaviyo](https://help.klaviyo.com/hc/pt-br/articles/115000976672.md)
  Saiba como a Klaviyo cobra os clientes por perfis e e-mails, mensagens móveis, avaliações, Advanced Klaviyo Data Platform (anteriormente "CDP"), Marketing Analytics, Customer Hub, Helpdesk e Customer Agent.  
