Use um proxy reverso com a HubSpot

• Revisado as considerações para saber se deve configurar um proxy reverso.
• Configurado o proxy no seu ambiente externo. O guia inclui instruções gerais, bem como instruções específicas do provedor para Amazon CloudFront e nginx.
• Confirmado que a configuração está correta. Este guia também inclui etapas de solução de problemas se você estiver vendo um 404 erro durante esse processo.
• Adicionado o domínio à HubSpot para habilitar a criação de conteúdo na HubSpot.

​

Considerações

​

1. Configurar o proxy

​

Instruções gerais

1. Configure seu proxy para não executar nenhum cache para caminhos originados da HubSpot. O HubSpot gerencia automaticamente o conteúdo do cache do nosso CDN para que as páginas sejam atualizadas automaticamente quando o conteúdo é publicado. Observe que se o serviço armazenar respostas em cache, as páginas poderão não ser atualizadas por horas ou dias.
2. Adicionar ou acrescentar a um ​cabeçalho X-Forwarded-For​ com o endereço IP do cliente do solicitante original. Isso é necessário para diferenciar os clientes uns dos outros. Muitos serviços, como o CloudFront, mantêm esses cabeçalhos automaticamente.
3. Para garantir que o conteúdo personalizado com base na localização funcione, passe um cabeçalho estático de X-HubSpot-Trust-Forwarded-For: true​. Isso vai confiar no ​X-Forwarded-For​ cabeçalho, que pode não ter sido atualizado por todos os proxies upstream.
4. Passe um ​​ cabeçalho X-HS-Public-Host com um valor do seu domínio de destino.
5. Permitir todos os métodos HTTP.
6. Certifique-se de que um certificado SSL esteja provisionado e instalado para seu domínio proxy.
7. Encaminhe todas as strings de consulta.
8. Encaminhetodos​ os outros cabeçalhos de solicitação e resposta como estão, incluindo cookies.
9. O ideal é que todos os caminhos sob seu domínio sejam proxy para a HubSpot. Se esse não for o caso, os seguintes caminhos devem servir de proxy para que os ativos sejam carregados corretamente do seu domínio: /_hcms/*, /hs/*, /hubfs/*, hs-fs/hubfs/*, /hs-fs/*​, /cs/c/*, e /e3t/*.

​

2. Confirme se sua configuração está correta

• Você pode identificar problemas com a configuração nas configurações de domínio da HubSpot:
  • Na sua conta HubSpot, clique em ícone de configurações na barra de navegação principal.
  • No menu da barra lateral esquerda, navegue até Site > Domínios e URLs.
  • Ao lado do domínio que você está usando para seu proxy reverso, clique em Editar menu suspenso e selecione Verificar conexão de proxy reverso.
  • Clique em qualquer categoria que é rotulado como Fracassado para ver recomendações para corrigir o problema.
  • Depois de implementar suas correções, clique em Teste de atualização para verificar sua configuração novamente.

• Para todas as outras contas, para confirmar sua configuração, visite:https://[yourFullDomain]/_hcms/diagnostics
• Verifique as seguintes informações:
  • O valor de tempo atual muda a cada carga. Isso confirma que a página não está armazenada em cache.
  • O User-Agent é consistente com seu navegador.
  • O Accept-Language o valor é consistente com seu navegador.
  • O Accept-Encoding cabeçalho é *. Isso garante que as respostas sejam compactadas.
  • O Cookie o valor não está em branco.
  • O Protocol é https.
  • O endereço IP mais à esquerda em X-Forwarded-For corresponde ao seu endereço IP conforme relatado por um serviço como https://www.whatismyip.com.
  • O IP-Determined Location os valores são precisos para sua localização. Eles são baseados nos cabeçalhos relacionados ao IP em X-Forwarded-For.

​

Solução de problemas

• X-Forwarded-For
• X-HubSpot-Trust-Forwarded-For
• X-HS-Public-Host

​

Cliques registrados como eventos de bot

​

3. Adicione o domínio à HubSpot

• Na sua conta HubSpot, navegue até o seu configurações de domínio.
• Clique Conectar um domínio.
• Selecione Primário ou Secundário. Domínios de redirecionamento e envio de e-mail não são suportados por este recurso.
• Clique para alternar o Conecte-se à rede de distribuição de conteúdo (CDN) integrada do HubSpot desligue e clique Conectar.
• Selecione o tipo de conteúdo você estará hospedando no domínio, então clique Próximo.
• Entre no domínio da marca. Por exemplo, para www.site.com, você entraria site.com.

• Entre no subdomínio no qual você hospedará o conteúdo. O subdomínio precisa corresponder ao subdomínio do domínio hospedado externamente. Então clique Próximo.
• Revise o domínio que você inseriu e clique em Próximo.
• Em seguida, verifique seu domínio para que o HubSpot possa confirmar a propriedade do seu domínio e permitir a publicação de conteúdo:
  • No seu provedor de DNS, crie os registros usando os valores fornecidos.
  • No HubSpot, clique em Verificar. Pode levar até 4 horas para o HubSpot reconhecer as alterações feitas no seu provedor de DNS e verificar seu nome de host.

​

Instruções específicas do provedor

​

Configurar um proxy reverso no Amazon CloudFront

• Efetue login na sua conta do Amazon CloudFront.
• Na barra lateral esquerda, navegue até Distribuições.
• Se você estiver começando do zero, primeiro precisará criar uma nova distribuição clicando em Criar Distribuição. Alternativamente, você pode editar uma distribuição existente ou pular para o etapas de configuração de origem e comportamentos.
  • No Em geral aba, clique Editar.
  • No Nomes de domínio alternativos (CNAMEs) campo, adicione o domínio, incluindo o subdomínio. Isso deve corresponder ao domínio que você adicionou ao HubSpot.
  • Confirme suas alterações clicando em Sim, Editar. Você será então direcionado de volta para o Em geral aba onde seu domínio agora deve estar listado ao lado de Nomes de domínio alternativos (CNAMEs).
  • Você também precisará criar um novo registro CNAME no seu provedor de DNS usando o valor do Nome de domínio campo. Este valor deve ser algo como <value>.cloudfront.net.
• Em seguida, configure uma nova origem:
  • Clique no Origens e Grupos de Origem aba.
  • Clique Criar Origem, então configure sua origem:
    • No Domínio de origem campo, digite o <HubID>.<suffix> Valor CNAME do tabela acima. Este valor deve ser algo como 123.sites-proxy.hscoscdn20.net.
    • Sob Adicionar cabeçalho personalizado, clique Adicionar cabeçalho. Em seguida, adicione os seguintes detalhes do cabeçalho:
      • Para garantir que o conteúdo personalizado com base na localização funcione, passe um X-Client-IP cabeçalho com um valor do IP do usuário final (preferencial) ou passe um cabeçalho estático de X-HubSpot-Trust-Forwarded-For: true. Este último confiará no X-Forwarded-For cabeçalho, que pode não ter sido atualizado por todos os proxies upstream.
      • Passar um X-HS-Public-Host cabeçalho com um valor do seu domínio de destino.
  • Clique Criar para salvar suas alterações.
• Então, configure comportamentos de cache para os caminhos de página em que você hospedará o conteúdo do HubSpot:
  • Clique no Comportamentos aba.
  • Clique Criar comportamento.
  • No Padrão de caminho campo, insira o caminho da URL da página na qual seu conteúdo do HubSpot está hospedado. Pode ser um caminho para uma página específica ou uma URL flexível, como um curinga. Saiba mais sobre padrões de caminho.
  • Clique no Origem e Grupos de Origem campo e selecione a origem que você criou anteriormente.
  • Clique Salvar alterações.

​

Configurar um proxy reverso usando nginx

location ~ ^(/|/some-other-path) {
    proxy_set_header Host $http_host;
    proxy_set_header X-HS-Public-Host www.example.com;
    proxy_pass_request_headers on;
    proxy_set_header X-HubSpot-Trust-Forwarded-For true;
    proxy_pass https://2XX93.sites-proxy.hscoscdnXX.net;
    proxy_ssl_name www.example.com;
    proxy_ssl_server_name on;
    proxy_set_header   X-Real-IP $proxy_protocol_addr;
    proxy_set_header   X-Forwarded-Proto  $scheme;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header   X-HubSpot-Client-IP $proxy_protocol_addr;
  }

location ~ ^(/hs|/_hcms|/hubfs|/hs-fs|/cs/c) {
    proxy_set_header Host $http_host;
    proxy_set_header X-HS-Public-Host www.example.com;
    proxy_pass_request_headers on;
    proxy_set_header X-HubSpot-Trust-Forwarded-For true;
    proxy_pass https://2XX93.sites-proxy.hscoscdnXX.net;
    proxy_ssl_name www.example.com;
    proxy_ssl_server_name on;
    proxy_set_header   X-Real-IP  $proxy_protocol_addr;
    proxy_set_header   X-Forwarded-Proto  $scheme;
    proxy_set_header   X-Forwarded-For    $proxy_add_x_forwarded_for;
    proxy_set_header   X-HubSpot-Client-IP $proxy_protocol_addr;
  }

proxy_ssl_name www.example.com;
proxy_ssl_server_name on;