コネクタをデプロイするには次の手順を実行します。
BMC Remedy User Managementの複数のインストールに対応するようにコネクタを構成する場合は、次の手順を実行します。
次の表に、コネクタのデプロイ要件を示します。
項目 | 要件 |
---|---|
Oracle Identity Manager | Oracle Identity Managerリリース8.5.3以上。 |
ターゲット・システム | BMC Remedy AR System 6.0。 |
外部コード | BMC Remedy Admin Clientのインストール・ディレクトリにある次のJARおよびDLLファイル。
arapi60.jar arutil60.jar arapi60.dll arjni60.dll arrpc60.dll arutl60.dll |
ターゲット・システムのユーザー・アカウント | APP管理グループのメンバーであるユーザー・アカウント。
「ITリソースの定義」の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。 |
ターゲット・システムを構成するには、次の手順を実行します。
「ユーザー」フォームを使用して、License Type=Fixed
のユーザーを作成します。このユーザー・アカウントは、新しい(カスタム)フォームの作成に使用されます。
「SHR:DeletePeople」フォームは、削除されたユーザーの詳細を保存するために使用されます。この情報は、リコンシリエーション中に必要です。
「SHR:DeletePeople」フォームを作成するには、次のようにします。
ArAdminツールを開きます。
Demo
ユーザーIDを使用してBMC Remedy User Managementサーバーに接続します。パスワードは空白のままにできます。
「Forms」をクリックします。
「File」メニューから「Save As」を選択し、このフォームをSHR:DeletePeopleとして保存します。
削除されたユーザー・レコードを「SHR:People」フォームから「SHR:DeletePeople」フォームに移動するためのデータベース・トリガーを作成するには、次のようにします。
BMC Remedy用に作成されたOracle Databaseで次のSELECT文を実行して、「SHR:People」および「SHR:DeletePeople」フォームの表の名前を決定します。
SELECT name,schemaid FROM arschema WHERE name LIKE 'SHR:People';
SQL*Plusを使用してBMC Remedyデータベースにログインします。
SQLプロンプトで、インストール・メディア・ディレクトリにある次のファイルからSQLコードをコピーします。
BMCTrigger\Trigger.txt
SQLコード内で、仮の表名である57
および608
を、ステップ1を実行して決定した表名で置き換えます。
SQLコードを実行してトリガーを作成します。
この項では、Remedy暗号化に関する次の項目について説明します。
Remedy暗号化を有効化するには、次のようにします。
実行中のAR Systemプロセスをすべて終了または停止します。これを実行するには、「コントロール パネル」、「管理ツール」、「サービス」の順に開きます。実行中の各AR Systemプロセスを停止します。
ar.conf
ファイル(UNIXの場合)またはar.cfg
ファイル(Microsoft Windowsの場合)に、設定が0
(暗号化を許可)または1
(暗号化必須)のEncrypt-Security-Policy
オプションを追加します。必要に応じて、ファイルにその他のオプションを追加します。
ar.conf
ファイルのデフォルトのUNIXディレクトリは、ar_install_dir
/conf
です。Microsoft Windowsの場合、ar.cfg
ファイルはar_install_dir
\conf
ディレクトリに格納されています。ここで、ar_install_dir
はARサーバーのARSystemのインストール・ディレクトリです。
注意: Encrypt-Security-Policy オプションを1 (暗号化必須)に設定すると、暗号化を使用するようにアップグレードされていないサーバーまたはクライアントと通信できなくなります。 |
AR Systemサーバーを再起動します。
暗号化を有効化して暗号化オプションを設定するには、ar.conf
ファイル(UNIX)またはar.cfg
ファイル(Microsoft Windows)にサーバー暗号化オプションを指定する必要があります。これは、テキスト・エディタを使用して実行できます。
Encrypt-Security-Policy
暗号化オプションを設定できます。これは、暗号化が有効化されているかどうかを示す整数値です。暗号化が有効化されている場合には、暗号化を必須または許可に設定できます。ar.cfg
(またはar.conf
)ファイルにこのオプションがない場合、暗号化はデフォルトで無効化されています。このオプションには、次に示すいずれかの値を割り当てることができます。
0: 暗号化が許可されます。暗号化が有効化または無効化されているクライアントおよびサーバーがこのAR Systemサーバーに接続できます。
1: 暗号化は必須です。暗号化が有効化されているクライアントおよびサーバーのみがこのAR Systemサーバーに接続できます。
2: 暗号化は許可されません。暗号化が有効化されているかどうかにかかわらず、クライアントおよびサーバーは暗号化なしで通信できます。
次の表に、ar.conf
(またはar.cfg
)ファイルに追加可能なオプションのサンプル設定を示します。
オプションの設定 | 意味 |
---|---|
Encrypt-Security-Policy: 1 | 暗号化は必須です。 |
Encrypt-Public-Key-Expire: 86400 | 公開鍵の継続時間は1日(86400秒)です。 |
Encrypt-Symmetric-Data-Key-Expire: 2700 | 対称型データの暗号化キーの継続時間は45分(2700秒)です。 |
Encrypt-Public-Key-Algorithm: 5 | 公開鍵の暗号化キーの強度はRSA-1024(パフォーマンス・セキュリティ)です。 |
Encrypt-Data-Encryption-Algorithm: 2 | 対称型データの暗号化キーの強度はRC4 128ビット(パフォーマンス・セキュリティ)です。 |
これらのオプションを設定しない場合は、デフォルト値が使用されます。暗号化レベルのデフォルトは、使用する暗号化製品により異なります。
AR Systemサーバーを起動すると、暗号化が有効化されている場合には、暗号化ライセンスおよび暗号化構成設定が確認されます。Remedy暗号化製品の適切なライセンスが検出されない場合、または無効な構成設定が検出された場合には、次のエラー・メッセージが1つ以上表示されます。
暗号化が無効化されている場合、暗号化エラー・チェックは行われず、暗号化エラーは無視されます。エラー・メッセージは、検出された順序で表示されます。
次の表に、コピーするコネクタ・ファイルおよびそれらのコピー先のディレクトリを示します。
注意: この表の最初の列に示すディレクトリ・パスは、インストール・メディアの次のディレクトリでのコネクタ・ファイルの場所に対応しています。Help Desk\BMC Remedy User Management これらのファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。 |
次のファイルをBMC Remedy Admin Clientのインストール・ディレクトリ(C:\Program Files\AR System
など)から、OIM_home
\xellerate\ThirdParty
ディレクトリにコピーします。
arapi60.jar arutil60.jar arapi60.dll arjni60.dll arrpc60.dll arutl60.dll
PATH
環境変数にOIM_home
\xellerate\ThirdParty
を指定します。
注意: Oracle Identity Managerをクラスタ環境にインストールするときは、インストール・ディレクトリの内容をクラスタの各ノードにコピーします。同じく、connectorResources ディレクトリとJARファイルも、クラスタの各ノードの対応するディレクトリにコピーする必要があります。 |
Oracle Identity Managerサーバーの構成には、次の手順があります。
注意: クラスタ環境では、クラスタの各ノードでこの手順を実行する必要があります。 |
必要な入力ロケール(言語および国の設定)に変更するには、必要なフォントのインストールと必要な入力ロケールの設定を行います。
必要な入力ロケールを設定するには、次のようにします。
注意: 使用しているオペレーティング・システムによっては、この手順の実行方法が異なる場合があります。 |
「コントロール パネル」を開きます。
「地域のオプション」をダブルクリックします。
「地域のオプション」ダイアログ・ボックスの「入力ロケール」タブで、使用する入力ロケールを追加してから、その入力ロケールに切り替えます。
OIM_home
\xellerate\connectorResources
ディレクトリ内に新しいリソース・バンドルを追加するたび、または既存のリソース・バンドルで変更を行うたびに、コネクタ・リソース・バンドルに関連するコンテンツをサーバー・キャッシュから消去する必要があります。
サーバー・キャッシュからのコネクタ・リソース・バンドルに関連する内容を消去するには、次のようにします。
コマンド・ウィンドウで、OIM_home
\xellerate\bin
ディレクトリに移動します。
次のコマンドのいずれかを入力します。
注意: このステップを実行する前にステップ1を実行する必要があります。コマンドを次のように実行すると、例外がスローされます。OIM_home\xellerate\bin\batch_file_name |
Microsoft Windowsの場合:
PurgeCache.bat ConnectorResourceBundle
UNIXの場合:
PurgeCache.sh ConnectorResourceBundle
このコマンドのConnectorResourceBundle
は、サーバー・キャッシュから削除できるコンテンツ・カテゴリの1つです。その他のコンテンツ・カテゴリの詳細は、次のファイルを参照してください。
OIM_home\xellerate\config\xlConfig.xml
注意: ステップ2の実行時にスローされる例外は無視できます。 |
コネクタのXMLファイルをOracle Identity Managerにインポートするには、次のようにします。
左側のナビゲーション・バーの「デプロイメント管理」リンクをクリックします。
「デプロイメント管理」の下の「インポート」リンクをクリックします。ファイル検索用のダイアログ・ボックスが表示されます。
OIM_home
\xlclient
ディレクトリにあるBMCConnector_DM.xml
ファイルを探して開きます。このXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。
「ファイルの追加」をクリックします。「置換」ページが表示されます。
「次へ」をクリックします。「確認」ページが表示されます。
BMC
ITリソースのパラメータの値を指定します。指定する値の詳細は、「ITリソースの定義」の表を参照してください。
「次へ」をクリックします。BMCRemedy
ITリソース・タイプの新しいインスタンスの「ITリソース・インスタンス・データの提供」ページが表示されます。
その他のITリソースを定義しないことを指定するには、「スキップ」をクリックします。「確認」ページが表示されます。
関連資料: その他のITリソースを定義する場合、手順は『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。 |
「選択内容の表示」をクリックします。
XMLファイルの内容が「インポート」ページに表示されます。ノードの横に十字形のアイコンが表示されることがあります。各ノードを右クリックして「削除」を選択し、それらのノードを削除します。
「インポート」をクリックします。コネクタのXMLファイルがOracle Identity Managerにインポートされます。
コネクタのXMLファイルをインポートしたら、「手順6: リコンシリエーションの構成」に進みます。
BMC
ITリソース・パラメータには、次の表に示す値を指定してください。
パラメータ | 説明 |
---|---|
UserName |
ターゲット・システムへの接続に使用されるユーザーID。
デフォルト値は |
Password |
ターゲット・システムへの接続に使用されるユーザーIDのパスワード。 |
ServerName |
BMC Remedy User ManagementサーバーのIPアドレスまたはコンピュータ名。 |
Port |
BMC Remedy User ManagementサーバーがリスニングするTCP/IPポート。
デフォルト値は |
TrustedField |
ユーザー・レコード検索用の一意の識別キー。
デフォルト値は |
IsDebug |
デバッグ文を表示する必要があるかどうかを指定します。
値は |
TimeStamp |
最初のリコンシリエーションの実行では、このパラメータに値None を指定します。次のリコンシリエーションの実行以降は、このパラメータには最後のリコンシリエーションの実行が完了した時間が格納されます。
デフォルト値は |
IsSecure |
暗号化機能が有効化されているかどうかを指定します。
値は |
DeleteUserFormName |
削除されたユーザーの詳細を取得できるターゲット・システムのフォームの名前。
デフォルト値は |
FormName |
新規作成されたユーザーおよび更新されたユーザーの詳細を取得できるターゲット・システムのフォームの名前。
値は |
これらのITリソース・パラメータの値を指定したら、この手順のステップ9に進んで、コネクタのXMLファイルをインポートします。
リコンシリエーションを構成するには、次の手順を実行します。
注意: この手順のこのステップは、信頼できるソース・リコンシリエーションを構成する場合にのみ実行します。信頼できるソース・リコンシリエーションに構成できるのは、1つのコネクタのみです。信頼できるソースが別に構成されている場合に、信頼できるソース・リコンシリエーションをこのコネクタで構成すると、両方のコネクタでリコンシリエーションが機能しなくなります。リコンシリエーションの構成の概念の詳細は、『Oracle Identity Manager Connectorフレームワーク・ガイド』を参照してください。 |
Oracle Identity Manager Design Consoleを使用して、信頼できるソース・リコンシリエーションを次のように構成します。
「Resource Objects」フォームで、リコンサイルするフィールドを次のように選択します。
「Resource Management」フォルダを開きます。
「Resource Objects」をダブルクリックします。
Xellerate User
を「Name」フィールドに入力し、「Query」アイコンをクリックします。
表示されるリストの「Xellerate User」をダブルクリックします。
「Object Reconciliation」タブで、必要なリコンシリエーション・フィールドを追加します。「Xellerate User」フォームの必須フィールドへの入力を指定するために必要なすべてのリコンシリエーション・フィールドを追加してください。たとえば、「User Login」や「First Name」などのフィールドです。ただし、「Password」フィールドは必須フィールドですが、値を指定する必要はありません。
「Process Definition」フォームで、リコンシリエーション・フィールド・マッピングを次のように作成します。
「Process Management」フォルダを開きます。
「Process Definition」をダブルクリックします。
Xellerate User
を「Name」フィールドに入力し、「Query」アイコンをクリックします。
「Reconciliation Field Mappings」タブで、必要なリコンシリエーション・フィールド・マッピングを追加します。「User Defined Process」フォームのすべての必須フィールドをマッピングしてください。
「Reconciliation Rules」フォームで、Xellerate User
オブジェクトのルールを次のように作成します。
「Development Tools」フォルダを開きます。
「Reconciliation Rules」フォームをダブルクリックします。
Xellerate Userオブジェクトのルールと必要なルール要素を作成します。
関連資料: 詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。 |
「Active」チェック・ボックスを選択して、ルールを有効にします。
リコンシリエーションを構成するには、参照フィールドおよびユーザー・リコンシリエーション用にスケジュール済タスクを作成します。これらのスケジュール済タスクを作成するには、次のようにします。
「Xellerate Administration」フォルダを開きます。
「Task Scheduler」を選択します。
「Find」をクリックします。事前定義されたスケジュール済タスクの詳細が2つのタブに表示されます。
1つ目のスケジュール済タスクの場合は、「Max Retries」フィールドに数値を入力します。この数はOracle Identity Managerがタスクを完了するために試行する回数です。この数を超えると、ERROR
ステータスがタスクに割り当てられます。
「Disabled」および「Stop Execution」チェック・ボックスが選択されていないことを確認します。
「Start」リージョンで、「Start Time」フィールドをダブルクリックします。表示される日付時間エディタで、タスクを実行する日付と時間を選択します。
「Interval」リージョンで、次のスケジュール・パラメータを設定します。
タスクを繰り返し実行するように設定するには、「Daily」、「Weekly」、「Recurring Intervals」、「Monthly」または「Yearly」のオプションを選択します。
「Recurring Intervals」オプションを選択した場合は、タスクを繰り返して実行する間隔も指定する必要があります。
タスクを1回のみ実行するように設定するには、「Once」オプションを選択します。
スケジュール済タスクの属性の値を指定します。指定する値の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。
関連資料: タスク属性の追加および削除の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。 |
「Save」をクリックします。スケジュール済タスクが作成されます。現在はタスクが実行されていないため、「Status」フィールドにINACTIVE
ステータスが表示されます。タスクはステップ7で設定した日時に実行されます。
ステップ5〜10を繰り返してもう1つのスケジュール済タスクを作成します。
両方のスケジュール済タスクを定義したら、「手順7: アダプタのコンパイル」に進みます。
この項では、次のスケジュール済タスクに指定する属性値について説明します。
参照フィールド・リコンシリエーション・スケジュール済タスクの次の属性に値を指定する必要があります。
注意: 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。 |
スケジュール済タスク属性に値を指定したら、手順のステップ10に進んでスケジュール済タスクを作成します。
ユーザー・リコンシリエーション・スケジュール済タスクの次の属性に値を指定する必要があります。
注意: 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。 |
属性 | 説明 | 値 |
---|---|---|
ServerName |
ITリソース・インスタンスの名前。 | BMC |
IsTrusted |
リコンシリエーションが信頼モードで実行されるかどうかを指定します。 | YES またはNO
デフォルトは |
TargetRO |
リソース・オブジェクトの名前。 | BMCRO |
XellerateOrganisation |
Oracle Identity Managerの組織名のデフォルト値。
この値は、Xellerate Userを信頼できるモードで作成するために使用されます。 |
Xellerate Users |
スケジュール済タスク属性に値を指定したら、手順のステップ10に進んでスケジュール済タスクを作成します。
コネクタのXMLファイルのインポート時に、次のアダプタがOracle Identity Managerにインポートされます。
adpBMCCREATEUSER
adpBMCUPDATEUSER
adpBMCUPDATEPASSWORD
adpBMCDELETEUSER
これらのアダプタを使用してターゲット・システムにアカウントをプロビジョニングするには、これらをコンパイルする必要があります。
「アダプタ・マネージャ」フォームを使用してアダプタをコンパイルするには、次のようにします。
「アダプタ・マネージャ」フォームを開きます。
現在のデータベースにインポートしたすべてのアダプタをコンパイルするには、「すべてをコンパイル」を選択します。
複数のアダプタ(すべてではない)をコンパイルするには、コンパイルするアダプタを選択します。次に、「選択したものをコンパイル」を選択します。
注意: 正常にコンパイルされなかったアダプタのみを再コンパイルするには、「以前の失敗分をコンパイル」をクリックします。そのようなアダプタはコンパイルのステータスがOK になっていません。 |
「開始」をクリックします。選択したアダプタがOracle Identity Managerによってコンパイルされます。
Oracle Identity Managerがクラスタ環境にインストールされている場合は、OIM_home
\xellerate\Adapter
ディレクトリから、コンパイル済のアダプタをクラスタの他の各ノードの同じディレクトリにコピーします。必要な場合には、その他のノードのアダプタ・ファイルを上書きします。
アダプタの詳細情報を表示するには、次のようにします。
「アダプタ・マネージャ」フォームでアダプタをハイライト表示します。
アダプタの行ヘッダーをダブルクリックするか、アダプタを右クリックします。
表示されるショートカット・メニューで「アダプタの起動」を選択します。アダプタの詳細が表示されます。
注意: この手順は、BMC Remedy User Managementの複数のインストールに対してコネクタを構成する場合にのみ実行します。この手順の各ステップ実行の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。 |
ターゲット・システムの複数のインストールに対してコネクタを構成するには、次のようにします。
各ターゲット・システムのインストールに、リソース・オブジェクトを1つ作成および構成します。
「Resource Objects」フォームは、「Resource Management」フォルダにあります。コネクタのXMLファイルのインポート時に、BMCRO
リソース・オブジェクトが作成されます。このリソース・オブジェクトは、残りのリソース・オブジェクトを作成するためのテンプレートとして使用できます。
各リソース・オブジェクトに、ITリソースを1つ作成および構成します。
「IT Resources」フォームは「Resource Management」フォルダにあります。コネクタのXMLファイルのインポート時に、BMC
ITリソースが作成されます。このITリソースは、同じリソース・タイプの、残りのITリソースを作成するためのテンプレートとして使用できます。
各リソース・オブジェクトにプロセス・フォームを1つ設計します。
「Form Designer」フォームは、「Development Tools」フォルダにあります。コネクタのXMLファイルをインポートすると、UD_BMC
プロセス・フォームが作成されます。このプロセス・フォームは、残りのプロセス・フォームを作成するためのテンプレートとして使用できます。
各リソース・オブジェクトに、プロセス定義を1つ作成および構成します。
「Process Definition」フォームは、「Process Management」フォルダにあります。コネクタのXMLファイルのインポート時に、BMCPROCESS
プロセス定義が作成されます。このプロセス定義は、残りのプロセス定義を作成するためのテンプレートとして使用できます。
各プロセス定義の作成中に、実行する必要のある次のステップはこの手順に固有です。
「Object Name」参照フィールドから、ステップ1で作成したリソース・オブジェクトを選択します。
「Table Name」参照フィールドから、ステップ3で作成したプロセス・フォームを選択します。
ITリソース・データ型のアダプタ変数をマッピングするときは必ず、ステップ2で作成したITリソースを「Qualifier」リストから選択してください。
各ターゲット・システム・インストールについてリコンシリエーションを構成します。手順は、「手順6: リコンシリエーションの構成」を参照してください。リコンシリエーションのスケジュール済タスクごとに、次の属性の値のみを変更する必要がありますので注意してください。
TargetRO
ServerName
IsTrusted
信頼できるソースとして指定するBMC Remedy User Managementのインストールでは、IsTrusted
属性をYES
に設定します。BMC Remedy User Managementの単独インストールと複数インストールのいずれも信頼できるソースとして指定できます。その他のBMC Remedy User Managementのインストールでは、この属性をNO
に設定します。
必要であれば、Xellerate Userリソース・オブジェクトに対してリコンサイルされるフィールドを変更します。
管理およびユーザー・コンソールを使用してプロビジョニングを実行するときは、ユーザーをプロビジョニングするBMC Remedy User Managementインストールに対応するITリソースを指定できます。