プライマリ・コンテンツに移動
Oracle® Fusion MiddlewareOracle Adaptive Access Manager開発者ガイド
11gリリース2 (11.1.2.3.0)
E67356-01
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		 次
次		  

7 OAAM拡張共有ライブラリの使用によるOAAMのカスタマイズ

共有ライブラリは、複数のアプリケーションが使用できるプログラミングとデータの集合です。共有ライブラリによって、共通プログラミングとリソースを共有することでアプリケーションがメモリーを効率的に使用できるようになります。

この章では、OAAM拡張共有ライブラリを使用してOracle Adaptive Access Managerをカスタマイズする方法について説明します。この項の内容は、次のとおりです。

7.1 OAAM拡張共有ライブラリについて

一度に多くのカスタマイズを実行でき、リソース・バンドルをカスタマイズできます。また、ヘッダー、フッター、CSSファイルなど、ブランドで使用するカスタム・ファイルを追加できます。図7-1は、カスタム・ファイルの例を示しています。

図7-1 カスタム・ファイル

OAAMカスタム・ファイルを示します。

OAAM拡張共有ライブラリ、oracle.oaam.extensions.warは、IAM_Home/oaam/oaam_extensions/genericにあります。これは、OAAMサーバーとOAAM管理サーバーの両方にデプロイされます。デフォルトでは、oracle.oaam.extensions.warに、OAAM拡張共有ライブラリの定義を保存したMANIFEST.MFが含まれています。

7.2 列挙の編集によるOAAMのカスタマイズまたは拡張について

ユーザー定義列挙というプロパティを使用して、OAAMの外観と動作を管理できます。OAAMのカスタマイズのために、列挙とその要素およびプロパティを編集したり、新しい列挙を追加することもできますユーザー定義列挙は、アイテムのリストを表すプロパティの集合です。リスト内の各要素には、複数の異なる属性が含まれている場合があります。ユーザー定義列挙の定義はキーワード.enumで終わるプロパティで始まり、ユーザー定義列挙の使用を記述する値が続きます。各要素定義は、列挙と同じプロパティ名に要素名が追加されたもので始まり、IDである一意の整数の値が続きます。要素の属性も同じパターンに従い、要素のプロパティ名で始まり、その後に属性名がその属性の適切な値とともに示されます。

OAAMサーバー実装のログイン画面に表示される、列挙定義資格証明の例を次に示します。

bharosa.uio.default.credentials.enum = Enum for Login Credentials
bharosa.uio.default.credentials.enum.companyid=0
bharosa.uio.default.credentials.enum.companyid.name=CompanyID
bharosa.uio.default.credentials.enum.companyid.description=Company ID
bharosa.uio.default.credentials.enum.companyid.inputname=comapanyid
bharosa.uio.default.credentials.enum.companyid.maxlength=24
bharosa.uio.default.credentials.enum.companyid.order=0
bharosa.uio.default.credentials.enum.username=1
bharosa.uio.default.credentials.enum.username.name=Username
bharosa.uio.default.credentials.enum.username.description=Username
bharosa.uio.default.credentials.enum.username.inputname=userid
bharosa.uio.default.credentials.enum.username.maxlength=18
bharosa.uio.default.credentials.enum.username.order=1

OAAMプロパティをオーバーライドしたりOAAMを拡張するには、プロパティと列挙をoaam_custom.propertiesおよび(必要に応じて) client_resource_locale.propertiesに追加します。ローカライズされたプロパティは、プロパティ・ファイルとリソース・バンドル・ファイルで複製されることがよくあります。リソース・バンドルの値は常に標準プロパティよりも優先されます。これらのファイルは、後で保存してOAAM拡張ライブラリに再パッケージ化します。

OAAM管理コンソール・プロパティ・エディタで変更を行っても影響がないため、ローカライズする要素はOAAM拡張ライブラリを通じて変更する必要があります。これらの要素は次のとおりです。

  • 名前

  • 説明

  • ユーザーが使用するテキスト

7.3 OAAM拡張共有ライブラリの使用によるカスタマイズの追加

この項では、カスタマイズをOracle Adaptive Access Managerに追加する手順について説明します。

主な手順は次のとおりです。

  1. OAAM拡張共有ライブラリのWARファイルを抽出します。

  2. 新規および編集済ファイルでOAAM拡張共有ライブラリのWARファイルを作成します。

  3. WebLogic管理コンソールを使用し、WARファイルをライブラリとしてデプロイします。

7.3.1 Access ManagerとOAAMの統合およびカスタマイズに関する注意

プロパティbharosa.uio.proxy.mode.flagが適切に設定されていることを確認します。

bharosa.uio.proxy.mode.flagプロパティのデフォルトはfalseです。UIOプロキシ・デプロイメントを使用している場合は、プロパティをtrueに設定する必要があります。マルチテナントのカスタム・ブランドをOAAMプロキシで構成するには、プロパティbharosa.uio.proxy.mode.flagをtrueに設定する必要があります。

カスタマイズを追加しており、TAPスキームを使用してOracle Access Management Access Manager 11gとの統合も構成する場合は、プロパティをfalseに設定する必要があります。プロパティをtrueに設定すると、OAAMとAccess ManagerのTAPを使用した統合に失敗し、次のメッセージが表示されます。

Sorry, the identification you entered was not recognized.

7.3.2 ステップ1 OAAM拡張共有ライブラリの抽出

