Sun Java ロゴ     前へ      目次      索引      次へ     

Sun ロゴ
Sun™ Identity Manager 8.0 リソースリファレンス 

第 1 章
リソースリファレンス

ここでは、Identity Manager に付属して提供されるリソースアダプタについて説明します。

次の表に、これらのアダプタをタイプ別に並べ替えた一覧を示します。また、各アダプタについて、サポートされるバージョン、Active Sync のサポート、接続方法、および通信プロトコルの概要を説明します。

注

サポートされる各リソースのバージョンを確認するには、リリースノートを参照してください。

リソースアダプタは、次のカテゴリに分類されます。

Identity Manager のアダプタは、多くの場合デフォルトの状態で使用できます。

アダプタを有効にするには、次の手順に従います。

  1. この章にあるアダプタの「Identity Manager 上で設定する際の注意事項」に説明されている手順に従って、インストールと設定を行います。
  2. 『Identity Manager 管理ガイド』の説明に従って、リソースウィザードを使用してリソースを Identity Manager に追加します。

カスタマイズされたアダプタの作成については、『Sun Identity Manager 配備ツール』を参照してください。

アダプタに関する節の内容の紹介

この章のリソースアダプタに関する節は、次のように構成されています。

各トピックの詳細については、この節の残りの部分で説明します。

トピックの説明

ここでは、各アダプタに関する情報を提供します。それぞれのトピックが次のように構成されています。

概要

「概要」の節では、アダプタによってサポートされているリソースのバージョンを一覧にして示します。これ以外にもサポートされているバージョンがあるかもしれませんが、それらはテストが完了していません。

ここでは、アダプタの Java クラス名についても示します。クラス名はトレース時に常に使用されます。また、リソースがカスタムリソースである場合は、「管理するリソースの設定」ページでクラス名を指定してください。カスタムリソースの詳細については、「Identity Manager 上で設定する際の注意事項」を参照してください。

リソースの中には、複数のアダプタを備えているものもあります。たとえば、Identity Manager では、Windows Active Directory と Windows Active Directory ActiveSync 用のアダプタが提供されます。このような場合、「概要」の節には次のような表が示されます。

GUI 名

クラス名

Windows 2000 /
Active Directory

com.waveset.adapter.ADSIResourceAdapter

Windows 2000 / Active Directory ActiveSync

com.waveset.adapter.ActiveDirectoryActiveSyncAdapter

GUI 名は、「リソース」ページにドロップダウンメニューで表示されます。この名前は、リソースを Identity Manager に追加すると、リソースのブラウザに表示されます。

リソースを設定する際の注意事項

ここでは、Identity Manager からリソースを管理できるようにするためにリソース上で実行する追加の手順を示します。Identity Manager との接続を確立するには、リソースが完全に機能していることが前提です。

Identity Manager 上で設定する際の注意事項

インストールの観点から見ると、アダプタは次の 2 種類に分けられます。

Identity Manager アダプタには、追加のインストール手順は必要ありません。次の手順に従って、「リソース」ページ上のアクションメニューにリソースを表示させます。

  1. Identity Manager 管理インタフェースから、「リソース」をクリックし、次に「タイプの設定」をクリックします。
  2. Identity Manager の「リソース」セクションで、適切なオプションを選択します。
  3. ページの下部にある「保存」をクリックします。

カスタムアダプタの場合は、追加のインストール手順を実行する必要があります。通常は、1 つ以上の jar ファイルを InstallDir¥idm¥WEB-INF¥lib ディレクトリにコピーし、アダプタの Java クラスをアダプタのリストに追加します。jar ファイルは通常、インストールメディアから入手するか、インターネットからダウンロードすることができます。

次の例は、DB2 対応のリソースアダプタについて、この手順を示したものです。

  1. db2java.jar ファイルを InstallDir¥idm¥WEB-INF¥lib ディレクトリにコピーします。
  2. Identity Manager 管理インタフェースから、「リソース」をクリックし、次に「タイプの設定」をクリックします。
  3. ページの下部にある「カスタムリソースの追加」をクリックします。
  4. 下部のテキストボックスに、アダプタの完全なクラス名 (たとえば、com.waveset.adapter.DB2ResourceAdapter) を入力します。
  5. ページの下部にある「保存」をクリックします。

