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.

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 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
Security tab in Account settings
  1. Marque a caixa Provisionamento SCIM .
  2. 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
Example of an access key
  1. Clique em Concluído.
  2. 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. 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
Four tabs for an app with SSO: General, Sign On, Import, and Assignments
  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
Credental Details section in the Sign On tab
  1. Clique na aba Geral .
General tab for app, when there's no provisioning
General tab for app, when there's no provisioning
  1. Selecione Editar.
  2. Em provisionamento, selecione SCIM.
Selecting SCIM for the provisioning
Selecting SCIM for the provisioning
  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
SCIM Connection page with no information
  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
How the SCIM Connection should look once filled out
  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
Enabled features in the Provisioning to App page
  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
Top of the Profile Editor page in Okta, showing the button to add an attribute
  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
The first of the required settings for the role attribute
  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
All roles with the correct values for the role attribute
  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
The rest of the required settings for the role attribute
  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
Assignments tab showing the Assign dropdown
  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
Example of searching for a user to assign to an app
  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
Role dropdown, showing all the values for roles within Klaviyo
  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
Credential details section with the correct settings
  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. Use o URL do Klaviyo, a chave de acesso e os mapeamentos abaixo.

  1. Faça login no Microsoft Entra ID.
  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
The Enterprise applications option in the left sidebar
  1. Selecione seu aplicativo.
    • Se você ainda não criou seu aplicativo, siga as etapas no guia de SSO.
  2. Clique em Provisionamento à esquerda e selecione Começar.
Left sidebar for app when Provisioning is highlighted
Left sidebar for app when Provisioning is highlighted
  1. No campo chamado Modo de provisionamento, selecione Automático.
Changing the Provisioning mode to automatic
Changing the Provisioning mode to automatic
  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
Mappings dropdown to provision (in order) Azure AD groups or users
  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.
  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
Provisioning tab, showing the start provisioning button

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

  • How to set up single sign-on (SSO)

    Learn how to set up single sign-on (SSO) for your Klaviyo account or portfolio. Currently, only identity provided (IdP) single sign-on is supported in Klaviyo.

  • Troubleshoot SSO and SCIM errors

    Learn how to troubleshoot errors for single sign-on (SSO) with Klaviyo. This article is meant for those familiar with SSO, such as IT professionals.

  • How Klaviyo billing works

    Learn how Klaviyo bills customers for Profiles and Emails, Mobile Messaging, Reviews, Advanced Klaviyo Data Platform (formerly “CDP”), Marketing Analytics, Customer Hub, Helpdesk, and Customer Agent.

Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Parceiros
Contrate um especialista certificado pela Klaviyo para ajudá-lo com uma tarefa específica ou para gerenciamento contínuo de marketing.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano