コネクタの使用

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

コネクタを構成して、リコンシリエーションのタイプおよびそのスケジュールを指定できます。

この項では、リコンシリエーションの構成に関する次の項目について説明します。

5.1.1 完全リコンシリエーションおよび増分リコンシリエーションの実行

完全リコンシリエーションでは、既存のすべてのユーザー・レコードをターゲット・システムからOracle Identity Governanceへリコンサイルします。アプリケーションを作成した後はまず、完全リコンシリエーションを実行する必要があります。

完全リコンシリエーションを実行するには、Latest TokenとFilter Suffixの各パラメータに現在割り当てられている値を削除し、「リコンシリエーション・ジョブ」の項にリストされているリコンシリエーション・ジョブの1つを実行します。

MS Teamsコネクタでは、増分リコンシリエーションのオプションはデフォルトでは有効になっていません。コネクタでは、ターゲット・システムにオブジェクトの作成または変更のタイムスタンプが格納される属性が含まれている場合にのみ、増分リコンシリエーションをサポートします。

5.1.2 制限付きリコンシリエーションの実行

制限付きつまりフィルタ済リコンシリエーションは、設定されたフィルタ基準に基づいてリコンサイルすることによりレコードの数を制限するプロセスです。

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

リコンシリエーション・モジュールのフィルタを作成して、制限付きリコンシリエーションを実行できます。APIバージョン1.6で有効なFilter Suffixの値の例を次に示します。

Filter Suffix値: &$filter=startswith(displayName,'john.doe')

このコネクタのFilter Suffix属性(スケジュール済タスクの属性)により、ターゲット・システムの任意の属性を使用してターゲット・システム・レコードをフィルタ処理できます。ユーザー・リコンシリエーション・スケジュール済ジョブの構成中に、Filter Suffix属性に値を指定します。

ノート:

Filter Suffix属性の値は、使用するMicrosoft Graph APIでサポートされる形式で指定します。たとえば:

サンプルのFilter Suffix %20and%20startswith(displayName,'user1')
サンプルのFilter Suffix &$filter=startswith(displayName,'user1')

5.2 リコンシリエーション・ジョブの構成

ターゲット・システムで定期的に新しい情報をチェックしてOracle Identity Governanceにそのデータを複製するリコンシリエーションを実行するリコンシリエーション・ジョブを構成します。

この手順は、ユーザーと権限のためのリコンシリエーション・ジョブを構成する場合に適用できます。

リコンシリエーション・ジョブを構成するには、次のようにします。

アイデンティティ・システム管理にログインします。
左ペインの「システム管理」で、「スケジューラ」をクリックします
次のようにして、スケジュール済ジョブを検索して開きます。
1. 「検索」フィールドに、検索基準としてスケジュール済ジョブの名前を入力します。「拡張検索」をクリックして検索基準を指定することもできます。
2. 左ペインの検索結果表で、「ジョブ名」列のスケジュール済ジョブをクリックします。
「ジョブの詳細」タブで、スケジュール済タスクのパラメータを変更できます。
- 再試行: このフィールドには整数値を入力します。この数値は、ジョブに「停止済」ステータスを割り当てるまでに、スケジューラがジョブの開始を試行する回数を表します。
- スケジュール・タイプ: ジョブを実行する頻度に応じて、適切なスケジュール・タイプを選択します。『Oracle Fusion Middleware Oracle Identity Governanceの管理』のジョブの作成に関する項を参照してください。
ジョブ詳細を変更する他に、ジョブを有効化または無効化できます。
「ジョブの詳細」タブの「パラメータ」領域で、スケジュール済タスクの属性の値を指定します。

ノート:

すべての属性に値(デフォルトまたはデフォルト以外)を割り当てる必要があります。属性値を1つでも空白のままにした場合、リコンシリエーションは実行されません。
「適用」をクリックして変更を保存します。

ノート:

Identity System Administrationのスケジューラのステータス・ページを使用して、スケジューラを起動、停止または再初期化できます。

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

Azure ADコネクタのプロビジョニング操作を構成できます。

この項では、次のトピックについて説明します。

5.3.1 プロビジョニング操作の実行に関するガイドライン

ここでは、プロビジョニング操作を実行する際に適用する必要があるガイドラインについて説明します。

ユーザーの作成プロビジョニング操作の場合、「ユーザー・プリンシパル名」フィールドの値をドメイン名とともに指定する必要があります。たとえばjdoe@example.comのように指定し、これは必須フィールドです。このほかにも、「表示名」、「パスワード」、メール・ニックネームおよび使用場所が必須フィールドです。
グループのプロビジョニング操作では、「表示名」およびメール・ニックネーム・フィールドの値を入力する必要があります。メール・ニックネーム・フィールドの値にスペースを含めることはできません。

5.3.2 プロビジョニング操作の実行

「ユーザーの作成」ページを使用して、Identity Self Serviceに新規ユーザーを作成します。アカウントのプロビジョニングやリクエストは「ユーザーの詳細」ページの「アカウント」タブで実行します。

