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 SCIMAtivar o provisionamento de usuários do SCIM
- Clique no nome de sua organização no canto inferior esquerdo.
- Clique em Settings (Configurações) > Security (Segurança).
- Marque a caixa SCIM Provisioning (Provisionamento SCIM ).
- 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. - Clique em Done (Concluído).
- 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
- Navegue até o aplicativo > Applications.
- Selecione o aplicativo Klaviyo.
- Vá para a guia Sign On (Acessar ).
- 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.
- Clique na guia General (Geral ).
- Selecione Edit.
- Em Provisioning (Provisionamento), selecione SCIM.
- Clique em Salvar.
- Clique na guia Provisioning (Provisionamento ).
- Selecione Edit (Editar ) para abrir a página SCIM Connection (Conexão SCIM ) (mostrada abaixo).
- No URL de base do conector SCIM, cole o URL de base do Klaviyo.
- No campo Unique identifier (Identificador exclusivo) para usuários, digite "userName".
- 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
- Altere a opção Authentication Mode (Modo de autenticação ) para HTTP Header (Cabeçalho HTTP).
- Cole a chave de acesso em Authorization (Autorização).
- Clique em Test Connector Configuration.
- Clique em Salvar.
- Ao lado de Provisioning to App (Provisionamento para aplicativo), clique em Edit (Editar).
- Marque Enable para os seguintes recursos:
- Criar usuários.
- Atualizar atributo de usuário.
-
Desativar usuários.
- Clique em Salvar.
- Role para baixo até a seção de mapeamentos de atributos do seu aplicativo.
- Clique em Go to Profile Editor.
- Clique em Add Attribute (Adicionar atributo).
- Digite "role" para Display name, Variable name e External name.
- Em External namespace, digite o seguinte:
urn:ietf:params:scim:schemas:core:2.0:User - Marque a caixa para Definir lista enumerada de valores.
- 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
- Role para baixo até Attribute required (Atributo obrigatório ) e marque Yes (Sim).
- Escolha o tipo de atributo (pessoal ou de grupo).
- Recomendado: deixe a permissão de usuário como Read Only (Somente leitura).
- Clique em Salvar.
- Navegue até Aplicativos > Aplicativos e, em seguida, selecione o aplicativo.
- Clique em Assign.
- 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 deseja atribuir o Klaviyo e clique em Assign (Atribuir ) ao lado dos respectivos nomes.
- Role para baixo até o campo de função e atribua a eles a função correta.
- Clique em Save (Salvar) e volte.
Um login
- No Portal do administrador, clique em Aplicativos.
- Clique em Add App.
- Pesquise "Klaviyo".
- Clique em Klaviyo para adicioná-lo.
- Opcional: Renomeie a conexão.
- Clique em Configuration.
- No campo SCIM Bearer Token (Token de portador SCIM), cole sua chave de acesso SCIM.
- Clique em Enable (Ativar ) em API Connection (Conexão de API).
- Clique em Salvar.
- Vá para Provisioning (Provisionamento ) na barra lateral esquerda.
- Marque a caixa Enable Provisioning (Ativar provisionamento ).
- Não desmarque as caixas Create user (Criar usuário), Delete user (Excluir usuário) ou Update user (Atualizar usuário ).
- 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.
- Clique em Salvar.
Microsoft Entra ID (antigo Azure AD)
- Faça login no Microsoft Entra ID.
- Clique em Microsoft Entra ID (anteriormente chamado de "Azure Active Directory")
- Clique em Enterprise Applications no lado esquerdo.
- Selecione seu aplicativo.
- Se o senhor ainda não tiver criado seu aplicativo, siga as etapas do guia SSO.
- Clique em Provisioning (Provisionamento ) à esquerda e selecione Get Started (Iniciar).
- No campo denominado Provisioning Mode (Modo de provisionamento), selecione Automatic (Automático).
- Vá para Credenciais de administrador.
- Cole o URL da base SCIM do Klaviyo no campo Tenant URL (URL do locatário ).
- 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").
- Teste a conexão.
- Quando a conexão for bem-sucedida, clique em Save (Salvar ) no canto superior esquerdo.
- Nessa mesma página, role a tela para baixo e abra o menu suspenso Mappings (Mapeamentos ).
- Selecione Provisionar usuários do Azure Active Directory.
- Opcional: excluir atributos não suportados. Observe que o Klaviyo suporta apenas os seguintes atributos na colunaAttribute do customappsso para o SCIM:
- "userName",
- "ativo"
- emails[type eq "work"].value',
- "name.givenName",
- "name.familyName",
- emails[primary eq "True"].value',
- roles[primary eq "True"].value'
- Clique em Save e depois em Home.
- Navegue de volta para o Microsoft Entra ID > Aplicativos corporativos > Klaviyo > Provisionamento.
- Selecione Start Provisioning (Iniciar provisionamento).