コネクタをOracle Identity Managerにインストールする必要があります。必要に応じて、コネクタをコネクタ・サーバーにインストールすることもできます。
次の図に示すように、Generic RESTコネクタのインストールは様々なステージに分けることができます:
次の各項では、インストール時の作業について説明します。
コネクタ・インストーラを実行して、コネクタ・インストール・パッケージをインストールする必要があります。コネクタ・インストーラを実行すると、構成ファイルがOracle Identity Managerに自動的にコピーされ、コネクタ・バンドルorg.identityconnectors.genericrest-1.0.1115.jarがOracle Identity Managerデータベースにアップロードされます。
メタデータ・ジェネレータを実行してコネクタ・メタデータ・パッケージを生成し、インストールする必要があります。
メタデータ・ジェネレータを実行して、ターゲット・システムのコネクタ・メタデータ・パッケージを生成します。
GenericRestGenerator.cmdまたはGenericRestGenerator.shという名前の実行可能ファイルを使用して、コマンドラインからメタデータ・ジェネレータを起動します。
メタデータ・ジェネレータを実行するには、コマンド・ウィンドウで、genericrest-RELEASE_NUMBER/metadata-generator/binディレクトリに移動し(genericrest-11.1.1.5.0/binなど)、使用しているオペレーティング・システムに応じて次のコマンドのいずれかを実行します。
Microsoft Windowsの場合
GenericRestGenerator.cmd CONFIG_FILE CONFIG_NAME
UNIXの場合
GenericRestGenerator.sh CONFIG_FILE CONFIG_NAME
このコマンドの次の部分を置き換えます。
CONFIG_FILEは、GenericRestConfiguration.groovyファイルの絶対または相対パス名に置き換えます。
CONFIG_NAMEは、ターゲット・システムに使用されている、GenericRestConfiguration.groovyファイル内の構成セクションの名前に置き換えます。このファイル内のサンプル構成は、trustedおよびtargetです。実際の要件に応じて、異なる名前を持つ追加のカスタム構成を作成できます。
サンプル・コマンド: GenericRestGenerator.cmd ..\resources\GenericRestConfiguration.groovy target
このコマンドで、"target"は、値を指定したGenericRestConfiguration.groovyファイルのセクション名を示します。
メタデータ・ジェネレータの実行中にエラーが発生した場合は、それを修正してからメタデータ・ジェネレータの実行を再開する必要があります。
コネクタ・インストーラを実行して、コネクタ・メタデータ・パッケージをインストールする必要があります。コネクタ・インストーラを実行すると、メタデータ・ファイルがOracle Identity Managerに自動的にインポートされ、すべてのコネクタ・コンポーネントが生成され、プロビジョニングに使用されるアダプタがコンパイルされます。
コネクタ・メタデータ・パッケージは、GenericRest-RELEASE_NUMBER/metadata-generator/ディレクトリに生成されるZIPファイルです。
たとえば、GenericRestConfiguration.groovyファイルにitResourceDefNameエントリの値としてGenRestと指定した場合、コネクタ・パッケージのZIP (GenRest.zip)ファイルがGenericRest-11.1.1.5.0/metadata-generator/ディレクトリに生成されます。コネクタ・メタデータ・パッケージのディレクトリ構造は、次のとおりです:
CONNECTOR_METADATA_PCKG/ configuration/ IT_RES_DEF-CI.xml resources/ genericrest-generator.properties xml/ IT_RES_DEF-ConnectorConfig.xml
このディレクトリ構造の意味は次のとおりです。
CONNECTOR_METADATA_PCKGは、GenericRestConfiguration.groovyファイルのitResourceDefNameエントリの値として指定されたITリソース定義の名前で置き換えられます。
IT_RES_DEFは、GenericRestConfiguration.groovyファイルのitResourceDefNameエントリの値として指定されたITリソース定義の名前で置き換えられます。
コネクタ構成XMLファイルが生成されると、動作が次のようになります。
ターゲット・システムのフィールド(列)の長さはプロセス・フォームにフェッチされません。そのため、「一意のID」フィールドと「パスワード」フィールドを除き、プロセス・フォームにおける(文字列データ型の)他のすべてのデータ・フィールドの長さは、常に255文字に設定されます。「一意のID」フィールドと「パスワード」フィールドの長さは、40文字に設定されます。