3 コネクタの使用

コネクタを自分の要件にかなうように構成したら、コネクタを使用してリコンシリエーションおよびプロビジョニング操作を実行できます。

この章には次の項が含まれます:

• コネクタ使用のガイドライン

• 参照フィールド同期のスケジュール済タスク

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

• スケジュール済タスクの構成

• Oracle Identity Managerリリース11.1.1でのプロビジョニングの構成

• Oracle Identity Managerリリース11.1.2でのプロビジョニングの構成

• アクション・スクリプトの構成

3.1 コネクタ使用のガイドライン

リコンシリエーション操作とプロビジョニング操作のためにコネクタを使用する際に適用する必要があるガイドラインは、次のとおりです。

• リコンシリエーションの構成に関するガイドライン

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

3.1.1 リコンシリエーションの構成に関するガイドライン

リコンシエーションを構成する際には、次のガイドラインを適用してください。

• ターゲット・リソースのリコンシリエーションを実行する前に、参照定義がターゲット・システムの参照フィールドと同期している必要があります。つまり、ユーザー・リコンシリエーションの実行前に、参照フィールド同期のスケジュール済タスクを実行する必要があります。

  Oracle Identity Manager 11.1.2.x以降を使用している場合、権限リストおよびカタログ同期化ジョブ・スケジュール済ジョブも実行する必要があります。

• 削除されたユーザー・データのリコンシリエーションのスケジュール済タスクの前に、ユーザー・リコンシリエーションのスケジュール済タスクを実行する必要があります。

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

プロビジョニング操作を実行する際には、次のガイドラインを適用してください。

• プロビジョニング操作を実行する前に、すべての参照定義をリコンサイルする必要があります。

• Exchangeユーザーをプロビジョニングする前に、ADユーザーをプロビジョニングする必要があります。

• ユーザー・タイプにUserMailboxを選択する場合、プロセス・フォームの「データベース」フィールドは必須です。ユーザー・タイプにMailUserを選択する場合、プロセス・フォームの外部電子メール・アドレス・フィールドは必須です。

• フィールドでのマルチバイト値の指定。

  アジア言語の中には、マルチバイト文字セットを使用するものがあります。ターゲット・システムのフィールドの文字数の制限がバイト単位で指定されている場合、特定のフィールドに入力できるアジア言語の文字数は、同じフィールドに入力できる英語の文字数よりも少なくなることがあります。この例を次に示します。

  ターゲット・システムの「表示名」フィールドに英語50文字を入力できるとします。日本語用にターゲット・システムを構成した場合、そのフィールドに入力できるのは25文字までです。

• ターゲット・システム・フィールドの文字長を考慮に入れた上で、対応するOracle Identity Managerのフィールドの値を指定する必要があります。

  プロビジョニング操作の際に、Oracle Identity Managerのプロセス・フォームのフィールドに値を入力するときは、ターゲット・システムのフィールドの長さを考える必要があります。プロセス・フォームの一部のフィールドに指定されている文字制限が、ターゲット・システムの対応するフィールドの文字制限を超えることがあります。

3.2 参照フィールド同期のスケジュール済タスク

参照フィールド同期用のスケジュール済タスクでは、ターゲット・システムの特定のフィールドから最新の値がOracle Identity Managerの参照定義にフェッチされます。これらの参照定義はOracle Identity Managerの参照フィールドの入力ソースとして使用されます。

次に、参照フィールド同期のスケジュール済タスクを示します。

ノート:

これらのスケジュール済タスクの構成手順は、このマニュアルで後述します。

• Exchangeユーザー配布グループ参照のリコンシリエーション

  このスケジュール済タスクは、フォレストに存在するすべてのメール対応ユニバーサル配布グループをLookup.Exchange.DistributionGroups参照定義にフェッチします。

• Exchangeユーザー・メールボックス・データベース・グループ参照のリコンシリエーション

  このスケジュール済タスクは、Oracle Identity Managerのメールボックス・データベース参照フィールドと、ターゲット・システムのメールボックス・データベースを同期するのに使用されます。

表3-1に、この2つのスケジュール済タスクの属性の説明を示します。

表3-1 参照フィールド同期のスケジュール済タスクの属性

属性	説明
コード・キー属性	参照定義の「コード・キー」列に移入するのに使用される、コネクタまたはターゲット・システム属性の名前(「参照名」属性の値として指定)。 デフォルト値: __NAME__ ノート: この属性の値を変更しないでください。
デコード属性	参照定義の「デコード」列に移入するのに使用される、コネクタまたはターゲット・システム属性の名前(「参照名」属性の値として指定)。 デフォルト値: __NAME__ ノート: この属性の値を変更しないでください。
ITリソース名	レコードをリコンサイルする元のターゲット・システム・インストールのITリソースの名前。 デフォルト値: Exchange IT Resource
参照名	ターゲット・システムからフェッチされた値で移入される必要がある、Oracle Identity Managerの参照定義の名前。 使用中のスケジュール済タスクに応じて、デフォルト値は次のようになります。 Exchangeユーザー配布グループ参照のリコンシリエーションの場合: Lookup.Exchange.DistributionGroups Exchangeユーザー・メールボックス・データベース・グループ参照のリコンシリエーションの場合: Lookup.Exchange.MailboxDatabase
オブジェクト・タイプ	リコンサイルするオブジェクトのタイプの名前。 使用中のスケジュール済タスクに応じて、デフォルト値は次のようになります。 Exchangeユーザー配布グループ参照のリコンシリエーションの場合: __DISTRIBUTIONGROUP__ Exchangeユーザー・メールボックス・データベース・グループ参照のリコンシリエーションの場合: __MAILBOXDATABASE__
リソース・オブジェクト名	レコードをリコンサイルする元のターゲット・システム・インストールのリソース・オブジェクトの名前。 デフォルト値: Exchange User

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

