Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理ガイド

- Previous: メッセージセキュリティーのプロバイダを有効にする
- Next: メッセージセキュリティープロバイダの作成

## メッセージセキュリティープロバイダを設定する

プロバイダの再設定は通常、そのメッセージ保護ポリシーを変更するために行われますが、プロバイダのタイプ、実装クラス、およびプロバイダ固有の設定プロパティーも変更可能です。

##### 手順

1. 管理コンソールのツリーコンポーネントで、「設定」ノードを展開します。

2. 設定するインスタンスを選択します。

   - 特定のインスタンスを設定するには、そのインスタンスの設定ノードを選択します。たとえば、デフォルトインスタンス `server` の場合は、`server-config` ノードを選択します。

   - すべてのインスタンスのデフォルト値を設定するには、`default-config` ノードを選択します。

3. 「セキュリティー」ノードを展開します。

4. 「メッセージセキュリティー」ノードを展開します。

5. 「SOAP」ノードを選択します。

6. 「プロバイダ」タブを選択します。

7. 編集するメッセージセキュリティープロバイダを選択します。

   Application Server には `ClientProvider` と `ServerProvider` が付属しています。

8. 「プロバイダ設定の編集」の「プロバイダ設定」セクションで、次のプロパティーが変更に使用できます。

   - プロバイダタイプ – `client`、`server`、または `client-server` を選択して、プロバイダがクライアント認証プロバイダ、サーバー認証プロバイダ、あるいはこの両方 (クライアント - サーバープロバイダ) のいずれかとして使用されるようにします。

   - クラス名 - プロバイダの Java 実装クラスを入力します。クライアント認証プロバイダは、`com.sun.enterprise.security.jauth.ClientAuthModule` インタフェースを実装する必要があります。サーバー側プロバイダは、`com.sun.enterprise.security.jauth.ServerAuthModule` インタフェースを実装する必要があります。プロバイダはどちらのインタフェースも実装可能ですが、プロバイダタイプに対応したインタフェースを実装している必要があります。

9. 「プロバイダ設定の作成」ページの「要求ポリシー」セクションで、必要に応じて、次のオプションの値を入力します。

   これらのプロパティーはオプションですが、指定されない場合、認証はメッセージの要求にまったく適用されません。

   「要求ポリシー」は、認証プロバイダが実行する要求処理に関連付けられた認証ポリシー要件を定義します。ポリシーはメッセージ送信者の順序で送信されます。この順序では、コンテンツのあとで暗号化するという要件は、メッセージ受信者がメッセージの復号化を行なってから署名の検証を想定することを意味しています。

   - 認証元– `sender`、`content`、または null (空白オプション) を選択して、メッセージレイヤー送信者認証 (ユーザー名、パスワードなど)、コンテンツ認証 (デジタル署名など) の要件を定義するか、あるいはメッセージの要求に認証を適用しないようにします。null が指定される場合、要求のソース認証は必須ではありません。

   - 認証受信者– `beforeContent` または `afterContent` を選択し、XML 暗号化などを使用して、送信者に対する要求メッセージの受信者のメッセージレイヤー認証要件を定義します。値が指定されない場合、デフォルトでは `afterContent` に指定されます。

   SOAP メッセージセキュリティープロバイダがメッセージ保護ポリシーに従った決定として実行されるアクションについては、「要求および応答ポリシー設定のアクション」を参照してください。

10. 「プロバイダ設定の作成」ページの「応答ポリシー」セクションで、必要に応じて、次のオプションの値を入力します。

    これらのプロパティーはオプションですが、指定されない場合、認証はメッセージの応答にまったく適用されません。

    「応答ポリシー」は、認証プロバイダが実行する応答処理に関連付けられた認証ポリシー要件を定義します。ポリシーはメッセージ送信者の順序で送信されます。この順序では、コンテンツのあとで暗号化するという要件は、メッセージ受信者がメッセージの復号化を行なってから署名の検証を想定することを意味しています。

    - 認証元 – `sender`、`content`、または null (空白オプション) を選択して、メッセージの応答に適用されるように、メッセージレイヤー送信者認証 (ユーザー名、パスワードなど) またはコンテンツ認証 (デジタル署名など) の要件を定義します。null が指定される場合、応答のソース認証は必須ではありません。

    - 認証受信者 – `beforeContent` または `afterContent` を選択し、XML 暗号化などを使用して、送信者に対する応答メッセージの受信者のメッセージレイヤー認証要件を定義します。値が指定されない場合、デフォルトでは `afterContent` に指定されます。

    SOAP メッセージセキュリティープロバイダがメッセージ保護ポリシーに従った決定として実行されるアクションについては、「要求および応答ポリシー設定のアクション」を参照してください。

11. 「プロパティーを追加」ボタンをクリックして、プロパティーをさらに追加します。

    Application Server に同梱されるプロバイダは、次に表示するプロパティーをサポートします。ほかのプロバイダが使用されている場合、プロパティーおよび有効な値の詳細については、該当するドキュメントを参照してください。

    - `server.config` – サーバー設定情報を収める XML ファイルのディレクトリおよびファイル名。たとえば、domain-dir`/config/wss-server-config.xml`。

12. 「保存」をクリックします。

##### 同機能を持つ asadmin コマンド

応答ポリシーを設定するには、次のコマンドの `request` を `response` に置き換えます。

- 要求ポリシーをクライアントに追加して、認証元を設定します。

      asadmin  set --user  admin-user --port admin-port
      server-config.security-service.message-security-config.SOAP.
      provider-config.ClientProvider.request-policy.auth_source=
      sender | content

- 要求ポリシーをサーバーに追加して、認証元を設定します。

      asadmin  set --user  admin-user --port admin-port
      server-config.security-service.message-security-config.SOAP.
      provider-config.ServerProvider.request-policy.auth_source=
      sender | content

- 要求ポリシーをクライアントに追加して、認証受信者を設定します。

      asadmin  set --user  admin-user --port admin-port
      server-config.security-service.message-security-config.SOAP.
      provider-config.ClientProvider.request-policy.auth_recipient=
      before-content | after-content

- 要求ポリシーをサーバーに追加して、認証受信者を設定します。

      asadmin  set --user  admin-user --port admin-port
      server-config.security-service.message-security-config.SOAP.
      provider-config.ServerProvider.request-policy.auth_recipient=
      before-content | after-content

- Previous: メッセージセキュリティーのプロバイダを有効にする
- Next: メッセージセキュリティープロバイダの作成

- © 2010, Oracle Corporation and/or its affiliates