Provisão de utilizadores do HubSpot com SCIM através do Okta

O aprovisionamento dos utilizadores através do SCIM (o Sistema de Gestão de Identidade de Domínios Cruzados) proporciona uma forma segura e automatizada de criar e gerir utilizadores do HubSpot através do Okta.

Abaixo, aprender como configurar o aprovisionamento do utilizador através do Okta.

Pré-requisitos

• O logon único (SSO) deve estar ativado na sua conta da HubSpot. 
• Recomenda-se configurar conjuntos de permissões de utilizador no HubSpot com base no Okta Roles da sua equipa antes de configurar o SCIM.
• Para definir permissões de utilizador, tem de criar conjuntos de permissões no HubSpot. O Okta pode então atribuir permissões a um utilizador se o seu papel no Okta corresponder ao nome do conjunto de permissões do HubSpot. 
• Para atribuir postos de trabalho pagos aos utilizadores configurados com o SCIM, deve primeiro comprar os postos de trabalho no HubSpot e criar um conjunto de permissões com um posto de trabalho pago. Em seguida, no Okta, defina a função do utilizador para ser a mesma que a permissão definida.
• Para verificar o seu domínio, terá de actualizar os seus registos DNS. Certifique-se de que tem os dados de login para o seu fornecedor DNS e de que tem acesso aos registos TXT.

Estabelecer o aprovisionamento do SCIM

Para configurar o aprovisionamento de utilizadores SCIM através do Okta, será necessário primeiro adicionar a aplicação HubSpot no Okta, depois atribuir utilizadores à aplicação:

• Iniciar sessão no Okta.
• No menu da barra lateral esquerda, seleccione Aplicações > Aplicações e, em seguida, procure e adicione a aplicação HubSpot na sua conta Okta.
• No ecrã da aplicação HubSpot, clique no separador Provisão, depois clique em Configurar Integração API.
  
  
• Seleccione a caixa de verificação Habilitar integração API, depois clique em Autenticar com HubSpot. Abrirá uma nova janela onde poderá dar acesso à sua conta HubSpot no Okta.
• Na janela HubSpot, seleccione com que conta deseja integrar o Okta, depois clique em Escolher conta.
• Clique em Ligar aplicação. A janela irá fechar-se, e será direccionado para a consola administrativa do Okta.
• Clique em Salvar.
• No separador Aprovisionamento , seleccione como pretende que o Okta aprovisione os utilizadores do HubSpot, clicando em Editar.
  
• Seleccione as caixas de verificação Activar ao lado de Criar Utilizadores, Actualizar Atributos de Utilizador e Desactivar Utilizadores para configurar a integração.
• Clique em Salvar.
• Em seguida, atribui utilizadores à aplicação da HubSpot.

Verifique o seu domínio

Depois de adicionar a aplicação HubSpot através do Okta, terá de verificar o seu domínio no HubSpot, actualizando os seus registos DNS. 

• Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
• No menu da barra lateral esquerda, navegar para Integrations > Connected Apps.
• Clique em Okta SCIM.

• No campo Domínio, introduza o domínio de envio de correio electrónico dos seus utilizadores.

• Clique em Salvar.
• Clique em Verifique-o agora.

• Na caixa de diálogo, seleccionar Seguinte.

• Copiar o valor na coluna Valor. Utilizará então este valor ao criar um novo registo TXT no seu fornecedor DNS
• Inicie sessão na sua conta de fornecedor DNS, depois crie um novo registo TXT para o domínio que está a verificar. Colar o valor copiado do HubSpot no campo Valor/Pontos Para/Alvo. 
• Depois de ter criado o registo TXT, navegue de volta ao HubSpot, depois clique em Next (Seguinte). Assim que as alterações do DNS se propagarem, o domínio será verificado.

Atenção: pode demorar até 48 horas para que as alterações do DNS se propaguem e reflictam no HubSpot.

Desactivar o aprovisionamento do SCIM

Para desactivar o aprovisionamento do SCIM no HubSpot, deve desinstalar o Okta SCIM no HubSpot antes de fazer quaisquer alterações na sua conta do Okta. 

• Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
• No menu da barra lateral esquerda, navegar para Integrations > Connected Apps.
• Sob a aplicação Okta SCIM, clique no menu suspenso Acções, depois clique em Desinstalar.
• Na sua conta Okta, os utilizadores tornar-se-ão editáveis e não serão mais sincronizados com SCIM.

Perguntas frequentes

Os utilizadores criados através do SCIM podem ser editados no HubSpot?

Não. Um utilizador criado através do SCIM só pode ser actualizado através do seu fornecedor de identidade. Isto inclui permissões de utilizador, nome de utilizador, e endereço de correio electrónico. 

Pode a Okta atribuir utilizadores a equipas?

Não. No entanto, depois de o utilizador ser adicionado ao HubSpot, pode atualizar a sua equipa manualmente no HubSpot.

O que acontece se eu apagar um utilizador SCIM no HubSpot ou no Okta?

A eliminação de um utilizador no HubSpot não irá eliminar o utilizador no Okta. No entanto, se remover o acesso de um utilizador ao HubSpot do Okta, ou desactivar a sua conta no Okta, o utilizador será eliminado no HubSpot. A adição de um utilizador ao HubSpot não adicionará o utilizador ao Okta.

O que acontece aos utilizadores existentes na minha conta HubSpot quando eu ligo o Okta?

Após configurar o SCIM através do Okta, quaisquer utilizadores existentes do HubSpot que correspondam aos utilizadores no Okta serão automaticamente convertidos em utilizadores SCIM. O HubSpot tentará atribuir ao utilizador um conjunto de permissões baseado no seu papel no Okta. Se o utilizador não tiver uma função no Okta que corresponda a uma permissão definida no HubSpot, o utilizador terá apenas permissões mínimas no HubSpot. 

Estou a ver o erro "Este domínio não pôde ser verificado", como é que eu corrijo isto?

Se estiver a ver este erro, certifique-se de que o seu domínio foi introduzido correctamente sem erros ortográficos. Verifique também se copiou o valor correcto para o registo TXT da etapa de Configuração no HubSpot para o seu fornecedor DNS.