Como configurar o SSO OAuth do HubSpot usando a loja Shopify como provedor de identidade (IdP)?
O Single Sign-On para HubSpot permite o login seguro em páginas de destino, blogs e outras páginas do HubSpot CMS usando o Shopify como provedor OAuth. Ele oferece suporte a recursos avançados de Single Sign-On (SSO), como mapeamento de atributos de perfil de usuário, etc.
Neste guia, vamos configurar o SSO entre o Salesforce e o Shopify. Ao final, os usuários poderão acessar o HubSpot diretamente do Shopify. Para saber mais sobre o Single Sign-On para 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: Login único - Aplicativo de login SSO
- Faça login na sua conta do Salesforce como administrador.
- Acesse aqui Para instalar o Single Sign-On para HubSpot da miniOrange, clique aqui. Ou você pode instalar nosso aplicativo em [link para o aplicativo]. Mercado de aplicativos da HubSpot .
- Na loja de aplicativos Shopify, instale o Armazenar como IdP - Login SSO em aplicativos por miniOrange.
Passos para configurar o Single Sign-On (SSO) para o login do HubSpot com o Shopify como provedor de identidade (IdP)
Etapa 1: configurar o Shopify como provedor OAuth
- Vá até sua loja Shopify, clique em Apps Guia e selecione Armazenar como login IDP-SSO aplicação.
- Na barra de navegação à esquerda, selecione Apps e clique em Adicionar aplicativo botão.
- Acesse OAuth/OIDC guia e selecione o nome do IDP como um OpenID Connect da lista.
- De acordo com o relatório Adicionar seção de aplicação Insira os valores consultando a tabela abaixo.
| Nome do Cliente | Escolha um nome apropriado de acordo com sua escolha |
| URI de redirecionamento/URI de retorno de chamada OAuth | Você obterá isso de Step2 |
| Descrição | Adicione uma descrição apropriada de acordo com sua escolha |
| Nome do grupo | PADRÃO |
| Nome da política | HubSpot |
| Método de login | Senha |
- Clique em Economize para salvar as configurações.
- Após salvar o aplicativo, clique em Selecionar e depois Editar opção do aplicativo que você acabou de configurar.
- Você receberá o ID do cliente, segredo do cliente, endpoints e escoposGuarde esses valores, pois você precisará deles mais tarde durante a configuração. Login único para HubSpot .
Etapa 2: configurar o HubSpot como cliente OAuth
- 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 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 do Shopify (aplicativo de terceiros).
- Agora, para configurar o Single Sign-On (OAuth SSO), você precisará inserir o ID do cliente, Segredo do cliente,e Escopo, e habilitar Enviar no Cabeçalho e Corpo e Pontos finais da Shopify (consulte a tabela abaixo).
| ID do cliente: | do step 1 acima |
| Segredo do cliente: | do step 1 acima |
| Escopo: | perfil de e-mail openid |
| Configuração de Cabeçalho/Corpo | Habilitar tanto o Cabeçalho quanto o Corpo |
| Pontos finais: | do step 1 acima |
- Quando tiver preenchido todos os detalhes, clique em Salvar e testar configuração botão.
- Você será redirecionado para a loja de aplicativos da Shopify, onde precisará inserir a senha do aplicativo e, em seguida, fazer login. Faça login com suas credenciais da Shopify.
- Após a autenticação bem-sucedida, você verá a lista com os detalhes do seu perfil de usuário.
Etapa 3: Configure a restrição de páginas no HubSpot (Site, Páginas de destino, 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 esse método, você pode restringir o acesso a 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 contra usuários não autorizados, clique em Economize para salvar as informações.
- Ao acessar o URL da página que você restringiu, você verá a janela de login do seu provedor de identidade, onde deverá 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ê garante que seus contatos estejam sempre atualizados. os dados do cliente estão atualizados, precisos, e consistente em vários sistemas, poupando-lhe 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 e 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 atributo de aplicativo/provedor de identidade de terceiros. recebido no resultado da configuração de testeAlém disso, se forem necessários vários atributos, 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 ContactsEsta é uma ótima maneira de gerar leads, pois permite adicionar novos contatos aos seus funis de vendas e marketing do HubSpot de forma rápida e fácil. A sincronização de contatos garante que seus A conta HubSpot está 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 de SSO do seu portal HubSpot.
Portanto, você conectou com sucesso o Single Sign-On do HubSpot usando a loja Shopify como provedor de identidade (IdP).
Perguntas Frequentes (FAQs)
Mais 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 remove as páginas do SSO, mantendo as configurações do aplicativo intactas e permitindo que as páginas sejam reconfiguradas para acesso SSO novamente.
Recebo a seguinte mensagem: {"status":"failed","message":"Erro ao buscar o token do provedor OAuth."}
- Certifique-se de ter marcado uma ou ambas as caixas de seleção a seguir nas configurações do aplicativo HubSpot.
- Se o seu IdP precisar das credenciais no cabeçalho, você precisará marcar a caixa de seleção "Cabeçalho".
- Salve a configuração e clique em "Testar configuração".
- Se isso não resolver o seu problema, você pode tentar selecionar as caixas de seleção "Cabeçalho" e "Corpo".
- Da mesma forma, se o seu IdP precisar das credenciais no corpo da requisição, você deverá selecionar a caixa de seleção "Corpo".
- 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á ativado, o usuário é redirecionado para a página de login do provedor de identidade (IdP) e, após fazer login, retorna ao site principal. No entanto, como o cache está ativado, ele é redirecionado para a página de login do IdP, criando um loop.
2. Discrepância HTTP/HTTPS:
Isso ocorre quando o HTTPS não é imposto no site, mas está configurado no lado do provedor de identidade (IdP) com uma 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 impede o login do usuário no site da Shopify, embora a sessão seja 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, ou vice-versa. Nesse caso, se você configurou o aplicativo usando um aplicativo OAuth 2.0 personalizado, reconfigure-o com um aplicativo OpenID Connect personalizado e, se você configurou o aplicativo usando um aplicativo OpenID Connect personalizado, reconfigure-o com um aplicativo OAuth 2.0 personalizado. Isso deve resolver o problema.
- Se a solução acima não funcionar, 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 sobre o formato de solicitação/resposta do seu aplicativo/provedor, um 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 corretamente o endpoint de informações de token e usuário na tabela de endpoints do aplicativo SSO do HubSpot. Você pode confirmar o formato correto do endpoint em AQUI.
Obrigado pela sua resposta. Entraremos em contato em breve.
Algo deu errado. Envie sua consulta novamente.
