O que você vai aprender

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

O senhor deve ter um plano pago e ser um administrador ou proprietário para configurar esse recurso.

Antes de começar

O senhor também deve ter o SSO ativado no Klaviyo antes de configurar o SCIM.

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

Ativar o provisionamento de usuários do SCIM

  1. Clique no nome de sua organização no canto inferior esquerdo.
  2. Clique em Settings (Configurações) > Security (Segurança).
Guia Segurança nas configurações da conta
Guia Segurança nas configurações da conta
  1. Marque a caixa SCIM Provisioning (Provisionamento SCIM ).
  2. Copie ou faça o download da chave de acesso, incluindo o prefixo Klaviyo-API-Key.
    Observe que essa chave é exibida apenas uma vez, portanto, certifique-se de que o senhor pode acessá-la. Se o copiar, cole-o imediatamente em um local seguro.
Exemplo de uma chave de acesso
Exemplo de uma chave de acesso
  1. Clique em Done (Concluído).
  2. Copie o URL da base e cole-o em algum lugar, de preferência onde o senhor armazenou a chave de acesso.

Em seguida, o senhor deve ir ao seu provedor de SSO para concluir o processo. Esse processo varia de acordo com o provedor. Abaixo, temos instruções para o OKTA, One Login e Azure, embora o senhor possa configurá-lo usando qualquer outro provedor.

OKTA
  1. Navegue até o aplicativo > Applications.
  2. Selecione o aplicativo Klaviyo.
  3. Vá para a guia Sign On (Acessar ).
Quatro guias para um aplicativo com SSO: General, Sign On, Import e Assignments
Quatro guias para um aplicativo com SSO: General, Sign On, Import e Assignments
  1. Em Credential Details (Detalhes da credencial), verifique isso:
    • O formato do nome de usuário do aplicativo está definido como E-mail.
    • Atualizar o nome de usuário do aplicativo em está definido como Criar e atualizar.
Seção Credental Details na guia Sign On
Seção Credental Details na guia Sign On
  1. Clique na guia General (Geral ).
Guia Geral do aplicativo, quando não há provisionamento
Guia Geral do aplicativo, quando não há provisionamento
  1. Selecione Edit.
  2. Em Provisioning (Provisionamento), selecione SCIM.
Seleção do SCIM para o provisionamento
Seleção do SCIM para o provisionamento
  1. Clique em Salvar.
  2. Clique na guia Provisioning (Provisionamento ).
  3. Selecione Edit (Editar ) para abrir a página SCIM Connection (Conexão SCIM ) (mostrada abaixo).
Página de conexão SCIM sem informações
Página de conexão SCIM sem informações
  1. No URL de base do conector SCIM, cole o URL de base do Klaviyo.
  2. No campo Unique identifier (Identificador exclusivo) para usuários, digite "userName".
  3. Em Ações de provisionamento com suporte, marque as seguintes caixas:
    • Importar novos usuários e atualizações de perfil
    • Enviar novos usuários
    • Atualização do perfil push
  4. Altere a opção Authentication Mode (Modo de autenticação ) para HTTP Header (Cabeçalho HTTP).
  5. Cole a chave de acesso em Authorization (Autorização).
Como a conexão SCIM deve ficar depois de preenchida
Como a conexão SCIM deve ficar depois de preenchida
  1. Clique em Test Connector Configuration.
  2. Clique em Salvar.
  3. Ao lado de Provisioning to App (Provisionamento para aplicativo), clique em Edit (Editar).
  4. Marque Enable para os seguintes recursos:
    • Criar usuários.
    • Atualizar atributo de usuário.
    • Desativar usuários.
Recursos ativados na página Provisionamento para aplicativo
Recursos ativados na página Provisionamento para aplicativo
  1. Clique em Salvar.
  2. Role para baixo até a seção de mapeamentos de atributos do seu aplicativo.
  3. Clique em Go to Profile Editor.
  4. Clique em Add Attribute (Adicionar atributo).
Parte superior da página do Profile Editor no Okta, mostrando o botão para adicionar um atributo
Parte superior da página do Profile Editor no Okta, mostrando o botão para adicionar um atributo
  1. Digite "role" para Display name, Variable name e External name.
  2. Em External namespace, digite o seguinte:
    urn:ietf:params:scim:schemas:core:2.0:User
  3. Marque a caixa para Definir lista enumerada de valores.
A primeira das configurações necessárias para o atributo de função
A primeira das configurações necessárias para o atributo de função
  1. Adicione as funções e os valores; os valores de função válidos são os seguintes:
    • administrador
    • gerente
    • analista
    • coordenador_de_campanha
    • criador de conteúdo
    • suporte
Todas as funções com os valores corretos para o atributo de função
Todas as funções com os valores corretos para o atributo de função
  1. Role para baixo até Attribute required (Atributo obrigatório ) e marque Yes (Sim).
  2. Escolha o tipo de atributo (pessoal ou de grupo).
  3. Recomendado: deixe a permissão de usuário como Read Only (Somente leitura).
O restante das configurações necessárias para o atributo de função
O restante das configurações necessárias para o atributo de função
  1. Clique em Salvar.
  2. Navegue até Aplicativos > Aplicativos e, em seguida, selecione o aplicativo.
  3. Clique em Assign.
  4. Escolha se deseja atribuir o aplicativo a um indivíduo (ou seja, pessoas) ou a um grupo.
