すべてのプロダクト
Search
ドキュメントセンター

CDN:HTTPリクエストヘッダーの設定

最終更新日:Feb 22, 2024

デフォルトでは、Alibaba Cloud CDN はクライアントIPアドレスなどのリクエストヘッダーをサポートしています。 カスタムリクエストヘッダーを設定することもできます。 Alibaba Cloud CDNでは、back-to-originリクエストのHTTPヘッダーを書き換えることができます。 ビジネス要件に基づいて、back-to-originリクエストのHTTPヘッダーを追加、削除、変更、または置き換えることができます。

背景情報

HTTPリクエストヘッダーは、HTTP経由で送信されるリクエストのヘッダーセクションのコンポーネントです。 HTTPリクエストヘッダーには、サーバーに送信される特定のパラメーターが含まれます。

ポイントオブプレゼンス (POP) がオリジンサーバーから要求されたリソースを取得すると、オリジンサーバーは要求ヘッダーに含まれる情報を取得できます。Alibaba Cloud CDNを すると、back-to-originリクエストのHTTPヘッダーを書き換えることができます。 リクエストヘッダーに含まれる情報は、特定のビジネス要件を満たすためにオリジンサーバーに渡されます。 たとえば、X-Forwarded-For (XFF) ヘッダーを構成して、クライアントのIPアドレスを配信元サーバーに渡すことができます。

オリジンサーバーがback-to-originリクエストのXFFヘッダーからクライアントのIPアドレスを取得する方法については、「クライアントの送信元IPアドレスの取得」をご参照ください。

image

使用上の注意

  • back-to-originリクエストは、Alibaba Cloud CDN によって特定の高速化ドメイン名のオリジンサーバーに送信されるHTTPメッセージです。 書き換えルールは、オリジンサーバーとPOPの間で送信されるリクエストのHTTPヘッダーのみを書き換えます。 書き換えルールは、POPとクライアント間で送信されるリクエストのHTTPヘッダーを書き換えません。

  • ワイルドカードドメイン名にカスタムHTTPリクエストヘッダーを指定することはできません。

  • デフォルトでは、Alibaba Cloud CDN は次のHTTPリクエストヘッダーをサポートしています。

    オリジンHTTPヘッダー

    説明

    例:

    Ali-Cdn-Real-Port

    POPに接続するためにクライアントが使用するポート。

    Ali-Cdn-Real-Port:80

    Ali-Cdn-Real-Ip

    POPに接続するためにクライアントが使用するIPアドレス。

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    クライアントのIPアドレスと、配信元サーバーへの接続に使用されるPOPのIPアドレス。

    X-転送対象: 192.168.0.1、172.16.0.1

    X-Client-Scheme

    HTTPやHTTPSなど、POPにリクエストを送信するためにクライアントが使用するプロトコル。

    X-Client-Scheme:http

    ホスト

    リクエストのリダイレクト先のオリジンサーバーのドメイン名。

    Hos t:example.com

    経由

    リクエストが通過するすべてのPOPの名前。

    経由: cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

  • HTTPリクエストヘッダーの値が変数の場合は、変数を使用する際に特定の値が代入されます。 使用可能な変数を次の表に示します。

    オリジンHTTPヘッダー

    説明

    $http_Ali_Cdn_Real_Port

    クライアントポートをオリジンサーバーに渡すヘッダーを追加します。

    $http_Ali_Cdn_Real_Ip

    クライアントIPアドレスを配信元サーバーに渡すヘッダーを追加します。

    $proxy_add_x_forwarded_for

    back-to-originリクエストにXFFヘッダーを追加します。 XFFヘッダーは、クライアントIPアドレスとプロキシIPアドレスをオリジンサーバーに渡します。

