18 インストールとテストのためのコネクタの構成

この章で説明するガイドラインの目的は、カスタム・コネクタが、コネクタ・インストーラと診断ダッシュボードを使用するための互換性要件を満たしていることを確認することです。このガイドラインが適用されるのは、カスタム・コネクタ開発の特定の領域のみです。

この章の内容は、次のとおりです。

構成XMLファイルの構造

この項では、コネクタのインストール・プロセスで使用される構成XMLファイルの構造について説明します。この項の情報を使用し、カスタム・コネクタ用に構成XMLファイルを作成します。

次に、事前定義済コネクタのインストール・ファイルをコピーするための推奨パスを示します。

OIM_HOME/xellerate/ConnectorDefaultDirectory

Oracle Identity Managerをインストールする際に、次のファイルがConnectorDefaultDirectoryディレクトリにコピーされます。

ConnectorConfigTemplate.xml

これは構成XMLファイルのテンプレートです。このファイルのコピーを使用し、構成XMLファイルを作成します。
ConnectorSchema.xsd

これは作成した構成XMLファイルの検証に必要なXMLスキーマ文書（XSD）です。

表18-1は、構成XMLファイルの要素のリストです。各要素に関する項にアクセスするには、この表内のリンクを使用します。

表18-1 構成XMLファイルの要素

ルート要素	レベル1要素	レベル2要素	レベル3要素
connector要素
	connector-name要素
	connector-version要素
	filecopy要素	destination要素	file要素
	configuration要素	source要素	file要素
	pre-Install要素	title要素	step要素
	dependency-connector要素	dependency-connector-name要素
		dependency-connector-version要素

connector要素

次の表に、connector要素のプロパティについてまとめます。

プロパティ 値

親要素

該当なし

属性

該当なし
テンプレートのXMLファイルで、この要素の属性の値は変更しないでください。

子要素

connector-name、connector-version、filecopy、configuration、pre-Install、およびdependency-connector

出現回数

1回

要素値

該当なし

プロパティ	値
親要素	該当なし
属性	該当なしテンプレートのXMLファイルで、この要素の属性の値は変更しないでください。
子要素	`connector-name`、`connector-version`、`filecopy`、`configuration`、`pre-Install`、および`dependency-connector`
出現回数	1回
要素値	該当なし

connector要素は、構成XMLファイルではルート要素です。connector要素の子要素の詳細は、次の項を参照してください。

connector-name要素

次の表に、connector-name要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

なし

出現回数

1回

要素値

コネクタの名前

プロパティ	値
親要素	`connector`
属性	なし
子要素	なし
出現回数	1回
要素値	コネクタの名前

connector-name要素は、コネクタのターゲット・システムの名前を指定する場合に使用します。コネクタ名の値がほとんどのコネクタのインストール・ページ上に表示されます。

使用方法の例:

<connector-name>Active Directory</connector-name>

connector-version要素

次の表に、connector-version要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

なし

出現回数

1回

要素値

コネクタのリリース番号

プロパティ	値
親要素	`connector`
属性	なし
子要素	なし
出現回数	1回
要素値	コネクタのリリース番号

connector-version要素は、コネクタのリリース番号を指定する場合に使用します。リリース番号は、コネクタ名とともに表示されます。リリースを比較したり、ユーザーにアップグレードのガイドラインを提供する場合にも使用されます。

使用方法の例:

<connector-version>9.1.0</connector-version>

connector-version要素に値を指定する場合は、次の点を考慮してください。

コネクタのリリース番号の指定には、数字とピリオド（.）のみを使用します。
コネクタのリリース番号には空白が入らないようにしてください。
コネクタのリリース番号の末尾のゼロは、その番号が他のコネクタのリリース番号と比較される際には、削除されます。たとえば、値9.1.0および9.1.0.0は、リリース番号を比較するコードでは同じとみなされます。

filecopy要素

次の表に、filecopy要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

destination

出現回数

1回

要素値

該当なし

プロパティ	値
親要素	`connector`
属性	なし
子要素	`destination`
出現回数	1回
要素値	該当なし