コネクタ・インストーラを実行すると、ユーザー・リコンシリエーションのスケジュール済タスクがOracle Identity Managerに自動的に作成されます。リコンシリエーションの構成では、これらのスケジュール済タスクの属性の値を指定します。

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

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

• フィルタを使用する制限付きリコンシリエーション

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

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

完全リコンシリエーションでは、既存のすべてのユーザー・レコードをターゲット・システムからOracle Identity Managerへリコンサイルします。コネクタをデプロイしたら、最初に完全リコンシリエーションを実行する必要があります。さらに、すべてのターゲット・システム・レコードをOracle Identity Managerでリコンサイルする必要がある場合はいつでも、増分リコンシリエーションから完全リコンシリエーションへ切り替えることができます。

スケジュール済タスクのDomainControllerパラメータに値を指定することで、単一ドメインに対して完全および増分リコンシリエーションを実行できます。DomainControllerパラメータが空白だと、リコンシリエーションはフォレストに対して実行されます。

完全リコンシリエーションを実行するには、ユーザー・レコードのリコンシリエーションのスケジュール済タスクの次の属性に対し、値を指定しません。

• フィルタ

• 増分リコンシリエーション属性

• 最新のトークン

3.3.2 フィルタを使用する制限付きリコンシリエーション

リコンシリエーション・モジュールのフィルタを作成して、制限付きリコンシリエーションを実行できます。このコネクタのFilter属性(スケジュール済タスクの属性)により、Exchangeリソース属性を使用してターゲット・システム・レコードをフィルタ処理できます。

表3-2に、使用可能なフィルタ構文と、対応する説明およびサンプル値を示します。

ノート:

ワイルドカード文字を含むフィルタはサポートされていません。

表3-2 Filter属性のキーワードと構文

フィルタ構文	説明
文字列フィルタ
startsWith('ATTRIBUTE_NAME','PREFIX')	指定した接頭辞で属性値が開始するレコードがリコンサイルされます。 例: startsWith('DisplayName','John') この例では、表示名が「John」で開始するすべてのレコードがリコンサイルされます。
endsWith('ATTRIBUTE_NAME','SUFFIX')	指定した接尾辞で属性値が終了するレコードがリコンサイルされます。 例: endsWith('DisplayName','Doe') この例では、表示名が「Doe」で終わるすべてのレコードがリコンサイルされます。
contains('ATTRIBUTE_NAME','STRING')	指定した文字列が属性値に含まれるレコードがリコンサイルされます。 例: contains('DisplayName','Smith') この例では、表示名にSmithが含まれるすべてのレコードがリコンサイルされます。
等価および不等価フィルタ
equalTo('ATTRIBUTE_NAME','VALUE')	この構文に指定した値と属性値が等しいレコードがリコンサイルされます。 例: equalTo('DisplayName','Sales Organization') この例では、表示名がSales Organizationであるすべてのレコードがリコンサイルされます。
greaterThan('ATTRIBUTE_NAME','VALUE')	この構文に指定した値よりも属性値(文字列または数値)が(辞書順または数値順で)大きいレコードがリコンサイルされます。 例: greaterThan('DisplayName','bob') この例では、表示名が、「bob」という共通名よりも辞書順(すなわちアルファベット順)で後になるすべてのレコードがリコンサイルされます。
greaterThanOrEqualTo('ATTRIBUTE_NAME','VALUE')	この構文に指定した値に対して、属性値(文字列または数値)が辞書順または数値順で等しいか大きいレコードがリコンサイルされます。 例: greaterThanOrEqualTo('DisplayName','S') この例では、表示名が辞書順で「S」と等しいまたは「S」以降であるすべてのレコードがリコンサイルされます。
lessThan('ATTRIBUTE_NAME','VALUE')	この構文に指定した値よりも属性値(文字列または数値)が(辞書順または数値順で)小さいレコードがリコンサイルされます。 例: lessThan('DisplayName','Smith') この例では、表示名が、「Smith」という姓よりも辞書順(すなわちアルファベット順)で後になるすべてのレコードがリコンサイルされます。
lessThanOrEqualTo('ATTRIBUTE_NAME','VALUE')	この構文に指定した値に対して、属性値(文字列または数値)が辞書順または数値順で等しいか小さいレコードがリコンサイルされます。 例: lessThanOrEqualTo('DisplayName','A') この例では、表示名が辞書順で「A」と等しいまたは「A」よりも若いすべてのレコードがリコンサイルされます。
複雑なフィルタ
<FILTER1> & <FILTER2>	filter1とfilter2両方の条件を満たすレコードがリコンサイルされます。この構文では、論理演算子& (アンパサンド記号)を使用して両方のフィルタを結合します。 例: startsWith('DisplayName', 'John') & endsWith('DisplayName', 'Doe') この例では、表示名がJohnで開始しDoeで終了するすべてのレコードがリコンサイルされます。
<FILTER1> | <FILTER2>	filter1とfilter2の条件のいずれかを満たすレコードがリコンサイルされます。この構文では、論理演算子| (縦棒)を使用して両方のフィルタを結合します。 例: contains('DisplayName', 'Andy') | contains('DisplayName', 'Brown') この例では、表示名属性に「Andy」を含むレコードまたは表示名に「Brown」を含むレコードがすべてリコンサイルされます。
not(<FILTER>)	指定のフィルタ条件を満たさないレコードがリコンサイルされます。 例: not(contains('DisplayName', 'Mark')) この例では、表示名「Mark」を含まないすべてのレコードがリコンサイルされます。