次の表は、Identity Manager サーバー上に jar ファイルをインストールする必要のあるアダプタの一覧です。

アダプタ

必要なファイル

Access Enforcer

  • sapjco.jar
  • axis.jar
  • commons-discovery-0.2.jar
  • commons-logging-1.0.4.jar
  • jaxrpc.jar
  • log4j-1.2.8.jar
  • saaj.jar
  • wsdl4j-1.5.1.jar

Access Manager

pd.jar

ACF2

habeans.jar

- または -

  • habase.jar
  • hacp.jar
  • ha3270.jar
  • hassl.jar
  • hodbase.jar

- または -

  • RWebSDK.jar
  • wrqtls12.jar
  • profile.jaw

ClearTrust

ct_admin_api.jar

SSL を使用する場合は、次の .jar ファイルも必要です。

  • asn1.jar
  • certj.jar
  • jce1_2-do.jar
  • jcert.jar
  • jnet.jar
  • jsafe.jar
  • jsaveJCE.jar
  • jsse.jar
  • rsajsse.jar
  • sslj.jar

DB2

db2java.jar

INISafe Nexess

  • concurrent.jar
  • crimson.jar
  • external-debug.jar
  • INICrypto4Java.jar
  • jdom.jar
  • log4j-1.20.6.jar

MS SQL Server

Microsoft SQL Server 2005 JDBC Driver と接続する場合

  • mssqlserver.jar

Microsoft SQL Server 2000 JDBC Driver と接続する場合

  • msbase.jar
  • mssqlserver.jar
  • msutil.jar

MySQL

mysqlconnector-java-Version-bin.jar

Oracle および Oracle ERP

oraclejdbc.jar

PeopleSoft コンポーネントおよび PeopleSoft コンポーネントインタフェース

psjoa.jar

RACF

habeans.jar

- または -

  • habase.jar
  • hacp.jar
  • ha3270.jar
  • hassl.jar
  • hodbase.jar

- または -

  • RWebSDK.jar
  • wrqtls12.jar
  • profile.jaw

SAP

  • sapjco.jar
  • sapidoc.jar

SAP HR Active Sync

  • sapjco.jar
  • sapidoc.jar
  • sapidocjco.jar

スクリプトホスト

habeans.jar

- または -

  • habase.jar
  • hacp.jar
  • ha3270.jar
  • hassl.jar
  • hodbase.jar

- または -

  • RWebSDK.jar
  • wrqtls12.jar
  • profile.jaw

Siebel CRM

Siebel 6:

  • SiebelDataBean.jar
  • SiebelTC_enu.jar
  • SiebelTcCommon.jar
  • SiebelTcOM.jar

Siebel 7.0:

  • SiebelJI_Common.jar
  • SiebelJI_enu.jar
  • SiebelJI.jar

Siebel 7.7、7.8

  • Siebel.jar
  • SiebelJI_enu.jar

SiteMinder

  • smjavaagentapi.jar
  • smjavasdk2.jar

Sun Java System
Access Manager

7.0 より前のバージョン:

  • リリースによって異なる

Version 7.0 以降

  • am_sdk.jar
  • am_services.jar

Sun Java System Access Manager Realm

  • am_sdk.jar
  • am_services.jar

Sybase

jconn2.jar

Top Secret

habeans.jar

- または -

  • habase.jar
  • hacp.jar
  • ha3270.jar
  • hassl.jar
  • hodbase.jar

- または -

  • RWebSDK.jar
  • wrqtls12.jar
  • profile.jaw

使用上の注意

ここでは、リソースの使用に関連する依存関係と制限について示します。この節で説明する内容は、アダプタによって異なります。

ActiveSync 設定

このセクションでは、「同期ポリシーの編集」ページに表示できるリソース固有の設定情報について説明します。次の属性は、ほとんどの Active Sync アダプタに適用されます。

パラメータ

説明

処理規則

TaskDefinition の名前、またはフィード内のすべてのレコードに対して実行される TaskDefinition の名前を返す規則のいずれかです。この処理規則は、activeSync 名前空間内のリソースアカウント属性を、リソース ID およびリソース名とともに取得します。

このパラメータは、ほかのすべてのパラメータよりも優先されます。この属性が指定されると、このアダプタ上にほかのどんな設定があっても、すべての行に対してこのパラメータで定義された処理が実行されます。