Oracle Identity Governanceでプロビジョニング操作を実行するには、次のようにします。

Identity Self Serviceにログインします。
次のようにユーザーを作成します。
1. Identity Self Serviceで、「管理」をクリックします。「ホーム」タブには、異なる「管理」オプションが表示されます。「ユーザー」をクリックします。「ユーザーの管理」ページが表示されます。
2. 「アクション」メニューから「作成」を選択します。または、ツールバーにある「作成」をクリックします。「ユーザーの作成」ページが表示され、ユーザー・プロファイル属性の入力フィールドが表示されます。
3. 「ユーザーの作成」ページに、ユーザーの詳細を入力します。
「アカウント」タブで、「アカウントのリクエスト」をクリックします
「カタログ」ページで、以前に構成したコネクタのアプリケーション・インスタンスを検索してカートに追加した後、「チェックアウト」をクリックします。
アプリケーション・フォームの各フィールドの値を指定し、「送信準備ができています」をクリックします
「送信」をクリックします。

5.4 グループ管理に使用されるコネクタ・オブジェクト

グループ管理操作(作成や削除など)を実行するためにコネクタによって使用されるオブジェクトについて学習します。

5.4.1 グループの管理のための参照定義

グループの参照定義は、コネクタを使用してアプリケーションを作成した後、Oracle Identity Governanceに自動的に作成されます。

Lookup.MSTeams.GM.Configuration
Lookup.MSTeams.GM.ProvAttrMap
Lookup.MSTeams.GM.ReconAttrMap

Lookup.MSTeams.GM.Configuration

Lookup.MSTeams.GM.Configuration参照定義には、グループ・オブジェクト・タイプに固有の構成エントリが含まれています。この参照定義は、ターゲット・システムがターゲット・リソースとして構成されているときに、グループ管理操作で使用されます。

表5-1 Lookup.MSTeams.GM.Configuration参照定義のエントリ

コード・キー	デコード	説明
プロビジョニング属性マップ	Lookup.MSTeams.GM.ProvAttrMap	このエントリは、Oracle Identity Governanceとターゲット・システムの間の属性マッピングを保存する参照定義の名前を保持します。この参照定義は、プロビジョニング操作の際に使用されます。
リコンシリエーション属性マップ	Lookup.MSTeams.GM.ReconAttrMap	このエントリは、Oracle Identity Governanceとターゲット・システムの間の属性マッピングを保存する参照定義の名前を保持します。この参照定義は、リコンシリエーションの際に使用されます。

Lookup.MSTeams.GM.ProvAttrMap

Lookup.MSTeams.GM.ProvAttrMap参照定義には、プロセス・フォーム・フィールド(コード・キー値)とターゲット・システム属性(デコード)間のマッピングが含まれています。この参照定義は事前に構成されており、グループ・プロビジョニング操作の際に使用されます。

表5-2 Lookup.MSTeams.GM.ProvAttrMap参照定義のエントリ

Oracle Identity Governanceのグループ・フィールド	MSTeamsフィールド
表示名	__NAME__
ObjectId	__UID__
説明	説明
所有者[LOOKUP]	所有者
テンプレート[LOOKUP]	テンプレート

Lookup.MSTeams.GM.ReconAttrMap

Lookup.MSTeams.GM.ReconAttrMap参照定義には、リソース・オブジェクト・フィールド(コード・キー値)とターゲット・システム属性(デコード)間のマッピングが含まれています。この参照定義は事前に構成されており、ターゲット・リソースのグループ・リコンシリエーションの実行時に使用されます。

表5-3 Lookup.MSTeams.GM.ReconAttrMap参照定義のエントリ

Oracle Identity Governanceのグループ・フィールド	MSTeamsフィールド
OIM Org Name	OIM組織名ノート: これはコネクタ属性です。この属性の値は、Oracle Identity Governanceのグループの組織を指定するために、コネクタによって内部的に使用されます。
表示名	__NAME__
ObjectId	__UID__
説明	説明
所有者[LOOKUP]	所有者

5.4.2 グループ管理のためのリコンシリエーション・ルールとアクション・ルール

リコンシリエーション・エンジンがリコンシリエーション・ルールを使用して、ターゲット・システムで新たに検出されたアカウントにOracle Identity Governanceが割り当てる必要があるアイデンティティを判別します。リコンシリエーション・アクション・ルールでは、コネクタが定義されたリコンシリエーション・ルールに基づいて実行する必要があるアクションが定義されます。

5.4.2.1 グループのリコンシリエーション・ルール

グループのプロセス一致ルールを次に示します。

ルール名: MSTeams Group Recon Rule

ルール要素: Organization Name Equals OIM Org Name

このルール要素の意味は次のとおりです。

Organization Nameは、OIMユーザー・フォームの「組織名」フィールドです。
OIM Org Nameは、Oracle Identity Governanceのグループの組織名です。OIM Org Nameは、MSTeamsグループ・リコンシリエーション・スケジュール済ジョブの「組織名」属性で指定された値です。

