3 コネクタの構成

コネクタをデプロイしたら、要件に合せて構成する必要があります。この章では、次のコネクタ構成手順を説明します。

注意: これらの項では、コネクタの構成に関する概念および手順の両方を説明します。概念情報を確認してから手順を実行することをお薦めします。

• リコンシリエーションの構成

• プロビジョニングの構成

• ターゲット・システムの複数のインストールに対するコネクタの構成

• 従業員アカウントのアクティブ化と非アクティブ化

リコンシリエーションの構成

このガイドで前述したように、リコンシリエーションとは、ターゲット・システム上でのユーザー・アカウントの作成および変更を、Oracle Identity Manager内で複製することです。この項では、リコンシリエーションの構成に関する次の項目について説明します。

• 部分リコンシリエーション

• ユーザー・タイプに基づくリコンシリエーション

• 信頼できるソース・リコンシリエーションの構成

• リコンシリエーションのスケジュール済タスクの構成

部分リコンシリエーション

デフォルトでは、前回のリコンシリエーションの実行後に追加または変更されたすべてのターゲット・システム・レコードが、現在のリコンシリエーションの実行中にリコンサイルされます。リコンサイルする必要のある追加または変更されたターゲット・システム・レコードのサブセットを指定して、このプロセスをカスタマイズできます。これは、リコンシリエーション・モジュールのフィルタを作成して行います。

このコネクタの場合、フィルタを作成するには、「ITリソースの定義」で説明されている手順を実行する際に、ITリソース・パラメータCustomizedReconQueryに値を指定します。

次の表に、問合せ条件の作成に使用できるSiebel Enterprise Applicationsの属性、および対応するOracle Identity Managerの属性を示します。この問合せ条件は、CustomizedReconQueryパラメータの値として指定します。

Oracle Identity Managerの属性	Siebel Enterprise Applicationsの属性
ユーザーID	Login Name
名	First Name
姓	Last Name
電子メール	EMail Addr
役職	Job Title
ミドル・ネーム	Middle Name
組織	Organization
職責	Responsibility
担当	Position
従業員タイプ	Employee Type
別名	Alias

次に、問合せ条件の例を示します。

• givenname=John&sn=Doe

  この問合せ条件では、名前がJohnで姓がDoeであるユーザーのレコードがリコンサイルされます。

• givenname=John&sn=Doe|group=contractors

  この問合せ条件では、次の条件のいずれかに合致するユーザーのレコードがリコンサイルされます。

  • ユーザーの名がJohnであるか、姓がDoeである。

  • ユーザーがcontractorsグループに属している。

CustomizedReconQueryパラメータの値を指定しないと、リコンシリエーション中に、ターゲット・システムのすべてのレコードが既存のOracle Identity Managerレコードと比較されます。

CustomizedReconQueryパラメータの値を指定する際に従う必要のあるガイドラインを次に示します。

• ターゲット・システムの属性では、この項に示した表と同様に大文字または小文字を使用する必要があります。属性名は大/小文字が区別されるためです。

• 問合せ条件の演算子と値の間に不要な空白を入れないでください。

  値と演算子が空白で区切られている問合せ条件と、値と演算子の間に空白が含まれていない問合せ条件を比較した場合、異なる結果が生じます。たとえば、次の問合せ条件による出力は異なります。

  givenname=John&sn=Doe

  givenname= John&sn= Doe

  2つ目の問合せ条件では、リコンシリエーション・エンジンは冒頭に空白が含まれた名および姓の値を検索します。

• 問合せ条件には、等号記号（=）、アンパサンド（&）および縦線（|）以外の特殊文字を使用しないでください。

  
  

  注意: 等号記号（=）、アンパサンド（&）および縦線（|）以外の特殊文字を使用すると、例外がスローされます。

  
  

• 問合せ条件の式にはカッコを使用しないでください。

