コネクタをデプロイする手順は、インストール前、インストール、およびインストール後の3つのステージに分けることができます。
次の各トピックでは、これらのステージについて詳しく説明します。
Boxコネクタのインストール前の作業では、ターゲット・システムで一連のタスクを実行します。
Oracle Identity Managerにコネクタをインストールする必要があります。必要に応じて、コネクタ・サーバーにコネクタをデプロイすることもできます。
次のトピックでは、Boxコネクタのインストールについて説明します。
このコネクタ・コードは、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ホスト・コンピュータ上のコピー先ディレクトリにコピーされます。Boxコネクタ・インストール・メディア上のファイルおよびディレクトリに、これらのファイルを示します。
ターゲット・システムのITリソースは、コネクタのインストール後に作成されます。このITリソースを構成することで、コネクタによりOracle Identity Managerをターゲット・システムと接続できます。
この項の内容は次のとおりです。
ITリソースは、ターゲット・システムに関する接続やその他の汎用情報を格納するパラメータで構成されます。Oracle Identity Managerはこの情報を使用して、ターゲット・システムの特定のインストールまたはインスタンスに接続します。
接続パラメータ
認証パラメータ
表2-1に、接続パラメータを示します。
表2-1 接続のITリソース・パラメータ
パラメータ | 説明 |
---|---|
Host |
ターゲット・システムのホストであるコンピュータのホスト名またはIPアドレス。 サンプル値: |
Port |
ターゲット・システムがリスニングしているポート番号。 サンプル値: |
authenticationType |
ターゲット・システムにより使用される認証のタイプ。Boxターゲット・システムでは、OAuth2.0認証でアクセス・トークンとリフレッシュ・トークンの手動入力を使用します。 デフォルト値: パラメータの値は変更しないでください。 |
clientId |
登録処理中に認証サーバーによってクライアント・アプリケーションに対して発行されるクライアント識別子(一意の文字列)を入力します。インストール前の作業として新しく登録したアプリケーションを構成しているときにクライアントIDを取得しています。 サンプル値: |
clientSecret |
クライアント・アプリケーションのアイデンティティを認証するのに使用されるシークレット・キーを入力します。インストール前の作業として新しく登録したアプリケーションを構成しているときに秘密キーを取得しています。 サンプル値: |
Configuration Lookup |
リコンシリエーションおよびプロビジョニング操作時に使用される構成情報を格納する参照定義の名前。 デフォルト値: |
Connector Server Name |
Javaコネクタ・サーバーにBoxコネクタをデプロイしている場合、コネクタ・サーバーのITリソースの名前を入力します。 |
sslEnabled |
ターゲット・システムでSSL接続が必要な場合、このパラメータの値をtrueに設定します。そうではない場合、値をfalseに設定します。 デフォルト値: |
proxyHost |
外部のターゲット・システムへの接続に使用するプロキシ・ホストの名前。 サンプル値: |
proxyPort |
プロキシ・ポート番号。 サンプル値: |
proxyUser |
ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるターゲット・システム・ユーザー・アカウントのプロキシ・ユーザー名。 |
proxyPassword |
ターゲット・システムに接続するために、Oracle Identity Managerにより使用されるターゲット・システム・ユーザー・アカウントのプロキシ・ユーザーIDのパスワード。 |
表2-2に、認証パラメータを示します。
表2-2 認証ITリソースのパラメータ
パラメータ | 説明 |
---|---|
clientId |
登録プロセス中にクライアントに発行されるクライアント識別子。 サンプル値: |
clientSecret |
登録プロセス中にクライアントに発行されるクライアント・シークレットID。 サンプル値: |
customAuthHeaders |
アクセス・トークンおよびリフレッシュ・トークンの値を取得します。 サンプル値1: サンプル値2: |
ターゲット・システムのITリソースには、ターゲット・システムに関する接続情報が含まれます。Oracle Identity Managerでは、プロビジョニングおよびリコンシリエーション時にこの情報を使用します。
Box ITリソースは、コネクタ・インストーラを実行すると自動的に作成されます。ITリソースのパラメータ値を指定する必要があります。値を指定するには:
Boxコネクタのインストール後の作業では、Oracle Identity Managerの構成、ロギングの有効化によるすべてのコネクタ・イベントに関する情報の追跡、およびSSLの構成を実行します。また、ユーザー・インタフェースのローカライズなどのオプションの構成も行います。
次の各項では、インストール後の作業について説明します。
リコンシリエーションおよびプロビジョニング操作を実行するリソースに対し、UIフォームおよびアプリケーション・インスタンスを作成する必要があります。さらに、権限およびカタログ同期化ジョブを実行する必要があります。
これらの手順について、次の各項で説明します。
カスタマイズおよびフォーム管理機能の使用を開始するには、サンドボックスを作成してアクティブにする必要があります。次に、サンドボックスを公開してそのカスタマイズを他のユーザーが使用できるようにします。
Oracle Fusion Middleware Oracle Identity Managerのためのアプリケーションの開発とカスタマイズのサンドボックスの作成に関する項 および サンドボックスのアクティブ化および非アクティブ化に関する項を参照してください。
Oracle Identity System Administrationのフォーム・デザイナを使用して、アプリケーション・インスタンス・フォームを作成および管理できます。Oracle Fusion Middleware Oracle Identity Managerの管理 の フォーム・デザイナを使用したフォームの作成に関する項を 参照してください。
UIフォームを作成するときは、必ずそのフォームを関連付けるBoxコネクタに対応するリソース・オブジェクトを選択します。また、「権限フォームの生成」チェック・ボックスを選択します。
サンドボックスを公開する前に、ベスト・プラクティスとして次の手順を実行し、このステージまでに行われたすべてのサンドボックスの変更を検証してください(サンドボックスが一度公開されると変更を元に戻すことは難しいため)。
関連項目:
権限リスト・スケジュール済ジョブおよびカタログ同期化ジョブ・スケジュール済ジョブの詳細は、Oracle Fusion Middleware Oracle Identity Managerの管理で事前定義済のスケジュール済タスクを参照してください。
使用する言語に対応するリソース・バンドルを使用して、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-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のインストール時に指定されたドメイン名とサーバー名です。