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

注意事項

• 出力リクエストとは、CDN を介してオリジンサーバーに送信される HTTP メッセージです。「出力リクエストヘッダーの変更」の構成は、オリジンサーバーに送信される HTTP メッセージにのみ影響し、エッジノードからユーザーに直接提供される HTTP メッセージには影響しません。

• ワイルドカードドメイン名に対して出力リクエストヘッダーを変更することはできません。

• ApsaraVideo VOD は、デフォルトで次のオリジンリクエスト HTTP ヘッダーを転送します。 追加の設定は必要ありません。

  オリジン HTTP ヘッダー	説明	例
  Ali-Cdn-Real-Ip	POP への接続におけるクライアントの実際の IP アドレス。	Ali-Cdn-Real-Ip:192.168.0.1
  X-Forwarded-For	クライアントおよび中間エッジノードの IP アドレス。	X-Forwarded-For:192.168.0.1, 172.16.0.1
  X-Client-Scheme	クライアントが POP にリクエストを送信するために使用するアプリケーション層プロトコル（HTTP や HTTPS など）。	X-Client-Scheme:http
  Host	オリジンリクエストでアクセスされるオリジンサーバーのドメイン名。	Host:example.com
  Via	クライアントリクエストが通過するすべてのエッジノードの名前。	Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

操作手順

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

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

3. 対象のドメイン名を見つけ、設定 列の [設定] をクリックします。

4. ドメインの左側メニューで、Back-to-Origin をクリックします。

5. [オリジンリクエスト HTTP ヘッダー] タブをクリックします。

6. 追加 をクリックし、ヘッダーを設定します。

   重要

   • 同じリクエストヘッダーに対して競合する操作を構成した場合、優先度に従って実行されます。優先度の順序は 書き換え > 追加 > 変更 および 削除 です。たとえば、同じパラメーターに対して [追加] と [削除] の両方を構成した場合、システムはまずヘッダーを追加し、その後削除します。

   • 機能の構成がルールエンジンで設定されたルール条件を参照している場合、実行順序は機能構成の優先度ではなく、関連付けられたルール条件の優先度に従います。

   ヘッダーの追加

   

   パラメーター	例	説明
   実行内容	追加	指定されたリクエストヘッダーをオリジン HTTP リクエストに追加します。
   要求ヘッダー	カスタムバックトゥオリジンリクエストヘッダー	プリセットされたリクエストヘッダーを選択するか、カスタム back-to-origin リクエストヘッダー を選択します。
   カスタム要求ヘッダー名	x-code	カスタムリクエストヘッダー名は x-code です。
   要求ヘッダー値	key1, key2	リクエストヘッダーに複数の値を設定できます。複数の値はカンマ (,) で区切ります。
   重複の許可	はい	はい：重複するリクエストヘッダーを追加できます。たとえば、x-code:key1 および x-code:key2 です。 いいえ：同じ名前のリクエストヘッダーを追加すると、新しい値が古い値を上書きします。たとえば、最初に x-code:key1 を追加し、次に x-code:key2 を追加した場合、最終的な値は x-code:key2 になります。
   ルール条件	使用しない	ルール条件は、リクエスト内のさまざまなパラメーターを評価することで、構成がリクエストに適用されるかどうかを決定します。 条件を使用しない：条件付きルールを無効にします。 ルールエンジン で条件付きルールを追加または編集できます。

   ヘッダーの削除

   

   パラメーター	例	説明
   実行内容	削除	指定されたリクエストヘッダーを削除します。ヘッダーが重複している場合は、すべての値を含めて削除されます。
   要求ヘッダー	カスタムバックトゥオリジンリクエストヘッダー	プリセットされたリクエストヘッダーを選択するか、カスタム back-to-origin リクエストヘッダー を選択します。
   カスタム要求ヘッダー名	x-code	カスタムリクエストヘッダー名は x-code です。
   ルール条件	使用しない	ルール条件は、リクエスト内のさまざまなパラメーターを評価することで、構成がリクエストに適用されるかどうかを決定します。 条件を使用しない：条件付きルールを無効にします。 ルールエンジン で条件付きルールを追加または編集できます。

   ヘッダーの変更

   

   パラメーター	例	説明
   実行内容	変更	重複していないリクエストヘッダーのみ変更できます。
   要求ヘッダー	カスタムバックトゥオリジンリクエストヘッダー	プリセットされたリクエストヘッダーを選択するか、カスタム back-to-origin リクエストヘッダー を選択します。
   カスタム要求ヘッダー名	x-code	カスタムリクエストヘッダー名は x-code です。
   値の変更	key1, key3	リクエストヘッダーに複数の値を設定できます。複数の値はカンマ (,) で区切ります。
   ルール条件	使用しない	ルール条件は、リクエスト内のさまざまなパラメーターを評価することで、構成がリクエストに適用されるかどうかを決定します。 条件を使用しない：条件付きルールを無効にします。 ルールエンジン で条件付きルールを追加または編集できます。

   ヘッダーの置き換え

   

   パラメーター	例	説明
   実行内容	置き換え	重複していないリクエストヘッダーのみ置き換えられます。
   要求ヘッダー	カスタムバックトゥオリジンリクエストヘッダー	プリセットされたリクエストヘッダーを選択するか、カスタム back-to-origin リクエストヘッダー を選択します。
   カスタム要求ヘッダー名	x-code	カスタムリクエストヘッダー名は x-code です。
   検索	key	置き換える値を指定する正規表現。
   書き換え後	abc	挿入する新しい値。正規表現がサポートされています。
   一致	すべて一致	すべてマッチ：一致したすべての値が置き換えられます。たとえば、ヘッダー 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

シナリオ：X-Forwarded-For ヘッダーをオリジンリクエストに追加して、クライアント IP と中間プロキシサーバーの IP をオリジンサーバーに渡します。

ApsaraVideo VOD は、デフォルトでオリジンリクエストに X-Forwarded-For ヘッダーを含めます。 ヘッダー名を変更しない限り、設定は不要です。

• カスタムヘッダー名：X-Forwarded-For

• ヘッダー値：$proxy_add_x_forwarded_for

例 2

シナリオ：ヘッダーをオリジンリクエストに追加して、クライアントのリアル IP アドレスをオリジンサーバーに渡します。

ApsaraVideo VOD は、デフォルトでオリジンリクエストに Ali-Cdn-Real-Ip ヘッダーを含めます。 このヘッダーには、クライアントのリアル IP アドレスが含まれています。 ヘッダー名を変更しない限り、設定は不要です。

例 3

シナリオ：ヘッダーをオリジンリクエストに追加して、クライアントのリアルポートをオリジンサーバーに渡します。

ApsaraVideo VOD は、デフォルトでオリジンリクエストに Ali-Cdn-Real-Port ヘッダーを含めます。 このヘッダーには、クライアントのリアルポートが含まれています。 ヘッダー名を変更しない限り、設定は不要です。

関連ドキュメント

ドメイン名の一括設定