• 複数値のロールやグループに基づくユーザーの検索はサポートされていません。ロールやプロファイルについては一度に1つの値の問合せしかできません。たとえば、問合せ条件がUsergroup=a,b,cの問合せはエラーになります。

• 4つ以上のユーザー属性に基づくユーザー検索はサポートされていません。たとえば、問合せ条件がuserid=JOHN&firstname=John&lastname=Doe&country=USの問合せはエラーになります。

「ITリソースの定義」で説明した手順の実行中に、CustomizedReconQueryパラメータの値を指定します。

ユーザー・タイプに基づくリコンシリエーション

Siebelでは、次のユーザー・タイプの定義がサポートされます。

• Employee

• Partner User

• Customer

リコンシリエーションを実行する必要があるユーザー・タイプを指定できます。

リコンシリエーションを実行する必要があるユーザー・タイプを指定するには、UserTypeスケジュール済タスク属性を使用します。この属性については、「スケジュール済タスク属性の値の指定」で説明します。

信頼できるソース・リコンシリエーションの構成

コネクタの構成中に、ターゲット・システムを、信頼できるソースまたはターゲット・リソースとして指定できます。ターゲット・システムを信頼できるソースとして指定すると、新規作成されたユーザー・アカウントと変更されたユーザー・アカウントの両方が、Oracle Identity Managerでリコンサイルされます。ターゲット・システムをターゲット・リソースとして指定すると、変更されたユーザー・アカウントのみがOracle Identity Managerでリコンサイルされます。

注意: ターゲット・システムをリコンシリエーションの信頼できるソースとして指定しない場合は、この項を省略してかまいません。

信頼できるソースのリコンシリエーションの構成には、次の手順が含まれます。

1. デプロイメント・マネージャを使用して、信頼できるソースのリコンシリエーション用のXMLファイル（SiebelEmpXLResourceObject.xml）をインポートします。この項では、XMLファイルのインポート手順を説明します。

2. スケジュール済タスクのIsTrusted属性をTrueに設定します。ユーザー・リコンシリエーションのスケジュール済タスクの構成中に、この属性の値を指定します。これについては、このガイドで後述します。

信頼できるソースのリコンシリエーション用のXMLファイルをインポートするには、次のようにします。

1. Oracle Identity Manager管理およびユーザー・コンソールを開きます。

2. 左のナビゲーション・バーの「デプロイメント管理」リンクをクリックします。

3. 「デプロイメント管理」の下の「インポート」リンクをクリックします。ファイルを開くダイアログ・ボックスが表示されます。

4. SiebelEmpXLResourceObject.xmlファイルを検索して開きます。このファイルはOIM_home/xellerate/Siebel/xmlディレクトリにあります。このXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

5. 「ファイルの追加」をクリックします。「置換」ページが表示されます。

6. 「次へ」をクリックします。「確認」ページが表示されます。

7. 「インポート」をクリックします。

8. 表示されるメッセージで、「インポート」をクリックしてXMLファイルのインポートを確認します。次に、「OK」をクリックします。

信頼できるソースのリコンシリエーション用のXMLファイルをインポートしたら、リコンシリエーションのスケジュール済タスクのIsTrusted属性の値をTrueに設定する必要があります。この手順は、「リコンシリエーションのスケジュール済タスクの構成」の項で説明されています。

リコンシリエーションのスケジュール済タスクの構成

「手順4: コネクタのXMLファイルのインポート」で説明する手順を実行すると、参照フィールドおよびユーザー・リコンシリエーションに対するスケジュール済タスクが、Oracle Identity Managerで自動的に作成されます。このスケジュール済タスクを構成するには、次のようにします。

1. Oracle Identity Manager Design Consoleを開きます。

2. 「Xellerate Administration」フォルダを開きます。

3. 「Task Scheduler」を選択します。

4. 「Find」をクリックします。事前定義されたスケジュール済タスクの詳細が2つのタブに表示されます。

