Utiliser un proxy inverse avec HubSpot

• Examen des considérations pour savoir s’il convient de mettre en place un proxy inverse.
• Configuration du proxy dans votre environnement externe. Le guide comprend des instructions générales ainsi que des instructions spécifiques aux fournisseurs pour Amazon CloudFront et nginx.
• Vérification de la configuration. Ce guide comprend également des étapes de dépannage si vous rencontrez une erreur 404 au cours de ce processus.
• Ajout du domaine à HubSpot pour permettre la création de contenu dans HubSpot.

​

Considérations

​

1. Configurer le proxy

​

Instructions générales

1. Configurez votre proxy pour qu’il n’effectue pas de mise en cache pour les chemins d’accès provenant de HubSpot. HubSpot gère automatiquement le contenu du cache de son réseau de diffusion de contenu afin que les pages soient automatiquement mises à jour lorsque du contenu est publié. Notez que si le service met en cache les réponses, les pages peuvent ne pas être mises à jour pendant plusieurs heures ou jours.
2. Ajoutez ou précédez à un en-tête X-Forwarded-For l’adresse IP du client du demandeur d’origine. Cela est nécessaire pour différencier les clients les uns des autres. De nombreux services, tels que CloudFront, gèrent automatiquement ces en-têtes.
3. Pour s’assurer que le contenu personnalisé basé sur la localisation fonctionne, transmettez un en-tête statique de X-HubSpot-Trust-Forwarded-For: true. Cela permet de se fier à l’en-tête ​X-Forwarded-For​, qui peut ne pas avoir été mis à jour par tous les serveurs mandataires en amont.
4. Passez un en-tête X-HS-Public-Host avec la valeur de votre domaine de destination.
5. Autorisez toutes les méthodes HTTP.
6. Assurez-vous qu’un certificat SSL est fourni et installé pour votre domaine proxy.
7. Transférez toutes les chaînes de requête.
8. Transférez tous les autres en-têtes de requête et de réponse tels quels, y compris les cookies.
9. Idéalement, tous les chemins d’accès de votre domaine devraient être dirigés vers HubSpot. Si ce n’est pas le cas, les chemins d’accès suivants doivent être utilisés dans le proxy pour que les actifs se chargent correctement à partir de votre domaine : /_hcms/*, /hs/*, /hubfs/*, hs-fs/hubfs/*, /hs-fs/*​, /cs/c/* et /e3t/*.

​

2. Confirmer que votre configuration est correcte

• Vous pouvez identifier les problèmes de configuration dans les paramètres de domaine de HubSpot :
  • Dans votre compte HubSpot, cliquez sur l’icône Paramètres dans la barre de navigation principale.
  • Dans le menu latéral de gauche, accédez à Site web > Domaines et URL.
  • À côté du domaine que vous utilisez pour votre proxy inverse, cliquez sur le menu déroulant Modifier et sélectionnez Vérifier la connexion au proxy inverse.
  • Cliquez sur n’importe quelle catégorie intitulée Échec pour afficher des recommandations de résolution du problème.
  • Une fois les corrections apportées, cliquez sur Actualiser les tests pour vérifier à nouveau votre configuration.

• Pour tous les autres comptes, pour confirmer votre configuration, visitez le site : https://[yourFullDomain]/_hcms/diagnostics
• Vérifiez les informations suivantes :
  • La valeur de temps actuelle change à chaque chargement. Cela confirme que la page n’est pas mise en cache.
  • Le User-Agent est cohérent avec votre navigateur.
  • La valeur Accept-Language correspond à votre navigateur.
  • L’en-tête Accept-Encoding est *. Cela garantit que les réponses sont compressées.
  • La valeur Cookie n’est pas vide.
  • Le Protocol est https.
  • L’adresse IP la plus à gauche dans X-Forwarded-For correspond à votre adresse IP telle qu’elle est indiquée par un service comme https://www.whatismyip.com.
  • Les valeurs IP-Determined Location correspondent à votre situation géographique. Elles sont basées sur les en-têtes liés à l’adresse IP dans X-Forwarded-For.

​

Résolution des problèmes

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

​

Clics enregistrés en tant qu’événements de bot

​

3. Connecter un domaine à HubSpot

• Dans votre compte HubSpot, accédez à vos paramètres de votre domaine.
• Cliquez sur Connecter un domaine.
• Sélectionnez Primaire ou Secondaire. Les domaines de redirection et d’envoi d’e-mail ne sont pas pris en charge pour cette fonctionnalité.
• Cliquez sur pour désactiver l’option Se connecter au réseau de diffusion de contenu (CDN) intégré à HubSpot, puis cliquez sur Connecter.
• Sélectionnez le type de contenu que vous allez héberger sur le domaine, puis cliquez sur Suivant.
• Saisissez le domaine de marque. Par exemple, pour www.website.com, vous saisirez website.com.

• Saisissez le sous-domaine sur lequel vous allez héberger le contenu. Le sous-domaine doit correspondre à celui du domaine hébergé en externe. Cliquez ensuite sur Suivant.
• Vérifiez le domaine que vous avez saisi, puis cliquez sur Suivant.
• Ensuite, vérifiez votre domaine afin que HubSpot puisse confirmer votre propriété de domaine et autoriser la publication de contenu :
  • Dans votre fournisseur de système de noms de domaine (DNS), créez les enregistrements en utilisant les valeurs fournies.
  • Dans HubSpot, cliquez sur Vérifier. HubSpot peut prendre jusqu’à 4 heures pour reconnaître les changements apportés à votre fournisseur DNS et vérifier votre nom d’hôte.

​

Instructions spécifiques aux fournisseurs

​

Configurer un proxy inverse dans Amazon CloudFront

• Connectez-vous à votre compte Amazon CloudFront.
• Dans le menu latéral de gauche, accédez à Distributions.
• Si vous partez de zéro, vous devrez d’abord créer une nouvelle distribution en cliquant sur Créer une distribution. Vous pouvez également modifier une distribution existante ou passer directement aux étapes de configuration de l’origine et des comportements.
  • Dans l’onglet Général, cliquez sur Modifier.
  • Dans le champ CNAME (Alternate Domain Names), ajoutez le domaine, y compris le sous-domaine. Cela doit correspondre au domaine que vous avez ajouté à HubSpot.
  • Confirmez les modifications apportées en cliquant sur Oui, modifier. Vous reviendrez alors à l’onglet Général où votre domaine devrait maintenant être répertorié à côté des autres noms de domaines CNAME.
  • Vous devrez également créer un nouvel enregistrement CNAME dans votre fournisseur de système de noms de domaine (DNS) en utilisant la valeur du champ Nom de domaine. Cette valeur devrait ressembler à <value>.cloudfront.net.
• Ensuite, configurez une nouvelle origine :
  • Cliquez sur l’onglet Origines et Groupes d’origines.
  • Cliquez sur Créer une origine, puis configurez votre origine :
    • Dans le champ Domaine d’origine, saisissez la valeur CNAME <HubID>.<suffix> du tableau ci-dessus. Cette valeur devrait ressembler à 123.sites-proxy.hscoscdn20.net.
    • Sous Ajouter un en-tête personnalisé, cliquez sur Ajouter un en-tête. Puis, ajoutez les détails d’en-tête suivants :
      • Pour garantir le bon fonctionnement du contenu personnalisé en fonction de l’emplacement, transmettez un en-tête X-Client-IP avec une valeur égale à l’adresse IP de l’utilisateur final (de préférence) ou un en-tête statique X-HubSpot-Trust-Forwarded-For: true. Ce dernier se fiera à l’en-tête X-Forwarded-For, qui peut ne pas avoir été mis à jour par tous les mandataires en amont.
      • Passez un en-tête X-HS-Public-Host avec la valeur de votre domaine de destination.
  • Cliquez sur Créer pour enregistrer vos modifications.
• Ensuite, configurez les comportements de cache pour les chemins de page sur lesquels vous hébergerez du contenu HubSpot :
  • Cliquez sur l’onglet Comportements.
  • Cliquez sur Créer un comportement.
  • Dans le champ Modèle de chemin, entrez le chemin d’URL de la page sur laquelle votre contenu HubSpot est hébergé. Il peut s’agir d’un chemin d’accès à une page spécifique ou d’une URL flexible telle qu’un caractère générique. Découvrez-en davantage sur les modèles de chemin.
  • Cliquez sur le champ Origine et groupes d’origine, puis sélectionnez l’origine que vous avez créée précédemment.
  • Cliquez sur Enregistrer les modifications.

​

Configurer un serveur proxy inverse

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;