フィルタでサポートされる属性は次のとおりです。

• ArchiveQuota

• ProhibitSendQuota

• ArchiveWarningQuota

• Database

• IssueWarningQuota

• ProhibitSendQuota

• ProhibitSendReceiveQuota

• UseDatabaseQuotaDefaults

• ExternalEmailAddress

• DisplayName

• SimpleDisplayName

• EmailAddressPolicyEnabled

• HiddenFromAddressListsEnabled

• MaxSendSize

• MaxReceiveSize

• Name

• 別名

• PrimarySmtpAddress

• RecipientLimits

• RecipientType

• WhenChanged

• CustomAttribute1、CustomAttribute2など、最大CustomAttribute15まで

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

コネクタ・インストーラを実行すると、Oracle Identity Managerにリコンシリエーションのスケジュール済タスクが自動的に作成されます。

Microsoft Exchangeコネクタには、リコンシリエーション用に次のスケジュール済タスクが用意されています。

関連項目:

Exchangeユーザー配布グループ参照のリコンシリエーションおよびExchangeユーザー・メールボックス・データベース・グループ参照のリコンシリエーション・スケジュール済タスクの詳細は、「参照フィールド同期のスケジュール済タスク」を参照してください

• Exchangeターゲット・リソースのユーザー・リコンシリエーション

• Exchangeターゲット・リソースの削除ユーザー・リコンシリエーション

• Exchange休暇更新タスク

3.3.3.1 Exchangeターゲット・リソースのユーザー・リコンシリエーション

Exchangeターゲット・リソースのユーザー・リコンシリエーション・スケジュール済タスクを使用して、アクティブなメールボックスおよびメール・ユーザーからのデータをリコンサイルします。表3-3に、このスケジュール済タスクの属性をリストします。

表3-3 Exchangeターゲット・リソースのユーザー・リコンシリエーション・スケジュール済タスクの属性

属性	説明
Database	データベースの識別名を指定します。 ノート: データベースの識別名は、Lookup.Exchange.MailboxDatabase参照定義で使用可能です。
ドメイン・コントローラ	この属性は、特定のドメインからリコンサイルするかどうかを示します。ドメイン・コントローラを指定しないと、リコンシリエーションの実行により、フォレスト内のすべてのドメインからユーザーがフェッチされます。 デフォルトで、この値は空白です。
フィルタ	スケジュール済タスクでリコンサイルされる必要のあるレコードをフィルタするための式。構文は表3-2を参照してください。 デフォルト値: None たとえば、equalTo('DisplayName','john')フィルタを設定すると、DisplayName = johnのレコードのみがリコンサイルされます。
増分リコンシリエーション属性	ターゲット・システム属性の名前。最終更新関連番号(非減少値)が保持されます。たとえば、numericまたはstringsです。 この属性の値は増分リコンシリエーション中に使用され、ターゲット・システムからリコンサイルされた最も新しいレコードを判別します。 デフォルト値: LastModified ノート: この属性の値を変更しないでください。
ITリソース名	コネクタがデータのリコンサイルに使用する必要のあるITリソース・インスタンスの名前。 デフォルト値: Exchange IT Resource
最新のトークン	前回のリコンシリエーションの実行が開始したときのタイムスタンプ。 ノート: この属性に値を入力しないでください。リコンシリエーション・エンジンにより、値はこの属性に自動的に入力されます。
オブジェクト・タイプ	リコンサイルするオブジェクトのタイプ。 デフォルト値: User
OrganizationalUnit	メールボックスをリコンサイルする組織単位の識別名を指定してください。
リソース・オブジェクト名	リコンシリエーションを実行する必要のあるリソース・オブジェクトの名前。 デフォルト値: Exchange User ノート: このコネクタと同梱されているリソース・オブジェクトの場合、この属性の値を変更しないでください。ただし、リソース・オブジェクトのコピーを作成した場合は、この属性の値として、そのリソース・オブジェクトに一意の名前を入力できます。
スケジュール済タスク名	スケジュール済タスクの名前。 デフォルト値: Exchange Target Resource User Reconciliation ノート: このコネクタに同梱されているスケジュール済タスクについては、この属性の値を変更しないでください。ただし、このタスクのコピーを作成した場合は、そのスケジュール済タスクの一意の名前をこの属性の値として入力できます。