5. 最初のスケジュール済タスクについて、「Max Retries」フィールドに数値を入力します。この数はOracle Identity Managerがタスクを完了するために試行する回数です。この数を超えると、ERRORステータスがタスクに割り当てられます。

6. 「Disabled」チェック・ボックスと「Stop Execution」チェック・ボックスが選択されていないことを確認します。

7. 「Start」リージョンで「Start Time」フィールドをダブルクリックします。表示される日付時間エディタで、タスクを実行する日付と時間を選択します。

8. 「Interval」リージョンで、次のスケジュール・パラメータを設定します。

   • タスクを繰り返し実行するように設定するには、「Daily」、「Weekly」、「Recurring Intervals」、「Monthly」または「Yearly」のオプションを選択します。

     「Recurring Intervals」オプションを選択した場合は、タスクを繰り返して実行する間隔も指定する必要があります。

   • タスクを1回のみ実行するように設定するには、「Once」オプションを選択します。

9. スケジュール済タスクの属性の値を指定します。指定する値の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。

   
   

   関連資料: タスク属性の追加および削除の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

   
   

10. 「Save」をクリックします。スケジュール済タスクが作成されます。INACTIVEステータスが「Status」フィールドに表示されますが、これは、タスクが現在実行されていないためです。タスクは手順7で設定した日時に実行されます。

11. ステップ5〜10を繰り返してもう1つのスケジュール済タスクを作成します。

両方のスケジュール済タスクを作成したら、「プロビジョニングの構成」の項に進みます。

スケジュール済タスク属性の値の指定

この項では、次のスケジュール済タスクに指定する属性値について説明します。

• 参照フィールド・リコンシリエーションのスケジュール済タスク

• ユーザー・リコンシリエーションのスケジュール済タスク

参照フィールド・リコンシリエーションのスケジュール済タスク

Siebel LookupRecon参照フィールド・リコンシリエーション・スケジュール済タスクの次の属性に値を指定する必要があります。

注意: 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。 すべての属性に値（デフォルトまたはデフォルト以外）を割り当てる必要があります。属性値を1つでも空白のままにした場合、リコンシリエーションは実行されません。

属性	説明	デフォルト/サンプル値
ITResource	ITリソースの名前。	SIEBEL IT Resource

スケジュール済タスク属性に値を指定したら、手順のステップ10に進んでスケジュール済タスクを作成します。

ユーザー・リコンシリエーションのスケジュール済タスク

Siebel EmployeeReconユーザー・リコンシリエーション・スケジュール済タスクの次の属性に値を指定する必要があります。

注意: 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。 すべての属性に値（デフォルトまたはデフォルト以外）を割り当てる必要があります。属性値を1つでも空白のままにした場合、リコンシリエーションは実行されません。

属性	説明	デフォルト/サンプル値
Organization	Oracle Identity Managerユーザー。	OIM Users
Xellerate Type	Oracle Identity Managerユーザーのタイプ。	End user Administrator
Role	デフォルトの従業員タイプ。	Consultant
ITResource	ITリソースの名前。	SIEBEL IT Resource
ResourceObject	リソース・オブジェクトの名前。	SIEBEL Resource Object
IsTrusted	信頼できるソース・リコンシリエーションを実行するかどうかを指定します。 信頼できるソース・リコンシリエーションの場合は、このパラメータをTrueに設定します。ターゲット・リソース・リコンシリエーションの場合は、Falseに設定します。	False（信頼できないリコンシリエーション） True（信頼できるリコンシリエーション）
isDeleteRecon	ユーザーの削除リコンシリエーションを実行するかどうかを指定します。 このパラメータをTrueに設定すると、ターゲット・システムから削除されたユーザーはOracle Identity Managerから削除されます。このパラメータをFalseに設定すると、ターゲット・システムから削除されたユーザーはOracle Identity Managerから削除されません。 注意: Siebel Enterprise Applicationsでは削除されたユーザーのレコードを保持しないため、このパラメータは最適化の目的でのみ指定します。	TrueまたはFalse
UserType	リコンサイルするユーザー・タイプを指定します。 Siebelのユーザー・タイプは次のとおりです。 Employee: このユーザーは従業員です。つまり、社内の部門に所属して担当を持つユーザーです。 Partner User: このユーザーはパートナ企業（外部組織）の従業員です。その企業の部門に所属して担当を持っています。つまり、Partner UserもEmployeeですが、内部のEmployeeではありません。 Customer: このユーザーは、社内に担当を持たない自己登録パートナです。ただし、このユーザーには、自らがアクセスできるアプリケーション・ビューを定義する職責があります。 ユーザー・タイプに基づくリコンシリエーションのテストの詳細は、「ユーザー・タイプに基づくリコンシリエーションのテスト」を参照してください。	Employee