filecopy要素は、コネクタのインストール・メディアのディレクトリに含まれる特定のディレクトリからコピーされるファイルの詳細を保持する、destination要素のコンテナとして機能します。

「destination要素」では、filecopy要素の子要素について説明します。

destination要素

次の表に、destination要素のプロパティについてまとめます。

プロパティ 値

親要素

filecopy

属性

folder

子要素

file

出現回数

コピー対象のファイルのタイプごとに1回

要素値

値は、JavaTasks、ScheduleTask、connectorResourcesまたはThirdPartyのいずれかです。

プロパティ	値
親要素	`filecopy`
属性	`folder`
子要素	`file`
出現回数	コピー対象のファイルのタイプごとに1回
要素値	値は、`JavaTasks`、`ScheduleTask`、`connectorResources`または`ThirdParty`のいずれかです。

特定のタイプのコネクタ・ファイルをコピーする必要がある場合、コピー先としてOracle Identity Managerサーバーのフォルダの名前を指定するには、destination要素のfolder属性を使用します。表で言及しているとおり、次の中から任意のフォルダを指定できます。

connectorResources: コネクタのインストール・メディアにリソース・バンドルが含まれる場合はこのフォルダを指定します。
JavaTasks: コネクタのインストール・メディアにプロビジョニング用のJARファイルが含まれる場合はこのフォルダを指定します。
ScheduleTask: コネクタのインストール・メディアにリコンシリエーション用のJARファイルが含まれる場合はこのフォルダを指定します。
ThirdParty: コネクタのインストール・メディアに、プロビジョニングまたはリコンシリエーション用にコネクタが必要とする外部コード・ファイルが含まれる場合はこのフォルダを指定します。

「file要素」では、filecopy要素の子要素について説明します。

file要素

次の表に、file要素のプロパティについてまとめます。

プロパティ 値

親要素

destination

属性

なし

子要素

なし

出現回数

少なくとも1回

要素値

コピー対象のファイルの名前

プロパティ	値
親要素	`destination`
属性	なし
子要素	なし
出現回数	少なくとも1回
要素値	コピー対象のファイルの名前

file要素は、親であるdestination要素によって指定されるフォルダにコピーする必要があるファイルの名前を指定する場合に使用します。ファイル名に指定した大/小文字の区別は、実際の名前のものと同じである必要があります。指定した名前を持つファイルを探すために、インストール・プログラムはコネクタのインストール・メディアのディレクトリ全体を検索し、そのファイルを親であるdestination要素が指定するフォルダにコピーします。

使用方法の例:

<file>ActiveDirectory.properties</file>

同じファイルを複数のディレクトリにコピーする場合は、ファイル名を該当するdestination要素の下のfile要素に指定する必要があります。たとえば、connector.jarファイルをJavaTasksディレクトリとScheduleTaskディレクトリの両方にコピーする場合、次の行をXMLファイルに追加します。

<destination folder="JavaTasks">
  <file>connector.jar</file>
</destination>
<destination folder="ScheduleTask">
  <file>connector.jar</file>
</destination>

configuration要素

次の表に、configuration要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

destination

出現回数

1回

要素値

該当なし

プロパティ	値
親要素	`connector`
属性	なし
子要素	`destination`
出現回数	1回
要素値	該当なし

configuration要素は、インストール・プロセスでインポートされるXMLファイルに関する情報を保持する場合に使用されます。

「source要素」では、configuration要素の子要素について説明します。

source要素

次の表に、source要素のプロパティについてまとめます。

プロパティ 値

親要素

configuration

属性

folder

子要素

file

出現回数

1回

要素値

xml

プロパティ	値
親要素	`configuration`
属性	`folder`
子要素	`file`
出現回数	1回
要素値	`xml`

source要素は、コネクタXMLファイルが格納されている、コネクタのインストール・メディアのディレクトリ内のxmlフォルダを指定する場合に使用されます。インストール・プロセスでは、デプロイメント・マネージャが呼び出され、これらのXMLファイルがインポートされます。

「file要素」では、source要素の子要素について説明します。

file要素