ターゲット・システムに多数のメールボックスがある場合、コネクタのパフォーマンスを向上させるために次のパラメータに値を指定することをお薦めします。

• Database

• ドメイン・コントローラ

• OrganizationalUnit

ノート:

ExchangeユーザーがOracle Identity Managerで無効の場合、Exchangeは有効化/無効化の操作をサポートしないため、ターゲット・システムでメールボックスの最大受信サイズおよび最大送信サイズのパラメータがゼロに設定されます。同様に、リコンシリエーション中にターゲット・システムでExchangeユーザーのMaxSendSizeおよびMaxReceiveSizeパラメータがゼロに設定された場合、Oracle Identity Managerアカウントのステータスは無効に構成できます。

リコンシリエーションにこの動作を実現するには、次のようにします。

1. Design Consoleで、「管理」の下の「参照定義」をクリックします。

2. Lookup.Exchange.UM.ReconTransformationに次のエントリを追加します。

   コード・キー: Status

   デコード: oracle.iam.connectors.exchange.extension.StatusReconTransformer

3.3.3.2 Exchangeターゲット・リソースの削除ユーザー・リコンシリエーション

Exchangeターゲット・リソースの削除ユーザー・リコンシリエーション・スケジュール済タスクを使用して、削除されたなメールボックスおよびメール・ユーザーに関するデータをリコンサイルします。表3-4に、このスケジュール済タスクの属性をリストします。

表3-4 Exchangeターゲット・リソースの削除ユーザー・リコンシリエーション・スケジュール済タスクの属性

属性	説明
ITリソース名	コネクタがデータのリコンサイルに使用する必要のあるITリソース・インスタンスの名前。 デフォルト値: Exchange IT Resource
オブジェクト・タイプ	この属性は、リコンサイルするオブジェクトのタイプを保持します。 デフォルト値: User
リソース・オブジェクト名	リコンシリエーションを実行する必要のあるリソース・オブジェクトの名前。 デフォルト値: Exchange User ノート: このコネクタに同梱されているリソース・オブジェクトでは、この属性の値を変更しないでください。ただし、リソース・オブジェクトのコピーを作成した場合は、この属性の値として、そのリソース・オブジェクトに一意の名前を入力できます。

3.3.3.3 Exchange休暇更新タスク

Exchange休暇更新タスクは、ユーザー用のMicrosoft Exchange上のHiddenFromAddressListsEnabled属性を設定します。

このタスクを実行するには、リコンシリエーションを実行する必要のあるリソース・オブジェクトの名前を指定します。

このタスクは、「休暇開始日」および「休暇終了日」値がプロセス・フォームに指定されている場合にのみ実行されます。たとえば、日付が「休暇開始日」と「休暇終了日」の間であれば、このタスクは実行され、そのユーザー用のMicrosoft Exchange上のHiddenFromAddressListsEnabled属性が設定されます。それ以外の場合、このタスクは、そのユーザー用のHiddenFromAddressListsEnabled属性をリセットします。

3.4 スケジュール済タスクの構成

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

この手順は、参照フィールド同期およびリコンシリエーションのスケジュール済ジョブを構成する場合に適用できます。

スケジュール済タスクを構成するには、次のようにします。

1. 管理およびユーザー・コンソールにログインします。

2. 「Oracle Identity Manageセルフ・サービスへようこそ」ページで、ページの右上隅の「拡張」をクリックします。

3. 次のように、スケジュール済タスクを検索して開きます。

   1. 「Oracle Identity Manager拡張管理へようこそ」ページの「システム管理」領域で、「スケジュール済ジョブの検索」をクリックします。

   2. 左ペインの「検索」フィールドで、検索基準にスケジュール済タスクの名前を入力します。または、「拡張検索」をクリックして、検索条件を指定します。

   3. 左ペインの検索結果表で、「ジョブ名」列のスケジュール済タスクをクリックします。

4. スケジュール済タスクの詳細を変更します。これを行うには:

   1. 「ジョブの詳細」タブで、次のパラメータを変更できます。

      • 再試行: このフィールドには整数値を入力します。この数値は、タスクに「停止済」ステータスを割り当てるまでに、スケジューラがタスクの開始を試行する回数を表します。

      • スケジュール・タイプ: タスクを実行する頻度に応じて、適切なスケジュール・タイプを選択します。

      関連項目:

      スケジュール・タイプの詳細は、Oracle Fusion Middleware Oracle Identity Managerの管理のジョブの作成を参照してください。

      タスクの詳細の変更に加えて、タスクを有効または無効にすることができます。

5. スケジュール済タスクの属性の値を指定します。これを行うには:

   ノート:

   • 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。

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

   • スケジュール済タスクのFilter属性に構成された値に応じて、リコンシリエーションを部分モードまたはカスタム・モードで実行できます。

   • 「ジョブの詳細」タブの「パラメータ」領域で、スケジュール済タスクの属性の値を指定します。