OAAM拡張共有ライブラリを抽出するには、次の手順を実行します。

  1. oaam_extensionsという作業フォルダを作成します。

    このフォルダは、インストール・フォルダ以外であればどこにでも作成できます。

  2. oracle.oaam.extensions.warファイルを作業フォルダ内に抽出します。

    oaam_extensionsフォルダに、次のサブフォルダが表示されます。

    • META-INF

    • WEB-INF

    • WEB-INF\lib

    • WEB-INF\classes

7.3.3 ステップ2 MANIFEST.MFファイルの作成

META-INFフォルダにMANIFEST.MFというファイルを作成し、そのファイルに次の行が含まれていることを確認します。

Extension-Name: oracle.oaam.extensions
Implementation-Version:99.9.9.9.9
Specification-Version:99.9.9.9.9

仕様バージョンと実装バージョンは、現在のファイルにあるバージョン以上である必要があります。たとえば、ファイルの実装バージョンが11.1.1.3.0の場合は、99.9.9.9.9に変更できます。バージョンが増分されない場合は、エラーがスローされます。

7.3.4 ステップ3 カスタムJavaクラスのコンパイル

JARファイルをORACLE_IDM_HOME\oaam\cli\libフォルダからビルド・クラス・パスに追加して、Oracle Adaptive Access Managerのクラスを拡張または実装するカスタムJavaクラスをコンパイルします。

7.3.5 ステップ4 カスタム・ファイルの追加

カスタム・ファイルを説明に従って追加します。

  1. カスタムJARファイルをoaam_extensions\WEB-INF\libフォルダに追加します。たとえば、oaam_core.jarです。

  2. oaam_custom.propertiesでプロパティおよび列挙を追加または変更し、ファイルをネイティブWebアプリケーションのoaam_extensions\WEB-INF\classes\bharosa_propertiesディレクトリに保存します。

  3. カスタムJSPファイルをoaam_extensionsに直接追加します。

  4. 第8.4.4項「ユーザー定義メッセージの追加」の説明に従って、client_resource_locale.propertiesファイルを追加します。

  5. 第8.4.2項「ユーザー定義ヘッダーおよびフッターの追加」の説明に従って、ヘッダーおよびフッター・ファイルを追加します。

  6. 第8.4.3項「ユーザー・インタフェース・スタイルのカスタマイズ」の説明に従って、CSSファイルを追加します。

  7. カスタム仮想認証デバイス関連の画像をoaam_extensions\WEB-INF\classes\bharosa_propertiesディレクトリに追加します。

7.3.6 ステップ5 新しいWARファイルへのOAAM拡張共有ライブラリの再パッケージ化

次のコマンドを使用して、OAAM拡張共有ライブラリ、oracle.oaam.extensions.warをoaam_extensionsの親フォルダから再パッケージ化します。

jar -cvfm oracle.oaam.extensions.war oaam_extensions/META-INF/MANIFEST.MF -C  oaam_extensions/ .

注意:

コマンド末尾にドットがあることに留意してください。

このコマンドにより、WARファイルがMANIFEST.MFファイルとともに再作成されます。カスタムJARファイル、CSS、新しいWARファイル。

7.3.7 ステップ6 再パッケージ化したWARファイルにカスタムJARファイルが含まれているかどうかの確認

再パッケージ化したWARファイルにカスタムJARファイルが含まれていることを確認します。次のコマンドを使用して、その内容を表示します。

jar tvf oracle.oaam.extensions.war

7.3.8 ステップ7 すべての管理対象サーバーの停止

管理対象サーバーが稼働している場合はすべて停止します。

MW_HOME/user_projects/domains/domain_name/bin/stopManagedWeblogic.sh
  oaam_admin_server1
MW_HOME/user_projects/domains/domain_name/bin/stopManagedWeblogic.sh
  oaam_server_server1

7.3.9 ステップ8 WebLogic管理サーバーの起動

WebLogic管理サーバーを起動します。

MW_HOME/user_projects/domains/domain_name/bin/startWeblogic.sh

7.3.10 ステップ9 WebLogic管理コンソールへのログイン

Oracle Adaptive Access ManagerがデプロイされているWebLogic Serverを起動し、WebLogic管理コンソールにログインします。

http://hostname:port/console

7.3.11 ステップ10 新しいOAAM拡張共有ライブラリのデプロイ

oaam_server_server1およびoaam_admin_server1をターゲット・アプリケーションとする、新しいoracle.oaam.extensions.warファイルを、共有ライブラリとしてデプロイします。

  1. 「ドメイン環境」→「デプロイメント」に移動して、コンソールをロックします。

  2. 「インストール」ボタンをクリックします。

  3. oracle.oaam.extensions.warファイルの場所を参照し、WARファイルの横のオプションをクリックして選択します。その後、「次へ」をクリックします。

  4. 「このデプロイメントをライブラリとしてインストールする」が選択されていることを確認し、「次へ」をクリックします。

  5. デプロイメントのターゲット、oaam_admin_server1およびoaam_server_server1を選択します。

  6. 「次へ」を再度クリックしてこの次のページでデフォルトを受け入れ、「終了」をクリックします。

  7. 「保存」ボタンをクリックしてから、「変更のアクティブ化」をクリックします。

  8. OAAM管理とOAAM管理対象サーバーを起動します。

    MW_HOME/user_projects/domains/domain_name/bin/startManagedWeblogic.sh
  oaam_admin_server1
MW_HOME/user_projects/domains/domain_name/bin/startManagedWeblogic.sh
  oaam_server_server1

7.3.12 ステップ11 機能のテスト

カスタム機能をテストして、oracle.oaam.extensions.warに追加したファイルをOracle Adaptive Access Managerアプリケーションが使用していることを確認します。

  前
前 		 次
次
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次