スケジュール済タスク属性に値を指定したら、手順のステップ10に進んでスケジュール済タスクを作成します。

プロビジョニングの構成

このガイドで前述したように、プロビジョニングとは、Oracle Identity Managerを介して、ターゲット・システム上でユーザー・アカウント情報を作成または変更することです。

注意: このターゲット・システムに対してOracle Identity Managerのプロビジョニング機能を使用する場合は、この項の手順を実行する必要があります。

アダプタは、プロビジョニング機能を実装するために使用されます。コネクタのXMLファイルをインポートすると次のアダプタがOracle Identity Managerにインポートされます。

関連項目: このコネクタで使用できるプロビジョニング機能のリストについては、「サポートされている機能」を参照してください。

• PrePopulate SIEBEL Form

• Siebel Delete User

• Siebel Modify User

• Siebel Add Position

• Siebel Create User

• Siebel Remove Position

• Siebel Add Responsibility

• Siebel Remove Responsibility

• Siebel Add Primary Position

これらのアダプタは、プロビジョニング操作で使用する前にコンパイルする必要があります。

「アダプタ・マネージャ」フォームを使用してアダプタをコンパイルするには、次のようにします。

1. 「アダプタ・マネージャ」フォームを開きます。

2. 現在のデータベースにインポートしたすべてのアダプタをコンパイルするには、「すべてをコンパイル」を選択します。

   （すべてではないが）複数のアダプタをコンパイルするには、コンパイルするアダプタを選択します。次に、「選択したものをコンパイル」を選択します。

   
   

   注意: 正常にコンパイルされなかったアダプタのみを再コンパイルするには、「以前の失敗分をコンパイル」をクリックします。そのようなアダプタはコンパイルのステータスがOKになっていません。

   
   

3. 「開始」をクリックします。選択したアダプタがOracle Identity Managerによってコンパイルされます。

4. Oracle Identity Managerがクラスタ環境にインストールされている場合は、OIM_home/xellerate/Adapterディレクトリから、コンパイル済のアダプタをクラスタの他の各ノードの同じディレクトリにコピーします。必要な場合には、その他のノードのアダプタ・ファイルを上書きします。

一度に1つのアダプタをコンパイルする場合は、「アダプタ・ファクトリ」フォームを使用します。

関連資料: 「アダプタ・ファクトリ」フォームおよび「アダプタ・マネージャ」フォームの使用方法の詳細は、『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。

アダプタの詳細情報を表示するには、次のようにします。

1. 「アダプタ・マネージャ」フォームでアダプタをハイライト表示します。

2. アダプタの行ヘッダーをダブルクリックするか、アダプタを右クリックします。

3. 表示されるショートカット・メニューで「アダプタの起動」を選択します。アダプタの詳細が表示されます。

ターゲット・システムの複数のインストールに対するコネクタの構成

注意: この手順は、Siebel Enterprise Applicationsの複数のインストールに対してコネクタを構成する場合にのみ実行します。

状況によっては、コネクタをSiebel Enterprise Applicationsの複数のインストールに対して構成する必要が生じることもあるでしょう。次の例はそのような状況について説明したものです。