6. 属性の指定後、「適用」をクリックして変更を保存します。

   ノート:

   使用しているOracle Identity Managerリリースに応じて、管理およびユーザー・コンソールまたはアイデンティティ・システム管理の「スケジューラのステータス」ページを使用して、スケジューラを開始、停止または再初期化できます。

3.5 Oracle Identity Managerリリース11.1.1でのプロビジョニングの構成

プロビジョニングとは、Oracle Identity Managerを介して、ターゲット・システム上でメールボックス・データを作成または変更することです。

この項では、次の項目について説明します。

• プロビジョニングでのコネクタの使用

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

• リクエストベースのプロビジョニングと直接プロビジョニングの切替え

3.5.1 プロビジョニングでのコネクタの使用

プロビジョニング操作でのコネクタの使用を開始する際には、次のガイドラインに従います。

ユーザーにMicrosoft Exchangeリソース・オブジェクトをプロビジョニングする前に、Microsoft Active Directoryにユーザーのアカウントがあることを確認します。Microsoft Active Directoryにユーザーのアカウントがない場合は、プロビジョニング操作が失敗します。

ユーザー用のMicrosoft Active Directoryアカウントを作成するために、Microsoft Active Directoryリソース・オブジェクトをOracle Identity Managerのユーザーにプロビジョニングできます。

ノート:

Microsoft Active Directoryのプロビジョニング中に、メールのリダイレクション機能を設定できます。メールのリダイレクションが設定されている場合は、Microsoft Exchangeのリソース・オブジェクトをプロビジョニングする必要はありません。

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

OIMユーザーへのリソースのプロビジョニングでは、Oracle Identity Managerを使用して、ユーザーのMicrosoft Exchangeアカウントが作成されます。

Oracle Identity Managerにコネクタをインストールするときに、直接プロビジョニング機能は自動的に有効になります。つまり、コネクタのインストール時にプロセス・フォームが有効になります。

リクエストベースのプロビジョニング用にコネクタを構成した場合、プロセス・フォームが抑制されてオブジェクト・フォームが表示されます。つまり、リクエストベースのプロビジョニング用にコネクタが構成されるときに、直接プロビジョニングが無効になります。直接プロビジョニングに戻るには、「リクエストベースのプロビジョニングと直接プロビジョニングの切替え」に記載されているステップを実行します。

次にプロビジョニング操作のタイプを示します。

• 直接プロビジョニング

• リクエストベースのプロビジョニング

• ポリシー変更でトリガーされるプロビジョニング

この項では、次の項目について説明します。

• 直接プロビジョニング

• リクエストベースのプロビジョニング

3.5.2.1 直接プロビジョニング

直接プロビジョニングの手法を使用してリソースをプロビジョニングするには、次の手順を実行します。

ノート:

Microsoft Exchangeリソースをプロビジョニングする前に、Microsoft Active Directoryリソースがプロビジョニングされていることを確認してください。

リソース・オブジェクトのチェック・ボックスが選択されている場合は、1人のOIMユーザーに対して複数のメールボックスをプロビジョニングできます。ただし、ターゲット・システムでサポートされるのは、各ユーザーに対して1つのメールボックスのみです。

1. 管理およびユーザー・コンソールにログインします。

2. 「アイデンティティ管理へようこそ」ページの「ユーザー」領域で、「ユーザーの作成」をクリックします。

3. 「ユーザーの作成」ページでOIMユーザーのフィールドに値を入力し、「保存」をクリックします。

4. Microsoft Exchangeメールボックスを既存のOIMユーザーにプロビジョニングする場合は、次のようにします。

   1. 「アイデンティティ管理へようこそ」ページで、左ペインのリストから「ユーザー」を選択することで、OIMユーザーを検索します。

   2. 検索結果に表示されたユーザーのリストから、OIMユーザーを選択します。右ペインに「ユーザーの詳細」ページが表示されます。

5. 「ユーザーの詳細」ページで、「リソース」タブをクリックします。

6. 「アクション」メニューから「リソースの追加」を選択します。または、プラス(+)記号の付いたリソースの追加アイコンをクリックします。「ユーザーへのリソースのプロビジョニング」ページが新しいウィンドウに表示されます。

7. 「ステップ1: リソースの選択」ページで、リストから「Exchange」を選択し、「続行」をクリックします。

8. 「ステップ2: リソースの選択の検証」ページで「続行」をクリックします。

9. 「ステップ5: プロセス・データの指定」ページで、ターゲット・システムに作成するメールボックスの詳細を入力し、「続行」をクリックします。

10. 「ステップ6: プロセス・データの検証」ページで、指定したデータを確認して「続行」をクリックします。

11. 「プロビジョニングは開始されています。」というメッセージを表示しているウィンドウを閉じます。

12. 「リソース」タブで「リフレッシュ」をクリックして、新しくプロビジョニングされたリソースを表示します。

3.5.2.2 リクエストベースのプロビジョニング

リクエストベースのプロビジョニング操作には、エンドユーザーと承認者の両方が関係します。通常、承認者はリクエスト発行者の上司です。次の項では、リクエストベースのプロビジョニング操作でエンドユーザーおよび承認者によって実行されるステップについて説明します。