Guia Atribuições mostrando o menu suspenso Atribuir
Guia Atribuições mostrando o menu suspenso Atribuir
  1. Encontre as pessoas ou os grupos aos quais deseja atribuir o Klaviyo e clique em Assign (Atribuir ) ao lado dos respectivos nomes.
Exemplo de busca de um usuário para atribuir a um aplicativo
Exemplo de busca de um usuário para atribuir a um aplicativo
  1. Role para baixo até o campo de função e atribua a eles a função correta.
Dropdown de funções, mostrando todos os valores das funções no Klaviyo
Dropdown de funções, mostrando todos os valores das funções no Klaviyo
  1. Clique em Save (Salvar) e volte.
Um login
  1. No Portal do administrador, clique em Aplicativos.
  2. Clique em Add App.
  3. Pesquise "Klaviyo".
  4. Clique em Klaviyo para adicioná-lo.
  5. Opcional: Renomeie a conexão.
  6. Clique em Configuration.
  7. No campo SCIM Bearer Token (Token de portador SCIM), cole sua chave de acesso SCIM.
  8. Clique em Enable (Ativar ) em API Connection (Conexão de API).
  9. Clique em Salvar.
  10. Vá para Provisioning (Provisionamento ) na barra lateral esquerda.
  11. Marque a caixa Enable Provisioning (Ativar provisionamento ).
  12. Não desmarque as caixas Create user (Criar usuário), Delete user (Excluir usuário) ou Update user (Atualizar usuário ).
Seção de detalhes da credencial com as configurações corretas
Seção de detalhes da credencial com as configurações corretas
  1. Recomendado: selecione Excluir no menu suspenso para Quando os usuários forem excluídos no OneLogin ou o acesso ao aplicativo do usuário for removido, execute a ação abaixo.
  2. Clique em Salvar.
Microsoft Entra ID (antigo Azure AD)
  1. Faça login no Microsoft Entra ID.
  2. Clique em Microsoft Entra ID (anteriormente chamado de "Azure Active Directory")
  3. Clique em Enterprise Applications no lado esquerdo.
A opção Aplicativos empresariais na barra lateral esquerda
A opção Aplicativos empresariais na barra lateral esquerda
  1. Selecione seu aplicativo.
    • Se o senhor ainda não tiver criado seu aplicativo, siga as etapas do guia SSO.
  2. Clique em Provisioning (Provisionamento ) à esquerda e selecione Get Started (Iniciar).
Barra lateral esquerda do aplicativo quando o Provisionamento está destacado
Barra lateral esquerda do aplicativo quando o Provisionamento está destacado
  1. No campo denominado Provisioning Mode (Modo de provisionamento), selecione Automatic (Automático).
Alteração do modo de provisionamento para automático
Alteração do modo de provisionamento para automático
  1. Vá para Credenciais de administrador.
  2. Cole o URL da base SCIM do Klaviyo no campo Tenant URL (URL do locatário ).
  3. Cole a chave da API do SCIM no campo Secret Token (Token secreto ). Observe que esse token deve ser colado sem nenhum prefixo (por exemplo, não inclua "Bearer" ou "Klaviyo-API-Key").
  4. Teste a conexão.
  5. Quando a conexão for bem-sucedida, clique em Save (Salvar ) no canto superior esquerdo.
  6. Nessa mesma página, role a tela para baixo e abra o menu suspenso Mappings (Mapeamentos ).
Lista suspensa de mapeamentos para provisionar (em ordem) grupos ou usuários do Azure AD
Lista suspensa de mapeamentos para provisionar (em ordem) grupos ou usuários do Azure AD
  1. Selecione Provisionar usuários do Azure Active Directory.
  2. Opcional: excluir atributos não suportados. Observe que o Klaviyo suporta apenas os seguintes atributos na colunaAttribute do customappsso para o SCIM:
    • "nome do usuário"
    • "ativo"
    • E-mail[type eq "work"].value'
    • "name.givenName"
    • "name.familyName"
    • E-mail[primary eq "True"].value'
    • roles[primary eq "True"].value'
    • SingleAppRoleAssignment([appRoleAssignments])
      • Não há suporte para appRoleAssignments
      • Use "Expression" como tipo de mapeamento se você estiver usando SingleAppRoleAssignment
  3. Clique em Save e depois em Home.
  4. Navegue de volta para o Microsoft Entra ID > Aplicativos corporativos > Klaviyo > Provisionamento.
  5. Selecione Start Provisioning (Iniciar provisionamento).
Guia Provisionamento, mostrando o botão Iniciar provisionamento
Guia Provisionamento, mostrando o botão Iniciar provisionamento

Agora, o Microsoft Entra ID começará a provisionar seus usuários de acordo com uma programação. Para obter mais informações sobre quais usuários foram provisionados, selecione View provisioning logs (Exibir registros de provisionamento).

Recursos adicionais

  • Como configurar o logon único (SSO)

    Saiba como configurar o logon único (SSO) para sua conta ou portfólio da Klaviyo. Atualmente, apenas o logon único fornecido pela identidade (IdP) é compatível com o Klaviyo.

  • Solucionar erros de SSO e SCIM

    Saiba como solucionar erros de logon único (SSO) com o Klaviyo. Este artigo é destinado a pessoas familiarizadas com o SSO, como profissionais de TI.

  • Como funciona a cobrança na Klaviyo

    Saiba como a Klaviyo faz a cobrança dos clientes de perfis e e-mails, mensagens móveis, avaliações, Advanced Klaviyo Data Platform (anteriormente "plataforma de dados do cliente"), Marketing Analytics, Customer Hub, Helpdesk e 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