表5-4に、グループのリコンシリエーションのアクション・ルールを示します。

表5-4 グループ・リコンシリエーションのアクション・ルール

ルール条件	アクション
一致が見つからなかった場合	なし
1つのエンティティ一致が見つかった場合	リンクの確立
1つのプロセス一致が見つかった場合	リンクの確立

5.4.2.2 グループのリコンシリエーション・アクション・ルール

表5-5に、グループのリコンシリエーションのアクション・ルールを示します。

表5-5 グループ・リコンシリエーションのアクション・ルール

ルール条件	アクション
一致が見つからなかった場合	なし
1つのエンティティ一致が見つかった場合	リンクの確立
1つのプロセス一致が見つかった場合	リンクの確立

5.4.2.3 リコンシリエーション・ルールの表示

コネクタを使用してアプリケーション作成した後、次のステップを実行して、リコンシリエーション・ルールを表示できます。

Oracle Identity Governance Design Consoleにログインします。
「開発ツール」を開きます。
「リコンシリエーション・ルール」をダブルクリックします。
MSTeams Group Recon Ruleルールを検索します。

「グループのリコンシリエーション・ルール」に、グループのリコンシリエーション・ルールを示します。

図5-1 グループのリコンシリエーション・ルール

5.4.2.4 リコンシリエーション・アクション・ルールの表示

コネクタを使用してアプリケーション作成した後、次のステップを実行して、グループのリコンシリエーション・アクション・ルールを表示できます。

Design Consoleにログインします。
「Resource Management」を展開し、「Resource Objects」をダブルクリックします。
MSTeamsグループ・リソース・オブジェクトを検索し、開きます。
「Object Reconciliation」タブ、「Reconciliation Action Rules」タブの順にクリックします。「リコンシリエーション・アクション・ルール」タブに、コネクタに定義されているアクション・ルールが表示されます。
「グループのリコンシリエーション・アクション・ルール」に、グループのリコンシリエーション・アクション・ルールを示します。

図5-2 グループのリコンシリエーション・アクション・ルール

5.4.3 グループ管理のためのリコンシリエーション・スケジュール済ジョブ

アプリケーションを作成した後、Oracle Identity Governanceにリコンシリエーション・スケジュール済ジョブが自動的に作成されます。これらのスケジュール済ジョブを、その属性の値を指定して必要に合うように構成する必要があります。

MSTeamsグループ・リコンシリエーションの属性に値を指定する必要があります。表5-6では、MSTeamsグループ・リコンシリエーション・ジョブの属性について説明します。

表5-6 MS Teamsグループ・リコンシリエーション・ジョブの属性

属性	説明
Filter Suffix	リコンシリエーションの実行時にターゲット・システムからフェッチされるユーザー・レコードの検索フィルタを入力します。この属性の詳細は、「制限付きリコンシリエーションの実行」を参照してください。
Object Type	この属性は、リコンシリエーションの実行用のオブジェクト・タイプの名前を保持します。デフォルト値: `Group` ノート: デフォルト値は変更しないでください。
Incremental Recon Attribute	トークン・レコードが変更されたタイムスタンプを保持する属性。
OIM組織名	リコンサイルするグループを作成または更新するOracle Identity Governance組織の名前を指定します。
ITリソース名	ユーザー・レコードのリコンサイル元のターゲット・システム・インストールに対するITリソースの名前を入力します。デフォルト値: `MSTeamsGroup`
リソース・オブジェクト名	この属性は、リコンシリエーションに使用されるリソース・オブジェクトの名前を保持します。デフォルト値:`MSTeamsGroup` ノート: デフォルト値は変更しないでください。
Scheduled Task Name	リコンシリエーションに使用されるスケジュール済タスクの名前。デフォルト値: `MSTeams Group Reconciliation` この属性の値は変更しないでください。

5.5 コネクタのアンインストール

Microsoft Teamsコネクタのアンインストールでは、そのリソース・オブジェクトに関連付けられているすべてのアカウント関連データを削除します。

なんらかの理由でコネクタをアンインストールする必要がある場合は、コネクタのアンインストール・ユーティリティを実行します。このユーティリティを実行する前に、ConnectorUninstall.propertiesファイルのObjectTypeとObjectValuesの各プロパティの値を設定したことを確認してください。たとえば、リソース・オブジェクト、スケジュール済タスクおよびコネクタに関連付けられたスケジュール済ジョブを削除する場合は、ObjectTypeプロパティの値としてResourceObject、ScheduleTask、ScheduleJobを入力し、ObjectValuesプロパティの値として、コネクタに対応するオブジェクト値のセミコロンで区切られたリストを入力します。

例: MSTeams User; MSTeams Group

ノート:

ConnectorNameとReleaseの各プロパティの値と同時にObjectTypeとObjectValueの各プロパティの値を設定すると、ObjectValuesにリストされたオブジェクトの削除はユーティリティによって実行され、コネクタ情報はスキップされます。

詳細は、『Oracle Fusion Middleware Oracle Identity Governanceの管理』のコネクタのアンインストールに関する項を参照してください。