ノート:

これらの項で説明している手順は、エンド・ユーザーがターゲット・システム・アカウントのプロビジョニングのリクエストを発生させるまたは作成する例で作成されています。このリクエストは次に承認者により承認されます。

• リクエストベースのプロビジョニングでのエンドユーザーの役割

• リクエストベースのプロビジョニングでの承認者の役割

3.5.2.2.1 リクエストベースのプロビジョニングでのエンドユーザーの役割

次のステップは、リクエストベースのプロビジョニング操作でエンドユーザーによって実行されます。

1. 管理およびユーザー・コンソールにログインします。
2. 「ようこそ」ページでページの右上の「拡張」をクリックします。
3. 「アイデンティティ管理へようこそ」ページで「管理」タブをクリックし、「リクエスト」タブをクリックします。
4. 左ペインの「アクション」メニューから「リクエストの作成」を選択します。

   「リクエスト・テンプレートの選択」ページが表示されます。

5. 「リクエスト・テンプレート」リストから「リソースのプロビジョニング」を選択して、「次」をクリックします。
6. 「ユーザーの選択」ページで、リソースをプロビジョニングするユーザーを検索するためのフィールドに検索基準を指定し、S「検索」をクリックします。指定した検索基準に一致するユーザーのリストが「使用可能なユーザー」リストに表示されます。
7. 「使用可能なユーザー」リストから、アカウントをプロビジョニングするユーザーを選択します。

   複数のユーザーに対するプロビジョニング・リクエストを作成する場合、「使用可能なユーザー」リストから、アカウントをプロビジョニングするユーザーを選択します。

8. 「移動」または「すべて移動」をクリックして、選択内容を「選択したユーザー」リストに移動し、「次」をクリックします。
9. 「リソースの選択」ページで「リソース名」フィールドの横にある矢印ボタンをクリックして、使用可能なすべてのリソースのリストを表示します。
10. 「利用可能なリソース」リストから「Exchange」を選択し、「選択したリソース」リストに移動して、「次」をクリックします。
11. 「リソースの詳細」ページで、ターゲット・システムに作成する必要があるアカウントの詳細を入力し、「次」をクリックします。
12. 「理由」ページで次のフィールドの値を指定し、「終了」をクリックします。

    • 有効日

    • 理由

    結果のページで、リクエストが正常に送信されたことを確認するメッセージが「リクエストID」とともに表示されます。

13. リクエストIDをクリックすると、「リクエストの詳細」ページが表示されます。
14. 承認の詳細を表示するには、「リソースの詳細」ページで「リクエスト履歴」タブをクリックします。

3.5.2.2.2 リクエストベースのプロビジョニングでの承認者の役割

次のステップは、リクエストベースのプロビジョニング操作で承認者によって実行されます。

1. 管理およびユーザー・コンソールにログインします。
2. 「ようこそ」ページの右上隅で、「セルフサービス」をクリックします。
3. 「Identity Managerセルフ・サービスへようこそ」ページで「タスク」タブをクリックします。
4. 「承認」タブの最初のセクションで、割り当てられているリクエスト・タスクの検索基準を指定できます。
5. 検索結果表から承認するリクエストを含む行を選択して、「タスクの承認」をクリックします。

   タスクが承認されたことを確認するメッセージが表示されます。

3.5.3 リクエストベースのプロビジョニングと直接プロビジョニングの切替え

リクエストベースのプロビジョニング用にコネクタを構成した場合は、いつでも直接プロビジョニングに切り替えることができます。同様に、いつでもリクエストベースのプロビジョニングに戻すことができます。

この項では、次の項目について説明します。

• リクエストベースのプロビジョニングから直接プロビジョニングへの切替え

• 直接プロビジョニングからリクエストベースのプロビジョニングへの切替え

3.5.3.1 リクエストベースのプロビジョニングから直接プロビジョニングへの切替

ノート:

「リクエストベースのプロビジョニング用のOracle Identity Managerの構成」に示す手順が実行されたことを想定しています。

リクエストベースのプロビジョニングからダイレクト・プロビジョニングに切り替えるには、次の手順を実行します。

1. Design Consoleにログインします。

2. 次のように、「自動保存フォーム」機能を無効にします。

   1. 「Process Management」を開いて「Process Definition」をダブルクリックします。

   2. Exchangeプロセス定義を検索して開きます。

   3. 「自動保存フォーム」チェック・ボックスを選択解除します。

   4. 「Save」アイコンをクリックします。

3. 「セルフ・リクエストを許可」機能が有効な場合、次のようにします。

   1. 「リソース管理」を開き、「リソース・オブジェクト」をダブルクリックします。

   2. 「Exchange」リソース・オブジェクトを検索して開きます。

   3. 「セルフ・リクエストを許可」チェック・ボックスを選択解除します。

   4. 「Save」アイコンをクリックします。

3.5.3.2 直接プロビジョニングからリクエストベースのプロビジョニングへの切替え

ダイレクト・プロビジョニングからリクエストベースのプロビジョニングに戻すには、次の手順を実行します。