次の表に、file要素のプロパティについてまとめます。

プロパティ 値

親要素

destination

属性

なし

子要素

なし

出現回数

少なくとも1回

要素値

XMLファイル名

プロパティ	値
親要素	`destination`
属性	なし
子要素	なし
出現回数	少なくとも1回
要素値	XMLファイル名

file要素は、コネクタのインストール・プロセスでデプロイメント・マネージャにインポートさせるXMLファイル名を指定する場合に使用します。複数のXMLファイルをインポートするには、file要素を複数追加します。

次のコード行の例では、configuration、destination、およびfile要素の正しい使用方法を示しています。

<configuration>
  <source folder="xml">
    <file>xliADResourceObject.xml</file>
    <file>xliADXLResourceObject.xml</file>
  </source>
</configuration>

pre-Install要素

次の表に、pre-Install要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

title

出現回数

1回

要素値

該当なし

プロパティ	値
親要素	`connector`
属性	なし
子要素	`title`
出現回数	1回
要素値	該当なし

コネクタの中には、使用を開始する前に特定のタスクの実行が必要なものがあります。たとえば、Microsoft Active Directoryコネクタは、Secure Sockets Layer（SSL）を構成してOracle Identity Managerとターゲット・システム間の通信を保護する必要があります。これらの前提条件タスクは、pre-Install要素の子要素を使用して、コネクタのインストール・プロセスの終了時に表示できます。

前提条件タスクをコネクタのインストール・プロセスの終了時に表示しない場合は、pre-Install要素をXMLファイルに含めないでください。

「title要素」では、pre-Install要素の子要素について説明します。

title要素

次の表に、title要素のプロパティについてまとめます。

プロパティ 値

親要素

pre-Install

属性

description

子要素

step

出現回数

少なくとも1回

要素値

表示するテキストを含む、リソース・バンドル行のキー値

プロパティ	値
親要素	`pre-Install`
属性	`description`
子要素	`step`
出現回数	少なくとも1回
要素値	表示するテキストを含む、リソース・バンドル行のキー値

title要素のdescription属性は、リソース・バンドル行のキー値を指定する場合に使用します。このリソース・バンドル行には、コネクタの前提条件タスクのセクション・タイトルが保持されます。

注意
リソース・バンドル行のキー値は、等号（=）の左側のテキストです。リソース・バンドルの詳細は、『Oracle Identity Managerグローバリゼーション・ガイド』を参照してください。

「step要素」では、title要素の子要素について説明します。この項の例では、この要素の正しい使用方法を示しています。

step要素

次の表に、step要素のプロパティについてまとめます。

プロパティ 値

親要素

title

属性

なし

子要素

なし

出現回数

1回

要素値

表示するテキストを含む、リソース・バンドル行のキー値

プロパティ	値
親要素	`title`
属性	なし
子要素	なし
出現回数	1回
要素値	表示するテキストを含む、リソース・バンドル行のキー値

step要素は、コネクタの1つの前提条件タスクを説明しているリソース・バンドル行のキー値を指定する場合に使用します。

次の例では、Microsoft Active Directoryコネクタを使用して、pre-Install、title、およびstep要素の正しい使用方法を説明しています。

次に、Microsoft Active Directoryコネクタのインストール後に表示される前提条件タスクの一部を示します。

Enabling LDAPS
- Ensure that Certificate Services are installed on the server.
- Open the default group policy for the Domain Controller on the server (in Active 
Directory Users and Computers).
- Right-click the domain node, and select Properties.Click the Group Policy tab.
- Select Default Domain Policy.
 . . .
 
Setting Up the Microsoft Active Directory Certificate as a Trusted Certificate
- To make the Microsoft Active Directory certificate a trusted certificate, export the 
certificate and import it into the keystore of the Oracle Xellerate Identity 
Provisioning server as a trusted CA certificate.
 . . .

次に、Microsoft Active Directoryコネクタのインストール後に表示される、前提条件タスクを含むリソース・バンドル行の一部を示します。

AD-connector.prerequisite.enablingldaps=Enabling LDAPS

