コネクタをデプロイする手順は、インストール前、インストール、およびインストール後の3つのステージに分けることができます。
次のトピックでは、これらのステージについて詳しく説明します。
注意:
この章に記載されている一部の手順は、ターゲット・システムで実行する必要があります。これらの手順を実行するには、管理者権限を持つSuccessFactorsアカウントを使用する必要があります。SuccessFactorsコネクタのインストール前の作業には、クライアント・アプリケーション(つまりSuccessFactorsコネクタ)をターゲット・システムに登録してコネクタがREST APIにアクセスできるようにすることが関係しています。インストール前のステップでは、クライアント・アプリケーションの登録、証明書の生成、クライアントIDおよびクライアント・シークレット属性の取得などを行います。
インストール前の作業では、ターゲット・システムで次の手順を実行します。
注意:
これらのインストール前タスクを実行する詳細な手順は、https://support.sap.com/documentation.html/にあるSuccessFactors製品のマニュアルで説明されています。/Certificate.pem
ファイルが生成されます。コネクタをOracle Identity Managerにインストールする必要があります。必要に応じて、コネクタをコネクタ・サーバーにインストールすることもできます。
次のトピックでは、コネクタのインストールについて詳しく説明します。
このコネクタ・コードは、Oracle Identity Managerでローカルに実行することも、コネクタ・サーバーでリモートで実行することもできます。
コネクタ・コード(バンドル)を実行する場所に応じて、コネクタのインストール・オプションは次のようになります。
Oracle Identity Managerでコネクタ・コードをローカルに実行します。
このシナリオでは、Oracle Identity Managerにコネクタをデプロイします。Oracle Identity Managerにコネクタをデプロイするには、コネクタ・インストーラの実行およびITリソース・パラメータで説明されている手順を実行します。
コネクタ・サーバーでコネクタ・コードをリモートに実行します。
このシナリオでは、Oracle Identity Managerにコネクタをデプロイしてから、コネクタ・サーバーにコネクタ・バンドルをデプロイします。コネクタ・サーバーのインストール・構成および実行、ならびにコネクタ・サーバーでのコネクタのインストールの詳細は、Oracle Fusion Middleware Oracle Identity Managerのためのアプリケーションの開発とカスタマイズのアイデンティティ・コネクタ・サーバーの使用を参照してください。
コネクタ・インストーラを実行すると、コネクタ・ファイルがOracle Identity Managerのディレクトリに自動的にコピーされ、コネクタXMLファイルがインポートされ、プロビジョニングに使用されるアダプタがコンパイルされます。
コネクタ・インストーラを実行するには、次のようにします。
ターゲット・システムのITリソースは、コネクタのインストール後に作成されます。このITリソースを構成することで、コネクタによりOracle Identity Managerをターゲット・システムと接続できます。
この項の内容は、次のとおりです。
ITリソースは、ターゲット・システムに関する接続やその他の汎用情報を格納するパラメータで構成されます。Oracle Identity Managerはこの情報を使用して、ターゲット・システムの特定のインストールまたはインスタンスに接続します。
ターゲット・システムのITリソースには、ターゲット・システムに関する接続情報が含まれます。Oracle Identity Managerでは、プロビジョニングおよびリコンシリエーション時にこの情報を使用します。
SuccessFactors ITリソースは、コネクタ・インストーラを実行すると自動的に作成されます。次のようにして、パラメータの値を指定する必要があります。
コネクタのインストール後の作業には、Oracle Identity Managerの構成、すべてのコネクタ・イベントに関する情報を追跡するためのロギングの有効化、およびSSLの構成が含まれます。また、ユーザー・インタフェースのローカライズなどのオプションの構成も行います。
インストール後のタスクは次の項に分かれています。
リコンシリエーションおよびプロビジョニング操作を実行するリソースに対し、UIフォームおよびアプリケーション・インスタンスを作成する必要があります。さらに、権限およびカタログ同期化ジョブを実行する必要があります。
これらの手順について、次の各項で説明します。
カスタマイズおよびフォーム管理機能の使用を開始するには、サンドボックスを作成してアクティブにする必要があります。次に、サンドボックスを公開してそのカスタマイズを他のユーザーが使用できるようにします。
Oracle Identity System Administrationのフォーム・デザイナを使用して、アプリケーション・インスタンス・フォームを作成および管理できます。
次のようにして、アプリケーション・インスタンスを作成します。詳しい手順は、Oracle Fusion Middleware Oracle Identity Managerの管理のアプリケーション・インスタンスの管理を参照してください。
子プロセス・フォーム表から権限割当てスキーマを移入し、ロール、アプリケーション・インスタンスおよび権限をカタログに収集できます。カタログ・メタデータをロードすることもできます。
ユーザー・プロビジョニング操作中に、ターゲット・システムで必須のフィールドがいくつかあります。ターゲット・システムで必須にする必要があるこれらのフィールドが、Oracle Identity Managerで必須フィールドになっていない場合、プロビジョニング操作が正常に実行されません。
プロビジョニング操作を正常に実行するには、Oracle Identity Managerで既存のフィールドを編集して、そのフィールドを必須にする必要があります。フォーム・デザイナでフィールドを変更し、タイプをオプションから必須に更新することができます。
注意:
フォーム・デザイナでなんらかの変更を行う場合、新しいUIフォームを作成し、アプリケーション・インスタンスでその変更を更新する必要があります。リコンシリエーション操作中、ターゲット・システムではOracle Identity Managerにいくつかの必須フィールドが存在することが条件になります。必須フィールドがOracle Identity Managerに存在しない場合、リコンシリエーション操作が正常に実行されません。
リコンシリエーション操作を正常に実行するには、Oracle Identity Managerで既存のフィールドを編集して、そのフィールドを必須にする必要があります。Design Consoleとリソース・オブジェクトを使用して、タイプをオプションから必須に更新することができます。
既存のフィールドを編集するには:使用する言語に対応するリソース・バンドルを使用して、UIフォーム・フィールド・ラベルをローカライズできます。リソース・バンドルはコネクタ・インストール・メディアに用意されています。
コネクタをデプロイすると、リソース・バンドルがインストール・メディアのresourcesディレクトリからOracle Identity Managerデータベースにコピーされます。connectorResourcesディレクトリに新しいリソース・バンドルを追加したり、既存のリソース・バンドルに変更を加えた場合は、コネクタ・リソース・バンドルに関連するコンテンツをその都度サーバー・キャッシュから消去する必要があります。
Oracle Identity ManagerではOracle Diagnostic Logging (ODL)ロギング・サービスを使用して、コネクタに関連するすべてのタイプのイベントを記録します。
次のトピックでは、ロギングについて詳しく説明します。
ロギングを有効化すると、Oracle Identity Managerはプロビジョニングおよびリコンシリエーション操作の過程で発生するイベントについての情報をログ・ファイルに自動的に格納します。ODLはOracle Identity Managerにより原則的に使用されるロギング・サービスで、java.util.Loggerに基づいています。ロギングを行うイベントのタイプを指定するには、ログ・レベルを次のいずれかに設定します。
SEVERE.intValue()+100
このレベルでは、致命的エラーに関する情報のロギングが有効化されます。
SEVERE
このレベルでは、Oracle Identity Managerの実行を続行できる可能性があるエラーに関する情報のロギングが有効化されます。
WARNING
このレベルでは、障害を引き起こす可能性のある状況に関する情報のロギングが有効化されます。
INFO
このレベルでは、アプリケーションの進行状況を示すメッセージのロギングが有効化されます。
CONFIG
このレベルでは、デバッグに役立つ詳細なイベントに関する情報のロギングが有効化されます。
FINE、FINER、FINEST
これらのレベルでは詳細なイベントに関する情報のロギングが有効化され、FINESTではすべてのイベントに関する情報が記録されます。
表2-2 ログ・レベルおよびODLメッセージ・タイプ: レベルの組合せ
Javaのレベル | ODLメッセージ・タイプ:レベル |
---|---|
SEVERE.intValue()+100 |
INCIDENT_ERROR:1 |
SEVERE |
ERROR:1 |
WARNING |
WARNING:1 |
INFO |
NOTIFICATION:1 |
CONFIG |
NOTIFICATION:16 |
FINE |
TRACE:1 |
FINER |
TRACE16 |
FINEST |
TRACE32 |
OJDLの構成ファイルはlogging.xmlで、これは次のパスにあります: DOMAIN_HOME/config/fmwconfig/servers/OIM_SERVER/logging.xml
ここで、DOMAIN_HOME
とOIM_SEVER
は、Oracle Identity Managerのインストール時に指定されたドメイン名とサーバー名です。