2 WebLogic ServerでのOWSMの使用

Oracle Web Services Managerは、WebLogic Serverにインストールできます。OWSMを構成することにより、ドメイン全体の管理ポートの使用、デフォルト・ユーザーの変更およびWebLogic Serverドメイン間のOWSMポリシー・マネージャの共有を行うことができます。

この章の構成は、次のとおりです。

• 第2.1項「WebLogic Serverと一緒のOWSMのインストール」

• 第2.2項「ドメイン全体の管理ポートでのOWSMの構成」

• 第2.3項「ポリシー・マネージャの自動検出のためのクロス・コンポーネント・ワイヤリングの使用」

• 第2.4項「デフォルト・ユーザーの変更」

2.1 WebLogic Serverと一緒のOWSMのインストール

OWSMは、Oracle Fusion Middleware Infrastructureのインストール時にデフォルトでインストールされます。ただし、JAX-WS WebサービスとクライアントがデプロイされているスタンドアロンのWebLogic Server環境がある場合、OWSMをインストールしてWebサービスとクライアントを保護するために使用できます。

注意: OWSMは、SOA Suiteを通じてのみライセンス付与できます。スタンドアロン・ライセンスは利用できません。ライセンスの詳細は、『Oracle Fusion Middlewareライセンス情報』を参照してください。

WebLogic ServerとともにOWSMを使用するには、Java Required Files (JRF)とOracle Enterprise Manager Fusion Middleware Controlが必要です。JRFは、Oracleビジネス・アプリケーションやアプリケーション・フレームワークに一般的な機能を提供するコンポーネントで構成されています。Oracle Enterprise Manager Fusion Middleware Controlは、Java EE (WebLogic) Webサービスを保護および管理するために使用できます。

Oracle Fusion Middleware Infrastructureの標準インストール・トポロジには、OWSM、JRFおよびEnterprise Managerが含まれています。このトポロジの詳細および詳細なインストール手順は、『Oracle Fusion Middleware Infrastructureのインストールと構成』を参照してください。WebLogic ServerとともにOWSMを使用するには、そのマニュアルの手順に従ってOracle Fusion Middleware Infrastructureの標準インストール・トポロジをインストールして構成してください。

インストールとドメインの構成が完了したら、このマニュアルの説明に従って、OWSMを使用してJava EE (WebLogic) JAX-WS Webサービスを保護できます。OWSMポリシーは、JAX-RPC Webサービスにアタッチできません。

Java EE (WebLogic) Webサービスの管理手順は、『Webサービスの管理』を参照してください。

2.2 ドメイン全体の管理ポートでのOWSMの構成

管理ポートを使用するようドメインが構成されている場合、管理者が実行するすべてのタスクはこのポートを経由する必要があります。デフォルトでは、OWSMポリシー・マネージャのターゲットは管理対象サーバーです。管理ポートでポリシー・マネージャを使用するには、ポリシー・マネージャのターゲットを管理対象サーバーおよび管理サーバーにする必要があります。

管理ポートの詳細は、次のトピックを参照してください。

• 『Oracle WebLogic Serverサーバー環境の管理』のネットワーク・チャネルの理解に関する項。

• Oracle WebLogic Server管理コンソール・オンライン・ヘルプのドメイン全体の管理ポートの構成に関する項。

ドメイン全体の管理ポートでOWSMを構成する手順は、次の2つに大きく分けられます。

手順1: WebLogic管理コンソールを使用して、ポリシー・マネージャのターゲットに管理サーバーを指定します。

1. Oracle Fusion Middlewareを使用したWebサービスの管理のOracle WebLogic管理コンソールへのアクセスに関する項での説明に従って、WebLogic管理コンソールにアクセスします。

   または、Fusion Middleware Controlで、WebLogicドメインのホーム・ページからWebLogic管理コンソールにアクセスすることもできます。その手順は、次のとおりです。

   1. Oracle Fusion Middlewareを使用したWebサービスの管理のOracle Enterprise Manager Fusion Middleware Controlへのアクセスに関する項での説明に従って、Fusion Middleware Controlにログインします。

   2. ナビゲータ・ペインで「WebLogicドメイン」を開き、管理コンソールにアクセスする対象のドメインを選択します。

      WebLogicドメインのホーム・ページが表示されます。

   3. 「WebLogicドメイン」メニューから、「WebLogic Server管理コンソール」を選択します。または、ページの「サマリー」セクションにある「Oracle WebLogic Server管理コンソール」リンクをクリックします。

   4. 「ようこそ」ページで、有効なユーザー名とパスワードを使用してログインします。

2. 管理コンソールの左ペインで、「デプロイメント」をクリックします。すべてのデプロイ済のエンタープライズ・アプリケーションとアプリケーション・モジュールを示す表が右ペインに表示されます。

