プロキシー・アクションの管理

新規プロキシー・アクションを作成したり、既存のプロキシー・アクションを管理したりすることができます。 プロキシー・サーバー・アクションは、HTTP 要求または HTTP 応答がプロキシー仮想ホストにより受信される際に実行されるイベントです。 プロキシー・サーバー・アクションの一例としては、キャッシング・アクション、再書き込みアクション、圧縮アクション、ヘッダー変更アクション、およびルーティング・アクションなどがあります。

事前処理

プロキシー・アクションは、プロキシー・ルール式と関連付けられていなければ実行されません。 プロキシー・ルール式は、プロキシー仮想ホストと関連付けられている場合にのみ評価されます。 プロキシー・アクションは、プロキシー・ルール式またはプロキシー仮想ホストを使用せずに作成したり管理したりすることができますが、これらがないと使用できません。

このタスクの概要

プロキシー・アクションはプロキシー・ルール式と関連付けられます。 プロキシー・ルール式が true と評価されると、プロキシー・ルール式構成で指定されたすべてのプロキシー・アクションが実行されます。 新規プロキシー・アクションを作成したり、プロキシー・サーバーの既存のプロキシー・アクションを管理したりするには、以下のステップを実行します。

手順

  1. 管理コンソールから、サーバー > サーバーの種類 >WebSphereプロキシサーバー >プロキシサーバー名> 代理アクション
  2. オプション:既存のプロキシ アクション構成を管理します。
    1. クリックプロキシアクション名既存のプロキシアクションの設定を表示または変更する場合。 プロキシー・アクション構成を変更した場合は、「OK」をクリックして変更を保存します。
    2. クリック消去選択されている既存のプロキシアクションを削除します。
  3. キャッシュプロキシアクションを作成する場合は、新しいキャッシュアクション
    1. 「アクション名」フィールドにプロキシー・アクションの名前を入力します。
      アクション名は、このプロキシー・アクション構成の固有 ID として使用されます。 アクション名はセルで固有でなければならず、また、#、&#xa5;、/、,、:、;、"、*、?、<、>、|、=、+、&、%、'、. の各文字は使用できません。
    2. を選択キャッシュを有効にするキャッシュを有効にするにはチェックボックスをオンにします。
    3. 秒数を入力してくださいデフォルトの有効期限分野。
      「デフォルトの有効期限」フィールドには、キャッシュされた応答の有効期限が切れるまでの時間 (秒単位) を指定します。
    4. 秒数を入力してください最終更新日要素。
      「最終変更要因」フィールドには、応答に明示的な HTTP 有効期限ヘッダーがない場合にその応答がキャッシュされるまでの時間を指定します。
    5. クリックわかりましたプロキシアクション構成を保存します。
  4. 圧縮アクションを作成する場合は、 [新規 ] → [ HTTP リクエスト圧縮アクション] をクリックしてリクエスト用のアクションを作成するか、 [新規 ] → [ HTTP レスポンス圧縮アクション] をクリックしてレスポンス用のアクションを作成します。
    1. プロキシアクションの名前をアクション名分野。
      アクション名は、このプロキシー・アクション構成の固有 ID として使用されます。 アクション名はセルで固有でなければならず、また、#、&#xa5;、/、,、:、;、"、*、?、<、>、|、=、+、&、%、'、. の各文字は使用できません。
    2. 「圧縮タイプ」メニューから適切な圧縮タイプを選択します。
    3. 圧縮対象とするコンテンツ・タイプを選択します。
      圧縮対象の複数のコンテンツ・タイプを選択できます。 「新規」をクリックして新規のコンテンツ・タイプをリストに追加します。 リストからコンテンツ・タイプを除去する場合は、除去するコンテンツ・タイプを選択してから「削除」をクリックします。
    4. クリックわかりましたプロキシアクション構成を保存します。
  5. ヘッダーアクションを作成するには、リクエスト用のアクションを作成するには 「新規 HTTP リクエストヘッダーアクション」 をクリックし、レスポンス用のアクションを作成するには「 新規 HTTP レスポンスヘッダーアクション 」をクリックします。
    1. プロキシアクションの名前をアクション名分野。
      アクション名は、このプロキシー・アクション構成の固有 ID として使用されます。 アクション名はセルで固有でなければならず、また、#、&#xa5;、/、,、:、;、"、*、?、<、>、|、=、+、&、%、'、. の各文字は使用できません。
    2. ヘッダー名フィールドに、変更する HTTP ヘッダーの名前を入力してください。
    3. 適切なアクションを選択してくださいヘッダー変更アクションメニュー。
      使用可能なヘッダー変更アクションは次のとおりです。
      • 設定
      • 追加
      • 編集
      • 除去
    4. ヘッダー変更アクションで使用する値をヘッダー値分野。
    5. ヘッダー値に対して実行する式をヘッダー値式分野。
      ヘッダーの値式が評価され、評価が一致を戻した場合は変更アクションが実行されます。
    6. HTTP 要求ヘッダー・アクションを作成している場合は、実行されるヘッダー変更アクションに適したメソッドを選択します。
      複数のメソッドを選択することができます。 「新規」をクリックして新規メソッドをリストに追加します。 リストからメソッドを除去する場合は、除去するメソッドを選択して、「削除」をクリックします。
    7. HTTP 応答ヘッダー・アクションを作成している場合は、実行されるヘッダー変更アクションに適した状況コードを選択します。
      含める複数の状況コードを選択できます。 「新規」をクリックして新しい状況コードをリストに追加します。 リストから状況コードを除去する場合は、除去する状況コードを選択して、「削除」をクリックします。
    8. クリックわかりましたプロキシアクション構成を保存します。
  6. 書き換えアクションのプロキシアクションを作成する場合は、新しい書き換えアクション
    1. プロキシアクションの名前をアクション名分野。
      アクション名は、このプロキシー・アクション構成の固有 ID として使用されます。 アクション名はセルで固有でなければならず、また、#、&#xa5;、/、,、:、;、"、*、?、<、>、|、=、+、&、%、'、. の各文字は使用できません。
    2. 実行する再書き込みアクションのタイプを、「再書き込みアクション・タイプ (Rewriting action types)」メニューで選択します。
      このタイプのプロキシー・アクションを使用して、以下のエレメントを再書き込みできます。
      • 絶対 URL 応答
      • リダイレクト・ロケーション・ヘッダー
      • リダイレクト状況コード
      • 相対 URL 応答
      • Cookie ドメインの設定
      • Cookie パスの設定
    3. From パターン 」フィールドに、書き換え対象となる件名パターン( URL )を入力してください。
    4. 書き換えが行われた後、結果の URL パターンを 「宛先パターン 」フィールドに入力してください。
    5. オプション:選択するパッシブリライトを有効にするクライアントからその URI に対する後続のリクエストが送信されるまで、URI の書き換えを延期します。
    6. オプション:の中にクッキー名フィールドに、ドメインまたはパスを書き換える Cookie の名前を入力します。
      このフィールドは、再書き込みアクションの Cookie 設定タイプに対してのみ有効です。
    7. オプション: [Limit URL パターン ] フィールドで、レスポンスメッセージ内で書き換える URL パターンに対する制約を指定します。
      URL パターンを制限することにより、プロキシー・サーバーがあるページの応答メッセージのすべての URL パターンを再書き込みするのを防ぐことができます。 このフィールドは、絶対 URL 応答アクション・タイプまたは相対 URL 応答アクション・タイプに対してのみ有効です。
    8. オプション:の中にCookieドメインの制限フィールドで、Cookie ドメインの書き換えを指定されたドメインのセットのみに制限する制約を指定します。
      ドメインが指定されていない場合は、すべてのドメインが再書き込みされます。 このフィールドは再書き込みアクションの Cookie 設定タイプに対してのみ有効です。
    9. オプション:の中にCookie パスの制限フィールドで、Cookie パスの書き換えを指定されたパスのセットのみに制限する制約を指定します。
      パスが指定されていない場合は、すべてのパスが再書き込みされます。 このフィールドは再書き込みアクションの Cookie 設定タイプに対してのみ有効です。
    10. クリックわかりましたプロキシアクション構成を保存します。
  7. ルーティング プロキシ アクションを作成する場合は、次のいずれかをクリックします。新しいアプリケーション サーバー ルート新しい汎用サーバー クラスター ルート新しい失敗ルート新しいリダイレクトルート、 または新しいローカルルート
    1. プロキシアクションの名前をアクション名分野。
      アクション名は、このプロキシー・アクション構成の固有 ID として使用されます。 アクション名はセルで固有でなければならず、また、#、&#xa5;、/、,、:、;、"、*、?、<、>、|、=、+、&、%、'、. の各文字は使用できません。
    2. 新規アプリケーション・サーバー経路を作成する場合は、以下の追加ステップを実行します。
      1. 「開始時刻」フィールドに、このルーティング・ルールの開始時刻を入力します。 開始時刻を 12 時間クロックを使用して指定する場合は、「AM」または「PM」をクリックします。 開始時刻を 24 時間クロックを使用して指定する場合は、「24 時間 (24-hour)」をクリックします。
      2. 「終了時刻」フィールドに、このルーティング・ルールの終了時刻を入力します。 終了時刻を 12 時間クロックを使用して指定する場合は、「AM」または「PM」をクリックします。 終了時刻を 24 時間クロックを使用して指定する場合は、「24 時間 (24-hour)」をクリックします。
      3. 「含める (Include)」または「除外する (Exclude)」を「アクション」メニューから選択して、構成しているルールのタイプを指定します。
      4. このルールに従うアプリケーション・サーバーを、「使用可能なアプリケーション・サーバー (Available application servers)」メニューから選択します。
      5. クリック>
      6. 有効なアプリケーションサーバーメニューからアプリケーションサーバーを削除する場合は、有効なアプリケーションサーバーメニューからそのサーバーを選択し、 <
    3. 新規汎用サーバー・クラスター経路を作成する場合は、以下の追加ステップを実行します。
      1. このルールに従う汎用サーバー・クラスターを「汎用サーバー・クラスター名」メニューから選択します。
      2. 「アフィニティー・タイプ」として「アクティブなアフィニティー」または「受動のアフィニティー」のいずれかを選択します。
      3. 「アクティブなアフィニティー」を選択した場合は、有効期限の時間を「デフォルトの有効期限」フィールドに秒数で入力します。
      4. 「受動のアフィニティー」を選択した場合は、アフィニティーを管理するためにプロキシー・サーバーが使用する Cookie の名前を「Cookie 名」フィールドに入力します。
      5. 「受動のアフィニティー」を選択した場合は、アフィニティーを管理するためにこの Cookie が使用される汎用サーバー・マッピングを選択します。 追加のマッピングを作成する必要がある場合は、「新規」をクリックします。 既存の Cookie マッピングを除去する必要がある場合は、適切なマッピングを選択して「削除」をクリックします。
      6. クリック新しいタイムマッピング
      7. 「開始時刻」フィールドに、このルーティング・ルールの開始時刻を入力します。 このルールを常時適用する場合は、「24 時間 (24-hour)」を選択します。
      8. 「終了時刻」フィールドに、このルーティング・ルールの終了時刻を入力します。 このルールを常時適用する場合は、「24 時間 (24-hour)」を選択します。
      9. 「含める (Include)」または「除外する (Exclude)」を「アクション」メニューから選択して、構成しているルールのタイプを指定します。
      10. このルールに従うクラスター・メンバーを「使用可能な汎用サーバー・クラスター・メンバー (Available generic server cluster members)」メニューから選択します。
      11. クリック>
      12. 有効な汎用サーバークラスターメンバーメニューからクラスターメンバーを削除する場合は、有効な汎用サーバークラスターメンバーメニューからそのクラスターメンバーを選択し、 <
      13. 「OK」 をクリックして時刻の設定ルールに戻り、汎用サーバー・クラスター経路構成の作成を続けます。
    4. 失敗ルートを作成する場合は、次の追加手順に従います。失敗ステータスコードフィールドに、リクエストが成功しなかったことを示すために使用するステータス コードを入力します。
    5. リダイレクト ルートを作成する場合は、次の追加手順に従います。 [リダイレクト URL フィールドに、受信要求をリダイレクトするために使用する URL を入力します。
    6. ローカル経路を作成する場合は、次の追加ステップに従います。静的ファイルのドキュメント・ルートが正しいことを確認します。 リストされている値が希望するドキュメント・ルートではない場合は、「編集」をクリックします。 見るプロキシ仮想ホストの管理静的ファイルのドキュメント ルートを変更する方法の詳細については、こちらをご覧ください。
  8. クリックわかりましたプロキシアクションルールの作成を完了します。