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

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

最終更新日:Oct 23, 2024

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

背景情報

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

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

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

image

使用上の注意

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

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

  • デフォルトでは、ApsaraVideo VODは次の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

手順

  1. ApsaraVideo VODコンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[設定管理]> [CDN設定]> [ドメイン名] を選択します。

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

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

  5. [Origin HTTP Request Headers] タブをクリックします。

  6. [追加] をクリックし、パラメーターを設定します。

    重要

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

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

    HTTP请求头信息

    パラメーター

    説明

    実行内容

    追加

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

    要求ヘッダー

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

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

    カスタム要求ヘッダー名

    x-code

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

    要求ヘッダー値

    key1, key2

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

    重複の許可

    必須

    • はい: リクエストヘッダーを重複して追加できます。 例: 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

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

    ルール条件

    条件を使用しない

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

    • 条件を使用しない

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

    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に変更されます。

    ルール条件

    条件を使用しない

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

    • 条件を使用しない

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

  7. [OK] をクリックします。

設定例

例 1

デフォルトでは、XFFヘッダーはback-to-originリクエストに含まれています。 XFFヘッダーの名前を変更する必要がない場合は、追加の設定は必要ありません。

    例 2

    デフォルトでは、Ali_Cdn_Real_Ipヘッダーはback-to-originリクエストに含まれ、ヘッダーの値はクライアントのIPアドレスです。 Ali_Cdn_Real_Ipヘッダーの名前を変更する必要がない場合は、追加の設定は必要ありません。

    例 3

    デフォルトでは、Ali_Cdn_Real_Portヘッダーはback-to-originリクエストに含まれ、ヘッダーの値はクライアントのポートです。 Ali_Cdn_Real_Portヘッダーの名前を変更する必要がない場合は、追加の設定は必要ありません。

    関連ドキュメント

    BatchSetVodDomainConfigs