AD-connector.prerequisite.enablingldapsteps=<ul><li>Ensure that Certificate Services 
are installed on the server</li><li>Open the default group policy for the Domain 
Controller on the server (in Active Directory Users and Computers).</li><li>Right-click 
the domain node, and select Properties.</li><li>Click the Group Policy 
tab.</li><li>Select Default Domain Policy.</li>. . . </ul>

AD-connector.prerequisite.setupad=Setting Up the Microsoft Active Directory Certificate 
as a Trusted Certificate

AD-connector.prerequisite.setupadsteps=<ul><li>To make the Microsoft Active Directory 
certificate a trusted certificate, export the certificate and import it into the 
keystore of the Oracle Xellerate Identity Provisioning server as a trusted CA 
certificate.</li> . . .</ul>

インストール・プロセスの終了時にこれらのリソース・バンドル行を表示可能にするには、次の行を構成XMLファイルに追加する必要があります。

<pre-Install>
  <title description="AD-connector.prerequisite.enablingldaps">
    <step>AD-connector.prerequisite.enablingldapsteps</step>
  </title>
  <title description="AD-connector.prerequisite.setupad">
    <step>AD-connector.prerequisite.setupadsteps</step>
  </title>
</pre-Install>

dependency-connector要素

次の表に、dependency-connector要素のプロパティについてまとめます。

プロパティ 値

親要素

connector

属性

なし

子要素

dependency-connector-name、dependency-connector-version

出現回数

少なくとも1回

要素値

該当なし

プロパティ	値
親要素	`connector`
属性	なし
子要素	`dependency-connector-name`、`dependency-connector-version`
出現回数	少なくとも1回
要素値	該当なし

特定のコネクタは、他の特定のコネクタをインストールした後でのみ、使用を開始できます。たとえば、Novell GroupWiseコネクタは、Novell eDirectoryコネクタをインストールした後でなければ使用を開始できません。Oracle Identity Managerのコンテキストでは、インストールされていることが前提条件であるコネクタを依存コネクタと呼びます。たとえば、Novell eDirectoryコネクタは、Novell GroupWiseコネクタの依存（必須）コネクタです。

dependency-connector要素は、コネクタの依存コネクタに関する情報を保持するために使用されます。コネクタに複数の依存コネクタがある場合は、依存コネクタごとにXMLファイルでdependency-connector要素を1つずつ追加します。

次の項では、dependency-connector要素の子要素について説明します。

dependency-connector-name要素

次の表に、dependency-connector-name要素のプロパティについてまとめます。

プロパティ 値

親要素

dependency-connector

属性

なし

子要素

なし

出現回数

少なくとも1回

要素値

依存コネクタの名前

プロパティ	値
親要素	`dependency-connector`
属性	なし
子要素	なし
出現回数	少なくとも1回
要素値	依存コネクタの名前

dependency-connector-name要素は、コネクタの依存コネクタの名前を指定する場合に使用します。指定する名前は、依存コネクタのXMLファイルのconnector-name要素で指定した名前と同じにする必要があります。

「dependency-connector-version要素」には、dependency-connector-name要素の正しい使用方法を示す例が含まれています。

dependency-connector-version要素

次の表に、dependency-connector-version要素のプロパティについてまとめます。

プロパティ 値

親要素

dependency-connector

属性

なし

子要素

なし

出現回数

dependency-connector-name要素が出現するたびに1回

要素値

依存コネクタのリリース番号

プロパティ	値
親要素	`dependency-connector`
属性	なし
子要素	なし
出現回数	`dependency-connector-name`要素が出現するたびに1回
要素値	依存コネクタのリリース番号

dependency-connector-version要素は、コネクタの依存コネクタのリリース番号を指定する場合に使用します。指定するリリース番号は、依存コネクタの構成XMLファイルのconnector-version要素で指定したリリース番号と同じにする必要があります。指定するコネクタのバージョンの値には空白が入らないようにしてください。

次の例は、dependency-connector、dependency-connector-name、およびdependency-connector-version要素の使用方法について示しています。