3. この表で、ターゲットの再指定を行うwsm-pmアプリケーションを見つけて、その名前をクリックします。アプリケーションを見つけるには、「次」を数回クリックする必要がある場合があります。

   アプリケーションの「設定」ページが表示されます。

4. 「ターゲット」タブをクリックします。

   表の「現在のターゲット」列に、ポリシー・マネージャ・アプリケーションのターゲットであるサーバーが表示されます。

5. wsm-pmアプリケーションのターゲットをAdminServerにするには、「ターゲットの変更」をクリックします。

6. 「サーバー」ボックスで、「AdminServer」がまだ選択されていない場合はこれを選択し、「はい」をクリックします。

   変更は自動的にアクティブ化されます。

手順2: Fusion Middleware Controlを使用して、管理サーバー上のポリシー・マネージャのポリシー・アクセッサURLを指定します。

1. 「「WSMドメイン構成」ページへの移動」での説明に従って、「WSMドメイン構成」ページにアクセスします。

2. 「ポリシー・アクセス」タブを選択します。

3. このページの「ポリシー・マネージャ」セクションで、自動検出チェック・ボックスの選択を解除します。ポリシー・マネージャのURLの「編集」ボタンが有効になります。

4. ポリシー・マネージャのURLの「編集」ボタンをクリックします。

5. 「ポリシー・マネージャのURL値の編集」ページで+記号をクリックして、t3s://host:admin_port/wsm-pmなどの管理サーバーのURLを入力ます。

   たとえば、t3s://localhost:9002/wsm-pmと入力します。

   これは、管理サーバーで実行しているポリシー・マネージャの場所を指定します。

6. 「OK」をクリックするとウィンドウが閉じます。

7. ポリシーへのアクセス・ページで、「適用」をクリックします。

2.3 ポリシー・マネージャの自動検出のためのクロス・コンポーネント・ワイヤリングの使用

クロス・コンポーネント・ワイヤリングは、Fusion Middlewareコンポーネントをワイヤリングするための簡素化された方法を提供します。ワイヤリング・プロセスを自動化し、ワイヤリングの確立後に診断を行うことができます。

ワイヤリングは別のコンポーネントを指す1つのコンポーネントの構成の一部分で、コンポーネントの管理インタフェースを指すURLなどがあります。クロス・コンポーネント・ワイヤリングを使用すると、次のようになります。

• サービス・プロバイダは、サービス表にエンドポイントを公開します。これらのエンドポイントは、構成ウィザードを使用してドメインの作成や拡張を行ったときなどに自動的に公開することも、管理者が手動で公開することもできます。

• クライアントにはサービスを指す構成を含みます(サービスURLなど)。サービス表に公開されたサービス情報を含むこの構成を更新することで、クライアントはサービスにバインドされます。バインドは、構成ウィザードを使用してドメインの作成や拡張を行ったときなどに自動的に実行することも、管理者が手動で実行することもできます。

WebLogic ServerにFusion Middlewareをインストールして構成すると、ローカル・サービス表が作成されます。これにより、サービス・プロバイダはサービスのエンドポイント情報を公開し、これらのサービスのクライアントはそのサービスへの問合せとバインドを行います。ローカル・サービス表のスコープはドメインで、そのドメインが提供するサービスも含まれます。サービス表およびクロス・コンポーネント・ワイヤリングの詳細は、『Oracle Fusion Middlewareの管理』のクロス・コンポーネント・ワイヤリングに関する項を参照してください。

OWSMはクロス・コンポーネント・ワイヤリングを使用して、ドメイン内のポリシー・マネージャを自動検出します。構成ウィザードを使用してOWSMを含むドメインを作成または更新するとき、ローカル・サービス表にポリシー・マネージャURLが公開されます。構成マネージャやポリシー・アセス・ポイント(PAP)などのクライアント側のOWSMサブコンポーネントの集合であるOWSMエージェント・フックは、ローカル・サービス表に公開されたエンドポイント・エントリを使用して、OWSMポリシー・マネージャに自動的にワイヤリングされます。

ただし、構成ウィザード(WebLogic管理コンソール、Fusion Middleware ControlまたはWLSTなど)以外のツールを使用してドメインを変更した場合、ポリシー・マネージャURLへの変更は自動的にローカル・サービス表に公開されますが、OWSMエージェント・フックのクライアントは自動的に新しいURLにバインドされません。この場合、ポリシー・マネージャURLにOWSMエージェント・フックを手動でバインドする必要があります。詳細は、「Fusion Middleware Controlを使用したエージェント・バインディングの確認」を参照してください。

自動検出の設定の変更や無効化が行えます。この手順について次の各項で説明します。

