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.
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
- Clique no nome de sua organização no canto inferior esquerdo.
- Clique em Configurações > Segurança.

- Marque a caixa Provisionamento SCIM .
- 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.

- Clique em Concluído.
- 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.
- Navegue até Aplicativo > Aplicativos.
- Selecione o app da Klaviyo.
- Vá até a aba Fazer login .

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

- Clique na aba Geral .

- Selecione Editar.
- Em provisionamento, selecione SCIM.

- Clique em Save.
- Clique na guia Provisionamento .
- Selecione Editar para abrir a página Conexão SCIM (mostrada abaixo).

- Em base URL do conector SCIM, cole a base URL da Klaviyo.
- Em Campo de identificador exclusivo para usuários, insira
userName. - 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
- Altere a opção Modo de autenticação para Cabeçalho HTTP.
- Cole a chave de acesso em Authorization.

- Clique em Testar configuração do conector.
- Clique em Save.
- Ao lado de Provisionamento para o aplicativo, clique em Editar.
- Marque Ativar para os seguintes recursos:
- Criar usuários.
- Atualizar atributo do usuário.
- Desativar usuários.

- Clique em Save.
- Role para baixo até a seção de mapeamentos de atributos do seu app.
- Clique em Ir para o Editor de Perfil.
- Clique em Adicionar atributo.

- Digite "role" em Nome de exibição, Nome da variável e Nome externo.
- Em Namespace externo, insira o seguinte:
urn:ietf:params:scim:schemas:core:2.0:User - Marque a caixa para Definir lista enumerada de valores.

- Para uma conta, adicione os valores de função padrão abaixo. Para um portfólio, use
portfolio_admin,portfolio_managereportfolio_analyst.- Administrador
- Gerente
- Analista
- campaign_coordinator
- content_creator
social_media_manager- Suporte

- Role até Atributo obrigatório e marque Sim.
- Escolha o tipo de atributo (pessoal ou de grupo).
- Recomendado: deixe a permissão do usuário como Somente leitura.

- Clique em Save.
- Vá para Aplicativos > Aplicativos e selecione o seu app.
- Clique em Atribuir.
- Escolha se deseja atribuir o aplicativo a um indivíduo (ou seja, pessoas) ou a um grupo.

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

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

- Clique em Salvar e voltar.
OneLogin
- No Portal do Administrador, clique em Aplicativos.
- Clique em Adicionar aplicativo.
- Pesquise "Klaviyo."
- Clique em Klaviyo para adicioná-lo.
- Opcional: renomeie a conexão.
- Clique em Configuração.
- No campo Token do Portador SCIM , cole sua chave de acesso SCIM.
- Clique em Ativar em Conexão de API.
- Clique em Save.
- Acesse Provisionamento na barra lateral esquerda.
- Marque a caixa Ativar provisionamento .
- Não desmarque as caixas Criar usuário, Excluir usuário ou Atualizar usuário.

- 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.
- 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.
- Faça login no Microsoft Entra ID.
- Clique em Microsoft Entra ID (antes chamado de “Azure Active Directory”)
- Clique em Enterprise Applications no lado esquerdo.

- Selecione seu aplicativo.
- Se você ainda não criou seu aplicativo, siga as etapas no guia de SSO.
- Clique em Provisionamento à esquerda e selecione Começar.

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

- Acesse Credenciais do Administrador.
- Cole a base URL do SCIM do Klaviyo no campo URL do locatário.
- 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").
- Teste a conexão.
- Depois que a conexão for bem-sucedida, clique em Salvar no canto superior esquerdo.
- Nessa mesma página, role para baixo e abra o menu suspenso Mapeamentos .

- Selecione Provisionamento de usuários do Azure Active Directory.
- Opcional: exclua mapeamentos não compatíveis. A Klaviyo oferece suporte aos seguintes atributos de destino para atualizações de usuário:
userNameactiveemails[type eq "work"].valuename.givenNamename.familyNameemails[primary eq "True"].valueroles[primary eq "True"].value
- Para mapear uma função de app atribuída, use
SingleAppRoleAssignment([appRoleAssignments])como um mapeamento de Expressão pararoles[primary eq "True"].value.- Não mapeie
appRoleAssignmentsdiretamente 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.
- Não mapeie
- Clique em Salvar e depois clique em Início.
- Volte para Microsoft Entra ID > Enterprise applications > Klaviyo > provisionamento.
- Selecione Iniciar provisionamento.

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.