test

Sun Identity Manager 8.1 リソースリファレンス

第 56 章 アイデンティティーコネクタの概要

この章では、Identity Manager で新しくサポートされた、アイデンティティーコネクタ機能について説明します。コネクタは、リソースアダプタに代わって、ネイティブリソースのアイデンティティーとその他のオブジェクトタイプをマッピングします。この章では、コネクタに関する次のトピックを紹介します。

アイデンティティーコネクタの開発と実装に関する最新情報については、https://identityconnectors.dev.java.net を参照してください。

アイデンティティーコネクタの概要

アイデンティティーコネクタは、リソースアダプタに似たコンポーネントで、Identity Manager とネイティブリソース (データベース、LDAP、ERP システムなど) との間のリンクを提供します。

アイデンティティーコネクタは、次の点でリソースアダプタよりも利点があります。

既存のリソースからの移行

最終的には、リソースアダプタはコネクタに置き換えられます。ただし、このリリースでは、Identity Manager はこれまでのすべてのリソースアダプタをサポートします。厳密に移行を行う必要はありませんが、同等のコネクタを利用できる場合は移行することをお勧めします。

既存のリソースアダプタを置き換えることができる、新しいコネクタタイプを使用できる場合は、コネクタに切り替えられるように移行パスが用意されています。

一般的に、カスタマイズしたフォームやワークフローの数が多く複雑であるほど、変換プロセスは複雑になります。アダプタベースのリソースをコネクタベースのリソースに移行する準備を行うには、次の作業を実行します。

Procedureコネクタベースのリソースに移行する: 一般的な手順

本稼働環境では、この移行を実行しないでください。移行では既存のリソースがインプレースアップグレードされ、既存のリソースは、これまでのリソースアダプタの代わりにコネクタを使用するように変更されます。リソースに対する以前のユーザーアカウントの割り当ては、すべて移行後も維持されます。移行では下位互換性が維持されるように十分に注意していますが、本稼働環境に進む前に、変換したリソースをテストすることを推奨します。

  1. 新しいコネクタをインストールします (まだインストールされていない場合)。

  2. コネクタに用意されている Identity Manager に固有のインストール手順に従います。また、必要な Exchange ファイルもインポートします。

  3. コネクタに用意されている移行手順の説明に従います。一般的には、「Server Tasks」、「Run Tasks」の順に選択して、宣言された移行サーバータスクを実行します。

コネクタの設定と管理

ここでは、配備で使用可能なコネクタを一覧表示する方法、コネクタコードをダウンロードする方法、コネクタのインストール方法、およびコネクタサーバーを登録する方法を説明します。次のトピックを説明します。

Procedure使用可能なコネクタを一覧表示する

このリリースでは、Identity Manager に Active Directory および SPML2 リソース用のコネクタが用意されています。これらのコネクタの詳細は、第 57 章Active Directory コネクタおよび第 58 章SPML コネクタを参照してください。

  1. Identity Manager 管理インタフェースに、Resource Administrator 機能を持つ管理者としてログインします。

  2. 「リソース」、「Resource Type Actions」、「管理するリソースの設定」の順に選択します。「Resource Connectors」領域に、Identity Manager で現在認識されているすべてのコネクタが表示されます。

コネクタのダウンロード

&Product_IDMgr がサポートするアイデンティティーコネクタは、https://identityconnectors.dev.java.net から追加ダウンロードできます。

Java コネクタのダウンロード

Identity Manager がサポートする Java コネクタは、1 つの JAR ファイルと 1 つの ZIP ファイルとして配布されます。ダウンロードするには、次の操作が必要です。

詳細は、「Java コネクタをインストールする」を参照してください。

.NET コネクタのダウンロード

Identity Manager がサポートする .NET コネクタは、2 つの ZIP ファイルとして配布されます。次の操作が必要です。

詳細は、「.NET コネクタのインストール」を参照してください。

Java コネクタのインストール

ProcedureJava コネクタをインストールする

Java コネクタは、1 つの JAR ファイルと 1 つの ZIP ファイルとして配信されます。

  1. Identity Manager Web アプリケーションを停止します。

  2. コネクタの JAR ファイルを、Identity Manager Web アプリケーションの WEB-INF/bundles ディレクトリにコピーします。

  3. コネクタの ZIP ファイルを、Identity Manager Web アプリケーションのディレクトリに展開します。

  4. Identity Manager Web アプリケーションを起動し、コネクタに固有のインストール手順に従います。

    これで、新しくインストールした Java コネクタが Identity Manager に認識されます。Identity Manager 管理者インタフェースに、Resource Administrator 機能を持つ管理者としてログインします。「リソース」、「Resource Type Actions」、「管理するリソースの設定」の順に選択し、新しい Java コネクタが一覧に表示されていることを確認します (LOCAL コネクタサーバーが関連付けらていれます)。

  5. (省略可能) 新しいコネクタを使用する前に、1 つ以上の Exchange ファイルのインポートが必要となる場合があります。

