O Single Sign-On para o aplicativo HubSpot permite login seguro em landing pages, blogs e outras páginas do HubSpot CMS usando o Keycloak como provedor de OAuth. Ele suporta recursos avançados de Single Sign-On (SSO), como mapeamento de atributos de perfil de usuário, etc.
Aqui, apresentaremos um guia para configurar o SSO entre o HubSpot e o Keycloak. Ao final deste guia, os usuários deverão conseguir fazer login no HubSpot a partir do Keycloak. Para saber mais sobre o Single Sign-On para o HubSpot e outras integrações do HubSpot, você pode:
Clique aqui.
Não hesite em contactar-nos em hubapps@xecurify.com para saber mais sobre como instalar o Single Sign-On para HubSpot.
Pré-requisitos: Download e instalação
Etapas para configurar o Single Sign-On para o HubSpot Login com o Keycloak como Provedor de Identidade
Etapa 1: configurar o Keycloak como provedor OAuth
- Primeiro de tudo, Baixar Keycloak e instalá-lo.
- Inicie o servidor keycloak com base na sua versão do keycloak. (Veja a tabela abaixo)
| Para o Keycloak versão 17 e superior |
Vá para o diretório raiz do keycloak caixa kc.bat e execute os comandos abaixo.
1. compilação kc.bat
2. kc.bat start-dev
|
- Adicionar Realm: Agora faça login em Console de administração do Keycloak e navegue até o reino desejado. Clique em mestre e depois Criar reino botão.
- Entrar Nome do Reinoe clique em Criar botão.
- Criar cliente OpenID: Clique no Clientes e escolha Criar cliente para criar um novo cliente. Digite ID do Cliente (Pode ser qualquer número de caractere, etc. Mantenha-o à mão, pois precisaremos dele mais tarde ao configurar o aplicativo miniOrange Single Sign-On) e selecione o protocolo do cliente openeid-connect e clique Seguinte.
- permitir que o Autenticação de cliente e Autorização alternar e clicar em Próximo.
- De acordo com o relatório Configurações de login e digite seu URL de redirecionamento/retorno de chamada válido que você obterá do seu aplicativo miniOrange Single-sign-on presente no lado do cliente em Campo de texto de URLs de retorno de chamada.
- Vou ao Credenciais guia, copie o Segredo do cliente e mantenha-o à mão, pois precisaremos dele mais tarde ao configurar o aplicativo miniOrange Single Sign-On.
- Adicionar usuário: Precisamos adicionar usuários ao domínio que possam realizar o SSO para obter seu conteúdo do HubSpot. Clique em Utilizadores e clique em Crie um novo usuário para adicionar um novo usuário.
- Agora você pode criar um usuário preenchendo os detalhes necessários e clicando em Criar botão.
- Agora, vá para Credenciais para definir a senha para o usuário criado. Clique no Definir senha botão.
- Digite a senha de sua escolha e clique em Economize botão.
Etapa 2: Configurar o cliente OAuth do HubSpotas
- Vou ao Aplicativo miniOrange Single Sign-On (SSO) e faça login com suas credenciais.
- Selecione sua conta clicando em Escolher conta botão.
- Depois disso, clique em ícone certo para acessar o aplicativo.
- Acesse o painel do aplicativo Single Sign On do miniOrange e clique em Configurações de aplicativos aba.
- Aqui, selecione sua aplicação e clique nele. Se o seu aplicativo não estiver presente aqui, você pode criar um OAUTH 2.0 personalizado ou OIDC (protocolo Open ID Connect) aplicativo conforme a implementação do seu provedor.
- Introduzir o Texto do botão de login e copie o URL de retorno de chamada para configurar o Provedor de Identidade (aplicativo de terceiros) com o qual você gostaria de se autenticar.
- Agora, para configurar o Single Sign-On (OAuth SSO) do Provedor de Identidade, você precisará inserir o ID do cliente, Segredo do cliente,e Escopo, e habilitar Enviar no cabeçalho e Pontos finais da Keycloak (consulte a tabela abaixo).
| ID do cliente: |
do step 1 acima |
| Segredo do cliente: |
do step 1 acima |
| Escopo: |
código aberto |
| Configuração de Cabeçalho/Corpo |
Habilitar tanto o Cabeçalho quanto o Corpo
|
| Autorizar ponto final: |
https://<keycloak domain>/realms/{realm-name}/protocol/openid-connect/auth |
| Ponto final do token de acesso: |
https://<keycloak domain>/realms/{realm-name}/protocol/openid-connect/token |
| Obter informações do usuário Endpoint: |
https://<keycloak domain>/realms/{realm-name}/protocol/openid-connect/userinfo |
- Quando tiver preenchido todos os detalhes, clique em Salvar e testar configuração botão.
- Após o login bem-sucedido, você verá todos os valores retornados pelo seu Keycloak para o HubSpot em uma tabela.
Etapa 3: Configurar restrição de página no HubSpot (site, landing pages, blogs, base de conhecimento)
Os nossos Recurso de restrição de página permite que você proteja seu site HubSpot contra acesso não autorizado. É útil para proteger informações confidenciais. Usando este método, você pode restringir o acesso às páginas/conteúdo do HubSpot. Os visitantes precisarão fazer login antes de acessar as páginas do HubSpot.
- Após receber o resultado da configuração do teste, clique no botão Restrição de página aba.
- Selecione os checkbox ao lado da página que deseja proteger de usuários não autorizados e clique Economize para salvar as informações.
- Ao acessar a URL da página que você restringiu, você verá a janela de login do seu provedor de identidade, onde você inserirá suas credenciais.
- Após efetuar login, você será redirecionado com sucesso para a página do site.
Etapa 4: Configurar a sincronização de contatos no HubSpot
A sincronização de contatos é um recurso poderoso que permite a integração e sincronização perfeitas de informações de contato entre o HubSpot e plataformas ou aplicativos externos. Com a Sincronização de Contatos, você pode garantir que seus os dados do cliente estão atualizados, precisos, e consistente em vários sistemas, economizando seu tempo e eliminando a entrada manual de dados.
- Para sincronizar os detalhes de contato, vá para Configurações de APP guia e escolha o provedor que você criou.
- Clique no Editar ícone abaixo do Mapeamento de Atributos de Contato opção.
- Você verá o Atributos de contato e atributos IDP do HubSpot opção, mapeie seu atributo de contato do HubSpot com um aplicativo de terceiros / atributo IDP recebido no resultado da configuração de teste. Além disso, se vários atributos forem necessários, você pode adicioná-los usando o Mapeamento de atributos personalizados opção.
- Depois de adicionar todos os atributos, certifique-se de ter habilitado o Sincronização de contatos opção. Clique no Economize botão.
- Agora você pode encontrar o contato no HubSpot Contacts. Esta é uma ótima maneira de gerar leads, pois permite adicionar novos contatos aos seus pipelines de vendas e marketing da HubSpot de forma rápida e fácil. A sincronização de contatos permite que você garanta que seus A conta HubSpot é sempre atualizada com as informações mais recentes sobre seus leads e clientes (visitantes do site), o que pode ajudar você a gerar leads mais qualificados.
Etapa 5: Como desinstalar nosso aplicativo de um portal HubSpot
- Para desinstalar nosso aplicativo, acesse sua conta HubSpot e clique em Configurações ícone.
- Acesse ERP e SAP e clique em Apps conectados.
- Você verá a lista de aplicativos, selecione nosso aplicativo e clique em Ação botão. E então clique em unistall opção.
- Digite "desinstalar" abaixo para continuar e clique desinstalação botão.
Etapa 6: Como desconectar o aplicativo do HubSpot?
- Vou ao Restrição de página aba.
- Desmarque suas páginas do HubSpot conforme mostrado na captura de tela abaixo e clique em Economize botão. Isso desconectará nosso aplicativo para SSO do seu portal HubSpot.
Parabéns! Você desconectou com sucesso o aplicativo HubSpot Single Sign-On by miniOrange.
Solução de problemas / Perguntas frequentes
Como a desconexão e a desinstalação afetam as contas e os dados dos usuários do HubSpot?
A desinstalação remove o aplicativo e suas configurações, impedindo que os usuários acessem as páginas do HubSpot por meio do Single Sign-On (SSO). A desconexão apenas desvincula as páginas do SSO, deixando as configurações do aplicativo intactas e permitindo que as páginas sejam reconfiguradas para acesso via SSO novamente.
Recebo o seguinte: {"status":"failed","message":"Erro ao buscar o token do provedor OAuth."}
- Certifique-se de ter verificado um ou ambos das seguintes caixas de seleção em “Configuração do aplicativo HubSpot" configuração.
- Se o seu IdP precisar das credenciais no cabeçalho, você precisará verificar o cabeçalho caixa de seleção.
- Economize a configuração e então clique configuração de teste.
- Se isso não resolver o seu problema, você pode tentar selecionar ambos cabeçalho e Corpo caixas de seleção.
- Da mesma forma, se o seu IdP precisar das credenciais no corpo, você deve selecionar Corpo caixa de seleção.
- Depois de marcar as caixas de seleção apropriadas, você obterá a tabela de atributos na janela de configuração de teste.
Minha configuração de teste foi bem-sucedida, mas quando tento fazer login, fico preso em um loop de redirecionamento.
Há algumas razões pelas quais isso pode acontecer:
1. O cache está habilitado no site.
Quando o redirecionamento automático está habilitado, o usuário é redirecionado para a página de login do IDP e, após efetuar login, retorna ao site principal, mas como o cache está habilitado, ele redireciona para a página de login do IDP, causando um loop.
2. Discrepância HTTP/HTTPS:
Isso acontece quando o HTTPS não é imposto no site, mas está configurado no lado do IDP com URL HTTPS. Isso pode ser resolvido impondo o HTTPS no site definindo uma regra de redirecionamento no arquivo .htaccess ou no nível do Apache.
3. Adulteração de cookies:
O cookie criado pelo plugin após o login do usuário é alterado por outro plugin, o que faz com que o usuário não efetue login no site WordPress, mas a sessão é criada no IDP.
Obtendo erro: 'Resposta inválida'
Podem haver 2 possibilidades:
- Ou seu aplicativo é compatível com o protocolo OAuth 2.0 e você o configurou com o protocolo OpenID Connect e vice-versa. Nesse caso, se você configurou o aplicativo usando o aplicativo OAuth 2.0 personalizado, reconfigure-o com o aplicativo OpenID Connect personalizado. Se você configurou o aplicativo usando o aplicativo OpenID Connect personalizado, reconfigure-o com o aplicativo OAuth 2.0 personalizado. Isso deve resolver o problema.
- Se a solução acima não funcionar, a outra possibilidade é que seu aplicativo/provedor não siga o protocolo padrão OAuth 2.0/OpenID Connect. Nesse caso, entre em contato com hubapps@xecurify.com com a documentação do formato de solicitação/resposta do seu aplicativo/provedor e o técnico entrará em contato com você com uma solução.
Estou recebendo a mensagem de erro "Resposta inválida recebida"
Para corrigir esse problema, configure o endpoint correto de Token e Informações do Usuário na tabela de endpoints do aplicativo SSO do HubSpot. Você pode confirmar o formato correto do endpoint em AQUI.
Recursos adicionais
Precisa de ajuda?
Envie-nos um e-mail hubapps@xecurify.com para orientação rápida (por e-mail/reunião) sobre sua necessidade e nossa equipe ajudará você a selecionar a melhor solução/plano adequado de acordo com sua necessidade.
