コネクタをデプロイする手順は、インストール前、インストール、およびインストール後の3つのステージに分けることができます。
次のトピックでは、これらのステージについて詳しく説明します。
コネクタをOracle Identity Managerにインストールする必要があります。必要に応じて、コネクタをコネクタ・サーバーにインストールすることもできます。
次の項では、Fusion Appsコネクタのインストールについて詳しく説明します。
このコネクタ・コードは、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ファイルがインポートされ、プロビジョニングに使用されるアダプタがコンパイルされます。
コネクタ・インストーラを実行するには、次の手順を実行します。
コネクタ・インストーラを実行すると、コネクタ・ファイルおよび外部コード・ファイルがOracle Identity Managerホスト・コンピュータ上のコピー先ディレクトリにコピーされます。Fusion Appsコネクタ・インストール・メディア上のファイルおよびディレクトリに、これらのファイルを示します。
ターゲット・システムのITリソースは、コネクタのインストール後に作成されます。このITリソースを構成することで、コネクタによりOracle Identity Managerをターゲット・システムと接続できます。
この項の内容は次のとおりです。
ITリソースは、ターゲット・システムに関する接続やその他の汎用情報を格納するパラメータで構成されます。Oracle Identity Managerはこの情報を使用して、ターゲット・システムの特定のインストールまたはインスタンスに接続します。
FA User Request ServiceのITリソース・パラメータ
FA Identity ServiceのITリソース・パラメータ
表2-1に、FA User Request ServiceのITリソース・パラメータを示し、表2-2に、FA Identity ServiceのITリソース・パラメータを示します。
表2-1 FA User Request ServiceのITリソース・パラメータ
パラメータ | 説明 |
---|---|
host |
ターゲット・システムのホストであるコンピュータのホスト名またはIPアドレス。 サンプル値: |
port |
ターゲット・システムがリスニングしているポート番号。 サンプル値: |
userRequestServiceUri |
このパラメータは、ユーザー・リクエスト・サービスAPIのUniform Resource Identifierを保持します。 サンプル値:
/hcmCoreApi/atomservlet/user/userRequests |
userName |
このパラメータは、ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるデータベース・ユーザー・アカウントのユーザーIDです。 サンプル値:
HCM_INTEGRATION_HCM |
password |
このパラメータは、ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるデータベース・ユーザー・アカウントのパスワードです。 |
proxyHost |
外部のターゲット・システムへの接続に使用するプロキシ・ホストの名前。 サンプル値: |
proxyPassword |
ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるターゲット・システム・ユーザー・アカウントのプロキシ・ユーザーIDのパスワード。 |
proxyPort |
プロキシ・ポート番号。 サンプル値: |
proxyUsername |
このパラメータは、ターゲット・システムに接続するために使用されるプロキシのユーザーIDです。 |
socketTimeout |
このパラメータは、データ待機のタイムアウト時間であるデフォルトのソケット・タイムアウトをミリ秒単位で設定します。 |
connectionTimeout |
このパラメータは、接続が確立されるまでのタイムアウトを設定します。 |
Configuration Lookup |
リコンシリエーションおよびプロビジョニング操作時に使用される構成情報を格納する参照定義の名前。 デフォルト値: |
sslEnabled |
デフォルト値: False ターゲット・システムがSSLベースの場合、このパラメータの値を'true'に設定し、それ以外の場合は'false'に設定します。値を設定した後、Oracle Identity Managerがターゲット・システムでSSLハンドシェイクを設定できるように、Fusion AppsコネクタのSSLの構成に示された手順を実行します。 |
表2-2 FA Identity ServiceのITリソース・パラメータ
パラメータ | 説明 |
---|---|
adminUser |
コネクタ操作に作成する、ターゲット・システムのユーザー・アカウントのユーザーIDを入力します。 |
adminPassword |
コネクタ操作に作成する、ターゲット・システムのユーザー・アカウントのパスワードを入力します。 |
userEndPoint |
このパラメータは、ユーザーについての操作を実行するために使用されるエンドポイントURLを保持します。 サンプル値: |
roleEndPoint |
このパラメータは、ユーザーをロールに追加またはロールから削除するために使用されるエンドポイントURLを保持します。 サンプル値: |
userSchemaEndPoint |
このパラメータは、ユーザー・スキーマを取得するために使用されるエンドポイントURLを保持します。 サンプル値: |
Configuration Lookup |
リコンシリエーションおよびプロビジョニング操作時に使用される構成情報を格納する参照定義の名前。 デフォルト値: |
Connector Server Name |
このパラメータは、コネクタ・サーバーが存在するマシンのホスト名を保持します。 |
proxyHost |
外部のターゲット・システムへの接続に使用するプロキシ・ホストの名前。 サンプル値: |
proxyPassword |
ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるターゲット・システム・ユーザー・アカウントのプロキシ・ユーザーIDのパスワード。 |
proxyPort |
プロキシ・ポート番号。 サンプル値: |
proxyUsername |
このパラメータは、ターゲット・システムに接続するために使用されるプロキシのユーザーIDです。 |
host |
ターゲット・システムのホストであるコンピュータのホスト名またはIPアドレス。 サンプル値: |
port |
ターゲット・システムがリスニングしているポート番号。 サンプル値: |
socketTimeout |
このパラメータは、データ待機のタイムアウト時間であるデフォルトのソケット・タイムアウトをミリ秒単位で設定します。 |
connectionTimeout |
このパラメータは、接続が確立されるまでのタイムアウトを設定します。 |
sslEnabled |
デフォルト値: False ターゲット・システムがSSLベースの場合、このパラメータの値を'true'に設定し、それ以外の場合は'false'に設定します。値を設定した後、Oracle Identity Managerがターゲット・システムでSSLハンドシェイクを設定できるように、Fusion AppsコネクタのSSLの構成に示された手順を実行します。 |
ターゲット・システムのITリソースには、ターゲット・システムに関する接続情報が含まれます。Oracle Identity Managerでは、プロビジョニングおよびリコンシリエーション時にこの情報を使用します。
Fusion Apps ITリソースは、コネクタ・インストーラを実行すると自動的に作成されます。ITリソースのパラメータ値を指定する必要があります。値を指定するには:
Fusion Appsコネクタのインストール後の作業には、Oracle Identity Managerの構成、すべてのコネクタ・イベントに関する情報を追跡するためのロギングの有効化、およびSSLの構成が含まれます。また、ユーザー・インタフェースのローカライズなどのオプションの構成も行います。
リソース・オブジェクトの依存性を構成するには、次の手順を実行します:
関連項目:
非LDAP同期トポロジを使用している場合、必要なエンタープライズ・ディレクトリをインストールし、リソース・オブジェクトの依存性を構成します。他のトポロジを使用している場合は、ここに示す手順を実行しないでください。FA User
を検索して「名前」フィールドに指定します。リコンシリエーションおよびプロビジョニング操作を実行するリソースに対し、UIフォームおよびアプリケーション・インスタンスを作成する必要があります。さらに、権限およびカタログ同期化ジョブを実行する必要があります。
カスタマイズおよびフォーム管理機能の使用を開始するには、サンドボックスを作成してアクティブにする必要があります。次に、サンドボックスを公開してそのカスタマイズを他のユーザーが使用できるようにします。
Oracle Fusion Middleware Oracle Identity Managerのためのアプリケーションの開発とカスタマイズのサンドボックスの作成に関する項 および サンドボックスのアクティブ化および非アクティブ化に関する項を参照してください。
関連項目:
権限リスト・スケジュール済ジョブおよびカタログ同期化ジョブ・スケジュール済ジョブの詳細は、Oracle Fusion Middleware Oracle Identity Managerの管理で事前定義済のスケジュール済タスクを参照してください。
フォーム・デザイナで行うすべての変更に対して、新しいUIフォームを作成し、アプリケーション・インスタンスでその変更を更新する必要があります。新規フォームにより既存のアプリケーション・インスタンスを更新するには、次のようにします。
アプリケーション・インスタンスの作成に示されている手順を実行して、Fusion Apps用に作成されたアプリケーション・インスタンスを更新できますが、この項で説明する違いがあります。
手順のステップ3で、次の値を指定する必要があります。
名前: FusionApps User
表示名: Fusion Apps User
説明: Application instance for FusionApps
リソース・オブジェクト: FA User
ITリソース・インスタンス: FA Identity Service
フォーム: ドロップダウン・リストをクリックし、FA用に作成したフォームを選択します
前述のパラメータの他に、「親AppInstance」パラメータの値を指定する必要があります。これを行うには、フィールド内の検索アイコンをクリックし、エンタープライズ・ディレクトリ用に作成されたアプリケーション・インスタンスを選択します。
ユース・ケースに応じて、対応するアクセス・ポリシーを更新します。
使用しているユース・ケースに基づいて、この項で説明するいずれかの手順を実行します。
FA Access Policy For External User
と入力します。プロセス・タスクを更新するには、使用しているエンタープライズ・ディレクトリのプロセス定義フォーム用の新しいタスクを作成する必要があります。
ノート:
Oracle Identity Managerが非LDAP同期モードの場合のみ、この項に示すステップを実行してください。インストールされたエンタープライズ・ディレクトリのプロセス定義を更新する必要があります。これを行うには、次の手順を実行します:
Design Consoleにログインします。
「Process Management」を開いて「Process Definition」をダブルクリックします。
インストールされたエンタープライズ・ディレクトリのプロセス定義を開きます。
「タスク」タブを選択します。
「タスク名」フィールドに、プロセス・タスクの名前を入力します。LDAPユーザー・プロセス定義に新規プロセス・タスク「SSO属性の更新」を追加します。
統合タブから、UpdateDepProcessFormDataシステム・アダプタを選択します。
新しいタスクの作成ウィンドウのツールバーで、「保存」をクリックします。
次のチェック・ボックスを選択します。
条件付き
複数のインスタンスを許可
保留中の取消しを許可
「保存」、「終了」の順にクリックします。
この新しく作成したタスクを、電子メールID更新を行うタスクのSUCCESSレスポンスに追加します。
「保存」、「終了」の順にクリックします。
コネクタをデプロイすると、リソース・バンドルがインストール・メディアのresourcesディレクトリからOracle Identity Managerデータベースにコピーされます。connectorResourcesディレクトリに新しいリソース・バンドルを追加したり、既存のリソース・バンドルに変更を加えた場合は、コネクタ・リソース・バンドルに関連するコンテンツをその都度サーバー・キャッシュから消去する必要があります。
使用する言語に対応するリソース・バンドルを使用して、UIフォーム・フィールド・ラベルをローカライズできます。リソース・バンドルはコネクタ・インストール・メディアに用意されています。
SSO電子メールIDを伝播するには、次の手順を実行します。
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-3 ログ・レベルおよび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のインストール時に指定されたドメイン名とサーバー名です。