WebLogic Security サービスの開発

カスタムセキュリティプロバイダ用のコンソール拡張の記述

コンソール拡張を使用すると、標準 WebLogic Server Administration Console に含まれていない機能を追加したり、既存の機能のインタフェースを提供したりできます。こうした機能を提供するには、ナビゲーションツリーにノードを追加し、タブ付きダイアログとダイアログ画面を追加または置き換えます。

注意 : 以下の節に進む前に、『Administration Console の拡張』でコンソール拡張の記述方法について理解しておいてください。

以下の節では、特にカスタムセキュリティプロバイダと共に使用するコンソール拡張の記述について説明します。

コンソール拡張の記述が必要な場合

WebLogic Server Administration Console でカスタムセキュリティプロバイダ用の完全なコンフィグレーションおよび管理サポートを利用するには、以下の場合にコンソール拡張を記述する必要があります。

カスタムセキュリティプロバイダ用の MBean タイプを生成するときに任意 SSPI MBean を実装しないことを決定したが、Administration Console でカスタムセキュリティプロバイダをコンフィグレーションおよび管理する場合 (つまり、WebLogic Server コマンドラインインタフェースを代わりに使用しない場合)

BEA では、MBean タイプの生成 (「カスタムセキュリティプロバイダをコンフィグレーションおよび管理する MBean タイプの生成」を参照) によってカスタムセキュリティプロバイダをコンフィグレーションおよび管理することをお勧めします。しかし、ユーザが記述したコンソール拡張を介してカスタムセキュリティプロバイダを完全にコンフィグレーションおよび管理することもできます。

カスタム認証プロバイダ以外の任意 SSPI MBean を実装する場合

任意 SSPI MBean を実装してカスタム認証プロバイダを開発する場合は、Administration Console で MBean タイプの属性が自動的にサポートされることになります (任意 SSPI MBean から継承される)。カスタム認可プロバイダなどの他のタイプのカスタムセキュリティプロバイダでは、このサポートは受けられません。

シンプルなデータ型として表すことができないカスタム属性を、MBean 定義ファイル (MDF) (カスタムセキュリティプロバイダの MBean タイプを作成するために使用される) に追加する場合

カスタムセキュリティプロバイダの [詳細] タブにカスタム属性が自動的に表示されるのは、それらがシンプルなデータ型 (文字列、MBean、ブール、整数値) として表される場合のみです。非定型のデータ型 (フィンガープリントのイメージなど) として表されるカスタム属性がある場合、Administration Console ではカスタマイズを行わない限りその属性を表示できません。

カスタム操作を MBean 定義ファイル (MDF) (カスタムセキュリティプロバイダの MBean タイプを作成するために使用される) に追加する場合

カスタム操作はさまざまなので、Administration Console ではそれらを自動的に表示または処理する方法が分かりません。カスタム操作の例としては、声紋用のマイクや、インポート/エクスポートボタンなどがあります。Administration Console では、カスタマイズしない限りこれらのプロセスを表示できません。

Administration Console は、以下の場合にも拡張します。

企業ブランディング - たとえば、カスタムセキュリティプロバイダのコンフィグレーションおよび管理に使用するページにロゴを表示する場合など
連結 - たとえば、カスタムセキュリティプロバイダのコンフィグレーションおよび管理に使用するすべてのフィールドを、個別のタブや場所ではなく 1 ページに表示する場合など

開発プロセスでのコンソール拡張の記述

コンソール拡張を構成するさまざまなプログラマティック要素は、1 つの Web アプリケーションにパッケージ化されて WebLogic Server ドメインにデプロイされます。開発プロセスでいつ Web アプリケーションを開発するかは、完全にユーザの自由です。

ただし、コンソール拡張を使用してカスタムセキュリティプロバイダをコンフィグレーションおよび管理する前に、そのカスタムセキュリティプロバイダ用の MBean タイプを生成し (「カスタムセキュリティプロバイダをコンフィグレーションおよび管理する MBean タイプの生成」を参照)、コンソール拡張 Web アプリケーションを適切にパッケージ化してデプロイしておく必要があります。

注意 : コンソール拡張を Web アプリケーションとして開発、パッケージ化、およびデプロイする手順については、「Administration Console 拡張を記述する主要な手順」を参照してください。

カスタムセキュリティプロバイダ用のコンソール拡張と基本コンソール拡張との違い

基本コンソール拡張 (『Administration Console の拡張』を参照) も柔軟性と機能に富んでいますが、セキュリティプロバイダ固有のコンソール拡張で追加されるメカニズムでは以下のことが可能になります。

カスタムセキュリティプロバイダをコンフィグレーションおよび管理するための既存の Administration Console ページに緊密に統合できる
タブ付きダイアログまたはダイアログ画面を複数の異なる場所で統合できる (基本コンソール拡張ではタブ付きダイアログとダイアログ画面は新しいナビゲーションツリーノードの一部としてしか追加できない)
カスタムセキュリティプロバイダをコンフィグレーションおよび管理するための既存のタブ付きダイアログまたはダイアログ画面を置き換えることができる

Administration Console 拡張を記述する主要な手順

「カスタムセキュリティプロバイダ用のコンソール拡張と基本コンソール拡張との違い」で説明したように、セキュリティプロバイダ固有のコンソール拡張にはいくつかの追加機能が用意されていますが、コンソール拡張を記述する主要な手順は同じです。

Administration Console 拡張を定義する Java クラスを作成します。このクラスでは、コンソール拡張をナビゲーションツリー内のどこに表示するか、およびコンソール拡張で必要とされる追加機能を定義します。詳細については、『Administration Console の拡張』の「NavTreeExtension インタフェースの実装」を参照してください。