DepConn1およびDepConn2は、使用するコネクタの依存コネクタです。それぞれのリリース番号は、9.0.3および9.0.4.1です。これらの依存コネクタ用に、コネクタの構成XMLファイルに次の行を追加する必要があります。

<dependency-connector>
  <dependency-connector-name>DepConn1<dependency-connector-name>
  <dependency-connector-version>9.0.3<dependency-connector-version>
</dependency-connector>
<dependency-connector>
  <dependency-connector-name>DepConn2</dependency-connector-name>
  <dependency-connector-version>9.0.4.1<dependency-connector-version>
</dependency-connector>

コネクタに依存コネクタがない場合は、dependency-connector要素を追加する必要はありません。

コネクタ用のテスト・クラスの開発

コネクタ用のテスト・クラスを開発する必要があります。接続性、リコンシリエーション、またはプロビジョニングのテストで診断ダッシュボードを使用する場合、このクラスを使用してテストが実行されます。

テスト・クラスの作成に関するガイドラインを次に示します。

テスト・クラスでは、testBasicConnectivity、testProvisioning、およびtestReconciliationメソッドを実装する必要があります。これらのメソッドでは、ハッシュマップ・パラメータを受け入れる必要があります。
テスト・クラスの名前は、次の形式にする必要があります。
```
connector_nameConnectorTest.java
```
この形式を適用するには、次のファイルのSPD_KEY要素のITResourceDef属性の値をconnector_nameに置換します。
```
Connector_Pack_Directory/xml/xliconnector_nameResourceObject.xml
```
ITResourceDef属性の値に空白が含まれる場合は、空白を削除します。たとえば、XMLファイルに次のようなSPD_KEY要素があるとします。
```
<SPD_KEY ITResourceDef="AD Server"/>
```
この場合、テスト・クラスの名前をADServerConnectorTest.javaに設定します。
コネクタのJARファイルの中にテスト・クラスのファイルを含め、JARファイルをコネクタ・パック・ディレクトリのlibディレクトリにコピーします。

コネクタ・パック・ディレクトリの構造

コネクタ・ファイルの作成後は、それらを表18-2で説明するディレクトリに配置する必要があります。これらのディレクトリは、使用するコネクタのコネクタ・パック・ディレクトリに配置されます。たとえば、Microsoft Active Directoryコネクタのコネクタ・パック・ディレクトリは、ActiveDirectoryです。

表18-2 コネクタ・パック・ディレクトリの構造

ディレクトリ	説明
`configuration`	このディレクトリには、インストール・プロセスで使用される構成XMLファイルを配置します。例: `ActiveDirectorConnectorConfig.xml`
`ext`	このディレクトリには、すべてのサード・パーティ製JARファイルを配置します。インストール・プロセスでは、このディレクトリ内のファイルが`ThirdParty`ディレクトリにコピーされます。たとえば、Sun Java System Directoryコネクタを使用するには、`ldap.jar`がファイルが必要です。
`lib`	このディレクトリには、リコンシリエーションおよびプロビジョニングの操作に必要なJARファイルを配置します。インストール・プロセスでは、リコンシリエーション用のJARファイルは`ScheduleTask`ディレクトリにコピーされ、プロビジョニング用のJARファイルは`JavaTasks`ディレクトリにコピーされます。例: `xliActiveDirectory.jar`
`resources`	このディレクトリには、リソース・バンドルを配置します。インストール・プロセスでは、これらのリソース・バンドルが`connectorResources`ディレクトリにコピーされます。例: `ActiveDirectory_en.properties`
`scripts`	このディレクトリには、手動によるコネクタ構成プロセスの一部として実行する必要があるスクリプトを配置します。これらのスクリプトは、管理およびユーザー・コンソールを使用して実行されたインストール・プロセスでは使用されません。
`xml`	このディレクトリには、信頼できるソース・リソースおよびターゲット・リソースのリコンシリエーション用のコネクタXMLファイルを配置します。インストール・プロセスでは、構成XMLファイルに記述されているコネクタXMLファイルがデプロイメント・マネージャによってインポートされます。例: `ActiveDirectorConnectorConfig.xml`