.NET コネクタのインストール

.NET コネクタを正常にインストールするには、次の手順が必要です。

.NET の ZIP ファイルをインストールする前に、.NET コネクタサーバーをインストールして登録する必要があります。コネクタサーバーは 1 つまたは複数の .NET バンドルを管理し、Identity Manager と .NET バンドル間に送信される要求を処理します。.NET コネクタサーバーは、Identity Manager ゲートウェイに似ています。詳細は、次を参照してください。

Procedure.NET コネクタの実行可能 ZIP ファイルをインストールする

.NET コネクタバンドルは、2 つの ZIP ファイルとして配信されます。

注 –

.NET コネクタの実行可能 ZIP ファイルをインストールする前に、.NET コネクタサーバーをインストールする必要があります。

.NET コネクタの実行可能 ZIP ファイルをインストールするには、次の手順に従います。

  1. コネクタサーバーがすでにインストールされて実行中の場合は、Connector Server サービスを停止します。

  2. ZIP ファイルをコネクタサーバーのインストールディレクトリに展開します。

  3. Connector Server サービスを起動します。コネクタサーバーが Identity Manager でまだ宣言されていない場合は、「コネクタサーバーを登録する」を参照してください。

Procedure.NET コネクタの Identity Manager ZIP ファイルをインストールする

  1. Identity Manager Web アプリケーションを停止します。

  2. コネクタの ZIP ファイルを、Identity Manager Web アプリケーションのディレクトリに展開し、Identity Manager を再起動します。

  3. コネクタに固有のインストール手順に従います。

  4. (省略可能) 新しいコネクタを使用する前に、1 つ以上の Exchange ファイルのインポートが必要となる場合があります。

    この手順のあと、新しい .NET コネクタが Identity Manager に認識されるようになります。これを確認するには、Identity Manager 管理者インタフェースに、Resource Administrator 機能を持つ管理者としてログインします。「リソース」、「Resource Type Actions」、「管理するリソースの設定」の順に選択して、表に .NET コネクタが適切なコネクタサーバーとともに表示されることを確認します。

.NET コネクタサーバーのインストール

Identity Manager から .NET コネクタを使用する場合は、.NET コネクタサーバーをインストールして実行します。コネクタサーバーは 1 つまたは複数の .NET バンドルを管理し、Identity Manager と .NET バンドル間に送信される要求を処理します。.NET コネクタサーバーは、Identity Manager ゲートウェイに似ています。ただし、.NET コネクタサーバーは (コネクタを追加して) 簡単に拡張可能であり、コードが .NET で記述されている点が異なります。

コネクタサーバーを実行するマシンの最小の要件は、次のとおりです。

コネクタサーバーを Windows ホストにインストールするには、https://identityconnectors.dev.java.net にある、コネクタサーバーのインストールに関する注意事項を参照してください。あとで使用するために、コネクタサーバーのインストールに関する次の情報を記録する必要があります。

新しくインストールしたコネクタサーバーを Identity Manager で宣言する方法については、「コネクタサーバーを登録する」を参照してください。

Procedureコネクタサーバーを登録する

各 .NET コネクタサーバーと通信するために必要な接続情報を、Identity Manager 内で宣言する必要があります。この接続情報が正しく宣言されていないと、Identity Manager は .NET コネクタサーバー内に配備された .NET コネクタにアクセスできません。

  1. Identity Manager に、Resource Administrator 機能を持つ管理者としてログオンします。

  2. 「設定」、「Connector Servers」の順に選択します。

  3. 「Connector Servers Definition」ページで、「新規」をクリックします。

  4. 「New Connector Server」で、必要なフィールドに入力します。各フィールドについては、オンラインヘルプを参照してください。

  5. 「保存」をクリックします。Identity Manager がリモートコネクタサーバーと正常に通信できる場合は、新しいコネクタサーバー定義の「ステータス」列に「使用可能」と表示されます。

その他の管理に関するトピック

ここでは、Identity Manager 配備でのコネクタに関する次の管理タスクを説明します。

リソースが使用するコネクタサーバーまたはバージョンの変更

リソースを作成するときに、Identity Manager は選択したコネクタサーバーに関する情報をリソースオブジェクトに書き込みます。既存のリソースのコネクタサーバーを変更したり、コネクタのバージョンを変更することができます。

Procedureリソースオブジェクト内のコネクタサーバー情報を変更する

  1. 「リソース」ページで、編集するリソースを選択します。

  2. 「リソースアクション」、「Change Connector Parameters」メニューオプションの順に選択します。選択できるのは、使用可能なコネクタのバージョンが少なくとも 1 つあるコネクタサーバーのみです。選択したコネクタサーバーで提供されるバージョンのみが表示されます。

