SSO OAuth do HubSpot com WordPress como servidor OAuth | SSO do HubSpot usando WordPress
Visão geral
O logon único para o aplicativo HubSpot permite login seguro nas páginas de destino do HubSpot CMS, blogs e outras páginas usando o Wordpress como provedor OAuth. Ele oferece suporte a recursos avançados de logon único (SSO), como mapeamento de atributos de perfil de usuário, etc.
Aqui iremos percorrer um guia para configurar SSO entre HubSpot e WordPress. Ao final deste guia, os usuários devem conseguir fazer login no HubSpot a partir do WordPress. 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: Download e instalação
1. Etapas de instalação do aplicativo HubSpot
- Entrar na sua Conta HubSpot como administrador.
- Acesse aqui para instalar Login único para HubSpot da miniOrange ou você pode instalar nosso aplicativo de Mercado de aplicativos da HubSpot.
2. Etapas de instalação do plugin OAuth Server Single Sign-On (SSO) para WordPress
- Efetue login na sua instância do WordPress como administrador.
- Ir para o WordPress Painel >> Plugins e clique em adicionar Novo.
- Procurar por Plugin OAuth Server Single Sign-On (SSO) para WordPress e clique em Agora instale.
- Uma vez instalado, clique em Ativação.
Etapas de configuração
Etapa 1. Configurar o WordPress como provedor OAuth
- Acesse Servidor OAuth Plugin no WordPress e preencha o Nome do Cliente como desejar. Preencha também o URI de redirecionamento. Para saber como configurar o servidor OAuth no WordPress, clique aqui.
- Clique em Salvar cliente botão e você verá a seguinte tela. Anote o ID do cliente, segredo do cliente, endpoints e escopo para configurar o HubSpot.
Etapa 2. Configurar o HubSpot como cliente OAuth
- Vou ao Login único do HubSpot pela miniOrange 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 Configurar o WordPress como provedor de identidade (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 do WordPress (consulte a tabela abaixo).
| ID do cliente: | do step 1 acima |
| Segredo do cliente: | do step 1 acima |
| Escopo: | perfil de email |
| Configuração de Cabeçalho/Corpo | Habilitar tanto o Cabeçalho quanto o Corpo |
| Autorizar ponto final: | https://<your-site-url>/wp-json/moserver/authorize |
| Ponto final do token de acesso: | https://<your-site-url>/wp-json/moserver/token |
| Obter informações do usuário Endpoint: | https://<your-site-url>/wp-json/moserver/resource |
- Quando tiver preenchido todos os detalhes, clique em Salvar e testar configuração botão.
- Agora, um pop-up aparecerá. Clique Permitir botão.
- Você será redirecionado para a página de login do WordPress. Insira suas credenciais de usuário do WordPress para fazer login.
- Após a autenticação bem-sucedida, você verá a lista de Detalhes do perfil do usuário.
Etapa 3. Configurar a 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.
- Formato desinstalação abaixo para continuar e clicar 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.
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 no Configuração do aplicativo HubSpot criaçã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:
1. 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 e, 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.
2. 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.
Artigos Relacionados
Obrigado pela sua resposta. Entraremos em contato em breve.
Algo deu errado. Envie sua consulta novamente.
Entraremos em contato com você o mais breve possível!
Precisa de ajuda?
Envie-nos um e-mail hubapps@xecurify.com para orientação rápida (via e-mail/reunião) sobre sua necessidade e nossa equipe o ajudará a selecionar a solução/plano mais adequado de acordo com sua necessidade.
