Provisionar usuários do HubSpot com SCIM por meio do Okta

O provisionamento de usuários por meio do SCIM (Sistema de Gerenciamento de Identidade entre Domínios) fornece uma maneira segura e automatizada de criar e gerenciar usuários do HubSpot por meio do Okta.

Abaixo, aprenda como configurar o provisionamento de usuários através do Okta.

Pré-requisitos

• O logon único (SSO) deve estar habilitado na sua conta HubSpot. 
• É recomendado configurar conjuntos de permissões de usuário no HubSpot com base no Okta da sua equipe Funções antes de configurar o SCIM.
• Para definir permissões de usuário, você deve criar conjuntos de permissões no HubSpot. O Okta pode então atribuir permissões a um usuário se suas Funções no Okta corresponderem ao nome do conjunto de permissões HubSpot. 
• Para verificar seu domínio, você precisará atualizar os registros DNS. Verifique se você tem as informações de login do provedor de DNS e acesso aos registros TXT.
• A atribuição de assentos varia dependendo se você está ou não no modelo de preços baseado em assentos:
  • Se você não estiver em um modelo de preços baseado em assentos: atribuir assentos pagos para usuários configurados com SCIM, compre os assentos no HubSpot e criar um conjunto de permissões com um assento pago. Navegue de volta para Okta e defina as Funções do usuário para serem as mesmas do conjunto de permissões.
  • Se você estiver usando o modelo de preços baseado em assentos: você não pode atribuir assentos como assentos principais, Vendas ou Serviço Eixo assentos, ou assentos somente para visualização, com base em conjuntos de permissões atribuídos no Okta. Antes de atribuir permissões através do Okta, você precisará atualizar o assento de um usuário no HubSpot. 

Configurar o provisionamento SCIM

Para configurar o provisionamento de usuários do SCIM por meio do Okta, primeiro você precisará adicionar o aplicativo HubSpot no Okta e, em seguida, atribuir usuários ao aplicativo:

• Faça login no Okta.
• No menu da barra lateral esquerda, selecione Aplicações > Aplicações, então navegue por e adicione o aplicativo HubSpot na sua conta Okta.
• Na tela do aplicativo HubSpot, clique no botão Provisionamento aba, então clique Configurar integração de API.
  
  
• Selecione o Habilitar integração de API caixa de seleção e clique em Autenticar com HubSpot. Uma nova janela será aberta, onde você poderá dar ao Okta acesso à sua conta HubSpot.
• Na janela do HubSpot, selecione a conta com a qual deseja integrar o Okta e clique em Escolha a conta.
• Clique Conectar aplicativo. A janela será fechada e você será direcionado para o console de administração do Okta.
• Clique em Salvar.
• No Provisionamento guia, selecione como você deseja que o Okta provisione usuários para o HubSpot clicando em Editar.
   
• Selecione o Habilitar caixas de seleção ao lado de Criar usuários, Atualizar atributos do usuário, e Desativar usuários para configurar a integração.
• Clique em Salvar.
• Então, atribuir usuários ao aplicativo HubSpot.

Verificar seu domínio

Depois de adicionar o aplicativo HubSpot por meio do Okta, você precisará verificar seu domínio no HubSpot atualizando seus registros 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, acesse Integrações > Aplicativos conectados.
• Clique Okta SCIM.

• No Domínio campo, insira o domínio de envio de e-mail dos seus usuários.

• Clique em Salvar.
• Clique em Verificar agora.

• Na caixa de diálogo, selecione Próximo.

• Copie o valor na coluna Valor. Você usará esse valor ao criar um novo registro TXT no seu provedor de DNS
• Faça login na sua conta de provedor de DNS e crie um novo registro TXT para o domínio que você está verificando. Cole o valor copiado do HubSpot no campo Valor/Aponta para/Destino. 
• Depois de criar o registro TXT, volte ao HubSpot e clique em Próximo. Assim que as alterações de DNS se propagarem, o domínio será verificado.

Observação: pode levar até 48 horas para que as alterações do DNS sejam propagadas e refletidas no HubSpot.

Sincronizar funções do Okta com conjuntos de permissões do HubSpot

Para definir permissões de usuário, você deve criar conjuntos de permissões no HubSpot. O Okta pode então atribuir permissões a um usuário se suas Funções no Okta corresponderem ao nome exato do conjunto de permissões HubSpot, incluindo espaços e letras maiúsculas.

Para dar ao Okta acesso para atribuir conjuntos de permissões aos usuários:

• Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
• No menu da barra lateral esquerda, clique em Integrações > Aplicativos conectados.
• Sob Todos os aplicativos, clique Okta SCIM.
• Alternar Gerenciamento de conjunto de permissões sobre.

Desativar o provisionamento SCIM

Para desabilitar o provisionamento do SCIM no HubSpot, você deve desinstalar o Okta SCIM no HubSpot antes de fazer qualquer alteração 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, acesse Integrações > Aplicativos conectados.
• No aplicativo Okta SCIM, clique em Ações menu suspenso e clique em Desinstalar.
• Na sua conta Okta, os usuários se tornarão editáveis e não serão mais sincronizados com o SCIM.

Perguntas frequentes

Os usuários criados pelo SCIM podem ser editados no HubSpot?

Somente permissões de usuário podem ser editadas no HubSpot e somente se o gerenciamento de conjuntos de permissões não estiver configurado. Todas as outras informações do usuário, incluindo nome de usuário e endereço de email, só podem ser atualizadas através do seu provedor de identidade. 

Por que minhas funções atribuídas ao Okta não estão aparecendo no meu conjunto de permissões de usuário no HubSpot?

Você deve ativar o gerenciamento de Conjuntos de permissões no HubSpot para que as funções do Okta sejam sincronizadas com os conjuntos de permissões do HubSpot. O nome do conjunto de permissões no HubSpot deve corresponder aos nomes exatos de Funções no Okta, incluindo todos os espaços e letras maiúsculas.

O Okta pode atribuir usuários a equipes?

Não. No entanto, depois que o usuário for adicionado ao HubSpot, você pode atualizar sua equipe manualmente no HubSpot.

O que acontece se eu excluir um usuário SCIM no HubSpot ou Okta?

Excluir um usuário no HubSpot não excluirá o usuário no Okta. No entanto, se você remover o acesso de um usuário ao HubSpot do Okta ou desativar sua conta no Okta, o usuário também será desativado no HubSpot. Adicionar um usuário ao HubSpot não o adicionará ao Okta.

O que acontece com os usuários existentes na minha conta HubSpot quando conecto o Okta?

Após configurar o SCIM por meio do Okta, todos os usuários existentes do HubSpot que correspondem aos usuários do Okta serão automaticamente convertidos em usuários do SCIM. O HubSpot tentará atribuir ao usuário um conjunto de permissões com base em suas Funções no Okta. Se o usuário não tiver funções no Okta que correspondam às permissões definidas no HubSpot, ele terá apenas permissões mínimas no HubSpot. 

Estou vendo o erro "Este domínio não pôde ser verificado", como corrijo isso?

Se você receber esse erro, verifique se seu domínio foi inserido corretamente, sem erros ortográficos. Além disso, verifique se você copiou o valor correto para o registro TXT na etapa Configuração no HubSpot para o seu provedor de DNS.