コネクタベースリソースのタイムアウトの設定

コネクタベースのリソースを編集または作成するときに、Identity Manager は操作タイムアウトのフィールドセットを表示します。デフォルトでは、Identity Manager は操作タイムアウトの値を -1 に設定します。これは、タイムアウトが発生しないことを表します。このフィールドを 0 以外の値に設定すると、指定したタイムアウト間隔内にコネクタが操作を完了しないときに、操作がエラーによりタイムアウトします。Identity Manager は、タイムアウトの値を、<OperationTimeouts> タグ以下の Resource XML オブジェクトに格納します。値が -1 のタイムアウトは XML に格納されません。

接続プールのパラメータの編集

コネクタベースのリソースを編集するときに、リソースウィザードの最後のページに「Connector Pooling」の設定フィールドが表示されます。このページでは、次の属性に値を設定できます。

コネクタベースのリソースでのリソースアクションの使用

コネクタベースのリソースは、前アクションおよび後アクションとして使用するリソースアクションの定義に関して、アダプタベースのリソースと同じ規則に従います。Identity Manager は、作成、更新、削除、無効化、および有効化の操作を含む、前アクションと後アクションの使用をサポートします。

配備からのコネクタの削除

配備からコネクタを削除するには、コネクタに対応する .jar または DLL ファイルを削除します。コネクタを削除すると、Identity Manager はコネクタにアクセスできなくなります。Identity Manager リソースが実装で参照しているコネクタを配備から削除した場合、Identity Manager 内でそのリソースを使用すると、実行時エラーが発生します。この問題を避けるには、配備からコネクタを削除する前に Connectors-In-Use レポートを実行します。

デバッグとトラブルシューティング

Identity Manager のトレース機能

Identity Manager では、コネクタのパフォーマンスに関して次のタイプのトレースが用意されています。

注 –

ローカル Java コネクタのトレースは、クラスレベルのみに制限されています。これは、ほかのクラスでサポートされているメソッドレベルのトレースとは異なります。Identity Manager は、リモートコネクタのトレースを管理する機能をサポートしていません。

API レイヤーのトレース

このレベルのトレースを使用すると、問題が Identity Manager 内にあるのか、またはコネクタ自身にあるのかを判断できます。このトレース方法は、リモートコネクタおよびローカルコネクタの両方で動作します。コネクタで API レベルのトレースを有効にするには、org.identityconnectors.framework.impl.api.LoggingProxy クラスでレベル 4 の Identity Manager トレースを有効にします。このタイプのトレースは、すべてのコネクタ API のメソッド呼び出しについて、引数と戻り値に注目します。

Java コネクタに固有のトレース

このレベルのトレースを使用すると、コネクタ内の問題をトラブルシューティングできます。このトレース方法は、ローカルの Java コネクタのみで動作します。このトレースを実装するには、コネクタ Java クラス (たとえば、org.identityconnectors.datebasetable.DatabaseTableConnector) で Identity Manager トレースを有効にします。コネクタコードによるすべてのログの呼び出しを、Identity Manager トレースファイルに出力します。

Java コネクタフフレームワークトレース

このトレースを実装するには、コネクタ Java クラス (たとえば、org.identityconnectorsframework.*) で Identity Manager トレースを有効にします。このトレース方法は、フレームワーク実装クラスによるすべての内部的なログ呼び出しで動作します。

.NET トレース

.NET コネクタは、標準の .NET トレース API を呼び出します。Identity Manager で集中管理されたトレースは行われません。Identity Manager では、.NET トレースファイルを表示できません。ローカルコネクタサーバーの設定ファイルを編集して、.NET トレースを設定する必要があります。

コネクタの JMX 監視

コネクタベースのリソースは、リソースアダプタベースのリソースと同じ標準の JMX 監視をサポートします。

標準 Identity Manager トレースのデバッグページを使用して、ローカル Java コネクタのトレースを有効にできます。コネクタのログの呼び出しは、すべての Identity Manager トレースと同じトレースファイルに書き込まれます。

リモートコネクタのログは管理できません。リモートコネクタホストを実行しているマシンで、Windows のネイティブツールを使用して、リモートコネクタのログをローカルに設定する必要があります。

コネクタベースのリソースは、Identity Manager のほかの部分からは一般的なリソースと認識されるため、すでにリソースおよびリソースアダプタに用意されている JMX ツール (Active Sync JMX を含む) を使用して、コネクタベースのリソースの使用状況とパフォーマンスを監視できます。

コネクタフレームワーク API は、ローカル Java コネクタが使用する接続プールを維持します。現在のところ、この情報を表示または管理することはできません。リモートコネクタ用のコネクタ API でも、このためのツールは提供されていません。