CloudFront HTTP ヘッダーの追加 - Amazon CloudFront

CloudFront HTTP ヘッダーの追加

値がビューワーリクエストの特性に基づいている特定の HTTP ヘッダーを追加するように CloudFront を設定できます。これらのヘッダーを使用すると、オリジンはビューワーのデバイスタイプ、地理的位置などの情報を受け取ることができます。この情報を特定するためのカスタムコードは必要ありません。オリジンが、これらのヘッダーの情報に基づいて異なるレスポンスを返す場合は、CloudFront が別のレスポンスを別々にキャッシュするように、それらをキャッシュキーに含めることができます。

キャッシュキーにこれらのヘッダーを含めるには、キャッシュポリシーを使用します。詳細については、「キャッシュキーの管理」および「キャッシュキーについて」を参照してください。

オリジンでヘッダーを受信するが、キャッシュキーに含めないようにするには、オリジンリクエストポリシーを使用します。詳細については、「オリジンリクエストの制御」を参照してください。

ビューワーのデバイスタイプを特定するためのヘッダー

ビューワーのデバイスタイプを特定するために、次のヘッダーが追加できます。User-Agent ヘッダーの値に基づいて、CloudFront はこれらのヘッダーの値を true または false に設定します。デバイスが複数のカテゴリに属していると、複数の値が true になる場合があります。例えば、一部のタブレットデバイスに対して、CloudFront が CloudFront-Is-Mobile-ViewerCloudFront-Is-Tablet-Viewer の両方を true に設定します。

  • CloudFront-Is-Android-Viewer - ビューワーが Android オペレーティングシステム搭載のデバイスであると CloudFront が判断すると、true に設定します。

  • CloudFront-Is-Desktop-Viewer - ビューワーがデスクトップデバイスであると CloudFront が判断すると、true に設定します。

  • CloudFront-Is-IOS-Viewer – ビューワーが iPhone、iPod touch、その他の iPad デバイスなど、Apple モバイルオペレーティングシステム搭載のデバイスであると CloudFront が判断すると、true に設定します。

  • CloudFront-Is-Mobile-Viewer - ビューワーがモバイルデバイスであると CloudFront が判断すると、true に設定します。

  • CloudFront-Is-SmartTV-Viewer - ビューワーがスマートテレビであると CloudFront が判断すると、true に設定します。

  • CloudFront-Is-Tablet-Viewer - ビューワーがタブレットであると CloudFront が判断すると、true に設定します。

ビューワーの場所を特定するためのヘッダー

ビューワーの場所を特定するために、以下のヘッダーが追加できます。CloudFront は、ビューワーの IP アドレスに基づいてこれらのヘッダーの値を決定します。これらのヘッダーの値が ASCII 以外の文字の場合、CloudFront パーセントは RFC 3986 のセクション 1.2 に従って文字をエンコードします。

  • CloudFront-Viewer-Address – CloudFront にリクエストを送信したビューワーの IP アドレスと、リクエストのソースポートが含まれます。例えば、198.51.100.10:46532 のヘッダー値は、ビューワーの IP アドレスが 198.51.100.10 で、リクエストのソースポートが 46532 であることを意味します。

    注記

    オリジンリクエストポリシーで CloudFront-Viewer-Address が追加できますが、キャッシュポリシーではできません。

  • CloudFront-Viewer-Country - ビューワーの国の 2 文字の国コードが含まれています。国コードの一覧については、「ISO 3166-1 alpha-2」を参照してください。

次のヘッダーについては、CloudFront は Amazon EC2 から発信するリクエストを除くすべてのリクエストにそれらを追加します。

  • CloudFront-Viewer-City - ビューワーの市区町村名が含まれています。

  • CloudFront-Viewer-Country-Name - ビューワーの国名が含まれています。

  • CloudFront-Viewer-Country-Region - ビューワーのリージョンを表すコード (最大 3 文字) が含まれています。地域は、ISO 3166-2コードの第 1 レベルのサブディビジョン (最も広いまたは狭い) です。

  • CloudFront-Viewer-Country-Region-Name - ビューワーのリージョン名が含まれています。地域は、ISO 3166-2コードの第 1 レベルのサブディビジョン (最も広いまたは狭い) です。

  • CloudFront-Viewer-Latitude - ビューワーのおよその緯度が含まれています。

  • CloudFront-Viewer-Longitude - ビューワーのおよその経度が含まれています。

  • CloudFront-Viewer-Metro-Code - ビューワーのメトロコードが含まれています。これは、ビューワーが米国にいる場合にのみ表示されます。

  • CloudFront-Viewer-Postal-Code - ビューワーの郵便番号が含まれています。

  • CloudFront-Viewer-Time-Zone IANA タイムゾーンデータベース形式 (例: America/Los_Angeles) で、ビューワーのタイムゾーンが含まれています。

その他の CloudFront ヘッダー

ビューワーのリクエストのプロトコルおよび HTTP バージョンを特定するために、次のヘッダーが追加できます。

  • CloudFront-Forwarded-Proto - ビューワーのリクエストのプロトコル (HTTP または HTTPS) が含まれています。

  • CloudFront-Viewer-Http-Version - ビューワーのリクエストの HTTP バージョンが含まれています。