Acme Multinational Inc.では、東京、ロンドンおよびニューヨークの事業所で、それぞれ独自にSiebel Enterprise Applicationsがインストールされています。この会社は最近Oracle Identity Managerをインストールしたため、それを構成して、インストールされたすべてのSiebel Enterprise Applicationsをリンクさせようとしています。

これを実現するには、コネクタをSiebel Enterprise Applicationsの複数のインストールに対して構成する必要があります。

コネクタをターゲット・システムの複数のインストールに対して構成するには、次のようにします。

関連資料: この手順の各ステップ実行の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

1. ターゲット・システム・インストールごとに1つずつリソース・オブジェクトを作成して構成します。

   「Resource Objects」フォームは、「Resource Management」フォルダ内にあります。コネクタのXMLファイルをインポートすると、SIEBEL Resource Objectリソース・オブジェクトが作成されます。このリソース・オブジェクトは、残りのリソース・オブジェクトを作成するためのテンプレートとして使用できます。

2. リソース・オブジェクトごとに1つずつITリソースを作成して構成します。

   「IT Resources」フォームは「Resource Management」フォルダにあります。コネクタのXMLファイルをインポートすると、SIEBEL IT Resource ITリソースが作成されます。このITリソースは、同じリソース・タイプの、残りのITリソース作成用のテンプレートとして使用できます。

3. リソース・オブジェクトごとに1つずつプロセス・フォームを設計します。

   「Form Designer」フォームは、「Development Tools」フォルダ内にあります。コネクタのXMLファイルをインポートすると、次のプロセス・フォームが作成されます。

   • UD_SIEBEL（メイン・フォーム）

   • UD_SIEBEL_P（多値属性用の子フォーム）

   • UD_SIEBEL_R（多値属性用の子フォーム）

   これらのプロセス・フォームは、残りのプロセス・フォームを作成するためのテンプレートとして使用できます。

4. リソース・オブジェクトごとに1つずつプロセス定義を作成して構成します。

   「Process Definition」フォームは、「Process Management」フォルダ内にあります。コネクタのXMLファイルをインポートすると、Siebel Processプロセス定義が作成されます。このプロセス定義は、残りのプロセス定義を作成するためのテンプレートとして使用できます。

   ターゲット・システム・インストールごとにプロセス定義を作成するとき、実行する必要のある次の手順は、それぞれのプロセス定義の作成に関連しています。

   • 「Object Name」参照フィールドから、手順1で作成したリソース・オブジェクトを選択します。

   • 「Table Name」参照フィールドから、手順3で作成したプロセス・フォームを選択します。

   • 「IT Resource」データ型のアダプタ変数をマッピングするときは必ず、手順2で作成したITリソースを「Qualifier」リストから選択してください。

5. 各ターゲット・システム・インストールについてリコンシリエーションを構成します。手順は、「リコンシリエーションの構成」を参照してください。リコンシリエーションのスケジュール済タスクごとに、次の属性の値のみを変更する必要がありますので注意してください。

   • ITResource

   • ResourceObject

   • IsTrusted

   信頼できるソースとして指定するSiebel Enterprise ApplicationsインストールのIsTrusted属性をTrueに設定します。

6. 必要であれば、Xellerate Userリソース・オブジェクトに対してリコンサイルされるフィールドを変更します。

管理およびユーザー・コンソールを使用してプロビジョニングを実行する際には、特定のSiebel Enterprise Applicationsインストールに対応するITリソースを指定することによって、ユーザーのプロビジョニング先を選択することもできます。

従業員アカウントのアクティブ化と非アクティブ化

注意: この項は、デプロイ手順には含まれません。

Siebel Enterprise Applicationsの従業員アカウントをアクティブにするには、Oracle Identity Managerから職責を割り当てます。

Siebel Enterprise Applicationsの従業員アカウントを非アクティブにするには、Oracle Identity Managerからその従業員のすべての職責を削除します。