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

:HTTPリクエストヘッダーの設定 (new)

最終更新日:Aug 16, 2024

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

前提条件

カスタムHTTPリクエストヘッダーを設定するための権限が取得されました。 デフォルトでは、これは外部ユーザーには利用できません。 権限を要求するには、チケットを起票

背景情報

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

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

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

image

使用上の注意

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

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

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

    オリジンHTTPヘッダー

    説明

    例:

    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ヘッダー

    説明

    例:

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

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

    Ali-Cdn-Real-Port:80

    Ali_Cdn_Real_Ip

    $http_Ali_Cdn_Real_Ip

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

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

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

    X-転送対象: 192.168.0.1、172.16.0.1

手順

  1. DCDNコンソール

  2. 左側のナビゲーションウィンドウで、ドメイン名.

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

  4. ドメイン名の左側のナビゲーションツリーで、Back-to-Origin 設定.

  5. クリックカスタム要求ヘッダー (新).

  6. On theカスタム要求ヘッダー (新)タブをクリックします。追加.

  7. 表示されるダイアログボックスでパラメーターを設定します。

    重要

    異なる操作が同じ要求ヘッダに対して同時に実行される場合、操作には異なる優先度が割り当てられる。 操作の優先順位は、[置換] > [追加] > [変更 /削除] の順です。 たとえば、同じリクエストヘッダーに対して追加操作と削除操作を同時に実行すると、リクエストヘッダーが追加されてから削除されます。

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

    パラメーター

    説明

    操作

    追加

    オリジンHTTPリクエストにリクエストヘッダーを追加します。

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    ヘッダー値

    key1

    リクエストヘッダーには1つ以上の値を指定できます。 複数入力する場合は、カンマ (,) で区切ります。

    key1, key2

    重複の許可

    はい

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

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

    削除操作のパラメーター

    パラメーター

    説明

    操作

    削除

    request HeaderパラメーターとRequest Header Nameパラメーターの値に一致するすべてのリクエストヘッダーを削除します。 重複するリクエストヘッダーも削除されます。

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    変更操作のパラメーター

    パラメーター

    説明

    操作

    変更

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

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    変更後

    key1, key3

    リクエストヘッダーには1つ以上の値を指定できます。 複数入力する場合は、カンマ (,) で区切ります。

    Replace操作のパラメーター

    パラメーター

    説明

    操作

    書き換え

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

    リクエストヘッダー

    カスタムヘッダー

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

    リクエストヘッダー名

    x-code

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

    探す

    キー

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

    書き換え後

    こんにちは

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

    Match

    すべてマッチ

    • すべて一致: 一致するすべての値が置き換えられます。 たとえば、正規表現を使用して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.

関連するAPI操作

BatchSetDcdnDomainConfigs