1. Design Consoleにログインします。

2. 次のように、「自動保存フォーム」機能を有効にします。

   1. 「Process Management」を開いて「Process Definition」をダブルクリックします。

   2. Exchangeプロセス定義を検索して開きます。

   3. 「Auto Save Form」チェック・ボックスを選択します。

   4. 「Save」アイコンをクリックします。

3. エンド・ユーザーが自分のリクエストを生成できるようにするには、次のようにします。

   1. 「リソース管理」を開き、「リソース・オブジェクト」をダブルクリックします。

   2. 「Exchange」リソース・オブジェクトを検索して開きます。

   3. 「セルフ・リクエストを許可」チェック・ボックスを選択します。

   4. 「Save」アイコンをクリックします。

3.6 Oracle Identity Managerリリース11.1.2でのプロビジョニングの構成

Oracle Identity管理およびユーザー・コンソールを使用すると、Oracle Identity Managerリリース11.1.2でプロビジョニングを構成できます。

Oracle Identity Managerリリース11.1.2.xでプロビジョニング操作を構成する手順:

ノート:

このコネクタを使用して最初にプロビジョニング操作を実行する場合、完了するには通常より長い時間が必要となります。

1. Oracle Identity管理およびユーザー・コンソールにログインします。

2. ユーザーを作成します。ユーザーの作成の詳細は、Oracle Fusion Middleware Oracle Identity Managerでのセルフ・サービス・タスクの実行のユーザーの作成に関する項を参照してください。

3. 「アカウント」タブで、「アカウントのリクエスト」をクリックします。

4. 「カタログ」ページでアプリケーション・インスタンスを検索してカートに追加し、「チェックアウト」をクリックします。

5. アプリケーション・フォーム内のフィールドに値を指定し、「送信準備ができています」をクリックします。

6. 「送信」をクリックします。

7. Microsoft Exchangeメールボックスを既存のOIMユーザーにプロビジョニングする場合は、次のようにします。

   1. 「ユーザー」ページで、必要なユーザーを検索します。

   2. ユーザー詳細ページで、「アカウント」をクリックします。

   3. 「アカウントのリクエスト」ボタンをクリックします。

   4. カタログ検索ボックスでExchangeアプリケーション・インスタンスを検索し、これを選択します。

   5. 「カートに追加」をクリックします。

   6. 「チェックアウト」をクリックします。

   7. アプリケーション・フォーム内のフィールドに値を指定し、「送信準備ができています」をクリックします。

   8. 「送信」をクリックします。

3.7 アクション・スクリプトの構成

アクションは、プロビジョニング操作の前または後に実行するように構成できるスクリプトです。たとえば、カスタムPowerShellスクリプトを、メールボックスの作成、更新または削除の前または後に実行できます。

アクション・スクリプトに関連するトピックを、次に示します。

• アクション・スクリプトの構成について

• カスタムPowerShellスクリプトの実行

3.7.1 アクション・スクリプトの構成について

次に、アクション・スクリプトを構成する手順のサマリーを示します。

• コネクタ・サーバーをホストするコンピュータで、ディレクトリにカスタムPowerShellスクリプトを作成します。このスクリプトはそれ自体で完了できる必要があります。つまり、ターゲットExchange Serverでセッションを作成、保持、削除でき、それに対するすべてのアクションを完了できる必要があります。

• Oracle Identity Managerをホストしているコンピュータで、バッチ(.bat)ファイルを作成します。このバッチ・ファイルは、コネクタ・サーバーをホストするコンピュータで実行され、次にコネクタ・サーバーのホスト・コンピュータで使用可能なカスタムPowerShellスクリプトを呼び出します。Oracle Identity ManagerがUNIXベースのコンピュータにインストールされていても、バッチ・ファイルを作成します。

  バッチ・ファイルはPowershell.exeプログラムを使用してカスタムPowerShellを実行します。Powershell.exeの詳細は、http://technet.microsoft.com/en-us/library/hh847736.aspxを参照してください。

• Oracle Identity Manager Design Consoleを開き、次の値をLookup.Exchange.UM.Configuration参照定義に追加します。斜体で指定されたエントリは汎用的で、スクリプトを実行する必要がある時点で実際のエントリが必要になります。

  コード・キー	デコード
  TIMING Action Language	Shell ノート: この値は変更しないでください。
  TIMING Action File	Oracle Identity Managerをホストするコンピュータのバッチ・ファイルへのフルパスを入力します。
  TIMING Action Target	Resource ノート: この値は変更しないでください。

スクリプトを実行する必要がある時点で、前の表のTIMING Actionの実際のエントリを、次の表に基づいて更新できます。

スクリプトを実行する必要があるとき	TIMING Actionの実際の値
作成操作前	Before Create Action
作成操作後	After Create Action
更新操作前	Before Update Action
更新操作後	After Update Action
削除操作前	Before Delete Action
削除操作後	After Delete Action

様々な操作中、どのデータが使用可能かに関して違いがあります。

• 作成操作中は、プロセス・フォームのすべての属性部分にスクリプトが使用できます。

