ヘッダーの重複を許可するように Message Processor を構成する

ヘッダーが重複および複数の値を持つように構成されていることを確認する

このセクションでは、特定のヘッダーのプロパティ HTTPHeader.HEADER_NAME が正常に更新され、Message Processor での重複を許可されていることを確認する方法について説明します。

ヘッダーの例として Expires を使用し、対応するプロパティ HTTPHeader.Expires が更新されているかどうかを確認します。

トークン conf_http_HTTPHeader.Expires を使用して Message Processor の値を更新する場合でも、実際のプロパティ HTTPHeader.Expires が新しい値で設定されていることを確認する必要があります。

1. Message Processor マシンで、/opt/apigee/edge-message-processor/conf ディレクトリのプロパティ HTTPHeader.HEADER_NAME を検索し、次のように新しい値が設定されていることを確認します。

   grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
   

   たとえば、プロパティ HTTPHeader.Expires が新しい値で設定されていることを確認するには、次のコマンドを実行します。

   grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
   

2. Message Processor で HTTPHeader.HEADER_NAME に新しい値が正常に設定されると、上記のコマンドによって http.properties ファイルに新しい値が表示されます。

3. allowDuplicates と multiValued を構成した後の上記のコマンドのサンプル結果は次のとおりです。

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=allowDuplicates, multiValued
   

4. 上記の出力例では、プロパティ HTTPHeader.Expires が http.properties の新しい値 allowDuplicates, multiValued で設定されています。これは、HTTPHeader での重複と複数値を許可する動作が、Message Processor で正常に構成されていることを示します。
5. プロパティ HTTPHeader.HEADER_NAME に古い値が引き続き表示される場合は、allowDuplicates とヘッダーの複数の値の構成で説明されているすべてのステップに正しく従っていることを確認してください。ステップを見逃した場合は、すべてのステップをもう一度正しくやり直します。

   プロキシが想定どおりに動作することを確認します。特に、プロキシのヘッダーを取得して設定するための機能ロジックがある場合は、確認してください。

6. それでもプロパティを変更できない場合は、Apigee Edge サポートにお問い合わせください。

ヘッダーの allowDuplicates の無効化

このセクションでは、Edge の構成方法で説明されている構文に従って対応するトークンを使用し、Message Processor の特定の HTTP ヘッダーで重複や複数値を許可しないようにプロパティ HTTPHeader.{Headername} を構成する方法について説明します。

このセクションでは、以下で説明するように、重複を許容しないヘッダーの例として Expires（および myheader）を使用します。

1. 次のコマンドを使用して、プロパティ HTTPHeaderHEADER_NAME の 現在の値を特定し、まだ無効になっていないことを確認します。これにより、重複や複数の値を許可できます。

   grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
   

   たとえば、Expires ヘッダーのプロパティを設定しようとしている場合は、Message Processor のプロパティ HTTPHeader.Expires トークンの現在の値を確認します。

   grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
   

   上記のコマンドの出力は、次のいずれかになります。

   1. このプロパティが空白に設定されている場合は、値が NOT に上書きされ、重複したヘッダーと複数の値を許可することを意味します。つまり、Apigee への HTTP リクエストまたは HTTP レスポンスの一部として Expires ヘッダーを複数回送信することはできません。
   2. 特定のプロパティにヒットがない場合、値は上書きされません。これは、既存の設定の NOT ヘッダーです。Apigee Edge への HTTP リクエストまたは HTTP レスポンスの一部として、特定のヘッダーを複数回送信できます（重複は可能です）。
   3. このプロパティに値 allowDuplicates, multivalued を設定すると、値は明示的に上書きされ、これは既存の構成であることを意味します。ただし、Apigee への HTTP リクエストまたは HTTP レスポンスの一部として特定のヘッダーを複数回送信できます（重複は可能です）。

   出力例 1

   検索コマンドの出力例 1:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=allowDuplicates, multiValued
   

   このサンプル出力は、プロパティ HTTPHeader.Expires が allowDuplicates, multiValued に設定されていることを示しています。つまり、ヘッダー Expires のプロパティが重複または複数の値を許可するように上書きされます。

   出力例 2

   検索コマンドのサンプル コマンドと出力 2

   grep -ri "HTTPHeader.myheader" /opt/apigee/edge-message-processor/conf
   

   この出力例には出力はありません。これは、HTTPHeader.myheader プロパティがデフォルトで allowDuplicates, multiValued に設定されていることを示しています。また、これはヘッダー「myheader」のプロパティが上書きされない ことも意味します。