手順

  1. Alibaba Cloud CDNコンソール

  2. 左側のナビゲーションウィンドウで、ドメイン名 をクリックします。

  3. [ドメイン名] ページで、管理するドメイン名を見つけて、アクション 列の 管理 をクリックします。

  4. ドメイン名の左側のナビゲーションツリーで、Back-to-Origin 設定 をクリックします。

  5. カスタムリクエストヘッダー タブをクリックします。

  6. 追加 をクリックします。

  7. Back-to-originリクエストヘッダーダイアログボックスでパラメーターを設定します。

    重要

    同じリクエストヘッダに対して同時に異なるオペレーションが実行される場合、それらのオペレーションは異なる優先度を有する。 操作は、置換 > 追加 > 変更または削除の降順で優先されます。 たとえば、同じリクエストヘッダーに対して [追加] および [削除] 操作を同時に実行すると、リクエストヘッダーが追加されてから削除されます。

    [追加] 操作のパラメーター

    HTTP请求头信息

    パラメーター

    説明

    実行内容

    追加

    この操作により、back-to-origin HTTPリクエストにリクエストヘッダーが追加されます。

    要求ヘッダー

    カスタムBack-to-originリクエストヘッダー

    プリセットヘッダーを選択するか、[リクエストヘッダー] ドロップダウンリストから カスタム back-to-origin リクエストヘッダー を選択してリクエストヘッダーを指定します。

    カスタム要求ヘッダー名

    x-code

    カスタムリクエストヘッダーの名前はx-codeです。

    要求ヘッダー値

    key1, key2

    リクエストヘッダーには1つ以上の値を指定できます。 値はコンマ (,) で区切ります。

    重複の許可

    必須

    • はい: リクエストヘッダーを重複して追加できます。 例: x-code:key1およびx-code:key2

    • いいえ: 最新のヘッダー値は、同じヘッダー名を使用する既存のヘッダー値を上書きします。 たとえば、x-code:key1を追加してからx-code:key2を追加すると、x-code:key2が有効になります。

    ルール条件

    条件を使用しない

    ルール条件は、構成が要求に適用されるかどうかを決定するために要求内のパラメータを識別できる。

    • 条件を使用しない

    • ルールエンジンで設定されたルール条件を選択します。 詳細については、「ルールエンジン」をご参照ください。

    削除操作のパラメーター

    删除

    パラメーター

    説明

    実行内容

    削除

    この操作により、request HeaderパラメーターとHeader Nameパラメーターの値に一致するすべてのリクエストヘッダーが削除されます。 重複するリクエストヘッダーも削除されます。

    要求ヘッダー

    カスタムBack-to-originリクエストヘッダー

    プリセットヘッダーを選択するか、[リクエストヘッダー] ドロップダウンリストから カスタム back-to-origin リクエストヘッダー を選択してリクエストヘッダーを指定します。

    カスタム要求ヘッダー名

    x-code

    カスタムリクエストヘッダーの名前はx-codeです。

    ルール条件

    条件を使用しない

    ルール条件は、構成が要求に適用されるかどうかを決定するために要求内のパラメータを識別できる。

    • 条件を使用しない

    • ルールエンジンで設定されたルール条件を選択します。 詳細については、「ルールエンジン」をご参照ください。

    変更操作のパラメーター

    变更

    パラメーター

    説明

    実行内容

    変更点

    変更操作は、重複するリクエストヘッダーが存在しない場合にのみ実行できます。

    要求ヘッダー

    カスタムBack-to-originリクエストヘッダー

    プリセットヘッダーを選択するか、[リクエストヘッダー] ドロップダウンリストから カスタム back-to-origin リクエストヘッダー を選択してリクエストヘッダーを指定します。

    カスタム要求ヘッダー名

    x-code

    カスタムリクエストヘッダーの名前はx-codeです。

    値の変更

    key1, key3

    リクエストヘッダーには1つ以上の値を指定できます。 値はコンマ (,) で区切ります。

    ルール条件

    条件を使用しない

    ルール条件は、構成が要求に適用されるかどうかを決定するために要求内のパラメータを識別できる。

    • 条件を使用しない

    • ルールエンジンで設定されたルール条件を選択します。 詳細については、「ルールエンジン」をご参照ください。

    Replace操作のパラメーター

    替换

    パラメーター

    説明

    実行内容

    Replace

    重複するリクエストヘッダーが存在しない場合にのみ、置換操作を実行できます。

    要求ヘッダー

    カスタムBack-to-originリクエストヘッダー

    プリセットヘッダーを選択するか、[リクエストヘッダー] ドロップダウンリストから カスタム back-to-origin リクエストヘッダー を選択してリクエストヘッダーを指定します。

    カスタム要求ヘッダー名

    x-code

    カスタムリクエストヘッダーの名前はx-codeです。

    検索

    キー

    正規表現を使用して、置き換える値を検索できます。

    書き換え後

    こんにちは

    正規表現を使用して一致する値を置き換えることができます。

    一致

    すべてマッチ

    • すべてマッチ: 一致するすべての値が置き換えられます。 たとえば、正規表現を使用してx-code:key1,key2,key3のすべての "key" の文字列をabcに置き換えると、キーと値のペアはx-code:abc1,abc2,abc3に変更されます。

    • 最初のみマッチ: 最初に一致する値のみが置き換えられます。 たとえば、正規表現を使用してx-code:key1,key2,key3の最初の文字列 "key" をabcに置き換えると、キーと値のペアはx-code:abc1,key2,key3に変更されます。

    ルール条件

    条件を使用しない

    ルール条件は、構成が要求に適用されるかどうかを決定するために要求内のパラメータを識別できる。

    • 条件を使用しない

    • ルールエンジンで設定されたルール条件を選択します。 詳細については、「ルールエンジン」をご参照ください。

  8. OK をクリックします。