HTTP トランスポート・ポリシーの構成
管理コンソールでポリシー・セットを処理する場合は、 ポリシーをカスタマイズして、メッセージ・セキュリティーを確保できます。 Hypertext Transfer Protocol (HTTP) トランスポート・ポリシーの構成をカスタマイズすることも、 デフォルト設定で提供されたポリシーをそのまま使用することもできます。
始める前に
このタスクについて
HTTP トランスポート・ポリシーを使用して HTTP トランスポートを構成することができます。 HTTP は、分散型の共同ハイパーメディア情報システム向けのアプリケーション・レベルのプロトコルです。 このプロトコルは、汎用のステートレス・プロトコルであり、 要求メソッド、エラー・コードおよびヘッダーを拡張することにより、ハイパーテキスト用に使用する以外に、 多くのタスク (ネーム・サーバーや分散オブジェクト管理システムなど) にも使用できます。 HTTP の主要な機能として、データ表記のタイプ入力とネゴシエーションがあります。これにより、 システムは転送中のデータに影響されることなく構築されます。 HTTP 機能ポリシーおよび HTTP 接続プロパティーは、サービス・クライアントとサービス・プロバイダーの両方のアウトバウンド・メッセージに適用されます。
ポリシーは、ポリシー・セットを通じてのみ構成可能です。 そのため、HTTP トランスポート・ポリシーを構成する前に、その HTTP トランスポート・ポリシーを含むポリシー・セットが存在している必要があります。 提供されるデフォルトの WSHTTPS ポリシー・セットは読み取り専用で、編集することはできません。 HTTP トランスポート・ポリシーを含むポリシー・セットをカスタマイズするには、まず最初に WSHTTPS デフォルト・ポリシー・セットのコピーを作成するか、新規のポリシー・セットを作成して、その新規ポリシー・セットに HTTP トランスポート・ポリシーを追加する必要があります。
トラブルの回避 (Avoid trouble): WSHTTPS デフォルト・ポリシー・セットには、HTTP トランスポート・ポリシー、SSL トランスポート・ポリシーおよび WS-Addressing ポリシーが含まれています。SSL トランスポート・ポリシーまたは WS-Addressing ポリシーを必要としない場合は、WSHTTPS デフォルト・ポリシー・セットのコピーをカスタマイズして、必要のないポリシーを削除してもかまいません。gotchaWSHTTPS デフォルト・ポリシー・セットのコピーを作成、または追加した HTTP トランスポート・ポリシーを使用してポリシー・セットを新規作成したら、HTTP トランスポート・ポリシーをカスタマイズできます。 「HTTP トランスポート・ポリシー設定」パネルを使用して、読み取りタイムアウトまたは書き込みタイムアウトの値などの、HTTP トランスポート・ポリシー・プロパティーの値をカスタマイズします。 これで、カスタマイズした HTTP トランスポート・ポリシーの値が、そのカスタム HTTP トランスポート・ポリシーを含んでいるポリシー・セットに適用されます。カスタマイズ済みの HTTP トランスポート・ポリシーを含むこのポリシー・セットは、Java API for XML-Based Web Services (JAX-WS) アプリケーション、そのサービス、エンドポイント、または操作に関連付けることができます。この変更は、そのポリシー・セットが関連付けられているすべての JAX-WS アプリケーションに影響します。 アプリケーションへのポリシー・セットの関連付けについて詳しくは、アプリケーション・レベルでのサービス・プロバイダーおよびサービス・クライアントのポリシー・セットの管理に関する文書を参照してください。
例えば、HTTP トランスポート・ポリシーを含む、mypolicyset1 や mypolicyset2 など、複数のポリシー・セットがある場合、ポリシー・セットごとに HTTP トランスポート・ポリシーをカスタマイズして、タイムアウト値などのさまざまなプロパティーを反映させることができます。 この時点で、カスタマイズ済みポリシー・セットを 1 つ以上のアプリケーションに関連付けることができます。これらのアプリケーションでは、関連付けられたポリシー・セット内に含まれる HTTP トランスポート・ポリシーに関連付けられた HTTP プロパティー値を使用します。
手順
タスクの結果
例
アプリケーション、そのサービス、エンドポイント、または操作にポリシー・セットを関連付けることができます。 このシナリオ例では、アプリケーション用に 2 つの異なる JAX-WS サービス・クライアントを使用しているが、サービス・クライアントごとに別の HTTP トランスポート・プロパティー値を使用するものとします。 特に、読み取りまたは書き込みのタイムアウト値については、サービス・クライアントごとに異なる値を構成します。 HTTP タイムアウト値を変更する場合、アプリケーション (この場合、サービス・クライアント) に関連付けられたポリシー・セット内に含まれる HTTP トランスポート・ポリシーの値を編集することができます。 この変更内容は、カスタム HTTP トランスポート・ポリシーを含むポリシー・セットが関連付けられているすべてのアプリケーションに影響します。
- アプリケーション・サーバーにデプロイされている ServiceClient1 と ServiceClient2 という名前の 2 つの JAX-WS サービス・クライアントがあります。
- HTTP トランスポート・ポリシーはまだアプリケーションに関連付けられていません。
- 2 つのポリシー・セットを新規作成して、それらに HTTP トランスポート・ポリシーを追加します。
例えば、HTTPServiceClient1Policy および HTTPServiceClient2Policy のようになります。
- をクリックします。
- 新規アプリケーション・ポリシー・セットの名前 HTTPServiceClient1Policy を入力します。
- 「ポリシー」コレクションで、をクリックします。
- との順にクリックして、マスター構成に対して行った 変更を保存します。
- 上記手順を繰り返して、HTTPServiceClient2Policy を作成します。
- 新規作成した HTTPServiceClient1Policy ポリシー・セットと HTTPServiceClient2Policy ポリシー・セットの HTTP トランスポート・ポリシー設定をカスタマイズします。例えば、HTTPServiceClient1Policy ポリシー・セットに含まれる HTTP トランスポート・ポリシーの読み取りと書き込みのタイムアウト値、および HTTPServiceClient2Policy ポリシー・セットに含まれる HTTP トランスポート・ポリシーの接続タイムアウト値をカスタマイズします。
- 「HTTPServiceClient1Policy」をクリックします。
- 「ポリシー」コレクションで、をクリックします。
- 「HTTP トランスポートのポリシー構成」パネルで、HTTP 接続の読み取りと書き込みのタイムアウト値を 500 秒に変更します。
- との順にクリックして、マスター構成に対して行った 変更を保存します。
- 「HTTPServiceClient2Policy 」をクリックします。
- 「ポリシー」コレクションで、をクリックします。
- 「HTTP トランスポートのポリシー構成」パネルで、HTTP 接続タイムアウト値を 360 秒に変更します。
- との順にクリックして、マスター構成に対して行った 変更を保存します。
- カスタム HTTP トランスポート・ポリシー HTTPServiceClient1Policy をアプリケーション ServiceClient1 に関連付けます。 同様に、カスタム HTTP トランスポート・ポリシー HTTPServiceClient2Policy をアプリケーション ServiceClient2 に関連付けます。
- 「ServiceClient1」をクリックします。
- 「ポリシー・セット関連付け (Policy set attachments)」コレクションから、ServiceClient1 というサービスを選択します。
- 「」をクリックして HTTPServiceClient1Policy をクリックします。
- 「」をクリックして、マスター構成に対して行った変更を保存します。
- 「ServiceClient2」をクリックします。
- 「ポリシー・セット関連付け (Policy set attachments)」コレクションから、ServiceClient2 というサービスを選択します。
- 「」をクリックして HTTPServiceClient2Policy をクリックします。
- 「」をクリックして、マスター構成に対して行った変更を保存します。
これで、ServiceClient1 アプリケーションに HTTPServiceClient1Policy が関連付けられ、HTTP セッションで 500 秒の読み取りおよび書き込みのタイムアウト値が使用されます。 また、ServiceClient2 アプリケーションに HTTPServiceClient2Policy が関連付けられ、HTTP セッションで 360 秒の接続タイムアウト値が使用されます。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
タスク・トピック