• 「Fusion Middleware Controlを使用したポリシー・マネージャ接続の構成」

• 「WLSTを使用したポリシー・マネージャ接続の構成」

2.3.1 Fusion Middleware Controlを使用したサービス表エントリとコンポーネントの確認

サービス表エントリにポリシー・マネージャの正しいURLが含まれていることを確認する手順は次のとおりです。

• 「サービス表」ページの使用

  1. 「WebLogicドメイン」メニューから、「クロス・コンポーネント・ワイヤリング」→「サービス表」を選択します。

  2. 「サービス表」で、「接続」列のURLと「最終公開日」の日付に、「サービスID」がurn:oracle:fmw.owsm-pm:t3のOWSMポリシー・マネージャの正しい情報が反映されていることを確認します。

• 「コンポーネント」ページの使用

  1. 「WebLogicドメイン」メニューから、「クロス・コンポーネント・ワイヤリング」→「コンポーネント」を選択します。

  2. 「コンポーネント・タイプ」表で、OWSMポリシー・マネージャを選択します。

  3. 「サービス・エンド・ポイント」表で、「接続」列に正しいURLが表示されており、「サービスID」がurn:oracle:fmw.owsm-pm:t3のOWSMポリシー・マネージャのステータスがPublishedになっていることを確認します。ステータスがPublishedではない場合(たとえばOut of Sync)、このページを使用してポリシー・マネージャ接続を公開することもできます。これを行うには、表からそのポリシー・マネージャを選択し、「公開」をクリックします。

2.3.2 Fusion Middleware Controlを使用したエージェント・バインディングの確認

OWSMエージェント・フックが適切なポリシー・マネージャURLに正しくワイヤリングされていることを確認する手順は次のとおりです。

1. 「WebLogicドメイン」メニューから、「クロス・コンポーネント・ワイヤリング」→「コンポーネント」を選択します。

2. 「コンポーネント」表で、OWSMエージェント・フックを選択します。

3. 「クライアント構成」表で、「クライアントID」がowsm-agent-hook-t3の「接続」列に正しいポリシー・マネージャURLが反映されており、「ステータス」列のステータスがWiredとして表示されていることを確認します。

   「ステータス」列にOut of Syncが表示されている場合、エージェントをポリシー・マネージャにバインドする必要があります。これを行うには:

   1. 「クライアント構成」表からowsm-agent-hook-t3を選択し、「バインド」をクリックします。

   2. 「クライアント構成のバインド」ページで、「サービス・エンド・ポイント」に正しいポリシー・マネージャURLが含まれていることを確認し、「はい」をクリックします。

      「コンポーネント」ページに確認メッセージが表示され、エージェントのステータスがWiredに変更されます。

2.4 デフォルト・ユーザーの変更

OWSMエージェント・ランタイムは、デフォルトではOracleSystemUserアカウントとOracleSystemGroupを使用して、サーバーとの通信を行います。

デフォルト・ユーザーを変更するには、次の項で説明する手順を実行します。

• 認証プロバイダの構成

• 資格証明ストア・プロバイダの構成

• ドメインのポリシー・マネージャCSFキーの構成

• ユーザーのグループまたはロールの変更

2.4.1 認証プロバイダの構成

認証プロバイダを構成するには、次の手順を実行します。

1. Oracle WebLogic Server管理コンソール・オンライン・ヘルプの認証プロバイダとIDアサーション・プロバイダの構成に関する項の説明に従って、認証プロバイダを構成します。

   • 構成しているレルムの名前を選択します(たとえばmyrealm)。

   • 「新しい認証プロバイダの作成」ページで、認証プロバイダの名前を入力し(たとえば、OID)、タイプとしてOracle Internet Directoryオーセンティケータを選択します。

   • 「設定」セクションで、「制御フラグ」を「オプション」に設定します。

   「プロバイダ固有」タブで、次の情報を入力します。

   • ホスト: LDAPプロバイダURL

   • ポート: ポート番号

   • プリンシパル: 管理ユーザーの詳細(新しいデフォルト・ユーザー)

     例: CN=orcladmin,CN=Users,DC=us,DC=oracle,DC=com

   • 資格証明: LDAPのパスワード

   • 資格証明の確認: LDAPのパスワード

   • ユーザー・ベースDN

     例: CN=Users,DC=us,DC=oracle,DC=com

   • グループ・ベースDN

     例: CN=Groups,DC=us,DC=oracle,DC=com

2. WebLogic Serverを再起動します。

2.4.2 資格証明ストア・プロバイダの構成

「資格証明ストアへの鍵およびユーザー資格証明の追加」の説明に従って、次のパラメータを使用して、資格証明ストア・プロバイダを構成します。