ナビゲーションツリーの動作を定義します。この手順では、手順 1 で定義したノードの下に表示する複数のノードを定義できます。また、右クリックメニューとアクションも定義できます。詳細については、『Administration Console の拡張』の「ナビゲーションツリーの設定」を参照してください。

コンソール拡張画面を表示するための JavaServer Pages (JSP) を記述します。ローカライゼーションカタログ内の文字列を参照することによって、ローカライズされたテキストを使用できます。標準のタグライブラリを使用すると、標準の Administration Console と同じようなタブ付きダイアログ画面を作成し、ローカライゼーションカタログにアクセスできます。詳細については、『Administration Console の拡張』の「コンソール画面 JSP の記述」を参照してください。

コンソール拡張を、複数の言語で表示するためにローカライズします。詳細については、『Administration Console の拡張』の「Administration Console 拡張のローカライズ」を参照してください。

JSP、カタログ、および Java クラスを Web アプリケーションとしてパッケージ化します。詳細については、『Administration Console の拡張』の「Administration Console 拡張のパッケージ化」を参照してください。

コンソール拡張が収められた Web アプリケーションを WebLogic Server ドメインの管理サーバにデプロイします。詳細については、『Administration Console の拡張』の「Administration Console 拡張のデプロイメント」を参照してください。

SecurityExtensionV2 インタフェースの使用によるカスタムセキュリティプロバイダ関連の Administration Console ダイアログ画面の置き換え

SecurityExtensionV2 インタフェースのメソッドを使用すると、さまざまなカスタムセキュリティプロバイダ関連の Administration Console ダイアログ画面を置き換えることができます。コンソール拡張を定義するために作成する Java クラスは、Extension クラスを拡張するほかに (またはその代わりに) SecurityExtensionV2 インタフェースを実装できます。Extension クラスは、基本コンソール拡張用に使用します (使い方については『Administration Console の拡張』の「NavTreeExtension インタフェースの実装」を参照)。

注意 : このインタフェースのすべてのメソッドを実装する必要があります。置き換えないページについては null を返します。

表 12-1 に、置き換えることの多いセキュリティプロバイダ関連のダイアログ画面と、それらを置き換えるために実装する必要がある SecurityExtensionV2 インタフェースのメソッドを示します。

表 12-1 SecurityExtensionV2 インタフェースの使い方

置き換えるダイアログ画面の用途	実装するメソッド
新しいカスタムセキュリティプロバイダをコンフィグレーションし、既存のカスタムセキュリティプロバイダのコンフィグレーションを編集する	`getExtensionForProvider` メソッド
新規ユーザの作成と既存のユーザの編集 (カスタム認証プロバイダと共に使用)	`getExtensionForUser` メソッド
新規グループの作成と既存のグループの編集 (カスタム認証プロバイダと共に使用)	`getExtensionForGroup` メソッド
新規セキュリティロールの作成と既存のセキュリティロールの編集 (カスタムロールマッピングプロバイダと共に使用)	`getExtensionForRole` メソッド
新規セキュリティポリシーの作成と既存のセキュリティポリシーの編集 (カスタム認可プロバイダと共に使用)	`getExtensionForPolicy` メソッド
リモートユーザのパスワードをコンフィグレーションする (カスタム資格マッピングプロバイダと共に使用)	`getExtensionForUserPasswordCredential` メソッド
リソース ID およびローカルユーザ名をリモートユーザ名にマップする (カスタム資格マッピングプロバイダと共に使用)	`getExtentionForUserPasswordCredentialMapping` メソッド

注意 : SecurityExtention インタフェースは、このリリースの WebLogic Server で非推奨になりました。必ず SecurityExtensionV2 インタフェースを使用してください。詳細については、WebLogic Server 8.1 API リファレンス Javadoc の「SecurityExtensionV2 インタフェース」と「Extension クラス」を参照してください。

コンソール拡張が Administration Console に与える影響

コンソール拡張を記述する目的が、カスタムセキュリティプロバイダのコンフィグレーション用の BEA 標準ダイアログ画面を置き換えることであっても、セキュリティプロバイダに関連するユーザ、グループ、セキュリティロール、セキュリティポリシーの作成および編集用のダイアログ画面を置き換えることであっても、WebLogic Server Administration Console への影響は同じです。

たとえば、WebLogic Server Administration Console を使用してカスタムセキュリティプロバイダをコンフィグレーションしようとすると、以下のプロセスが発生します。

Administration Console のダイアログ画面の 1 つで [新しい Security_Provider_Type... のコンフィグレーション] リンク（図 12-1、の上部がその例) をクリックすると、Administration Console はカスタムセキュリティプロバイダ用のコンソール拡張の検索を試みます。

図 12-1 サンプル認証プロバイダのコンフィグレーション

サンプル認証プロバイダのコンフィグレーション

カスタムセキュリティプロバイダのコンフィグレーションを (手順 1 のように追加するのではなく) 編集する場合、Administration Console はそのカスタムセキュリティプロバイダのハイパーリンク名 (図 12-1 の下部がその例) がクリックされるとコンソール拡張を検索します。

Administration Console は、セキュリティプロバイダのコンソール拡張が使用可能であることを検出すると、getExtensionForProvider メソッドまたは他の getExtensionFor* ソッド表 12-1 を参照) から返された URL によって指定された JavaServer Page (JSP) を表示します。

BEA の標準インタフェースの代わりにこの JSP を使用して、カスタムセキュリティプロバイダをコンフィグレーションおよび管理します。

カスタム セキュリティ プロバイダ用のコンソール拡張の記述