相関規則

リソースアカウントを所有する Identity Manager ユーザーのリソース情報が特定されない場合、相関規則が呼び出され、(アカウントの名前空間内の) リソースアカウント属性に基づいて、ユーザーの照合に使用する、一致する可能性のあるユーザーまたはアカウント ID の候補のリスト、あるいは属性条件を特定します。

規則は、エントリを既存の Identity Manager アカウントに関連付けるために使用できる次のいずれかの情報を返します。

  • Identity Manager ユーザー名
  • WSAttribute オブジェクト (属性ベースの検索に使用)
  • AttributeCondition 型または WSAttribute 型の項目のリスト (AND 結合による属性ベースの検索)
  • String 型の項目のリスト (各項目は Identity Manager アカウントの Identity Manager ID またはユーザー名)

相関規則によって複数の Identity Manager アカウントが識別された場合は、複数の候補の中から一致させるべきアカウントを特定するために確認規則または解決プロセス規則が必要になります。

データベーステーブル、フラットファイル、および PeopleSoft コンポーネントの Active Sync アダプタの場合は、デフォルトの相関規則はリソース上の調整ポリシーから継承されます。

確認規則

相関規則によって返されるすべてのユーザーを対象にして評価される規則です。ユーザーごとに、Identity Manager の ID と (「account.」名前空間にある) リソースアカウント情報の相関を示す完全なユーザー表示が確認規則に渡されます。確認規則は、ブール値で表すことができる値を返すことが期待されます。たとえば、「true」または「1」または「yes」と、「false」または「0」または NULL です。

データベーステーブル、フラットファイル、および PeopleSoft コンポーネントの Active Sync アダプタの場合は、デフォルトの確認規則はリソース上の調整ポリシーから継承されます。

削除規則

activeSync. または account. という形式のキーを持つ値すべてのマップを期待できる規則です。プロキシ管理者のセッションに基づく LighthouseContext オブジェクト (display.session) は、この規則のコンテキストで利用できます。この規則は、ブール値で表すことができる値を返すことが期待されます。たとえば、「true」または「1」または「yes」と、「false」または「0」または NULL です。

あるエントリに関してこの規則によって true が返された場合、アダプタの設定方法に応じて、フォームとワークフローを介してアカウント削除リクエストが処理されます。

解決プロセス規則

TaskDefinition の名前、またはフィード内のあるレコードに対して複数の一致がある場合に実行される TaskDefinition の名前を返す規則のいずれかです。解決プロセス規則は、リソースアカウント属性をリソース ID およびリソース名とともに取得します。

この規則は、一致がなく、「一致しないアカウントの作成」が選択されていない場合にも必要です。

このワークフローは、管理者による手動操作を求める処理にすることもできます。

一致しないアカウントの作成

true に設定すると、一致する Identity Manager ユーザーが見つからない場合に、リソース上にアカウントが作成されます。false に設定すると、処理規則が設定され、その規則が識別するワークフローによって新しいアカウントが保証されていることが確認されないかぎり、アカウントは作成されません。デフォルトは true です。

グローバルで利用

true に設定すると、activeSync 名前空間に加えてグローバル名前空間にも値が入力されます。デフォルト値は、false です。

セキュリティーに関する注意事項

「セキュリティーに関する注意事項」では、接続や認証について説明します。

「サポートされる接続」: Identity Manager とリソースとの間の接続に使用する接続のタイプを一覧にして示します。次の接続タイプが一般的に使用されます。

ほかの接続タイプである可能性もあります。

「必要な管理特権」: Identity Manager 内からユーザーを作成したり他のタスクを実行したりするために、管理者アカウントが必要とする特権を一覧にして示します。管理者アカウントはリソース編集ページで指定します。

すべての Active Sync アダプタで、管理者アカウントには、「Active Sync の動作設定」の「ログファイルパス」フィールドで指定したディレクトリに対する読み取り、書き込み、および削除のアクセス権が必要です。

プロビジョニングに関する注意事項

ここでは、このアダプタのプロビジョニング機能の概要を表に示します。機能には次のようなものがあります。

アカウント属性

