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