• マップがまだない場合は、「マップの作成」を選択し、マップ名oracle.wsm.securityを入力します。

• 「資格証明ストア・プロバイダ」表で、oracle.wsm.securityを選択します。

• 「キーの作成」ダイアログで、適切なキーを入力します(たとえば、OID)。新しいデフォルト・ユーザーのユーザー名とパスワードを入力します(たとえば、orcladminおよびpassword)。

2.4.3 ドメインのポリシー・マネージャCSFキーの構成

ドメインのポリシー・マネージャCSFキーを構成する手順は次のとおりです。

1. 新しいデフォルト・ユーザーのアカウントでFusion Middleware Controlにログインします。

2. ナビゲーション・ペインで、「WebLogicドメイン」を開き、構成するドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「WSMドメイン構成」を選択します。

4. 「ポリシー・アクセッサ」タブを選択します。

5. 「Fusion Middleware Controlを使用したポリシー・マネージャ接続の構成」の手順3に従って、ポリシー・マネージャCSFキーを構成します。

   この手順で指定するCSFキーは、資格証明ストア内でポリシー・マネージャの管理ユーザー用に指定されているCSFキーに一致する必要があります。詳細は、「資格証明ストア・プロバイダの構成」を参照してください。

   その項の例を使用して、PM Csf Keyドロップダウン・メニューからOIDキーを選択し、資格証明とパスワードの組合せとしてoracladminとpasswordを入力します。

6. 「適用」をクリックして、WebLogic Serverを再起動します。

2.4.4 ユーザーのグループまたはロールの変更

OWSMエージェント・ランタイムは、OracleSystemUserアイデンティティを使用してwsm-pmにアクセスします。新しいデフォルト・ユーザーを定義する場合、AdministratorまたはOracleSystemGroupグループに含まれるか(グループが存在する場合)、表2-1で定義されているデフォルトのOWSM論理ロールにマップされる必要があります(グループが存在しない場合)。

表2-1 デフォルトのOWSM論理ロール

ロール	デフォルト・ユーザー	権限
policy.Updater	管理者	ポリシーの作成、編集、削除および更新
policy.User	すべての認証ユーザー	読取り専用権限(たとえば、ドキュメント情報の問合せ/表示)
policy.Accessor	管理者 OracleSystemGroup	OWSMポリシー・マネージャの使用によるポリシーのアタッチのためにOWSMエージェント・ランタイムがアクセスするEJBの保護

ユーザーに必要なロールがあることを確認するには、次のいずれかの手順を実行します。

• AdministratorまたはOracleSystemGroupグループがLDAPまたはアイデンティティ・ストアに存在する場合は、次の手順を実行します。

  1. LDAPで、デフォルトの管理ユーザーとして使用するユーザーを追加します。

  2. WebLogic Server管理コンソールで、ユーザーがAdministratorグループに存在することを確認します。詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのユーザーとグループの管理に関する項を参照してください。

• AdministratorまたはOracleSystemGroupグループがLDAPまたはアイデンティティ・ストアに存在しない場合は、次のOPSSスクリプトのいずれかを使用してアプリケーション・ロールを管理できます。

  • grantAppRole: プリンシパル(クラスおよび名前)を指定したアプリケーション・ストライプおよび名前を持つロールに追加します。

  • revokeAppRole: プリンシパル(クラスおよび名前)を指定したアプリケーション・ストライプおよび名前を持つロールから削除します。

  • listAppRoleMembers: 指定したアプリケーション・ストライプおよびロール名を持つロール内のすべてのメンバーがリストされます。

  これらのOPSSスクリプトおよびその他のOPSSスクリプトの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のポリシー・ストアの管理に関する項を参照してください。

OPSSスクリプトの使用方法の例を次に示します。OPSSスクリプトを発行する前に、『Webサービスの管理』のWebサービスのカスタムWLSTコマンドへのアクセスに関する項の説明に従って、WLSTを起動してWebLogic Serverの実行中のインスタンスに接続する必要があります。

次のコマンドは、policy.AccessorロールをPAPUserという名前のプリンシパルに追加します。

grantAppRole(appStripe="wsm-pm", appRoleName="policy.Accessor",principalClass="weblogic.security.principal.WLSUserImpl", principalName="PAPUser")

次のコマンドは、policy.AccessorロールをOracleSystemGroupから削除します。

revokeAppRole(appStripe="wsm-pm", appRoleName="policy.Accessor",principalClass="weblogic.security.principal.WLSGroupImpl", principalName="OracleSystemGroup")

次のコマンドは、policy.Accessorロールに関連付けられたメンバーをリストします。

listAppRoleMembers(appStripe="wsm-pm", appRoleName="policy.Accessor")