HubSpotでリバースプロキシーを使用する

• リバースプロキシーをセットアップするかどうかの判断に当たっての考慮事項を確認する。
• 外部環境でプロキシーを設定する。このガイドには、一般的な手順のほか、Amazon CloudFrontおよびnginx向けの固有の手順が記載されています。
• 設定が正しいことを確認する。また、このプロセス中に404エラーが表示された場合のトラブルシューティング手順も、このガイドで説明します。
• HubSpotでコンテンツを作成できるように、ドメインをHubSpotに追加する。

​

考慮事項

​

1. プロキシーを設定する

​

一般的な手順

1. HubSpotからのパスに関するキャッシュを実行しないようにプロキシーを設定します。HubSpotはCDNのキャッシュコンテンツを自動的に管理します。そのため、コンテンツの公開時にはページが自動的に更新されます。サービスがレスポンスをキャッシュする場合、ページの更新に数時間から数日かかることがあるため、ご注意ください。
2. 元のリクエスト送信者のクライアントIPアドレスをX-Forwarded-Forヘッダーに追加するか、このヘッダーの前に付加します。これは、クライアントをそれぞれ区別するために必要です。CloudFrontなどの多くのサービスでは、これらのヘッダーが自動的に保持されます。
3. 所在地に基づくコンテンツのパーソナライズが機能するよう、静的ヘッダーX-HubSpot-Trust-Forwarded-For: trueを渡します。この設定により、​X-Forwarded-For​ヘッダーが信頼されるようになります。ただし、このヘッダーは全てのアップストリームプロキシーで更新されているとは限りません。
4. 宛先ドメインの値が指定されたX-HS-Public-Hostヘッダーを渡します。
5. 全てのHTTPメソッドを許可します。
6. プロキシードメイン用にSSL証明書が発行され、インストールされていることを確認します。
7. 全てのクエリー文字列を転送します。
8. 他の全てのリクエストヘッダーとレスポンスヘッダーをそのまま転送します（Cookieを含む）。
9. ドメイン下の全てのパスがHubSpotにプロキシーされるのが理想的です。そうでない場合、ドメインからアセットを正しく読み込むために、パス/_hcms/*、/hs/*、/hubfs/*、hs-fs/hubfs/*、/hs-fs/*​、/cs/c/*、および/e3t/*をプロキシーする必要があります。

​

2. 設定が正しいことを確認する

• HubSpotのドメイン設定で構成に関する問題を特定できます。
  • HubSpotアカウントにて、メイン ナビゲーション バーの設定アイコンをクリックします。
  • 左のサイドバーメニューでウェブサイト > ドメインとURLの順に移動します。
  • リバースプロキシーに使用しているドメインの横にある編集ドロップダウンメニューをクリックし、リバースプロキシー接続を確認を選択します。
  • ［失敗］ラベルが付いたカテゴリーをクリックして、問題の修正に関する推奨事項を表示します。
  • 修正を実装したら、テストの再読み込みをクリックして、設定を再度確認します。

• その他のアカウントで設定を確認するには、こちらのリンクにアクセスします：https://[yourFullDomain]/_hcms/diagnostics
• 以下の情報を確認します。
  • 現在の時刻値が読み込みごとに変化すること。これにより、ページがキャッシュされていないことを確認できます。
  • User-Agentがブラウザーと一致していること。
  • Accept-Languageの値がブラウザーと一致していること。
  • Accept-Encodingヘッダーが*に設定されていること。これにより、レスポンスが確実に圧縮されます。
  • Cookie値が空でないこと。
  • Protocolがhttpsに設定されていること。
  • X-Forwarded-Forの一番左のIPアドレスがhttps://www.whatismyip.comなどのサービスから報告されるIPアドレスと一致していること。
  • IP-Determined Locationの値が現在地に対して正確であること。この値はX-Forwarded-ForのIP関連ヘッダーに基づいています。

​

トラブルシューティング

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

​

ボットイベントとして登録されたクリック数

​

3. ドメインをHubSpotに追加する

• HubSpotのアカウントでドメイン設定に移動します。
• ドメインを接続をクリックします。
• プライマリーまたはセカンダリーを選択します。この機能では、リダイレクトドメインおよびEメール送信ドメインはサポートされていません。
• HubSpotの標準で用意されているコンテンツ配信ネットワーク（CDN）と接続スイッチをオフに切り替え、接続をクリックします。
• ドメインでホスティングするコンテンツタイプを選択し、次へをクリックします。
• ブランドドメインを入力します。例えば_www.website.com_を使用する場合、website.comを入力します。

• コンテンツをホスティングするサブドメインを入力します。サブドメインは、外部でホスティングされているドメインのサブドメインと一致している必要があります。次へをクリックします。
• 入力したドメインを確認し、次へをクリックします。
• 次に、HubSpotがドメインの所有権を確認しコンテンツ公開を許可できるよう、ドメインを確認します。
  • DNSプロバイダーで、指定された値を使用してレコードを作成します。
  • HubSpotで確認をクリックします。HubSpotがDNSプロバイダーに加えられた変更を認識し、ホスト名を確認するまでに最大4時間かかることがあります。

​

プロバイダー固有の設定手順

​

Amazon CloudFrontにおけるリバースプロキシーのセットアップ

• Amazon CloudFrontアカウントにログインします。
• 左側のサイドバーで**Distributions（ディストリビューション）**に移動します。
• 新規にセットアップする場合は、最初に**Create Distribution（ディストリビューションの作成）**をクリックして新しいディストリビューションを作成する必要があります。または、既存のディストリビューションを編集するか、オリジンと動作のセットアップ手順に進むことができます。
  • ［General（一般）］タブで［Edit（編集）］をクリックします。
  • **代替ドメイン名（CNAMEs）（Alternate Domain Names (CNAMEs)）**フィールドに、サブドメインを含むドメインを追加します。これはHubSpotに追加したドメインと一致している必要があります。
  • **Yes, Edit（はい、編集します）**をクリックして変更を確定します。**General（一般）**タブが再び表示され、代替ドメイン名（CNAME）の横にドメインが一覧表示されます。
  • また、［Domain Name（ドメイン名）］フィールドの値を使用してDNSプロバイダーに新しいCNAMEレコードを作成する必要があります。この値は<value>.cloudfront.netのようになります。
• 次に、新しいオリジンを設定します。
  • **Origins and Origin Groups（オリジンとオリジングループ）**タブをクリックします。
  • **Create Origin（オリジンの作成）**をクリックして、オリジンをセットアップします。
    • ****［Origin domain（オリジンドメイン）］フィールドに、前述の表を基に<HubID>.<suffix>のCNAME値を入力します。この値は123.sites-proxy.hscoscdn20.netのようになります。
    • ［Add custom header（カスタムヘッダーの追加）］の下の［Add header（ヘッダーの追加）］をクリックします。次に、以下のヘッダーの詳細を追加します。
      • 所在地に基づくコンテンツのパーソナライズが機能するよう、エンドユーザーのIPの値を指定したX-Client-IPを渡すか（推奨）、または静的ヘッダーX-HubSpot-Trust-Forwarded-For: trueを渡します。後者の方法ではX-Forwarded-Forヘッダーを信頼するようになりますが、このヘッダーは全てのアップストリームプロキシーで更新されていない可能性があります。
      • 宛先ドメインの値が指定されたX-HS-Public-Hostヘッダーを渡します。
  • 作成をクリックして変更内容を保存します。
• 次に、HubSpotコンテンツをホスティングするページパスのキャッシュ動作をセットアップします。
  • **Behaviors（動作）**タブをクリックします。
  • **Create Behavior（動作の作成）**をクリックします。
  • **Path pattern（パスパターン）**フィールドに、HubSpotコンテンツがホスティングされるページのURLパスを入力します。特定のページのパス、またはワイルドカードなどのフレキシブルURLを指定できます。詳細については、パスパターンをご確認ください。
  • **Origin and Origin Groups（オリジンとオリジングループ）**フィールドをクリックし、先ほど作成したオリジンを選択します。
  • **Save changes（変更を保存）**をクリックします。

​

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;