2. 次のいずれかに該当する場合は、このセクションの残りの手順を行います。
   1. 特定のヘッダーに対応するプロパティは、上記の出力例 1（既存の構成を含むヘッダー）のように重複および複数の値を許可するために上書きされる
   2. 上記の出力例 2 にあるように、特定のヘッダーに対応するプロパティにヒットがない（既存の設定を含むヘッダーではない）

   それ以外の場合は、このセクションの残りの手順をスキップします。

3. 次のファイルを編集します。存在しない場合は、作成できます。

   /opt/apigee/customer/application/message-processor.properties
   

   たとえば、vi を使用してファイルを開くには、次のように入力します。

   vi /opt/apigee/customer/application/message-processor.properties
   

4. プロパティ ファイルに次の形式の行を追加します。

   既存の構成

   シナリオ 1: 既存の構成のヘッダー:

   conf_http_HTTPHeader.Expires=
   

   既存の設定はありません

   シナリオ 2: 既存の構成のヘッダーではない場合:

   conf/http.properties+HTTPHeader.myheader=
   

5. 変更を保存します。
6. プロパティ ファイルの所有者を apigee ユーザーにします。設定されていない場合は、次のコマンドを実行します。

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
   

7. Message Processor を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
   

   トラフィックに影響を与えずに再起動するには、 トラフィックに影響を与えずに Message Processor のローリング再起動を実行するをご覧ください。

8. 複数の Message Processor がある場合は、すべての Message Processor で上記の手順を繰り返します。

ヘッダーが重複および複数の値を許可しないように構成されていることを確認する

このセクションでは、Message Processor での重複が許可されないように、特定のヘッダーのプロパティ HTTPHeader.HEADER_NAME が正常に更新されていることを確認する方法について説明します。

ヘッダーの例として Expires（および myheader）を使用し、対応するプロパティ HTTPHeader.Expires（および HTTPHeader.myheader）が更新されているかどうかを確認します。

1. Message Processor マシンで、/opt/apigee/edge-message- processor/conf ディレクトリのプロパティ HTTPHeader.HEADER_NAME を検索し、次のように新しい値が設定されていることを確認します。

   grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
   

   たとえば、プロパティ HTTPHeader.Expires が新しい値で設定されていることを確認するには、次のコマンドを実行します。

   既存の構成

   grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
   

   既存の設定はありません

   grep -ri "HTTPHeader.myheader" /opt/apigee/edge-message-processor/conf
   

2. Message Processor で新しい HTTP ヘッダー値 HTTPHeader.HEADER_NAME I が正常に設定されると、上記のコマンドによって http.properties ファイルに新しい値が表示されます。
3. allowDuplicates を無効にした後の上記のコマンドの結果は次のとおりです。

   既存の構成

   シナリオ 1: 有効期限ヘッダー（既存の構成を含むヘッダー）

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=
   

   既存の設定はありません

   シナリオ 2: myheader ヘッダー（既存の構成のヘッダーではない）

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.myheader=
   

4. 上記の出力例では、プロパティ HTTPHeader.Expires（および HTTPHeader.myheader）が新しい値 {blank} で http.properties に設定されています。これは、特定の HTTP ヘッダー Expires（および myheader）について、重複や複数の値を許可する動作が Message Processor で正常に無効にされていることを示します。

5. プロパティ HTTPHeader.Expires (or HTTPHeader.myheader) に古い値が引き続き表示される場合は、allowDuplicates とヘッダーの複数の値の構成で説明されているすべてのステップに正しく従っていることを確認してください。ステップを見逃した場合は、すべてのステップを正しく繰り返します。

   プロキシが想定どおりに動作することを確認します。特に、プロキシのヘッダーを取得して設定するための機能ロジックがある場合は、確認します。

6. それでもプロパティを変更できない場合は、Apigee Edge サポートに連絡してください。