「アカウント属性」ページ (スキーママップ) では、Identity Manager アカウント属性をリソースアカウント属性にマップします。属性のリストはリソースごとに異なります。使用していない属性はすべて、スキーママップページから削除するようにしてください。属性を追加すると、多くの場合、ユーザーフォームやその他のコードを編集する必要が生じます。

Identity Manager ユーザー属性は、規則、フォーム、およびその他の Identity Manager 固有の機能で使用できます。リソースユーザー属性は、アダプタがリソースと通信しているときにだけ使用されます。

Identity Manager は、次のタイプのアカウント属性をサポートしています。

ほとんどのアダプタはバイナリアカウント属性をサポートしません。一部のアダプタは、グラフィックス、オーディオ、証明書などのバイナリ属性をサポートします。使用中のアダプタに対してサポートされているかどうかは、そのアダプタのマニュアルの「アカウント属性」の節を参照してください。

name はビューの予約語であるため、リソーススキーママップのアイデンティティーシステムユーザー属性として使用しないようにしてください。

リソースオブジェクトの管理

Identity Managerによって管理できるリソース上のオブジェクトを一覧にして示します。

アイデンティティーテンプレート

ユーザーに対するアカウント名の構文を定義します。ほとんどのリソースについて、構文はアカウント ID と同じですが、リソースが階層構造の名前空間を使用する場合は、構文が異なります。

サンプルフォーム

フォームはページに関連付けられたオブジェクトであり、ブラウザでユーザー表示属性をそのページにどのように表示するかについての規則が含まれています。フォームにはビジネスロジックを組み込むことができ、通常は、ユーザーに表示する前に、表示データを処理するために使用します。

フォームは Identity Manager 統合開発環境 (IDE) で編集できます。詳細については、『Identity Manager 配備ツール』を参照してください。

組み込みのフォーム

一部のフォームは、デフォルトで Identity Manager リポジトリに読み込まれます。リポジトリ内のフォームのリストを表示するには、次の手順を実行します。

  1. Web ブラウザで、http://IdentityManagerHost/idm/debug に移動します。

    2. ブラウザに「System Settings」ページが表示されます。

  2. オプションメニューから、「List Objects」の隣の「Type: ResourceForm」を選択します。
  3. 「List Objects」をクリックします。「List Objects of Type: ResourceForm」ページが表示されます。このページには、Identity Manager リポジトリに存在する編集可能なすべてのフォームが一覧表示されます。
その他の利用可能なフォーム

Identity Manager には、デフォルトではロードされない多くの追加フォームが用意されています。これらのフォームは InstallDir¥idm¥sample¥forms¥ ディレクトリに置かれています。

トラブルシューティング

アダプタに発生した問題を特定して解決する場合には、トレース出力が役立ちます。問題を特定して解決するためにトレースを使用する場合は、一般的に次のような手順を実行します。

  1. トレースをオンにします。
  2. 問題を再現し、結果を評価します。
  3. 必要に応じて、追加のパッケージやクラスのトレースをオンにしたり、トレースのレベルを上げたりして、手順 2 と 3 を繰り返します。
  4. トレースをオフにします。

トレースをオンにするには、次の手順に従います。

  1. Configurator アカウントで Identity Manager にログインします。
  2. デバッグページ (http://IdentityManagerHost:Port/idm/debug) に移動します。
  3. 「Show Trace」をクリックします。
  4. 「Trace Enabled」にチェックマークが付いていることを確認します。
  5. 「Method/Class」テキストボックスに完全なクラス名を入力します。
  6. トレースレベル (1 〜 4) を入力します。取得する情報のタイプは、レベルに応じて次のように異なります。
    • 1 - public メソッドの entry および exit と、主要な例外。
    • 2 - すべてのメソッドの entry および exit。
    • 3 - メソッドの呼び出しごとに一度だけ発生する重要な情報表示 (フローを制御する変数の値など)。
    • 4 - メソッドの呼び出しごとに n 回発生する情報表示。
  7. 必要に応じて、ページのその他の項目を入力します。トレースの準備ができたら「Save」をクリックします。

トレース機能を無効にするには、「Show Trace」オプションを選択解除するか、「Method/Class」テキストボックスからクラス名を削除します。



前へ      目次      索引      次へ     

Part No: 820-5456.   Copyright 2008 Sun Microsystems, Inc. All rights reserved.