• 更新操作中は、更新中の属性のみにスクリプトが使用できます。

  その他の属性も必要な場合、新規アダプタ呼び出しICProvisioningManager# updateAttributeValues(String objectType, String[] labels)が作成され使用される必要があります。プロセス・タスクのアダプタ・マッピング中は、依存属性のフォーム・フィールド・ラベルを追加します。

• 削除操作中は、__UID__ (GUID)属性のみにスクリプトが使用できます。

3.7.2 カスタムPowerShellスクリプトの実行

例として、次のプロシージャで、作成操作後にカスタムPowerShellスクリプトを実行するステップを説明します。

1. Design Consoleにログインします。
2. Lookup.Exchange.UM.Configuration参照定義を検索して開きます。
3. 次の新しい値を追加します。

   • コード・キー: After Create Action File

   • デコード: スクリプトを起動するバッチ・ファイルのフルパスを入力します(Oracle Identity Managerはこのファイルにアクセスできる必要があります)。

   • 例: /home/Scripts/CustomCreateScript.bat

4. 次の新しい値を追加します。

   • コード・キー: After Create Action Language

   • デコード: 実行するスクリプトのスクリプト言語を入力します。

   • 例: Shell (この値は変更しないでください)

5. 次の新しい値を追加します。

   • コード・キー: After Create Action Target

   • デコード: リソース(この値は変更しないでください)

6. 参照定義を保存します。
7. Oracle Identity Managerを実行しているコンピュータに、次の内容で/home/Scripts/CustomCreateScript.batファイルを作成します。

   Powershell.exe -File C:\PSScript\CustomCreateScript.ps1 %Alias% -SimpleDisplayName %DisplayName%
   Exit
   

   ノート:

   プロセス・フォームのパラメータはバッチ・ファイルで使用可能なため、スクリプトでも使用可能です。追加パラメータを含めるには、プロビジョニング属性マップの「デコード」列にエントリを指定できます(Lookup.Exchange.UM.ProvAttrMap)。

8. コネクタ・サーバーを実行しているコンピュータにログインし、次のコンテンツを含むC:\PSScript\CustomCreateScript.ps1ファイルを作成します。

   ノート:

   コネクタまたはOracle Identity Managerを使用してこのスクリプトを実行する前に、コネクタ・サーバーを実行しているコンピュータで次を確認してください。

   • PowerShellウィンドウを使用して、スクリプトで指定された値で問題なくExchange Serverに手動で接続できることを確認します。

   • Set-Mailboxコマンドを任意の既存のメールボックスに対して実行し、問題なく実行することを確認します。

   • コマンド・プロンプトからバッチ・ファイルを含むディレクトリに移動します。その後、適切なパラメータでバッチ・ファイルを実行し、PowerShellスクリプトがExchange Serverで問題なく実行できることを確認します。

   問題がある場合、バッチ・ファイルまたはスクリプトを適切に更新します。

   下のサンプル・スクリプトのユーザー名、パスワード、およびExchange Serverに適切な値を指定します。下のスクリプトで、次のようにします。

   • $pw変数の値を実際のパスワードで更新します。値Welcome1がサンプル値として指定されています。

   • $cred変数の値を実際のユーザー名で更新します。値Connectorse1\oim_exch_serviceがサンプル値として指定されています。

   • $Session変数の値を実際のExchange Serverで更新します。値http://example.com/PowerShell/がサンプル値として指定されています。

   <#  
   .SYNOPSIS
       Updates a mailbox property
    
   .DESCRIPTION
       This script assumes the first parameter as the identity value, second paramater as a the property name to be updated and thrid parameter as the new  
   value.
   .NOTES
       File Name      : CustomCreateScript.ps1
    
   #>
   
   #Accept parameters
   $Identity = $args[0]
   $ParameterName = $args[1]
   $ParameterValue = $args[2]
   
   #Remove "[" and "]"
   $Identity = $Identity.Replace("[","")
   $Identity = $Identity.Replace("]","")
   
   #Replace "[" with "-" and remove "]"
   $ParameterName = $ParameterName.Replace("[","-")
   $ParameterName = $ParameterName.Replace("]","")
   
   #Remove "[" and "]"
   $ParameterValue = $ParameterValue.Replace("[","")
   $ParameterValue = $ParameterValue.Replace("]","")
   
   
   #Create password
   $pw = convertto-securestring -AsPlainText -Force -String Welcome1
   
   #Create credential
   $cred = new-object -typename System.Management.Automation.PSCredential -argumentlist "Connectorse1\oim_exch_service",$pw
   
   #Create session
   $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://example.com/PowerShell/ -Authentication Kerberos -Credential $cred
   
   #Import session
   Import-PSSession $session
   
   #Create command variable
   $Command = "Set-Mailbox -Identity $Identity $ParameterName $ParameterValue"
   
   #Just to check if proper command is created, dump it to a file.
   $Command >> "c:\command.txt"
   
   #Invoke it
   Invoke-Expression $Command
   
   #Remove session
   Remove-PSSession -Session $Session
   

   このスクリプトは、各作成操作の後で実行されます。新しく作成したメールボックスのSimpleDisplayNameプロパティを、そのDisplayNameプロパティ値で更新します。