Reverse Proxy mit HubSpot verwenden

• Überlegungen zur Einrichtung eines Reverse Proxy prüfen.
• In Ihrer externen Umgebung den Proxy konfigurieren; der Leitfaden enthält sowohl allgemeine Anweisungen als auch anbieterspezifische Anweisungen für Amazon CloudFront und nginx.
• Bestätigen, dass die Konfiguration korrekt ist; dieser Leitfaden enthält auch Schritte zur Fehlerbehebung, falls dabei ein 404-Fehler auftritt.
• Die Domain zu HubSpot hinzufügen, um Contenterstellung in HubSpot zu ermöglichen.

​

Überlegungen

​

1. Proxy konfigurieren

​

Allgemeine Anweisungen

1. Legen Sie für Ihr Proxy fest, dass keine Zwischenspeicherung für Pfade, die von HubSpot stammen, durchgeführt wird. HubSpot verwaltet automatisch den Content im Cache unseres CDN, sodass Seiten automatisch aktualisiert werden, wenn Content veröffentlicht wird. Beachten Sie, dass Seiten möglicherweise mehrere Stunden oder Tage nicht aktualisiert werden, wenn der Dienst Antworten zwischenspeichert.
2. Fügen Sie eine X-Forwarded-For-Kopfzeile mit der Client-IP-Adresse des ursprünglichen Anfragenden hinzu oder stellen sie ihr voran. Dies ist erforderlich, um Kunden voneinander zu unterscheiden. Viele Dienste, wie z. B. CloudFront, pflegen diese Header automatisch.
3. Um sicherzustellen, dass personalisierter Content basierend auf dem Standort funktioniert, übergeben Sie einen statischen Header von X-HubSpot-Trust-Forwarded-For: true. Dadurch wird dem ​X-Forwarded-For​-Header vertraut, der möglicherweise von allen Upstream-Proxies aktualisiert wurde.
4. Übergeben Sie einen X-HS-Public-Host-Header mit dem Wert Ihrer Zieldomain.
5. Lassen Sie alle HTTP-Methoden zu.
6. Stellen Sie sicher, dass ein SSL-Zertifikat für Ihre Proxy-Domain bereitgestellt und installiert wurde.
7. Leiten Sie alle Abfragezeichenfolgen weiter.
8. Leiten Sie alle anderen Anfrage- und Antwort-Header unverändert weiter, einschließlich Cookies.
9. Idealerweise sollten alle Pfade unter Ihrer Domain zu HubSpot als Proxy führen. Wenn dies nicht der Fall ist, müssen die folgenden Pfade ein Proxy ausführen, damit die Elemente korrekt von Ihrer Domain geladen werden: /_hcms/*, /hs/*, /hubfs/*, hs-fs/hubfs/*, /hs-fs/*​, /cs/c/* und /e3t/*.

​

2. Bestätigen, dass Ihre Konfiguration korrekt ist

• Sie können in Ihren HubSpot-Domaineinstellungen Probleme mit Ihrer Konfiguration identifizieren:
  • Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnrad-Symbol.
  • Gehen Sie in der linken Seitenleiste zu Website > Domains & URLs.
  • Klicken Sie neben der Domain, die Sie für Ihr Reverse Proxy verwenden, auf das Dropdown-Menü Bearbeiten und wählen Sie Reverse-Proxy-Verbindung überprüfen aus.
  • Klicken Sie auf eine Kategorie mit der Bezeichnung Keine Anzeige der Empfehlungen zur Behebung des Problems.
  • Nachdem Sie Ihre Korrekturen implementiert haben, klicken Sie auf Test aktualisieren, um Ihre Konfiguration erneut zu überprüfen.

• Für alle anderen Accounts können Sie Ihre Konfiguration bestätigen, indem Sie https://[yourFullDomain]/_hcms/diagnostics aufrufen.
• Geben Sie die folgenden Informationen an:
  • Der aktuelle Zeitwert ändert sich bei jeder Last. Dadurch wird bestätigt, dass die Seite nicht zwischengespeichert wird.
  • Der User-Agent-Wert ist konsistent mit Ihrem Browser.
  • Der Accept-Language-Wert stimmt mit Ihrem Browser überein.
  • Der Accept-Encoding-Header lautet *. Dadurch wird sichergestellt, dass die Antworten komprimiert werden.
  • Der Cookie-Wert ist nicht leer.
  • Der Protocol-Wert ist https.
  • Die IP-Adresse ganz links in X-Forwarded-For stimmt mit Ihrer IP-Adresse überein, die von einem Dienst wie https://www.whatismyip.com gemeldet wird.
  • Die IP-Determined Location-Werte entsprechen Ihrem Standort. Diese basieren auf den IP-bezogenen Headern in X-Forwarded-For.

​

Fehlerbehebung

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

​

Als Bot-Events registrierte Klicks

​

3. Domain zu HubSpot hinzufügen

• Gehen Sie in Ihrem HubSpot-Account zu Ihren Domaineinstellungen.
• Klicken Sie auf Domain verknüpfen.
• Wählen Sie Primär oder Sekundär aus. Weiterleitungs- und E-Mail-Versanddomains werden für diese Funktion nicht unterstützt.
• Klicken Sie auf den SchalterMit dem in HubSpot integrierten Content Delivery Network (CDN) verknüpfen, um ihn zu deaktivieren, und dann auf Verknüpfen.
• Wählen Sie den Content-Typ aus, den Sie auf der Domain hosten möchten, und klicken Sie dann auf Weiter.
• Geben Sie die Brand-Domain ein. Für www.website.com würden Sie zum Beispiel website.com eingeben.

• Geben Sie die Subdomain ein, auf der Sie Content hosten möchten. Die Subdomain muss mit der Subdomain der extern gehosteten Domain übereinstimmen. Klicken Sie dann auf Weiter.
• Überprüfen Sie die eingegebene Domain und klicken Sie dann auf Weiter.
• Als Nächstes müssen Sie Ihre Domain überprüfen, damit HubSpot Ihre Domaininhaberschaft bestätigen und die Content-Veröffentlichung zulassen kann:
  • Erstellen Sie bei Ihrem DNS-Anbieter die Einträge mit den angegebenen Werten.
  • Klicken Sie in HubSpot auf Verifizieren. Es kann bis zu 4 Stunden dauern, bis HubSpot Änderungen bei Ihrem DNS-Anbieter erkennt und Ihren Hostnamen verifiziert.

​

Anbieterspezifische Anweisungen

​

Einrichten eines Reverse Proxy in Amazon CloudFront

• Melden Sie sich bei Ihrem Amazon CloudFront-Account an.
• Gehen Sie in der linken Seitenleiste zu Apps.
• Wenn Sie komplett neu beginnen, müssen Sie zuerst eine neue Verteilung erstellen, indem Sie auf Verteilung erstellen klicken. Alternativ können Sie eine vorhandene Verteilung bearbeiten oder mit den Einrichtungsschritten für Ursprung und Verhalten fortfahren.
  • Klicken Sie auf der Registerkarte Allgemein auf Bearbeiten.
  • Fügen Sie im Feld Alternative Domain-Namen (CNAMEs) die Domain einschließlich der Subdomain hinzu. Diese muss mit der Domain übereinstimmen, die Sie zu HubSpot hinzugefügt haben.
  • Bestätigen Sie Ihre Änderungen, indem Sie auf Ja, bearbeiten klicken. Sie werden dann zurück zur Registerkarte Allgemein geleitet, wo Ihre Domain neben Alternative Domain-Namen (CNAMEs) aufgeführt sein sollte.
  • Sie müssen außerdem einen neuen CNAME-Eintrag in Ihrem DNS-Anbieter erstellen, indem Sie den Wert aus dem Feld Domain-Name verwenden. Dieser Wert sollte etwa so aussehen: <value>.cloudfront.net.
• Richten Sie als Nächstes einen neuen Ursprung ein:
  • Klicken Sie auf die Registerkarte Ursprünge und Ursprungsgruppen.
  • Klicken Sie auf Ursprung erstellen und richten Sie dann Ihren Ursprung ein:
    • Geben Sie im Feld Ursprungsdomain den <HubID>.<suffix>-CNAME-Wert aus der obigen Tabelle ein. Dieser Wert sollte etwa so aussehen: 123.sites-proxy.hscoscdn20.net.
    • Klicken Sie unter Benutzerdefinierten Header hinzufügen auf Header hinzufügen. Fügen Sie dann die folgenden Header-Details hinzu:
      • Um sicherzustellen, dass personalisierter Content auf der Grundlage des Standorts funktioniert, übergeben Sie entweder einen X-Client-IP-Header mit dem Wert der IP des Endbenutzers (bevorzugt) oder einen statischen Header von X-HubSpot-Trust-Forwarded-For: true. Letzterer vertraut dem X-Forwarded-For-Header, der möglicherweise nicht von allen Upstream-Proxies aktualisiert wurde.
      • Übergeben Sie einen X-HS-Public-Host-Header mit dem Wert Ihrer Ziel-Domain.
  • Klicken Sie auf Erstellen, um Ihre Änderungen zu speichern.
• Richten Sie dann das Cache-Verhalten für die Seitenpfade ein, auf denen Sie HubSpot-Content hosten werden:
  • Klicken Sie auf die Registerkarte Verhalten.
  • Klicken Sie auf Verhalten erstellen.
  • Geben Sie im Feld Pfadmuster den URL-Pfad der Seite ein, auf der Ihre HubSpot-Content gehostet wird. Dies kann ein Pfad zu einer bestimmten Seite oder eine flexible URL wie ein Platzhalter sein. Erfahren Sie mehr über Pfadmuster..
  • Klicken Sie auf das Feld Ursprung und Ursprungsgruppen und wählen Sie dann den Ursprung aus, den Sie zuvor erstellt haben.
  • Klicken Sie auf Änderungen speichern.

​

Einrichten eines Reverse Proxy mit 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;