Fusion Middleware Oracle Identity Manager管理者ガイド

11g リリース1(11.1.1)

B62264-03(原本部品番号:E14308-08)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

第I部 アプリケーション管理

1 リコンシリエーション・イベントの管理

- 1.1 Oracle Identity Managerのリコンシリエーション機能

- 1.1.1 パフォーマンスの向上

- 1.1.1.1 新しいメタデータ・モデル - プロファイル

- 1.1.1.2制御フローとイベントの処理のパラメータ

- 1.1.1.3 リコンシリエーション実行によるイベントのグループ化

- 1.1.1.4 バッチによるイベントのグループ化

- 1.1.1.5 リコンシリエーション・エンジン・ロジックのデータベースでの実装

- 1.1.1.6 改善されたJavaエンジン

- 1.1.1.7 改善されたデータベース・スキーマ

- 1.1.2 Webベースのイベント管理インタフェース

- 1.1.3 その他の機能拡張

- 1.1.3.1 水平表

- 1.1.3.2 競合条件の処理

- 1.1.3.3 OES統合

- 1.1.3.4 非定型リンク

- 1.2 イベント管理タスク

- 1.2.1 イベントの検索

- 1.2.1.1 イベントの単純検索の実行

- 1.2.1.2 イベントの拡張検索の実行

- 1.2.2 イベントの詳細の表示

- 1.2.3 イベント・アクションの決定

- 1.2.4 イベントの再評価

- 1.2.5 イベントのクローズ

- 1.2.6 リコンシリエーション・イベントのリンク

- 1.2.6.1 非定型リンク

- 1.2.6.2 手動リンク

- 1.2.6.3 孤立アカウントのリンク

- 1.3 リコンシリエーション・プロファイルの手動による更新

- 1.3.1 新しいリコンシリエーション・プロファイルの作成

- 1.3.1.1 リソース・オブジェクトに基づいたリコンシリエーション用のデフォルト以外の追加プロファイルの作成

- 1.3.1.2 信頼できるソースのリコンシリエーション用の新しいプロファイルの作成

- 1.3.2 リコンシリエーション・プロファイルの更新

- 1.3.3 プロファイル・モードの変更

- 1.4 RECON_EXCEPTIONS表へデータ移入

2 スケジュール済タスクの管理

- 2.1 oim-config.xmlファイルの構成

- 2.2 スケジューラの起動と停止

- 2.3 スケジュール済タスク

- 2.3.1 事前定義済のスケジュール済タスク

- 2.3.2 LDAPスケジュール済タスク

- 2.3.3 カスタムのスケジュール済タスクの作成

- 2.4 ジョブ

- 2.4.1 ジョブの作成

- 2.4.2 ジョブの検索

- 2.4.2.1 ジョブの単純検索の実行

- 2.4.2.2 ジョブの拡張検索の実行

- 2.4.3 ジョブの表示

- 2.4.4 ジョブの変更

- 2.4.5 ジョブの無効化と有効化

- 2.4.6 ジョブの起動と停止

- 2.4.7 ジョブの削除

3 通知テンプレートの管理

- 3.1 イベント・メタデータの定義

- 3.1.1 リゾルバ・クラスの作成

- 3.1.2 通知イベントのデプロイ

- 3.2 通知テンプレートの作成

- 3.3 通知テンプレートの検索

- 3.4 通知テンプレートの変更

- 3.5 通知テンプレートの削除

- 3.6 通知テンプレートに対するロケールの追加と削除

- 3.7 プロキシ用の通知の構成

4 システム・プロパティの管理

- 4.1 Oracle Identity Managerのシステム・プロパティ

- 4.2 システム・プロパティの作成と管理

- 4.2.1 システム・プロパティの作成

- 4.2.2 キャッシュのパージ

- 4.2.3 システム・プロパティの検索

- 4.2.3.1 単純検索の実行

- 4.2.3.2 拡張検索の実行

- 4.2.4 システム・プロパティの変更

- 4.2.5 システム・プロパティの削除

5 デプロイメント・マネージャを使用したデータのインポートおよびエクスポート

- 5.1 デプロイメント・マネージャの機能

- 5.2 デプロイメントのエクスポート

- 5.3 デプロイメントのインポート

- 5.3.1 スケジュール済タスクの再インポート時のデプロイメント・マネージャの動作

- 5.3.2 XMLファイルのインポート

- 5.4 エンティティの水平移行

- 5.4.1 既存エンティティのバックアップの作成

- 5.4.2 水平移行ユーティリティの実行

- 5.4.3 サポートされるエンティティのデータ移行

- 5.4.3.1 カスタム・リソース・バンドル

- 5.4.3.2 プラグイン

- 5.4.4 水平移行レポート

- 5.5 デプロイメント・マネージャの使用に関連するベスト・プラクティス

- 5.5.1 必要な場合にのみ行うシステム・オブジェクトのエクスポート

- 5.5.2 関連するオブジェクトのグループのエクスポート

- 5.5.3 定義データおよび操作データの個別のグループ化

- 5.5.4 フォーム・バージョンに対する論理的なネーミング規則の使用

- 5.5.5 ルートのエクスポートによる完全な組織階層の保持

- 5.5.6 わかりやすいエクスポートの説明

- 5.5.7 インポート前のすべての警告のチェック

- 5.5.8 データ・エクスポート前の依存性のチェック

- 5.5.9 一致するスケジュール済タスク・パラメータ

- 5.5.10 アダプタのコンパイルおよびスケジュール済タスクの有効化

- 5.5.11 エンティティ・アダプタの個別のエクスポート

- 5.5.12 ロールの権限のチェック

- 5.5.13 データベースのバックアップ

- 5.5.14 システム静止中のデータのインポート

- 5.5.15 SDK表の更新

- 5.5.16 依存性としてイベント・ハンドラをインポートする前のデータ・オブジェクト・フィールドの削除

- 5.6 水平移行ユーティリティの使用のベスト・プラクティス

- 5.7 トラブルシューティング

6 コネクタ・ライフサイクルの管理

- 6.1 コネクタのライフサイクル

- 6.2 コネクタ・ライフサイクルおよび変更管理の用語

- 6.3 コネクタの詳細の表示

- 6.4 コネクタのインストール

- 6.4.1 コネクタのデプロイメント・プロセスの概要

- 6.4.2 コネクタのインストールのためのユーザー・アカウントの作成

- 6.4.3 コネクタのインストール

- 6.5 コネクタの定義

- 6.6 コネクタのクローニング

- 6.6.1 コネクタのクローニングのガイドライン

- 6.6.2 コネクタのクローニング

- 6.6.3 クローニング後の手順

- 6.7 コネクタ・オブジェクトの定義のコネクタXML形式でのエクスポート

- 6.8 コネクタのアップグレード

- 6.8.1 コネクタのアップグレード機能でサポートされているアップグレード・ユースケース

- 6.8.2 コネクタのアップグレード機能でサポートされるコネクタ・オブジェクト変更

- 6.8.2.1 リソース・オブジェクトの変更

- 6.8.2.2 プロセス定義の変更

- 6.8.2.3 コネクタ・コード・ファイルの変更

- 6.8.2.4 リソース・オブジェクトの変更

- 6.8.2.5 プロセス・フォームの変更

- 6.8.2.6 参照定義の変更

- 6.8.2.7 アダプタの変更

- 6.8.2.8 ルールの変更

- 6.8.2.9 ITリソース・タイプの変更

- 6.8.2.10 ITリソースの変更

- 6.8.2.11 スケジュール済タスクの変更

- 6.8.3 コネクタをアップグレードした場合の処理

- 6.8.4 アップグレード手順のサマリー

- 6.8.5 コネクタのアップグレード手順

- 6.8.5.1 アップグレード前の手順

- 6.8.5.2 アップグレード手順

- 6.8.5.3 アップグレード後の手順

- 6.8.6 非収束コネクタから収束されたコネクタへのアップグレード手順

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

- 6.9.1 コネクタのアンインストール・ユーティリティでサポートされるユースケース

- 6.9.2 コネクタのアンインストール・プロセスの概要

- 6.9.3 コネクタのアンインストール・ユーティリティの設定

- 6.9.4 コネクタのアンインストールおよびコネクタ・オブジェクトの削除

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

- 6.9.4.2 アダプタ、参照定義、リソース・オブジェクトおよびスケジュール済タスクの削除

- 6.9.4.3 コネクタおよびコネクタ・オブジェクトをアンインストールするスクリプトの実行

第II部 システム管理

7 サーバーの起動と停止

- 7.1 ノード・マネージャの構成

- 7.2 ノード・マネージャの起動

- 7.3 WebLogic管理サーバーの起動または停止

- 7.4 WebLogic管理対象サーバーの起動または停止

- 7.4.1 コマンド・プロンプトを使用した管理対象サーバーの起動または停止

- 7.4.2 Oracle Enterprise Manager Fusion Middleware Controlを使用した管理対象サーバーの起動または停止

- 7.4.3 Oracle WebLogic Server管理コンソールを使用したサーバーの起動または停止

8 システム・ロギングの有効化

- 8.1 ODLを使用したOracle Identity Managerのロギング

- 8.1.1 メッセージのタイプとレベル

- 8.1.2 ログ・ハンドラとロガーの構成

- 8.1.3 ログ・ハンドラの構成

- 8.1.3.1 ログ・ハンドラの構成ツール

- 8.1.4 ロガーの構成

- 8.1.5 ODLログ出力のサンプル

- 8.2 log4jを使用したOracle Identity Managerのロギング

- 8.2.1 ログ・レベル

- 8.2.2 ロガー

- 8.2.3 ロギングの構成と有効化

9 セキュアなCookieの有効化

10 LDAP同期の有効化

- 10.1 インストール後のLDAP同期の有効化

- 10.2 Identity Virtualization Library(libOVD)とディレクトリ・サーバーの間でのSSLの有効化

- 10.2.1 Identity Virtualization Library(libOVD)とMicrosoft Active Directoryの間でのSSLの有効化

- 10.2.2 Identity Virtualization Library(libOVD)とiPlanetの間でのSSLの有効化

- 10.2.3 Identity Virtualization Library(libOVD)とOIDの間でのSSLの有効化

- 10.3 LDAP同期を有効化する前に作成したユーザーおよびロールのLDAPへのプロビジョニング

- 10.4 LDAP同期の無効化

- 10.5 Identity Virtualization Library(libOVD)アダプタの管理

- 10.6 LDAP同期が有効な場合のLDAP認証の構成

11 他のOracleコンポーネントとの統合

- 11.1 Oracle Access Manager

- 11.2 Oracle Adaptive Access Manager

- 11.3 Oracle Identity Analytics

- 11.3.1 Oracle Identity Analyticsにおける統合の構成

- 11.3.2 Oracle Identity Managerにおける統合の構成

- 11.3.2.1 DataCollectionOperationsIntf APIインタフェース

- 11.3.2.2 ステージング表

- 11.3.2.3 データ収集プロセス

- 11.4 Oracle Identity Navigator

- 11.5 Oracle Virtual Directory

- 11.6 Oracle Service-Oriented Architecture

- 11.7 Oracle Business Intelligence Publisher

12 ライフサイクル管理変更の処理

- 12.1 Oracle Identity Managerに関連するURL変更

- 12.1.1 Oracle Identity Managerデータベースのホストとポートの変更

- 12.1.2 Oracle Virtual Directoryのホストとポートの変更

- 12.1.3 Oracle Identity Managerのホストとポートの変更

- 12.1.3.1 Oracle Identity Manager構成のOimFrontEndURLの変更

- 12.1.3.2 Oracle Identity Manager構成のbackOfficeURLの変更

- 12.1.4 BI Publisherのホストとポートの変更

- 12.1.5 SOAのホストとポートの変更

- 12.1.6 OAMのホストとポートの変更

- 12.2 Oracle Identity Managerに関連するパスワード変更

- 12.2.1 Oracle WebLogic管理者パスワードの変更

- 12.2.2 Oracle Identity Manager管理者パスワードの変更

- 12.2.3 Oracle Identity Managerデータベース・パスワードの変更

- 12.2.4 資格証明ストア・フレームワークのOracle Identity Managerパスワードの変更

- 12.2.5 OVDパスワードの変更

- 12.3 Oracle Identity ManagerのSSLの構成

- 12.3.1 鍵の生成

- 12.3.2 証明書への署名

- 12.3.3 証明書のエクスポート

- 12.3.4 証明書のインポート

- 12.3.5 Oracle Identity ManagerおよびSOAサーバーのSSLの有効化

- 12.3.5.1 Oracle Identity ManagerのSSLの有効化

- 12.3.5.2 OimFrontEndURLをSSLポートを使用するように変更

- 12.3.5.3 backOfficeURLをSSLポートを使用するように変更

- 12.3.5.4 SOAサーバーURLをSSLポートを使用するように変更

- 12.3.5.5 Design ConsoleのSSLの構成

- 12.3.5.6 Oracle Identity ManagerユーティリティのSSLの構成

- 12.3.5.7 MDSユーティリティのSSLの構成

- 12.3.5.8 SPML/コールバック・ドメインのSSLの構成

- 12.3.6 Oracle Identity Manager DBのSSLの有効化

- 12.3.6.1 サーバー認証SSLモードでのDBの設定

- 12.3.6.2 キーストアと証明書の作成

- 12.3.6.3 Oracle Identity Managerの更新

- 12.3.6.4 WebLogic Serverの更新

- 12.3.7 LDAP同期のSSLの有効化

- 12.3.7.1 OVD-OIDでのSSLの有効化

- 12.3.7.2 Oracle Identity ManagerのOVDホスト/ポートの更新

第III部 構成

13 ユーザー属性の構成

- 13.1 エンティティ構成操作

- 13.1.1 エンティティ属性のリスト表示

- 13.1.2 エンティティ属性の作成

- 13.1.2.1 属性プロパティ

- 13.1.2.2 LKU表およびLKV表の定義

- 13.1.3 エンティティ属性の変更

- 13.1.4 エンティティ属性の削除

- 13.1.5 カテゴリ構成の実行

- 13.1.5.1 カテゴリの作成

- 13.1.5.2 カテゴリの名前変更

- 13.1.5.3 カテゴリの削除

- 13.1.5.4 カテゴリ内での属性の順序付け

- 13.2 検索操作の構成

- 13.3 ユーザー構成管理の認証

- 13.4 リクエストでのUDFの使用の有効化

- 13.5 Oracle Identity ManagerとLDAP間でのユーザー定義フィールドの同期

- 13.5.1 手動による属性の同期化

- 13.5.2 ldapsyncudfユーティリティの使用によるOracle Identity ManagerとLDAP間のUDFの同期化

- 13.5.2.1 プロパティ・ファイルの構成

- 13.5.2.2 入力ファイルの構成

- 13.5.2.3 ユーティリティの実行

- 13.6 構成管理アーキテクチャ

14 パスワード・ポリシーの管理

- 14.1 パスワード・ポリシーの作成

- 14.1.1 「ポリシー・ルール」タブ

- 14.1.2 「使用状況」タブ

- 14.2 パスワード・ポリシーの基準の設定

15 アイデンティティおよびリソース情報の管理

- 15.1 ユーザー管理の概要

- 15.2 組織情報の管理

- 15.3 ユーザーに対して許可されているか、または許可されていないリソースの表示

- 15.3.1 ポリシーの履歴タブ

- 15.4 ロール・エンタイトルメントの割当て

16 非同期実行の管理

- 16.1 非同期サービスの概要

- 16.2 非同期ルーティングと構成

- 16.2.1 構成パラメータ

- 16.3 失敗した非同期タスクのトラブルシューティング

- 16.3.1 自動再試行のエラー処理メカニズム

- 16.3.2 手動再試行のエラー処理メカニズム

- 16.4 診断ダッシュボードUIの操作

- 16.4.1 診断ダッシュボードUIの起動

- 16.4.2 失敗した非同期タスクの表示

- 16.4.2.1 失敗した非同期タスクを表示する手順

- 16.4.3 失敗した非同期タスクの再試行

- 16.4.3.1 失敗した非同期タスクを再試行する手順

- 16.4.4 失敗した非同期タスクの再送信

- 16.4.5 失敗した非同期タスクのパージ

- 16.4.5.1 失敗した非同期タスクをパージする手順

17 オフライン・プロビジョニングの有効化

- 17.1 オフライン処理の特徴

- 17.2 オフライン・プロビジョニングの有効化と無効化

- 17.3 オフライン・プロビジョニング関連のレポート

- 17.4 失敗したオフライン・メッセージの削除スケジュール済タスクの構成

18 Enterprise Managerを使用したOracle Identity Manager構成の管理

- 18.1 MBeanを使用した構成変更

- 18.2 構成ファイルのエクスポートおよびインポート

19 ユーザーの言語の設定

第IV部 管理ユーティリティ

20 診断ダッシュボードの操作

- 20.1 診断ダッシュボードの概要

- 20.2 診断ダッシュボードのインストール

- 20.2.1 Oracle WebLogic Serverへの診断ダッシュボードのインストール

- 20.3 診断ダッシュボードの起動

- 20.4 診断ダッシュボードの使用

- 20.5 診断ダッシュボードを使用したテストの実行

- 20.5.1 Oracle Databaseの前提条件チェック

- 20.5.2 データベース接続性のチェック

- 20.5.3 アカウント・ロックのステータス

- 20.5.4 データ暗号化キーの検証

- 20.5.5 スケジューラ・サービスのステータス

- 20.5.6 リモート・マネージャのステータス

- 20.5.7 JMSメッセージ機能の検証

- 20.5.8 ターゲット・システムのSSLトラストの検証

- 20.5.9 Java VMシステム・プロパティのレポート

- 20.5.10 Oracle Identity Managerのライブラリと拡張機能のバージョンのレポート

- 20.5.11 Oracle Identity Managerのライブラリと拡張機能のマニフェストのレポート

- 20.5.12 基本接続性のテスト

- 20.5.13 プロビジョニングのテスト

- 20.5.14 リコンシリエーションのテスト

- 20.5.15 SOA-Oracle Identity Managerの構成チェック

- 20.5.16 診断情報のリクエスト

- 20.5.17 編成ステータス

- 20.5.18 失敗した編成の再試行

- 20.5.19 SPML Webサービス

- 20.5.20 OWSM設定のテスト

- 20.5.21 Oracle Identity Managerに対するSPLリクエスト呼出しのテスト

- 20.5.22 Oracle Identity Manager属性に対するSPML属性

- 20.5.23 ユーザー名テスト

- 20.5.24 Oracle Identity ManagerおよびLDAPにおけるユーザー作成とロール作成の診断

- 20.5.25 OVD接続の診断

- 20.5.26 LDAP予約コンテナの診断

21 リモート・マネージャのインストールと構成

- 21.1 リモート・マネージャの構成の概要

- 21.2 Remote Managerの構成

- 21.2.1 信頼関係の追加

- 21.2.2 独自の証明書を使用したリモート・マネージャの構成

- 21.2.3 リモート・マネージャの接続のテスト

- 21.2.4 リモート・マネージャのポート変更のためのxlconfig.xmlファイルの更新

- 21.3 リモート・マネージャの停止と起動

- 21.4 リモート・マネージャのトラブルシューティング

22 フォーム・バージョン制御ユーティリティの使用方法

- 22.1 FVCユーティリティでサポートされているユースケース

- 22.2 FVCユーティリティでサポートされていないユースケース

- 22.3 フォーム・バージョン制御プロセスのサマリー

- 22.4 FVCユーティリティのコンポーネント

- 22.5 FVCユーティリティの使用

- 22.5.1 プロパティ・ファイルの準備

- 22.5.2 FVCユーティリティを使用するための前提条件への対処

- 22.5.3 ユーティリティの実行

- 22.6 トラブルシューティング

23 アーカイブ・ユーティリティの使用

- 23.1 リコンシリエーション・アーカイブ・ユーティリティの使用

- 23.1.1 リコンシリエーション・アーカイブ・ユーティリティについて

- 23.1.2 リコンシリエーション・アーカイブ・ユーティリティの実行の前提条件

- 23.1.3 アーカイブ基準

- 23.1.4 リコンシリエーション・アーカイブ・ユーティリティの実行

- 23.1.5 リコンシリエーション・アーカイブ・ユーティリティにより生成されるログ・ファイル

- 23.2 タスク・アーカイブ・ユーティリティの使用

- 23.2.1 タスク・アーカイブ・ユーティリティについて

- 23.2.2 タスク・アーカイブ・ユーティリティのためのOracle Databaseの準備

- 23.2.3 タスク・アーカイブ・ユーティリティの実行

- 23.2.4 タスク・アーカイブ・ユーティリティにより生成される出力ファイルの確認

- 23.3 リクエスト・アーカイブ・ユーティリティの使用

- 23.3.1 リクエスト・アーカイブ・ユーティリティについて

- 23.3.2 リクエスト・アーカイブ・ユーティリティの実行の前提条件

- 23.3.3 入力パラメータ

- 23.3.4 リクエスト・アーカイブ・ユーティリティの実行

- 23.3.5 ユーティリティにより生成されるログ・ファイル

- 23.4 監査アーカイブおよびパージ・ユーティリティの使用

- 23.4.1 概要

- 23.4.2 ユーティリティの使用の前提条件

- 23.4.3 アーカイブおよびパージのためのUPA表の準備

- 23.4.4 UPA表のアーカイブまたはパージ

- 23.4.4.1 アーカイブまたはパージできないパーティション

- 23.4.4.2 進行中のパーティションのメンテナンス

- 23.4.4.3 UPA表のパーティションのアーカイブまたはパージ

第V章 パフォーマンス・チューニングとベスト・プラクティス

24 Oracle Databaseのチューニング

- 24.1 Oracle Identity Managerデータベースに対するデータベース・ロール/権限の使用

- 24.2 インスタンス構成パラメータのサンプル

- 24.3 物理データの配置

- 24.3.1 タスクの表

- 24.3.2 リコンシリエーション表

- 24.3.3 監査表

- 24.3.4 REDOログ・ファイル

- 24.3.5 プール保存の変更

- 24.4 データベース・パフォーマンスの監視

25 アプリケーション・サーバーのパフォーマンスのチューニング

- 25.1 JVMメモリー設定

- 25.2 JDBC接続プール

- 25.3 メッセージ・ドリブンBeanの数

- 25.4 ユーザー・インタフェース・スレッド

- 25.5 アダプタとプラグイン構成の再ロードの無効化

- 25.6 UNIX用のオープン・ファイル記述子数の変更(オプション)

- 25.7 Solaris Sparc T3またはT4に対するJVMガベージ・コレクションのチューニング

26 アプリケーション・キャッシュのチューニングと管理

- 26.1 キャッシングの概要

- 26.2 Oracle Identity Managerキャッシュのチューニング

- 26.3 キャッシュのパージ

27 デプロイメントの保護

索引

Oracle® Fusion Middleware

Oracle Identity Manager管理者ガイド

11g リリース1(11.1.1)

B62264-03(原本部品番号:E14308-08)

2011年12月

Oracle Fusion Middleware Oracle Identity Manager管理者ガイド 11g リリース1(11.1.1)

B62264-03

Copyright © 1991, 2011, Oracle and/or its affiliates.All rights reserved.

原本著者:  Debapriya Datta

原本協力者:  Prakash Hulikere

協力者:  Sid Choudhury

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle およびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

『Oracle Fusion Middleware System Oracle Identity Manager管理者ガイド』では、Oracle Identity Managerでのシステム管理タスクの実行方法について説明します。

対象読者

このガイドは、システム構成の水平移行、データベース全体のパフォーマンス調整、アプリケーション・サーバー、JMS、コネクタ、スケジュールされたタスクの管理、コネクタのインストールとデプロイメントおよびアーカイブ・ユーティリティ管理などのシステム構成タスクを実行できるシステム管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleカスタマは、My Oracle Supportから電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、次のドキュメントを参照してください。

- Oracle Fusion Middleware Oracle Identity Manager開発者ガイド

- Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイド

- Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド

- Oracle Identity ManagementのOracle Fusion Middlewareクイック・インストレーション・ガイド

- Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド

- Oracle Fusion Middlewareスイート統合概要

- Oracle Fusion Middleware Oracle Identity Managementユーザー・リファレンス

- Oracle Fusion Middleware高可用性ガイド

- Oracle Fusion Middleware Oracle Access Manager管理者ガイド

- Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイド

- Oracle Fusion Middleware Oracle Adaptive Access Manager開発者ガイド

- Oracle Fusion Middleware Oracle Identity Navigator管理者ガイド

- Oracle Fusion Middleware Authorization Policy Manager管理者ガイド

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ドキュメントのタイトル、強調またはユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

第I部

アプリケーション管理

この部では、Oracle Identity Managerでのアプリケーション管理タスクについて説明します。

次の章で構成されています。

- 第1章「リコンシリエーション・イベントの管理」

- 第2章「スケジュール済タスクの管理」

- 第3章「通知テンプレートの管理」

- 第4章「システム・プロパティの管理」

- 第5章「デプロイメント・マネージャを使用したデータのインポートとエクスポート」

- 第6章「コネクタ・ライフサイクルの管理」

1 リコンシリエーション・イベントの管理

リコンシリエーション・プロセスには、Oracle Identity Managerに適用されるイベントの生成が含まれます。このイベントには、ターゲット・システムでのアトミック変更が反映され、変更されたデータ、変更のタイプおよびその他の情報が含まれます。ターゲット・システムで発生した変更の結果として生成されるリコンシリエーション・イベントは、各種ビジネス要件を満たすように管理される必要があります。Oracle Identity Manager拡張管理の「イベント管理」セクションでは、このようなイベント管理要件に対処します。

関連項目:

リコンシリエーションの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのリコンシリエーション構成に関する項を参照してください。

「イベント管理」セクションを使用してリコンシリエーション・イベントを管理し、格納されたイベントに様々な方法で問い合せてイベント・データすべてを表示できます。これらのイベントは、常に「イベントの詳細」ページと同じ形式で表示されます。「拡張検索」機能を使用して、イベントに対してカスタム問合せを実行できます。イベントの問題を解決するために必要な任意のアクションを実行することもできます。

イベントはリコンシリエーション実行によって生成されます。これらのリコンシリエーション実行は、Oracle Identity Managerスケジューラを使用して実行がスケジュールされます。

関連項目:

スケジューラの詳細は、「スケジュール済タスクの管理」を参照してください。

この章の内容は次のとおりです。

- Oracle Identity Managerのリコンシリエーション機能

- イベント管理タスク

- リコンシリエーション・プロファイルの手動による更新

- RECON_EXCEPTIONS表へのデータ移入

1.1 Oracle Identity Managerのリコンシリエーション機能

リコンシリエーション機能は、次のカテゴリに分類できます。

- パフォーマンスの向上

- Webベースのイベント管理インタフェース

- その他の機能拡張

1.1.1 パフォーマンスの向上

11g リリース1 (11.1.1)では、次の機能拡張により、リコンシリエーション時のパフォーマンスが向上しました。

- 新しいメタデータ・モデル - プロファイル

- 制御フローとイベントの処理のパラメータ

- リコンシリエーション実行によるイベントのグループ化

- バッチによるイベントのグループ化

- リコンシリエーション・エンジン・ロジックのデータベースでの実装

- 改善されたJavaエンジン

- 改善されたデータベース・スキーマ

1.1.1.1 新しいメタデータ・モデル - プロファイル

Oracle Identity Managerには、さまざまなターゲットに関連付けられるメタデータを格納する新しいモデルがあります。

以前のリリースでは、メタデータはリコンシリエーション・ターゲットに関連付けられていました。このため、同じターゲットに対して複数のジョブを実行してさまざまなタイプのリコンシリエーションを行う機能が制限されていました。

Oracle Identity Manager 11g リリース1 (11.1.1)では、Oracle Identity Managerの各種コンポーネントのすべての構成は、MDSと呼ばれるXMLストアに集中的に格納されています。

下位互換性のために、現在のデプロイメントは、Oracle Identity Manager Design Consoleを介して継続して構成を管理し、構成は引き続きOracle Identity Managerデータベースに格納されます。Oracle Identity Manager 11g リリース1 (11.1.1)では、構成APIは構成を表から自動的に読み取り、それをデフォルト・プロファイルと呼ばれるXMLプロファイルに変換し、そのプロファイルを既存のリコンシリエーションの実行に関連付けます。デフォルト・プロファイルにはDEFAULTタグが付けられます。

すべてのメタデータは、Oracle Identity Manager Design Consoleを使用して管理されます。Oracle Identity Manager Design Consoleを使用して、デフォルトのリコンシリエーション・プロファイルを生成できます。Oracle Identity Manager Design Consoleからリコンシリエーション構成を変更する場合は、このデフォルトのプロファイルを使用してプロファイルを再生成できます。デプロイメント・マネージャから構成をインポートする場合は、デフォルトでプロファイルが生成されます。

デフォルト以外のすべてのプロファイルは、任意のXMLエディタを使用してすべて管理できます。

関連項目:

リコンシリエーション・プロファイルの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのリコンシリエーション・プロファイルを参照してください。

1.1.1.2 制御フローとイベントの処理のパラメータ

この項の内容は次のとおりです。

- 制御イベント処理のパラメータ

- 自動再試行の制御のパラメータ

制御イベント処理のパラメータ

BatchSizeは、イベント処理を制御するパラメータです。これはバッチのサイズを決定します。バッチ・サイズが1の場合、一度に1つのイベントが処理されます。バッチ・サイズはシステム・プロパティとして利用でき、Oracle Identity Manager Design Consoleから管理できます。そのプロパティ名は、OIM.ReconBatchSizeです。システムのBatchSizeパラメータのデフォルト値は500です。システム・プロパティの詳細は、第4章「システム・プロパティの管理」を参照してください。

自動再試行の制御のパラメータ

MaxRetryCountプロファイル・パラメータは、リコンシリエーション・エンジンがエラーとしてフラグを付けるか手動キューに送信する前に項目を再試行する回数を指定して、自動再試行を制御します。MaxRetryCount = 0は、自動再試行オプションが設定されていないことを意味します。

関連項目:

自動再試行の詳細は、「競合条件の処理」を参照してください。

1.1.1.3 リコンシリエーション実行によるイベントのグループ化

リコンシリエーション・データベースで作成されるすべてのイベントは、リコンシリエーション実行によってグループ化されます。リコンシリエーション実行のすべてのイベントは、共通のリコンシリエーション実行IDによってグループ化されます。各リコンシリエーション実行はプロファイルと関連付けられているため、リコンシリエーション実行のすべてのイベントは、同じプロファイルを使用して処理されます。これにより、構成はリコンシリエーション実行ごとに一度のみ取得されるため、パフォーマンスの最適化に役立ちます。

各プロファイルはそれぞれ異なるバッチ・サイズを使用できます。そのため、各ターゲット・リコンシリエーションに適したバッチ・サイズに調整することで、システム・パフォーマンスを向上させることができます。

1.1.1.4 バッチによるイベントのグループ化

バッチは、リコンシリエーション時のシステム・パフォーマンスを向上させるために導入されました。バッチには多数のイベントが含まれます。これはリコンシリエーション・エンジンの処理の単位です。バッチのサイズは設定可能です。リコンシリエーション実行は、固定サイズのバッチに分割されます。たとえば、リコンシリエーション実行が9900のイベントで構成され、バッチ・サイズが1000の場合、そのリコンシリエーション実行は、各サイズ1000のバッチと最後のサイズ900のバッチの計10個のバッチに分割されます。

バッチを1つの単位として処理すると、一度に1つのイベントを処理する際のオーバーヘッドを排除でき、システム・パフォーマンスが最適化されます。またこれにより、可能な場合にはバルク操作も実行できます。バッチを並列で実行して、ハードウェア・リソースをバランスよく使用することもできます。

1.1.1.5 リコンシリエーション・エンジン・ロジックのデータベースでの実装

以前のリリースでは、すべてのエンジン・ロジックはJavaで実装されており、一度に1つのイベントが処理されていました。11g リリース1(11.1.1)では、イベントを処理するロジックのほとんどは、ストアド・プロシージャとして実装されています。バッチ・レベルでの処理とPLSQLで実装されたロジックの組合せにより、SQLレイヤでバルク操作を実行できるようになりました。次の手順は、バルク(一度に1つのバッチ)で実行されます。

- 必要なデータのチェック

- 一致ルールの適用

- アクション・ルールの適用

1.1.1.6 改善されたJavaエンジン

ストアド・プロシージャで実行できず、Javaレイヤで実行する必要のある処理でも、次の理由により、以前のリリースのエンジンよりも優れたパフォーマンスが得られます。

- 次の場合、Javaエンジンはデフォルトでバルク操作を実行します。

- イベントをバッチでデータベースに送信

- アクションに応じたバルク後処理編成の送信

- 可能な限り、バルク操作を実行します。

1.1.1.7 改善されたデータベース・スキーマ

11g リリース1(11.1.1)の新しいデータベース・スキーマによる顕著なパフォーマンスの向上は、単一の垂直表のかわりに水平表を使用して各種ターゲットのイベント詳細を格納することで実現されます。水平表はプロファイルごとに使用されます。

関連項目:

水平表の詳細は、「水平表」を参照してください。

1.1.2 Webベースのイベント管理インタフェース

Oracle Identity Managerには、Webベースのイベント管理インタフェースが付属しており、Webからイベントを管理できます。認可されたユーザーは、イベントとユーザーを検索し、イベントをユーザーおよびアカウントにリンクして例外を処理できます。イベントのクローズ、失敗したイベントの再評価の強制、および非定型リンクも実行できます。

非定型リンクは、「イベント管理」セクションの認可されたユーザーに提供される機能を参照して、イベントをOracle Identity Managerのいずれかのユーザーにリンクします。リコンシリエーション・エンジンによってそのイベントに対するユーザー一致が検出された場合でも、この非定型リンク機能により、ユーザーはその一致を無視して別のユーザーを選択できるようになります。これにより、誤った一致によって生じる例外を処理できます。

関連項目:

「イベント管理」で実行されるタスクの詳細は、「イベント管理タスク」を参照してください。

1.1.3 その他の機能拡張

その他のリコンシリエーション拡張について、次の各項で説明します。

- 水平表

- 競合条件の処理

- OES統合

- 非定型リンク

1.1.3.1 水平表

以前のバージョンのOracle Identity Managerでは、さまざまなターゲットから取得したすべてのイベント詳細が、リコンシリエーション・スキーマの1つの表に格納されます。各種リコンシリエーション・イベントに含まれる属性およびその名前とタイプのリストは、ターゲットによって異なる場合があります。つまり、あるターゲットのイベントに含まれるデータ・セットが、別のターゲットのイベントに含まれるものと異なる場合があります。このようなイベントのデータを1つの表に格納する唯一の方法は、1行に1つの属性を格納することです。そのため、以前のリリースでは、イベント詳細表の各行が、リコンシリエーション・イベント・データの1つの属性に相当しています。各属性行には、その属性が属するイベント、属性の名前、タイプ、値が格納されます。このような表のことを、このドキュメントでは垂直表とも呼びます。垂直表は、柔軟性と拡張性の面では利点がありますが、パフォーマンスの観点からはイベント・レコードを格納する効率的な方法とはいえません。

11g リリース1(11.1.1)では、垂直表での格納が、水平表と呼ばれるターゲットごとの個別表で置き換えられました。イベントの属性を表内の行として垂直に格納する(属性の数が行数になる)のではなく、イベントの属性を列として水平に格納するため、水平表と呼ばれます。つまり、ターゲットの属性数と同じ数の列が存在します。各イベントは、行として格納されます。異なるターゲットは異なる属性セットを持つことがあるため、各ターゲットは、イベントの詳細を格納するリコンシリエーション・スキーマ内に個別の表を持ちます。子テーブル内の行として格納される複数値属性を処理する要件のために、1つのターゲットに複数の表が存在することがあります。

特定のプロファイルに対するイベント詳細表の各行には、1つのイベントのリコンシリエーション・フィールドのリストが格納されます。たとえば、信頼できるユーザーのリコンシリエーションで姓、名、電子メール属性がリコンサイルされる場合、RA_XELLERATE_USER水平表に次の列が含まれます。

RE_KEY、RECON_FIRSTNAME、RECON_LASTNAME、RECON_EMAI

水平表の作成と管理

水平表は、ターゲットをOracle Identity Managerに対してデプロイしている場合のみ作成できます。これは、ターゲットのデプロイ時に、リコンシリエーション・システムがリコンサイルする必要のあるターゲットの属性とそのタイプのリストを把握しているためです。

デプロイメント・マネージャから構成をインポートしたり、Oracle Identity Manager Design Consoleから変更を行ったりした場合には、水平表が更新されます。Oracle Identity Manager Design Consoleから水平表を生成するには、オブジェクト・リコンシリエーション・フォームで、リコンシリエーション・プロファイルの生成をクリックします。

1.1.3.2 競合条件の処理

以前のリリースのOracle Identity Managerでは、イベントをリコンサイルする際に、そのイベントをリコンサイルする前に別のイベントをリコンサイルする必要があるために、リコンシリエーション・エンジンがそのイベントを正常に処理できないことがありました。たとえば、リコンシリエーション・エンジンは、アカウントを作成するイベントをリコンサイルする前に、ユーザーを作成するイベントをリコンサイルする必要があります。これを競合条件と呼びます。

Oracle Identity Manager 11g リリース1(11.1.1)では、競合条件はリコンシリエーションの実行ごとに選択できる自動再試行オプションを使用して処理されます。自動再試行を構成するには、MaxRetryCountパラメータに1以上の値を指定します。自動再試行を構成しない場合は、MaxRetryCountパラメータの値に0を指定します。

注意:

MaxRetryCountは、リコンシリエーション・プロファイルのパラメータです。このパラメータのデフォルト値は5です。この値を変更するには、MDSからプロファイルをエクスポートし、再試行回数を更新し、それからMDSにインポートして戻します。リコンシリエーション・プロファイルの手動での更新については、「リコンシリエーション・プロファイルの更新」を参照してください。

自動再試行を構成する場合、リコンシリエーション・エンジンは競合条件をチェックします。競合条件が見つかると、リコンシリエーション・エンジンは、再試行回数に達するまでリコンシリエーション・イベントを再評価キューに入れます。

リコンシリエーションの再試行スケジュール済タスクは、再試行を待っているイベントがないか、そして再評価される準備ができているかどうかを定期的にチェックし、ある場合は、それをリコンシリエーション・エンジン処理用のキューに入れます。このスケジュール済タスクは、デフォルトで構成されています。

注意:

- 自動再試行回数に達すると、リコンシリエーション・エンジンはイベントの処理をやめ、一致ルールによってステータスを設定します。ただし、「イベント管理」から再評価をリクエストすれば、手動で再試行できます。イベントの再評価については、「イベントの再評価」を参照してください。

- 再試行中、イベントが正常に処理されると、CurrentRetryCountパラメータの値は0にリセットされます。

自動再試行は次の競合条件を処理できます。

- ユーザーを作成するイベントがまだ処理されていないために、Oracle Identity Managerのアカウントを作成するアカウント・イベントが、このイベントのユーザーが作成される前に処理されます。

- Oracle Identity ManagerのXellerateユーザーを作成するユーザー・イベントが、このユーザーが属する組織が作成される前に処理されます。

関連項目:

自動再試行パラメータについては、「自動再試行の制御のパラメータ」を参照してください。

CurrentRetryCountパラメータ以外のすべての自動再試行パラメータは、リコンシリエーション・プロファイルの一部として格納されます。つまり、あるリコンシリエーション実行に属するイベントに自動再試行が構成されていて、別のリコンシリエーション実行に属するイベントでは自動再試行が構成されていないこともあります。

Oracle Identity Manager 11g リリース1(11.1.1)では、このプロファイル内のパラメータを管理するUIがないため、XMLエディタを使用してXMLプロファイルを直接編集してパラメータを管理する必要があります。XMLプロファイルの編集については、「リコンシリエーション・プロファイルの更新」を参照してください。

1.1.3.3 OES統合

リコンシリエーション・イベントを管理するイベント管理API、リコンシリエーションAPIおよびUIは、認可ポリシーを使用して保護されます。Oracle Entitlements Server (OES)は、認可ポリシーの管理に使用されるOracle製品です。

注意:

OESの詳細は、次のURLを参照してください。

http://www.oracle.com/technetwork/middleware/oes/overview/index.html

リコンシリエーションのデフォルトの認可ポリシーでは、RECONCILIATION ADMINISTRATORSロールまたはSYSTEM ADMINISTRATORSロールを持つユーザーのみがリコンシリエーションにアクセスして使用できるように設定されます。

関連項目:

- 認可ポリシーの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの認可ポリシーの管理に関する項を参照してください。

- ユーザーへのロールの割当て方法については、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのロールの管理に関する項を参照してください。

1.1.3.4 非定型リンク

リコンシリエーション・エンジンで一致ルールに基づいて所有者を決定できない場合は、Oracle Identity Manager拡張管理を使用してアカウントをユーザーに手動でリンクできます。その後のアカウントに対する変更は、そのアカウントに自動的にリンクされます。

非定型リンクは、ユーザー・イベントおよびアカウント・イベントでサポートされています。リコンシリエーション・エンジンで一致ルールに基づいて所有者を決定できない場合は、ユーザー・イベントまたはアカウント・イベントをユーザーに手動でリンクできます。

関連項目:

非定型リンクの実行方法については、「非定型リンク」を参照してください。

1.2 イベント管理タスク

Oracle Identity Manager拡張管理の「イベント管理 」セクションを使用して、次のイベント管理タスクを実行できます。

- イベントの検索

- イベントの詳細の表示

- イベント・アクションの決定

- イベントの再評価

- イベントのクローズ

- リコンシリエーション・イベントのリンク

1.2.1 イベントの検索

次のタイプの検索を実行して、リコンシリエーション・イベントのサマリーを表示できます。

- イベントの単純検索の実行

- イベントの拡張検索の実行

1.2.1.1 イベントの単純検索の実行

イベントの単純検索を実行するには:

1. Oracle Identity Manager拡張管理にログインします。

2. 「ようこそ」ページの「イベント管理」で、「リコンシリエーション・イベントの検索」をクリックします。あるいは、「イベント管理」タブをクリックし、次に「リコンシリエーション」をクリックします。

3. 左ペインで、「検索」フィールドに検索基準を入力します。検索基準にはワイルドカード文字(*)を使用できます。
単純検索では1つの引数が使用されます。テキスト引数は、次のイベント・フィールドで検索されます。

- イベントID

- プロファイル名

- キー・フィールド

注意:

単純検索では、イベント日で検索することはできません。

4. 「検索」フィールドの横のアイコンをクリックします。検索基準に一致するイベントが検索結果表に表示されます。
検索により、前述の属性に「検索」フィールドで指定した文字列が含まれるすべての行がフェッチされます。検索結果には、「イベントID」、「プロファイル名」および「キー・フィールド」列が表示されます。「イベントID」列にはイベントIDが表示されます。IDは文字列ではなく、整数値としてソートされます。「プロファイル名」列には、リコンシリエーション・プロファイルの名前が表示されます。「キー・フィールド」は、データの行を一意に識別する属性です。リコンシリエーションでは、一部の属性にプロファイル内のキーとしてフラグが付けられています。これらのフィールドが「キー・フィールド」列に表示されます。

注意:

「単純検索」では、検索結果はページで区切られ、一度に64行のみ表示されます。これは、パフォーマンス向上のためです。UI内で64行目を超えてスクロールするたびに、データベースからの別のページのフェッチがトリガーされます。

1.2.1.2 イベントの拡張検索の実行

拡張検索では複数の引数が使用され、イベントのリストを細かく調整できます。イベントの拡張検索を実行するには、次の手順に従います。

1. 「リコンシリエーション」セクションの左ペインで、「拡張検索」をクリックします。「検索: イベント」ページが表示されます。

2. 次のオプションのいずれかを選択します。

- すべて: このオプションを選択すると、検索はAND条件で実行されます。つまり、指定されたすべての検索基準を満たす場合のみ検索操作が成功します。

- いずれか: このオプションを選択すると、検索はOR条件で実行されます。つまり、指定された選択基準のいずれかに一致する場合に検索操作が成功します。

3. 「イベントID」フィールドに検索するイベントIDを入力します。検索基準にはワイルドカード文字を使用できます。「イベントID」フィールドに隣接するリストから検索条件を選択します。

4. 「検索: イベント」ページに表示される他のフィールドで検索引数を指定します。表1-1に、「検索: イベント」ページに表示されるフィールドのリストを示します。

表1-1 拡張検索フィールド

フィールド

説明

イベントID

イベントID。IDは文字列ではなく、整数値としてソートされます。

リソース名

イベントの発行元となるターゲット・システムを表すリソース・オブジェクトの名前。

現行のステータス

イベントの現在の状態を表す文字列。

タイプ

イベントによって実行される操作のタイプ。定期(追加または変更)と削除があります。

プロファイル名

このイベントに関連するリコンシリエーション・プロファイルの名前。

関連項目: リコンシリエーション・プロファイルについては、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのリコンシリエーション・プロファイルに関する項を参照してください。

エンティティ

このイベントに関連するOracle Identity Managerエンティティのタイプ。ユーザー、アカウント、ロール、ロール付与、ロール階層があります。

開始日

検索する一番古いイベント作成日。

終了日

検索する最新のイベント作成日

リンクされたユーザー・ログイン

イベントにリンクされたユーザーのログインIDを表す文字列。

キー・フィールド

リコンシリエーション・プロファイルでキー・フィールドとしてフラグが付いた、データ行を一意に識別するフィールド。

5. 「検索」をクリックします。検索結果として、「イベントID」、「リソース名」、「エンティティ」イベント・ステータス、「タイプ」、「プロファイル名」、「ジョブID」、「キー・フィールド」、「日付」列が表示されます。

検索結果から、クローズや再評価などのイベントのバルク・アクションを実行できます。また、特定のイベントの詳細を表示することもできます。

LDAPプロファイルを使用してイベントを検索するには、検索で次のldapプロファイルを使用します。

オブジェクト

プロファイル

ユーザー

LDAPUser

ロール

LDAPRole

ロール・メンバーシップ

LDAPRoleMembership

ロール階層

LDAPRoleHierarchy

1.2.2 イベントの詳細の表示

イベントに関連する詳細を表示するには:

- Oracle Identity Manager拡張管理の左ペインで、イベントのリストから、詳細を表示するイベントを選択します。

- 拡張検索結果表の「イベントID」列をクリックします。

- 「アクション」リストから、「参照」を選択します。「イベントの詳細」ページが表示されます。「イベントの詳細」ページのフィールドは、イベント・タイプとイベント・ステータスに基づいて動的に変更されます。あるいは、右ペインのイベントのサマリーからイベントを選択し、参照用の虫眼鏡アイコンをクリックして「イベントの詳細」ページを開くこともできます。

「イベントの詳細」ページのデータは、次のセクションに表示されます。

- イベント: このセクションには、イベントID、イベント・タイプが「ユーザー」と「アカウント」のどちらか、イベントが作成された時間、リコンシリエーション実行ID、リソース名、プロファイル名およびキー・フィールド値などのイベントに関する情報が表示されます。リコンシリエーションは複数のキー・フィールドを使用でき、キー・フィールド値はカンマで区切って表示されます。

- リンク先: このセクションは、イベントがユーザーまたはアカウントにリンクされていることを示します。ここにはイベントがリンクされているユーザーまたはアカウントのID、アカウントの説明(あれば)、およびルールベースのリンクか手動リンクかなどのリンクのタイプが表示されます。ルールベースのリンクは、リコンシリエーション・エンジンがリンクを実行したことを意味します。手動リンクは、管理者がリンクを手動で実行したことを意味します。

- メモ: リコンシリエーション・エンジンにより、必要に応じてメモが追加されます。たとえば、「データ検証に失敗しました」がある場合、エンジンはその理由を説明するメモを追加します。これは読取り専用フィールドで、イベントにメモが付加されていない場合は空欄です。

- リコンシリエーション・データ: この表には、リコンシリエーション・イベント・データが表示されます。これには、属性名、属性値およびOracle Identity Managerのマッピング・フィールドが表示されます。また、イベントの子データがある場合は、それも表示されます。リコンシリエーション・データには、姓、名、雇用日、ユーザーIDおよびITリソース名が表示されます。
複数言語をサポートする属性がある場合は、その属性値も子データと同様に個別の表に表示されます。

- 一致したアカウント: この表には、一致したアカウントが表示されます。「一致したアカウント」表の列を、表1-2に示します。

表1-2 「一致したアカウント」表の列

列

説明

アカウントID

一致したアカウントのアカウントID。

ORCキー

ORC表に格納されている内部キー。このキーは、イベントがユーザーまたはアカウントに一致しているかどうかを示します。

ディスクリプタ・フィールド

アカウントに関連付けられた説明。

ログインID

ユーザー・イベントに対して表示されるユーザーIDに対応したユーザー・ログインID。

アカウント所有者名

アカウントを所有するユーザーの姓と名およびログインIDからなる文字列。イベントはこのアカウントに関連します。

アカウント所有者タイプ

ユーザーなど、アカウント所有者のタイプ。

- 一致したユーザー: この表には、リコンシリエーション・エンジンによって検索されたユーザー一致が表示されます。複数一致する場合、リンクされたユーザーはこの表には表示されません。

- 履歴: この表には、イベント作成やデータ検証からアカウント一致まで、このイベントに対して発生する操作と、更新が正常に行われたどうかが示されます。表1-3に「履歴」表の列を示します。

表1-3 履歴」表の列

列

説明

ステータス

指定された日時のイベント・ステータス。

アクション

指定された日時のイベントで実行されたアクション。

ユーザーによって実行されたアクション

前述のアクションを実行したユーザーのIDとログインID。エンジンでは、デフォルトのIAM管理者ID: xelsysadm、ID = 1が使用されます。

日付と時間

前述のアクションの日時。

メモ

指定された日時のイベントに添付されたメモ。

注意:

Oracle Identity Managerでは、リコンシリエーション・フィールド名の翻訳はサポートされていません。

1.2.3 イベント・アクションの決定

イベントで可能なアクションは、イベントのステータス、タイプおよび操作によって異なります。表1-4に、イベントのタイプおよびステータス別に可能なアクションを示します。

表1-4 イベントのステータスおよびタイプ別のアクション

イベント・ステータス

イベント・タイプ

可能なアクション

一致が見つかりません

ユーザー

イベントのクローズ

リコンシリエーション・ルールの再適用

エンティティの作成

非定型リンク

アカウント

イベントのクローズ

イベントの再評価

非定型リンク

ユーザーが一致しました

ユーザー

イベントのクローズ

リコンシリエーション・ルールの再適用

リンク

アカウント

イベントのクローズ

リコンシリエーション・ルールの再適用

リンク

アカウントが一致しました

アカウント

イベントのクローズ

リコンシリエーション・ルールの再適用

リンク

イベントを受信しました

任意

イベントのクローズ

可能なアクションについては、以降のセクションで説明します。

1.2.4 イベントの再評価

イベントの再評価は、リコンシリエーション・ルールをイベントに再適用することを意味します。リコンシリエーション・ルールは、イベントの所有者を識別するために使用する一致ルールを参照します。たとえば、Oracle Identity Manager Design Consoleを使用してリコンシリエーション・ルールを変更した場合、Oracle Identity Manager拡張管理の「イベント管理」セクションでルールを再評価できます。

イベントを再評価するには:

1. イベントのリストから、イベントを選択します。複数のイベントを同時に再評価する場合は、[Ctrl]キーを押しながら複数のイベント行を選択できます。

2. 「アクション」リストから、「イベントの再評価」を選択します。選択したイベントIDが「イベントの再評価」ダイアログ・ボックスに表示されます。

3. 「実行」をクリックします。リコンシリエーション・ルールがイベントに正常に再適用されたことを示す確認メッセージが表示されます。選択したアクションがいずれかのイベントで失敗した場合は、バルク処理に失敗したイベントIDを示す一般メッセージが表示されます。このような場合は、イベントを一度に1つずつ処理します。

注意:

- 処理前の検証では、再評価が有効なイベントと無効なイベントがリストされます。「実行」をクリックすると、有効なイベントのみが再評価されます。

- イベント履歴表ですべてのイベント・アクションがトラッキングされます。

1.2.5 イベントのクローズ

このアクションは、選択されたイベントをクローズまたは破棄し、イベントをそれ以降の処理キューから削除します。イベントをクローズするには、次の手順を実行します。

1. イベントのリストから、イベントを選択します。

2. 「アクション」リストから、「イベントのクローズ」を選択します。、[Ctrl]キーを押しながら複数のイベント行を選択すると、複数のイベントを一度にクローズできます。「イベントのクローズ」ダイアログ・ボックスが表示されます。

注意:

イベントのクローズが有効なオプションでない場合は、「イベントのクローズ」ダイアログ・ボックスにエラー・メッセージが表示されます。

3. 「理由」ボックスに、イベントをクローズする理由を入力します。

4. 「実行」をクリックします。イベントがクローズされることを示す確認メッセージが表示されます。選択したアクションがいずれかのイベントで失敗した場合は、バルク処理に失敗したイベントIDを示す一般メッセージが表示されます。このような場合は、イベントを一度に1つずつ処理します。

注意:

- イベント履歴表ですべてのイベント・アクションがトラッキングされます。

- イベントのクローズ操作では、理由を入力する必要があります。そのため、バルク操作を実行して複数のイベントを一度にクローズする場合は、クローズされるすべてのイベントが同じ理由になります。

1.2.6 リコンシリエーション・イベントのリンク

Oracle Identity Managerでは、次の操作を実行してリコンシリエーション・イベントをリンクできます。

- 非定型リンク

- 手動リンク

- 孤立アカウントのリンク

1.2.6.1 非定型リンク

非定型リンクにより、イベントをOracle Identity Managerの任意のユーザーまたはロールにリンクできます。リコンシリエーション・エンジンによってそのイベントに対するユーザー一致が検出された場合でも、この非定型リンク機能を使用して、ユーザーはその一致を無視して別のユーザーを選択できます。これにより、リコンシリエーション一致ルールが正しく機能しない場合に誤った一致によって生じる例外を処理できます。

このアクションにより、すでに一致しているエンティティ以外のエンティティにイベントをリンクできます。つまり、「一致したユーザー」表から行を選択するかわりに、別のユーザーを選択してイベントにリンクできます。

イベントに対して非定型リンクを作成するには:

1. 「イベントの詳細」ページで、「アクション」リストから「非定型リンク」を選択します。「非定型リンク」ダイアログ・ボックスが表示されます。

2. 検索基準を指定してユーザー検索を実行します。

3. 検索結果からユーザーを選択し、「実行」をクリックします。イベントとの非定型リンクが正常に行われたことを示す確認メッセージが表示されます。

1.2.6.2 手動リンク

リコンシリエーション・イベントが複数一致する場合は、各一致が「イベントの詳細」ページの「一致したアカウント」タブ(アカウント・エンティティの場合)または「一致したユーザー」タブ(ユーザー・エンティティの場合)に表示されます。リコンシリエーション・エンジンで検出されたすべての一致からいずれかの一致を手動で選択できます。手動リンクを実行するには、次の手順に従います。

注意:

手動リンクでは、Oracle Identity Managerの全ユーザーのリストから一致を選択するかわりに、リコンシリエーション・エンジンによって検出された一致のリストから選択します。

1. 「イベントの詳細」ページで、リコンシリエーション・エンジンによって検出されたすべての一致がリストされている表から行を選択します。

2. 「リンク」をクリックします。確認を求めるメッセージが表示されます。

3. 「 OK 」をクリックして続行します。

1.2.6.3 孤立アカウントのリンク

孤立アカウントとは、ターゲット・システムのアカウントで、Oracle Identity Managerにそれに対応するユーザーが存在しないものを指します。

Oracle Identity Managerに一致するユーザーがいないか、複数のユーザーが一致する孤立アカウントのイベントを解決できます。そのために、次のいずれかを実行できます。

- Oracle Identity Managerでユーザーを再作成する

- プロビジョニング・プロセスをトリガーして、ターゲット・システムからユーザーまたはアカウントを削除する

- 非定型または手動リンクを実行する

次のシナリオでは、「イベント管理」セクションを使用して正しい一致ユーザーを選択することで、孤立アカウントを解決できます。

- 複数の一致があるイベントの場合

- 一致のないイベントの場合

1.2.6.3.1 複数の一致があるイベントの場合

リコンシリエーション・エンジンにより複数のユーザーがイベント・データに一致された場合は、非定型または手動リンクを使用して正しいユーザーを選択する必要があります。

非定型リンクについては、「非定型リンク」を参照してください。

手動リンクについては、「手動リンク」を参照してください。

1.2.6.3.2 一致のないイベントの場合

イベントに一致が検出されない場合は、エンティティ作成をトリガーするか、Oracle Identity Managerのエンティティを選択してイベントにリンクします。Oracle Identity Managerのエンティティを選択してイベントにリンクする方法は、「非定型リンク」を参照してください。

1.3 リコンシリエーション・プロファイルの手動による更新

リコンシリエーション・プロファイルの手動による作成と更新について、次の各項で説明します。

- 新しいリコンシリエーション・プロファイルの作成

- リコンシリエーション・プロファイルの更新

- プロファイル・モードの変更

1.3.1 新しいリコンシリエーション・プロファイルの作成

次のシナリオではリコンシリエーション・プロファイルを作成することもできます。

- リソース・オブジェクトに基づいたリコンシリエーション用のデフォルト以外の追加プロファイルの作成

- 信頼できるソースのリコンシリエーション用の新しいプロファイルの作成

1.3.1.1 リソース・オブジェクトに基づいたリコンシリエーション用のデフォルト以外の追加プロファイルの作成

リソース・オブジェクトに基づいたリコンシリエーションでは、デフォルトのプロファイル名は、リソース・オブジェクトの名前と同じです。たとえば、リソース・オブジェクト名がtestresourceとすると、デフォルトのプロファイル名もtestresourceになります。対応するリコンシリエーション水平表の名前は、RA_TESTRESOURCE<obj_key>です。リソースにマルチ言語サポート(MLS)データがない場合は、MLS表の名前は、RA_MLS_TESTRESOURCE<obj_key>です。

リソース・オブジェクトに子表がある場合は、各子フォーム名UD_xxxに対して、対応するRA_UD_xxがあります。各表には対応するエンティティ定義XMLファイルがあり、プラットフォームのドキュメントに従って、MDS記憶域に格納されます。そのため、RA_MLS_TESTRESOURCE<obj_key>には、/db/RA_TESTRESOURCE<obj_key>.xmlという名前のエンティティ定義MDSドキュメントがあり、プラットフォームのドキュメントに従って、MDS記憶域に格納されます。

注意:

リソース・オブジェクトの名前を変更した場合は、Oracle Identity Manager Design Consoleでオブジェクト・リコンシリエーション・タブのリコンシリエーション・プロファイルの作成ボタンをクリックして、リコンシリエーション・プロファイルを再生成する必要があります。

リソース・オブジェクトに基づいたリコンシリエーション用のデフォルト以外のプロファイルを作成するには:

注意:

MDSエクスポート/インポート・ユーティリティを使用して、MDSに対してファイルをエクスポートまたはインポートすることができます。このユーティリティは、weblogicExportMetadata.shおよびweblogicImportMetadata.shスクリプトを実行することによって実行します。これらのスクリプトの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

1. エクスポートされたプロファイルXMLファイルのコピーを別の名前で作成します。

2. 新しいプロファイル名、水平表名、新しいリコンシリエーション・フィールド名およびマッピングに合わせて、ファイルを修正します。

3. MDSインポート・ツールを使用して、新しいプロファイルをMDSにインポートします。

4. エンティティ定義XMLファイルを、新しいプロファイル名に基づいた新しい名前でコピーします。リコンシリエーション・フィールド名も変更した場合は、新しいリコンシリエーション・フィールド名に合わせてXMLファイルを修正します。

5. MDSインポート・ツールを使用して、エンティティ定義XMLファイルをMDSにインポートします。

6. 新しいプロファイル名に基づいて、データベースに新しい水平表を作成します。

1.3.1.2 信頼できるソースのリコンシリエーション用の新しいプロファイルの作成

信頼できるソースのリコンシリエーションに新しいプロファイルを作成する手順は、「リソース・オブジェクトに基づいたリコンシリエーション用のデフォルト以外の追加プロファイルの作成」の手順と同様です。唯一の違いは、信頼できるソースのリコンシリエーションはリソース・オブジェクトに関連付けることも関連付けないこともできる点です。したがって、LDAPUserプロファイルに対応するXMLファイルをサンプルとして使用できます。

1.3.2 リコンシリエーション・プロファイルの更新

リコンシリエーション・プロファイルのプロパティ、たとえばバッチ・サイズを変更するには:

1. MDSから/db/PROFILE_NAMEプロファイル・ドキュメントをエクスポートします。

2. XMLファイルを修正します。たとえば、バッチ・サイズの値を変更します。

3. MDSインポート・ツールを使用して、更新されたプロファイルをMDSにインポートします。

1.3.3 プロファイル・モードの変更

次のいずれかの方法を使用して、プロファイル・モードのプロパティをCHANGELOGからREGULARに変更できます。

関連項目:

変更ログおよび定期リコンシリエーション・モードの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのリコンシリエーションのモードに関する項を参照してください。

- たとえば次のようにして、プロファイルでモード属性の値を変更します。

<generalconfig mode="REGULAR"
createEntityUsingSPFlag="true"
dateFormat="yyyy/MM/dd hh:mm:ss z"
ownerMatchingRuleWhereClause="
(UGP.ugp_ldap_guid=RA_SAMPLE_HIERARCHY.RECON_ROLE_GUID)"
entitytype="RoleRole"
version="1.0"
trustedSrcFlag="false"
accountPostProcessingRequiredFlag="NOT_SET"
sequentialProcessingFlag="false"
batchSize="-1"
retryInterval="30"
maxRetryCount="5"
defaultProfileFlag="true"
name="sample-hierarchy"/>

- 次の方法で、イベント作成時に属性を変更します。
Oracle Identity Manager 11g リリース1(11.1.1)で導入されたイベント作成APIには、3つのパラメータが含まれています。最初の2つのパラメータは、以前の作成イベントAPIで使用されるパラメータと同じです。3番目のパラメータは、dateFormat、changeType、eventFinished、actionDateなどの属性を持つことができます。

このAPIを使用してchangeTypeを次のように設定できます。

public long createReconciliationEvent(String objName, Map<String, Object>inputData, EventAttributes eventAttribs);

注意:

APIを使用したchangeType属性の設定は、プロファイルで設定されたchangeType属性の値より優先されます。

1.4 RECON_EXCEPTIONS表へのデータ移入

Oracle Identity Managerデータベース内のRECON_EXCEPTIONS表は、アカウント・リコンシリエーション中に生成されるエラー・メッセージを取得するために使用されます。このデータは、レポートの生成目的で収集されます。

関連項目:

アカウント・リコンシリエーションの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのアカウント・リコンシリエーションに関する項を参照してください。

リコンシリエーションが削除されたユーザーに一致することが検出された場合は、USER_DELETEDをREX_EXCEPTION列に、削除されたユーザーのキーをRECON_EXCEPTIONS表のUSR_KEY列に挿入する必要があります。

一致が検出されなかった場合は、USER_NOT_FOUNDをREX_EXCEPTION列に挿入します。

アカウント一致が検出された場合は、アカウントがすでにプロビジョニング解除されているかどうかチェックします。それからプロビジョニングされるユーザーに対して、RECON_EXCEPTIONS表のREX_EXCEPTION列に値RESOURCE_DEPROVISIONEDを挿入します。

RECON_EXEPTIONS表に例外データを移入するには:

1. 変更タイプ!= ('Modify' , 'Delete')でイベント・ステータスが('Single User Match Found', 'Single Org Match Found')のイベントをすべてフェッチします。

2. 次の手順を実行して、エンティティに対してリソース・オブジェクトをプロビジョニングします。

1. RECON_EXCEPTION DB表から例外データを収集します。これを行うには、次のいずれかを実行します。

- XL.EnableExceptionReportsプロパティの値がTRUEかどうかをチェックします。これがTRUEに設定されている場合は、次のステップに進みます。そうでない場合は、例外データを収集しないでください。

- プロビジョニングされたリソース・オブジェクトに対してobj表のobj_initial_recon_dateを選択し、今日の日付以前かどうかチェックします。以前の日付が表示される場合は、次のステップに進みます。そうでない場合は、例外データを収集しないでください。

2. リソース・オブジェクトをユーザーにプロビジョニングするときには、Oracle Identity Managerでリソース・オブジェクトがすでにプロビジョニング解除されているかどうかチェックします。:

- リソース・オブジェクトがすでにプロビジョニング解除されている場合は、プロビジョニングされるユーザーに対して、RECON_EXCEPTIONS表のREX_EXCEPTION列に値RESOURCE_DEPROVISIONEDを挿入します。

- リソース・オブジェクトがプロビジョニング解除されていない場合は、プロビジョニングされるユーザーに対して、RECON_EXCEPTIONS表のREX_EXCEPTION列に値RESOURCE_NEVER_PROVISIONEDを挿入します。

2 スケジュール済タスクの管理

Oracle Identity Managerでは、さまざまなアクティビティを管理するために、ジョブを指定された時間に定期的に実行する必要があることがよくあります。スケジューラにより、事前定義済のスケジュール済タスクを指定された時間に自動的に実行するジョブをスケジュールできます。これについて、次の例で説明します。

組織のセキュリティ・ポリシーを満たすために、従業員が製品アプリケーションのパスワードを60日ごとに変更する必要があるとします。このために、システム管理者は、製品アプリケーションのパスワードが期限切れになったすべての従業員に、電子メールが送信されるようにする必要があります。1つの方法は、パスワードが期限切れになったユーザーのセットを識別し、各従業員に手動で電子メールを送信することです。また別の方法として、システム管理者は、スケジューラなどのサービスを使用することもできます。Oracle Identity Managerには、パスワード警告タスクと呼ばれる、事前定義済のスケジュール済タスクがあります。システム管理者は、このスケジュール済タスクを使用し、意図したスケジュールでスケジュール済ジョブを作成できます。

関連項目:

パスワード警告タスクの詳細は、表2-2「事前定義済のスケジュール済タスク」を参照してください。

スケジューラを使用して、設定された時間にジョブで実行されるようにする独自のスケジュール済タスクを作成することもできます。

スケジュール済タスクは、実行されるジョブのメタデータと、そのタスクの実行に必要なパラメータを構成したものです。このメタデータは、事前定義済タスク用に事前定義されています。ユーザーは新規タスクを追加して新規メタデータを構成したり、既存タスクを更新して他の構成詳細用にパラメータの追加や更新を行うこともできます。ジョブは、指定された間隔で実行されるようにスケジュールできます。異なる時間間隔で実行するようにスケジュールされた複数のジョブを作成できます。ジョブ実行とは、ジョブの特定の実行のことです。各ジョブ実行には開始時間、停止時間、例外および実行のステータスなどの情報が含まれます。

この章の内容は、次のとおりです。

- oim-config.xmlファイルの構成

- スケジューラの起動と停止

- スケジュール済タスク

- ジョブ

2.1 oim-config.xmlファイルの構成

Oracle Identity Managerのインストール後に、メタデータ・ストア(MDS)の次の場所にあるoim-config.xmlファイル内のScheduler要素の子要素を編集して、スケジューラ設定を構成できます。

db/oim-config.xml

関連項目:

MDSに対するデータのインポートとエクスポートの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

表2-1に、oim-config.xmlファイルのScheduler要素内で構成できるデフォルトの要素をリストします。

注意:

新しい構成可能な子要素を追加できます。新しい子要素については、次のURLを参照してください。

http://www.quartz-scheduler.org/

表2-1 Scheduler要素の子要素

Scheduler要素内の要素

説明

DSJndiURL

この要素は、アプリケーション・サーバーでトランザクション・データ・ソースの構成に使用されます。これは接続を確立するためにQuartzによって使用されます。

デフォルト値: jdbc/operationsDB

nonTxnDSJndiURL

この要素は、アプリケーション・サーバーでの非トランザクション・データ・ソースの構成に使用されます。これは接続を確立するためにQuartzによって使用されます。

デフォルト値: jdbc/oimJMSStoreDS

Clustered

Oracle Identity Managerがクラスタ環境にインストールされている場合は、trueを入力します。そうでない場合は、falseを入力します。

デフォルト値: true

注意: クラスタ環境では、クラスタのすべてのノードの時計を同期させる必要があります。

implementationClass

スケジューラを実装するJavaクラスの名前を入力します。

デフォルト値: oracle.iam.scheduler.impl.quartz.QuartzSchedulerImpl

instanceID

この要素に一意の文字列値を入力します。この値は、Oracle Identity Managerスケジューラ・インスタンスを一意に識別する文字列を表します。

注意: クラスタ環境では、クラスタの各ノードが一意のInstanceIdを持つ必要があります。これを達成するには、InstanceId要素に値AUTOを入力します。

startOnDeploy

Oracle Identity Managerの起動時にスケジューラ・サービスを自動的に起動しないようにするには、falseを入力します。そうでない場合は、trueを入力します。

デフォルト値: true

threadPoolSize

この要素に整数値を入力します。この値は、ジョブの実行に使用する必要があるスレッド数を表します。

デフォルト値: 10

2.2 スケジューラの起動と停止

「スケジューラのステータス」ページは、スケジューラの現在のステータスを表示する認証されたUIページです。指定されたどのインスタンスでも、スケジューラのステータスは次のいずれかになります。

- 起動済
スケジューラが起動済ステータスの場合は、ジョブをスケジュールでき、すでにスケジュールされているジョブは、スケジュールされた時間に実行を継続します。

- 停止済
スケジューラが停止済ステータスの場合は、すべてのジョブが停止されます。ジョブの実行中にスケジューラが停止済ステータスになると、現在実行中のジョブが停止されます。また、実行するようスケジュールされているジョブは実行されませんが、実行のための発行はスケジュールに従って行われます。後でスケジューラ・サービスが起動されたときに、すべての発行済ジョブが実行されます。

「スケジューラのステータス」ページの「最後のエラー 」フィールドには、詳細なエラー・メッセージも表示されます(ある場合)。

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

Oracle Identity Managerのインストール後、スケジューラのステータスはデフォルトで起動済になっています。ただし、何らかの理由でスケジューラを停止して再起動する場合は、この項で説明する手順に従う必要があります。

スケジューラを起動または停止するには:

注意:

- スケジューラを起動または停止するには、スケジューラ管理者ロールが必要です。

- クラスタ環境では、この手順をクラスタの各ノードで実行する必要があります。

1. Webブラウザを使用して次のURLにアクセスします。
http://OIM_HOST:OIM_PORT/SchedulerService-web/status

このURLで、OIM_HOSTはOracle WebLogic Application Serverをホストするコンピュータの名前を表し、OIM_PORTはサーバーがリスニングしているポートを参照します。Oracle WebLogic Application Serverのデフォルトのポート番号は7001です。

2. ユーザーIDとパスワードを入力し、「OK」をクリックします。
「スケジューラのステータス」ページが表示されます。

注意:

シングル・サインオン環境で作業している場合は、スケジューラ・サービスに自動的にログインされることがあります。

3. 実行するアクションのタイプに応じて、次のいずれかをクリックします。

- START: スケジューラを起動するには、このボタンをクリックします。

- STOP: スケジューラを停止するにはこのボタンをクリックします。これにより、スケジューラおよびさらなるトリガーの実行が停止されますが、すでに実行されているジョブは停止も中断もされません。スケジューラ・サービスが再開されると、ジョブはスケジュールに従って適切な時間に実行されます。

- REINIT: このボタンをクリックすると、スケジューラを再初期化します。スケジューラを再初期化すると、スケジューラが再起動されます。

2.3 スケジュール済タスク

Oracle Identity Managerでは、メタデータはデフォルトのスケジュール済タスク用に事前定義されています。ユーザーは新しいメタデータを含む新しいタスクを追加したり、既存のタスクを更新してパラメータやその他の構成詳細を追加または更新したりできます。

たとえば、ターゲット・システムで定期的に新しい情報をチェックしてOracle Identity Managerに同じものを複製するスケジュール済タスクを使用して、リコンシリエーション実行を構成できます。各スケジュール済タスクは、次のメタデータ情報を含みます。

- スケジュール済タスクの名前

- スケジュール済タスクを実行するJavaクラスの名前

- 説明

- 再試行

- (オプション)スケジュール済タスクを受け入れるパラメータ。各パラメータには次の追加情報が含まれます。

- 名前

- データ・タイプ

- 必須/オプション

- ヘルプ・テキスト

- 暗号化

この項の内容は次のとおりです。

- 事前定義済のスケジュール済タスク

- LDAPスケジュール済タスク

- カスタムのスケジュール済タスクの作成

2.3.1 事前定義済のスケジュール済タスク

Oracle Identity Managerのこのリリースには、ジョブの作成または操作中に使用可能な事前定義済のスケジュール済タスク・セットが用意されています。表2-2に、事前定義済のスケジュール済タスクのリストを示します。

表2-2 事前定義済のスケジュール済タスク

ジョブ名

説明

ユーザー構成可能属性

デフォルトで有効化

パスワード期限切れタスク

このスケジュール済タスクは、タスクが実行された時点でパスワードの有効期限を経過していたユーザーに電子メールを送信し、ユーザー・プロファイルのUSR_PWD_EXPIREDフラグを更新します。

電子メール定義名: パスワード有効期限切れ通知をユーザーに送信するために、Design Consoleで作成された電子メール定義の名前。デフォルト値は「パスワード期限切れ」です。

はい

パスワード警告タスク

このスケジュール済タスクは、タスクが実行された時点でパスワードの警告日を経過しているユーザーに電子メールを送信し、ユーザー・プロファイルのUSR_PWD_WARNEDフラグを更新します。

電子メール定義名: パスワード有効期限切れ警告通知をユーザーに送信するために、Design Consoleで作成された電子メール定義の名前。デフォルト値は「パスワードの期限切れ警告」です。

いいえ

ユーザー操作

このスケジュール済タスクは、UserLogin属性で指定されたユーザー・アカウントで、UserOperation属性により指定された操作を実行します。

- UserLogin: ユーザー・アカウントのユーザーID

- UserOperation: ユーザー・アカウントで実行する操作。この属性の値は、「有効化」、「無効化」、「削除」のいずれかです。

いいえ

アテステーション猶予期間期限切れチェッカー

このスケジュール済タスクは、猶予期間の満了後にアテステーション・プロセスを委任します。

なし

はい

タスクのエスカレーション

このスケジュール済タスクは、スケジュール済タスクが実行された時点でエスカレーション時間が経過している保留タスクをエスカレーションします。

なし

はい

時間経過タスクの再試行

このスケジュール済タスクは、再試行時間が経過し、再試行回数が1以上の却下されたタスクに対して再試行タスクを作成します。

なし

はい

ユーザーのプロビジョニング解除された日を設定

プロビジョニング解除日は、ユーザー・アカウントの作成時に定義されます。このスケジュール済タスクの実行時点でプロビジョニング解除日が経過していたユーザーに対して、現在の日付をプロビジョニング解除された日付として設定します。

なし

はい

終了日後のユーザーを無効化/削除

終了日は、ユーザー・アカウントの作成時に定義されます。このスケジュール済タスクは、タスクの実行時点で、ユーザー・アカウントの終了日が現在の日付よりも過去の日付である場合、ユーザー・アカウントを無効にします。

注意: このスケジュール済タスクを30分または1時間ごとに実行することをお薦めします。

なし

はい

ユーザーのプロビジョニングされた日を設定

このスケジュール済タスクは、次の条件にすべて該当するユーザーについて、プロビジョニングされた日を現在の日付に設定します。

- プロビジョニング日が過去の日付です。

- プロビジョニング解除された日が設定されていません。

- プロビジョニング解除日に達していないか、NULLです。

なし

はい

開始日後のユーザーを有効化

開始日は、ユーザー・アカウントの作成時に設定されます。このスケジュール済タスクは、開始日を経過しており、ユーザー・ステータスが「開始日まで無効」であるユーザー・アカウントを有効にします。ユーザーはこのスケジュール済タスクを介して有効化され、ユーザーがアクティブになります。

なし

はい

オープン・タスクの削除

このスケジュール済タスクは、オープン・タスクに関する情報を、Oracle Identity Manager 管理およびユーザー・コンソールに表示されるリストのソースとして機能する表から削除します。

日数制限

オープン・タスクに関する情報を削除するまで表に保持しておく必要のある日数。

デフォルトでは、この属性は指定されず、無効になっています。時間を有効にして構成する必要があります。

いいえ

監査メッセージ発行タスク

このスケジュール済タスクは、監査メッセージの詳細をaud_jms表からフェッチし、aud_jms表の特定の識別子および監査者のエントリについてJMSメッセージを1つ送信します。MDBで対応する監査メッセージが処理されます。

最大レコード数: この属性を使用し、指定されたスケジュール済タスクの実行について処理される監査メッセージの最大数を指定します。この属性のデフォルト値は、400です。

はい

アテステーション・プロセスの起動

このスケジュール済タスクは、アテステーション・エンジンを呼び出し、経過した時間に実行するようスケジュールされているアテステーション・プロセスを実行します。

なし

はい

リクエスト実行スケジュール済タスク

これは、ステータスが「リクエストが完了待ちです」のリクエストを定期的に検索するスケジュール済タスクで、リクエスト発行時に設定された有効日が現在日以前の場合は、リクエストを次の段階「操作が開始されました」に進めます。

ジョブ周期設定: この属性を使用して、スケジュール済タスクを実行する時間間隔を指定します。

デフォルト値は6時間です。

はい

失敗した非同期タスクの自動再試行

このスケジュール済タスクは、失敗した非同期タスク(JMSメッセージ)を再試行します。タスクの実行が成功すると、失敗タスクのリストから削除されます。失敗すると、再試行回数を1つ増やします。失敗タスクを再試行する最大回数は、async-messaging.xmlでそのタスクに対して定義されているmaxRetriesによって決まります。

なし

はい

ユーザー・ポリシーの評価

このスケジュール済タスクは、アクセス・ポリシーを再評価します。

スレッド数: この属性を使用して、再評価を処理するスレッドの合計数を指定します。

デフォルト値は20です。

バッチ・サイズ: この属性を使用して、1つのイテレーションで処理されるデータベースからのレコード数をフェッチします。

デフォルト値は500です。

時間制限(分): この属性を使用してスケジュール・タスクを停止するまでの時間を分単位で指定します。

デフォルトでは、この属性は指定されず、無効になっています。時間を有効にして構成する必要があります。

いいえ

ユーザーの自動ロック解除

このスケジュール済タスクは、指定された日数後にユーザーを自動的にロック解除します。

なし

はい

ユーザーの遅延削除

このスケジュール済タスクは、削除日が今日に設定されているユーザーを自動的に削除します。このスケジュール済タスクは、ユーザーが削除されたときにユーザーが無効状態になる期間を示すXL.UserDeleteDelayPeriodシステム・プロパティを読み取ります。このスケジュール済タスクは、この期間が経過したすべてのユーザーを検出し、ユーザーを削除済としてマークします。

注意: XL.UserDeleteDelayPeriodシステム・プロパティの詳細は、「Oracle Identity Managerのシステム・プロパティ」を参照してください。

Oracle Identity Manager 11g リリース1(11.1.1.5)では、このスケジュール済タスクはデフォルトでアクティブではありません。Oracle Identity Manager 11g リリース1(11.1.1.3)では、このスケジュール済タスクはデフォルトでアクティブです。ただし、Oracle Identity Managerをリリース1(11.1.1.3)からリリース1(11.1.1.5)にアップグレードした場合、このスケジュール済タスクの状態は変化しません。

注意: このスケジュール済タスクを頻繁に実行することをお薦めします(たとえば、1時間ごと)。

なし

いいえ

エンタイトルメント割当て

このスケジュール済タスクは、「エンタイトルメント」フィールドがtrueとしてマークされている子プロセスフォーム表からエンタイトルメント割当てスキーマを移入します。

RECORDS_TO_PROCESS_IN_BATCH: バッチで処理するレコード数。

いいえ

エンタイトルメント・リスト

このスケジュール済タスクは、子プロセス・フォームのフィールド「エンタイトルメント」がtrueとしてマークされている参照表から「エンタイトルメント」スキーマを移入します。

なし

いいえ

エンタイトルメント更新

このスケジュール済タスクは、ユーザーに対してエンタイトルメントが追加、更新または削除された時点で、指定されたユーザーのエンタイトルメント割当てデルタ表に対して「エンタイトルメント」割当て表を移入します。

なし

いいえ

SODチェック結果承認の取得

このスケジュール済タスクは、SoDサーバー、たとえば、OAACG、SAP、GRCから、SoDチェック結果待ちのすべてのリクエストに対してSoD評価結果を返します。これにはSoDCheckResultと該当するデータセット属性の違反が反映されます。「SoDチェック結果が保留中です」状態で、「SoDチェックが完了しました」としてマークされているすべてのリクエストが選択されます。

なし

いいえ

SODチェック結果プロビジョニングの取得

このスケジュール済タスクは、保留中のすべてのSoDCheckプロビジョニング・タスクに対して、SoDサーバー、たとえばOAACG、SAP、GRCからのSoD評価の結果を返します。これにはSoDCheckResultおよび該当するプロセス・フォーム属性の違反が反映されます。

なし

いいえ

非スケジュール・バッチ・リコンシリエーション

このスケジュール済タスクは、PeopleSoftなど、スケジュールされていないタスクをベースとしたコネクタによって作成されたすべてのイベントの処理を試みます。このようなコネクタによって作成されたイベントは、「イベントを受信しました」または「データを受信しました」のいずれかの状態で、イベント・セットによって指定されたバッチ・サイズに達した場合またはこのスケジュール済タスクを介してのみ処理されます。このタスクは、設定に従って、未処理のスケジュールされていないタスクをベースとしたイベントをすべて選択し、それらを処理するためにリコンシリエーション・エンジンに送信します。

なし

いいえ

編成プロセス削除タスク

このスケジュール済タスクは、完了したすべての親編成プロセスを削除します。

バッチ・サイズ: この属性を使用して、繰返しごとに削除される完了済編成プロセスの数を指定します。

1つのバッチのみ削除: この属性を使用して、値trueまたはfalseを指定します。trueを指定すると、単一バッチのみが削除されます。falseを指定すると、すべての完了済イベントが一度にバッチで削除されます。

はい

マテリアライズド・ビューのリフレッシュ

マテリアライズド・ビューは、リコンシリエーションに関連するレポートの生成に使用されます。このビューは定期的に(指定された間隔で、たとえば1日に1回)更新する必要があります。そのため、ビューを定期的に更新するために、このスケジュール済タスクが作成されました。

なし

いいえ

開始されていない承認SODチェックの再送信

このスケジュール済タスクは、SoDCheckStatusが「SoDチェックが開始されていません」または「SoDチェックがエラーで完了しました」である保留リクエストのSoDチェックを開始しようとします。保留リクエストとは、最初の試行でSoDの開始に失敗し、特定の承認レベルを得るために保留になっているリクエストです。

なし

いいえ

開始されていないプロビジョニングSODチェックの再送信

このスケジュール済タスクは、すべての保留中のSoDCheckプロビジョニング・タスクに対してJMSメッセージを送信することにより、SoDチェックの開始を試みます。SoDチェックの開始は、ダイレクト・プロビジョニングによるエンタイトルメントの追加/更新時にSoDサーバーがダウンしていると失敗する可能性があります。

なし

いいえ

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

このスケジュール済タスクは、ステータスが「失敗」に設定されているユーザーに対して、失敗したリコンシリエーション・イベントを処理します。

なし

はい

将来日付のリコンシリエーション・イベントを実行

このスケジュール済タスクは、ステータスが遅延に設定されているユーザーに対して、現在日のリコンシリエーション・イベントを処理します。

なし

いいえ

ジョブ履歴のアーカイブ

このスケジュール済タスクは、ジョブ履歴のエントリをアーカイブまたはパージするために設計されたものです。

アーカイブ日: この属性を使用して、レコードをアーカイブまたはパージする期限日を指定します。

バッチ・サイズ: この属性を使用して、レコードを処理するバッチのサイズを指定します。

操作タイプ: この属性を使用して操作タイプを指定します。アーカイブまたはパージのいずれかの値を指定します。

デフォルト値は、アーカイブです。

いいえ

バルク・ロードの後処理

このスケジュール済タスクは、バルク・ロード・ユーティリティの後処理ジョブを開始します。

- レコード処理のバッチ・サイズ: ユーザー・レコードは、バッチで処理されます。この属性はバッチのサイズを指定するため、値を持っている必要があります。デフォルトは500です。

- パスワードの生成: この属性は、バルク・ロード・ユーティリティでユーザーが作成されたときに、パスワードを自動的に生成するかどうかを指定します。値としてYesまたはNoを持っている必要があります。デフォルトはYesです。

- Ldap同期: この属性は、バルク・ロード・ユーティリティを使用してOracle Identity Managerで作成したユーザーを、LDAPが有効化されている環境のLDAPリポジトリにも作成するかどうかを指定します。この属性は値としてYesまたはNoを持っている必要があります。デフォルトはNoです。

- 通知: この属性は、バルク・ロード・ユーティリティを使用して作成されたユーザーが、電子メールで通知されるかどうかを指定します。値としてYesまたはNoを持っている必要があります。デフォルトはYesです。

- ユーザーIDの処理: この属性は、処理が必要なユーザー・キー(Oracle Identity Manager Database内)の範囲を指定します。これらのキーは、バルク・ロード・ユーティリティを使用して作成されたユーザーと関連付けられます。これは、開始(From:)から終了(To:)までの範囲を定義します。

いいえ

バルク・ロードのアーカイブ・ジョブ

このスケジュール済タスクは、バルク・ロードの後処理中に使用された、Oracle Identity Managerデータベース・ステージング表内の処理済エントリをクリーンアップします。

- アーカイブ日: この属性は、レコードをパージする期限日を指定します。これは値を持っている必要があります。形式は、ddMMyyyyまたはMMM dd, yyyyです。

- バッチ・サイズ: データベース・レコードは、バッチでクリーンアップされます。この属性はバッチのサイズを指定するため、値を持っている必要があります。デフォルトは1000です。

いいえ

失敗した編成の再試行

このスケジュール済タスクは、指定された属性値に基づき、失敗した編成すべてを再試行します。パラメータ値が定義されていない場合、編成は再試行されません。

- 編成ID: この属性は、再試行する編成IDのカンマ区切りのリストを取得します。

- エンティティ・タイプ: 指定されたエンティティに発行された編成が再試行されます。

- 操作: 指定された操作に発行された編成が再試行されます。

- ステージ: 指定されたステージに対する編成が再試行されます。

- 開始日: 指定された日付より後に発行された編成が再試行されます。形式は、ddMMyyyyまたはMMM dd, yyyyです。

- 終了日: 指定された日付より前に発行された編成が再試行されます。形式は、ddMMyyyyまたはMMM dd, yyyyです。

いいえ

失敗したオフライン・メッセージの削除

このスケジュール済タスクは、失敗したオフライン・プロビジョニング・メッセージをOPS表から削除するために使用します。

より古い失敗したメッセージの削除(日付)

いいえ

DataCollectionスケジュール済タスク

このスケジュール済タスクは、Oracle Identity Managerの操作表からのデータをステージング表にオフラインで移入するために使用します。このスケジュール済タスクは手動で実行するようになっていて、Oracle Identity Analytics(OIA)でDataCollectionOperationsIntf->startDataCollection APIが起動されたときにトリガーされます。Oracle Identity ManagerとOIAの統合の詳細は、「Oracle Identity Analytics」を参照してください。

なし

はい

2.3.2 LDAPスケジュール済タスク

このリリースのOracle Identity Managerには、ジョブの作成または操作時に使用できるLDAPスケジュール済タスクが用意されています。これらのスケジュール済タスクは、Oracle Identity ManagerがLDAP同期で構成されている場合のみ作成されます。表2-3にLDAPスケジュール済ジョブのリストを示します。

関連項目:

Oracle Identity ManagerとLDAP間の統合の構成に関する詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのLDAPとの統合の構成に関する項を参照してください。

表2-3 LDAPスケジュール済ジョブ

スケジュール済ジョブ

説明

ユーザー構成可能属性

デフォルトで有効化

LDAPユーザー作成および更新のリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからユーザー更新をリコンサイルします。

LDAPユーザー作成および更新のリコンシリエーションスケジュール済ジョブは、「ユーザー定義フィールド」(UDF)をリコンサイルできません。このスケジュール済ジョブでUDFをリコンサイルできるようにするには、/db/LDAPUserおよび/db/RA_LDAPUSER.xmlファイルをMDSからエクスポートし、ファイル内で必要な構成変更を行って、MDSにインポートします。MDSファイルのインポートとエクスポートの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する項を参照してください。

注意: ファイルを変更する場合、プロファイルの属性名を指定するときに空白は入れないでください。

最終変更番号: この属性を使用して、スケジュール済ジョブの最終変更番号をOracle Internet Directoryの最終変更ログ番号の値で更新します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

OIMユーザー・タイプ: この属性を使用して、ユーザー・タイプ、たとえば「エンドユーザー」や「エンドユーザー管理者」を指定します。

OIMユーザー組織名: この属性を使用して、リコンサイルされるユーザーの作成先となるOracle Identity Managerの組織を指定します。

OIM従業員タイプ: この属性を使用して、リコンシリエーションによって作成されるユーザーの従業員タイプの値を指定します。

いいえ

LDAPユーザー削除のリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからユーザー削除をリコンサイルします。

最終変更番号: この属性を使用して、このジョブで処理された最終変更ログの識別子を指定します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

いいえ

LDAPロール作成および更新のリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからロールの作成または更新をリコンサイルします。

最終変更番号: この属性を使用して、このジョブで処理された最終変更ログの識別子を指定します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

いいえ

LDAPロール削除のリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからロール削除をリコンサイルします。

最終変更番号: この属性を使用して、このジョブで処理された最終変更ログの識別子を指定します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

いいえ

LDAPロール・メンバーシップのリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからロール・メンバーシップをリコンサイルします。

最終変更番号: この属性を使用して、このジョブで処理された最終変更ログの識別子を指定します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

いいえ

LDAPロール階層のリコンシリエーション

このスケジュール済ジョブは、変更ログに基づいてLDAPからロール階層をリコンサイルします。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

最終変更番号: この属性を使用して、このジョブで処理された最終変更ログの識別子を指定します。

いいえ

LDAPユーザー作成および更新の完全リコンシリエーション

このスケジュール済ジョブは、LDAPからユーザー作成またはユーザー更新をリコンサイルします。これにはDirectory Server ITリソースで定義されている検索ベースの下のすべてのユーザーが含まれます。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

OIMユーザー・タイプ: この属性を使用して、ユーザー・タイプ、たとえば「エンドユーザー」や「エンドユーザー管理者」を指定します。

OIMユーザー組織名: この属性を使用して、リコンサイルされるユーザーの作成先となるOracle Identity Managerの組織を指定します。

OIM従業員タイプ: この属性を使用して、リコンシリエーションによって作成されるユーザーの従業員タイプの値を指定します。

はい

LDAPユーザー削除の完全リコンシリエーション

このスケジュール済ジョブは、LDAPからユーザー削除をリコンサイルします。Oracle Identity ManagerとLDAPに存在するユーザーを比較して、削除されたユーザーを検出します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

はい

LDAPロール作成および更新の完全リコンシリエーション

このスケジュール済ジョブは、LDAPからロールの作成または更新をリコンサイルします。これにはDirectory Server ITリソースで定義されている検索ベースの下のすべてのロールが含まれます。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

はい

LDAPロール削除の完全リコンシリエーション

このスケジュール済ジョブは、LDAPからロール削除をリコンサイルします。Oracle Identity ManagerとLDAPに存在するロールを比較して、削除されたロールを検出します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

はい

LDAPロール・メンバーシップの完全リコンシリエーション

このスケジュール済ジョブは、LDAPからロール・メンバーシップをリコンサイルします。Oracle Identity ManagerとLDAPに存在するエントリを比較して、ロール・メンバーシップの追加または削除を検出します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

はい

LDAPロール階層の完全リコンシリエーション

このスケジュール済ジョブは、LDAPからロール階層をリコンサイルします。Oracle Identity ManagerとLDAPに存在するエントリを比較して、ロール階層の追加または削除を検出します。

バッチ・サイズ: この属性を使用して、各キューのディレクトリからエントリの数をフェッチします。

はい

Fusion Applicationsロール・カテゴリ・シーディング

このスケジュール済ジョブは、LDAPシステムにすべてのロールを問い合せ、そのロール・カテゴリを取得します。LDAPにOracle Identity Managerにない新しいロール・カテゴリがある場合は、Oracle Identity Managerに新しいロール・カテゴリを作成します。

開始変更ログ番号: この属性を使用して、このジョブで処理された最終変更ログの識別子または次の実行の開始識別子を指定します。

はい

2.3.3 カスタムのスケジュール済タスクの作成

Oracle Identity Managerには、独自のスケジュール済タスクを作成する機能があります。表2-2にリストされている事前定義済スケジュール済タスクを使用しないで、要件に合わせてスケジュール済タスクを作成できます。

関連項目:

スケジュール済タスクの作成の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのスケジュール済タスクの開発に関する説明を参照してください。

カスタムのスケジュール済タスクを作成するには:

1. スケジュール済タスクXMLファイルを作成し、それをメタデータ・ストア(MDS)にシードします。

2. スケジュール・タスク・クラスを作成し、それをJarにパッケージ化します。

3. Jarを次の方法でアップロードします。

- プラグインを使用

- データベースを使用

プラグインを使用

Oracle Identity Managerが提供するプラグイン・フレームワークを使用してJarをアップロードできます。

プラグインを使用してjarをアップロードするには:

1. plugin.xmlファイルを作成します。

2. スケジュール済タスクのディレクトリ構造(plugin.zip)を作成します。

3. 作成したplugin.zipをOracle Identity Managerデータベースにアップロードします。

データベースを使用

jarをOracle Identity Managerのデータベース(DB)にアップロードできます。

DBを使用してjarをアップロードするには:

UploadJarユーティリティを使用してjarをDBにアップロードします。このユーティリティは次の場所から実行できます。

$OIM_HOME/bin/

関連項目:

UploadJarユーティリティの実行についての詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのJarユーティリティのアップロードに関する項を参照してください。

2.4 ジョブ

冒頭部分の章の1つで説明したように、ジョブは、指定された間隔で実行するようにスケジュールできるタスクです。ジョブ実行は、ジョブの特定の実行です。各ジョブ実行には、開始時間、停止時間、ジョブ・ステータス、実行の例外とステータスが含まれます。

この項の内容は次のとおりです。

- ジョブの作成

- ジョブの検索

- ジョブの表示

- ジョブの変更

- ジョブの無効化と有効化

- ジョブの削除

2.4.1 ジョブの作成

注意:

この項で説明する手順は、ジョブ説明を含むスケジュール済タスクのXMLファイルが、OIM_HOME/metadata/fileディレクトリから入手可能であることを前提としています。

ジョブを作成するには:

1. 適切な資格証明を使用してOracle Identity Administrationにログインします。

2. 「システム管理」タブをクリックし、次に「スケジューラ」をクリックします。あるいは、「ようこそ」画面で「スケジュール済ジョブの検索」リンクをクリックします。

3. 左ペインで、「アクション」リストから「作成」を選択します。あるいは、「表示」リストの横のプラス(+)記号が付いたアイコンをクリックします。

4. 「ジョブの作成」ページで、「ジョブ情報」セクションの次のフィールドに値を入力します。

- ジョブ名: ジョブの名前を入力します。

- タスク: ジョブを実行するスケジュール済タスクの名前を指定します。あるいは、スケジュール済タスクを検索して指定します。
スケジュール済タスクを検索して指定するには:

1. このフィールドの横の虫眼鏡アイコンをクリックします。

2. 「検索と選択: スケジュール済タスク」ダイアログ・ボックスで、スケジュール済タスクの検索基準を指定し、「検索」フィールドの横のアイコンをクリックします。
検索基準を満たすすべてのスケジュール済タスクのリストが表示されます。

3. このリストから、作成されたジョブを実行するスケジュール済タスクを選択し、「確認」をクリックします。

- 開始日: ジョブを実行する日時を指定します。これを行うには、日付エディタで日付と時間をタイムゾーンとともに選択し、「OK」をクリックします。デフォルトでは、タイムゾーンは「(UTC-08:00) アメリカ太平洋標準時」です。

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

- スケジュール・タイプ: ジョブを実行する頻度に応じて、次のスケジュール・タイプのいずれかを選択します。

- 周期的: このオプションは、指定した時間で繰り返しジョブを実行させる場合に選択します。このオプションを選択した場合は、「ジョブ周期設定」セクションの「実行頻度」フィールドに整数値を入力し、次のいずれかの値を選択する必要があります。
- 分

- 時間

- 日

- cron: このオプションは、ジョブを特定の間隔で定期的に実行させる場合に選択します。たとえば、毎週月 - 金の8:00 A.M.と毎月最後の金曜日の1:30 A.M.に実行する必要があるジョブを作成できます。
ジョブの繰返しは、「cron設定」セクションで指定する必要があります。「定期実行間隔」フィールドで、次のいずれかの値を選択できます。

- 毎日

- 毎週

- 毎月指定日

- 毎月指定曜日

- 毎年

値を選択後、「実行間隔日数」フィールドに整数値を入力できます。

- 1回: このオプションは、ジョブを指定した開始日時に1回のみ実行させる場合に選択します。

- 事前定義済スケジュールなし: このオプションは、作成しているジョブに付加されたスケジュールなく、そのため自動的にトリガーされない場合に指定します。結果として、「保存して即時実行」をクリックした場合のみ、ジョブがトリガーされます。

5. 注意:
どのスケジュール・タイプでも、ジョブを保存してすぐに実行する場合は、「保存して即時実行」をクリックします。
ジョブが正常に作成されトリガーされたことを確認するメッセージが表示されます。

2.4.2 ジョブの検索

次の検索操作を実行して、Oracle Identity Administrationでジョブを検索できます。

- ジョブの単純検索の実行

- ジョブの拡張検索の実行

2.4.2.1 ジョブの単純検索の実行

ジョブの単純検索を実行するには:

1. Oracle Identity Administrationの「ようこそ」ページで、「システム管理」の下にある「スケジュール済ジョブの検索」をクリックします。あるいは、「システム管理」タブをクリックし、次に「スケジューラ」をクリックします。

2. 左ペインの「検索」フィールドで、検索するジョブの検索基準を指定します。検索基準にはワイルドカード文字を含めるこもともできます。

3. 「検索」フィールドの横のアイコンをクリックします。検索基準を満たすすべてのジョブのリストが表示されます。
検索結果が、次の列を含む表形式で表示されます。

- ジョブ名: この列にはジョブの名前が表示されます。ジョブの詳細を表示するには、列内のその名前をクリックします。

- ステータス: この列にはジョブのステータスが表示されます。ジョブのステータスは次のいずれかになります。

- 実行中: ジョブは現在実行中です。

- 停止済: ジョブは現在実行されていません。ただし、ジョブは「次のスケジュール実行」フィールドで指定された日時に再度実行されます。

- 割込み: ジョブは実行中に割り込まれました。このステータスは、ジョブの実行中に管理サーバーが割り込んだ場合に表示されることがあります。

- 失敗: ジョブは何らかの理由で実行に失敗しました。

2.4.2.2 ジョブの拡張検索の実行

スケジューラの拡張検索を実行するには:

1. 「スケジューラ」セクションの左ペインで、「拡張検索」をクリックします。「拡張検索: スケジュール済ジョブ」ページが表示されます。

2. 次のオプションのいずれかを選択します。

- すべて: このオプションを選択すると、検索はAND条件で実行されます。つまり、指定されたすべての検索基準を満たす場合のみ検索操作が成功します。

- いずれか: このオプションを選択すると、検索はOR条件で実行されます。つまり、指定された選択基準のいずれかに一致する場合に検索操作が成功します。

3. 「ジョブ名」フィールドで、検索するジョブ名を入力します。検索基準にはワイルドカード文字を使用できます。「ジョブ名」フィールドに隣接するリストから検索条件を選択します。検索条件には、「次を含まない」、「次で始まらない」、「次と等しくない」、「次と等しい」、「次で終わる」、「次で終わらない」、「次を含む」および「次で始まる」があります。

4. 「ステータス」フィールドに対する検索条件を選択します。「すべて」、「実行中」、「停止済」から検索するステータスを選択します。

5. 「タスク名」フィールドにタスク名を入力します。検索基準にはワイルドカード文字を使用できます。「タスク名」フィールドに隣接するリストから検索条件を選択します。

6. 「検索」をクリックします。検索基準を満たすジョブのリストが検索結果表に表示されます。
表2-4に、検索結果表の列のリストを示します。

表2-4 検索結果表のフィールド

フィールド

説明

ジョブ名

スケジュール済ジョブの名前

タスク

ジョブに関連付けられたタスク

ステータス

ジョブのステータスで、「実行中」、「停止済」、「失敗」、「割込み」のいずれか

スケジュール

ジョブを実行するスケジュールまたは時間

最終実行

ジョブを最後に実行した時間

有効化

ジョブが有効か無効か

2.4.3 ジョブの表示

ジョブの詳細を表示するには:

1. 詳細を表示するジョブを検索します。ジョブの検索方法については、「ジョブの検索」を参照してください。

2. 検索結果表の「ジョブ名」列で、詳細を表示するジョブをクリックします。

「ジョブの詳細」ページは、次のセクションに分かれています。

- ジョブ情報: このセクションには、ジョブに関する情報を提供するフィールドが表示されます。たとえば、「ジョブ名」、「タスク」、「再試行」および「開始日」フィールドなどが表示されます。ジョブの詳細を変更するには、目的の変更を行ってから「適用」をクリックします。ジョブの変更については、「ジョブの変更」を参照してください。

- ジョブ・ステータス: このセクションでは、ジョブのステータスの詳細が次のフィールドに表示されます。

- 現行のステータス: ジョブのステータスが表示されます。

- 最終実行開始: ジョブが最後に実行開始された日時が表示されます。

- 最終実行終了: ジョブが最後に実行停止された日時が表示されます。

- 次のスケジュール実行: このフィールドは、作成しているジョブに付加されたスケジュールがなく、そのためジョブは自動的にトリガーされないことを示します。この場合、ジョブをトリガーする方法は、「即時実行」の実行のみです。

注意:

「スケジュール・タイプ」が「事前定義済スケジュールなし」の場合、このフィールドに値は表示されません。

- パラメータ: ジョブの実行中に、ここに指定したパラメータ値がランタイムで使用されます。各ジョブのパラメータをここに入れておくと、ジョブの実行時にそれが使用されるため、ランタイムで値を指定する必要がありません。

- ジョブ履歴: このセクションには、表内のジョブのすべてのジョブ実行のリストが表示されます。
表の各行にジョブに関する次の情報が表示されます。

- 開始時間: この列には、ジョブ実行が実行を開始した日時が表示されます。

- 終了時間: この列には、ジョブ実行が実行を終了した時間が表示されます。

- ジョブ・ステータス: この列には、ジョブのステータスが表示されます。

- 実行ステータス: この列には、ジョブの実行ステータスが表示されます。

「履歴」セクションの表では、列の表示を並べ替えることができます。

1. 「表示」リストから、列の並替えを選択します。

2. 列の並替えダイアログ・ボックスで、並べ替える列名を選択します。

3. 列の表示順に応じて、上または下矢印をクリックします。

「履歴」セクションの表に表示される列を追加または移動するには:

1. 「表示」リストから、列を選択します。

2. 要件に応じて、次のいずれかを選択します。

- すべて表示

- 開始時間

- 終了時間

- ジョブ・ステータス

- 実行ステータス

3. 追加または削除する各列に対して、ステップaとbを繰り返します。

ジョブの詳細を表示後、ジョブを変更、実行または停止できます。また、ジョブの有効化または無効化も可能です。「ジョブの詳細」画面はリフレッシュできます。

「ジョブの詳細」ページでジョブの詳細を表示後、次のいずれかを実行できます。

- ジョブの詳細を変更するには、目的の変更を行ってから「適用」をクリックします。ジョブの変更については、「ジョブの変更」を参照してください。

- ジョブを実行するには、「即時実行」をクリックします。

- 「無効化」ボタンが有効な場合は、ジョブが現在有効であり、「無効化」をクリックしてジョブを無効化できることを意味します。

- 「有効化」ボタンが有効な場合は、ジョブが現在無効であり、「有効化」をクリックしてジョブを有効化できることを意味します。

- ジョブの詳細画面をリフレッシュするには、「リフレッシュ」をクリックします。

- 「停止」ボタンが表示されている場合は、ジョブが現在実行中で、「停止」をクリックしてジョブを停止できることを意味します。

2.4.4 ジョブの変更

ジョブを変更する手順:

1. 変更するジョブを検索して詳細を表示します。ジョブ詳細の表示方法は、「ジョブの表示」を参照してください。

注意:

ジョブを実行する場合は、検索結果表の1番目の列でジョブ名をクリックしてから「即時実行」をクリックします。「即時実行」をクリックすると、この手順の残りのステップは実行する必要はありません。ただし、ジョブを変更してから実行する場合は、次のステップを実行してから「即時実行」をクリックしてください。

2. 「ジョブの詳細」ページでは、「ジョブ情報」セクションの「ジョブ名」と「タスク」フィールド、および「ジョブ・ステータス」セクションのフィールドを除く、すべてのジョブ詳細を変更できます。変更するフィールドの詳細は、「ジョブの作成」のステップ4を参照してください。

3. 「ジョブの詳細」ページで行った変更をデータベースに適用するには、「適用」をクリックします。
ジョブが正常に変更されたこと確認するメッセージが表示されます。

2.4.5 ジョブの無効化と有効化

ジョブの作成と変更に加えて、現在有効なジョブの無効化、および以前に無効化されたジョブの有効化が可能です。「ジョブの詳細」ページで、次のようにします。

- 「有効化」ボタンが有効な場合は、ジョブが現在無効であり、「有効化」をクリックしてジョブを有効化できることを意味します。有効化されたジョブは、「ジョブの詳細」ページで次のいずれかがtrueである場合のみ実行されます。

- 「開始日」フィールドに表示されている日時が現在の日時と一致しています。

- 「次のスケジュール実行日」フィールドに表示される日時が現在の日時と一致しています。

- 「無効化」が有効な場合は、ジョブが現在有効であり、「無効化」をクリックしてジョブを無効化できることを意味します。無効化されたジョブは、ジョブの実行がスケジュールされている日時が現在の日時と一致した場合でも実行されません。
ジョブを有効化または無効化するには:

1. 「ジョブの検索」で説明する手順を実行して、有効化または無効化するジョブを検索します。

2. 左ペインの検索結果表で、ジョブ名を右クリックして「有効化」または「無効化」を選択します。「有効化」または「無効化」のどちらをクリックしたかに応じて、ジョブが正常に有効化または無効化されたことを示すメッセージが表示されます。

3. 「OK」をクリックし、ダイアログ・ボックスを閉じます。

2.4.6 ジョブの開始と停止

指定した時間に自動的に実行されるようにジョブをスケジュールするだけでなく、いつでも手動でジョブを開始または停止できます。たとえば、ジョブを作成し、金曜日ごとに実行されるようにスケジュールするとします。ただし、このジョブを金曜日以外に実行する必要がある場合は、ジョブを手動で実行する必要があります。

ジョブを開始または停止するには:

1. 「ジョブの検索」で説明する手順を実行して、開始または停止するジョブを検索します。

2. 左ペインの検索結果表で、開始または停止するジョブのジョブ名をクリックします。

注意:

デフォルトでは、ジョブが実行されていなければ、すべてのジョブのステータスは「停止済」になっています。

3. ジョブを開始する場合は、「アクション」リストで「即時実行」をクリックします。
ジョブを実行するかどうかの確認を求めるダイアログ・ボックスが表示されます。

4. ジョブを停止する場合は、「アクション」リストで「停止」をクリックします。
ジョブを停止するかどうかの確認を求めるダイアログ・ボックスが表示されます。

5. 「OK」をクリックします。

2.4.7 ジョブの削除

ジョブを削除する手順:

1. 「ジョブの検索」で説明する手順を実行して、削除するジョブを検索します。

2. 左ペインの検索結果表で、削除するジョブのジョブ名をクリックします。

3. 「アクション」リストから、「削除」をクリックします。あるいは、プラス(+)記号の付いたアイコンの横にある「削除」アイコンをクリックします。
ジョブを削除するかどうかの確認を求めるダイアログ・ボックスが表示されます。

4. 「OK」をクリックします。ジョブが正常に削除されたことを示すメッセージが表示されます。

3 通知テンプレートの管理

Oracle Identity Managerで発生したイベントに関する情報は、リクエスタ、受益者、管理者などのさまざまなユーザーに送信する必要があります。このイベントに関する情報は、通知電子メール・メッセージ形式の通知サービスを使用して送信されます。Oracle Identity Managerでは通知サービスを使用してすべての通知関連操作を実行できます。

イベントとは、Oracle Identity Managerで発生する操作で、ユーザー作成、リクエスト開始またはユーザーが作成した任意のカスタム・イベントなどが含まれます。イベントは、ビジネス操作の一部として、またはエラー生成を介して生成されます。イベント定義は、イベントを記述するメタデータです。イベントのメタデータを定義するには、機能コンポーネントでサポートされるすべてのイベント・タイプを識別することが重要です。たとえば、スケジューラ・コンポーネントの一部として、スケジュール済ジョブ実行の失敗とスケジューラの停止に対してメタデータを定義できます。ジョブの失敗またはスケジューラの停止のたびにイベントが発生し、イベントに関連付けられている通知が送信されます。

イベントで使用可能なデータを使用して、通知のコンテンツが作成されます。イベントに定義されたさまざまなパラメータにより、システムは適切な通知テンプレートを選択できます。イベントに定義されている各種のパラメータは、テンプレート設計時に使用可能にできるイベント変数をシステムが決定する際に役立ちます。

通知テンプレートは、通知を送信するために使用されます。これらのテンプレートには、より詳細な通知を提供するために、使用可能なデータを参照する変数が含まれています。通知が送信されるチャネルは、通知プロバイダと呼ばれます。このリリースでは、通知プロバイダとして電子メール通知プロバイダのみを使用できます。バックエンドでは、通知エンジンが通知の生成と通知プロバイダを利用した通知の送信を担当します。

注意:

通知を送信するには、XL.MailServerシステム・プロパティが構成されている必要があります。このシステム・プロパティの詳細は、「Oracle Identity Managerのシステム・プロパティ」を参照してください。

表3-1に示すように、Oracle Identity Managerにはデフォルトの通知テンプレート・セットが用意されています。

表3-1 デフォルトの通知テンプレート

通知テンプレート

説明

バルク・リクエスト作成

バルク・リクエストの作成中に通知を提供するためのテンプレート

ユーザー・セルフ・サービス通知の作成

新しいユーザーの作成後に通知を提供するためのテンプレート

終了日

報告者の終了日を経過したときにマネージャに通知を送信するためのテンプレート

生成されたパスワードの通知

Oracle Identity Managerによるパスワード生成後に通知を提供するためのテンプレート

リクエスト作成

リクエストの作成中に通知を提供するためのテンプレート

リクエスト・アイデンティティ作成

ユーザーの作成のリクエスト中に通知を提供するためのテンプレート

リクエスト・ステータス変更

リクエスト・ステータスの変更中に通知を提供するためのテンプレート

パスワードのリセット

パスワードがリセットされた後で通知を提供するためのテンプレート

ユーザーが削除されました

終了日を経過したため報告者のユーザー・アカウントが削除されたときに、マネージャに通知を送信するためのテンプレート

プロキシ通知の追加

ユーザーにプロキシが追加された後で通知を提供するためのテンプレート

次の各項で、通知テンプレートについて説明します。

- イベント・メタデータの定義

- 通知テンプレートの作成

- 通知テンプレートの検索

- 通知テンプレートの修正

- 通知テンプレートの削除

- 通知テンプレートに対するロケールの追加と削除

- プロキシ用の通知の構成

3.1 イベント・メタデータの定義

各イベントに対して、通知エンジンで定義される特定のスキーマを持つXMLファイルを作成する必要があります。そのスキーマ(.xsdファイル)に準拠して、イベントの概要を定義するXMLファイルが作成されます。イベントが定義されると、そのイベントの通知テンプレートを定義できます。

イベント・ファイルは通知エンジンで定義されるスキーマ、NotificationEvent.xsdに準拠している必要があります。イベント・ファイルにはイベントに関する基本情報が含まれます。

注意:

NotificationEvent.xsdファイルは、MDSのiam\iam-product\features\notification\metadataディレクトリにあります。

次にイベントXMLファイルのサンプルを示します。

<?xml version="1.0" encoding="UTF-8"?>
<Events xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../metadata/NotificationEvent.xsd">
<EventType name="User Created">
<StaticData>
<Attribute DataType="X2-Entity" EntityName="User" Name="Granted User"/>
<Attribute DataType="X2-Entity" EntityName="User" Name="Grantee User"/>
<Attribute DataType="91-Entity" EntityName="User Group" Name="User Grp"/>
</StaticData>
<Resolver class="oracle.iam.notification.DemoResolver">
<Param DataType="91-Entity" EntityName="Resource" Name="ResourceInfo"/>
</Resolver>
</EventType>
</Events>

このイベントXMLファイルには、次の要素があります。

- EventType name: イベントに通知テンプレートを作成する際に利用できるイベントの名前。

- StaticData: 静的パラメータのリスト。ユーザーは、このパラメータ・セットに、データ依存ではないパラメータを追加できます。つまり、この要素では、通知テンプレートが構成されるときに表示される静的データを定義します。たとえば、ユーザー・エンティティはデータ依存ではなく、解決されたときに、すべてのイベント・インスタンスおよび通知テンプレートに対して同じ属性セットを持ちます。

- Param DataType: 動的パラメータのリスト。ユーザーは、このパラメータ・セットに、データ依存のパラメータを追加できます。たとえば、Resourceエンティティはデータ依存です。このフィールドに対応する参照がUIに表示されます。ユーザーがこのリソース・オブジェクトを選択すると、そのコールは、ツリー(ユーザーはここからテンプレートで使用する属性を選択します)に表示されるフィールドを取得するために提供されているリゾルバ・クラスに向かいます。

注意:

使用可能なデータとは、テンプレートにトークンとして組み込むことのできる属性のリストです。これらのトークンは、ランタイム時にリゾルバ・クラスによって渡される値と置き換えられます。トークンの例は、「通知テンプレートの作成」のステップ7を参照してください。

「通知テンプレートの作成」に記載されているように、通知テンプレートを作成する際に使用可能なデータがドロップダウン・リストに表示されます。

選択されたデータは単一の属性であり、ユーザーが属性名をコピーして通知テンプレートに貼り付ける際に役立ちます。選択されたデータの属性名は、「使用可能なデータ」リストで選択されたものと同じです。

検索でサポートされる動的エンティティは、ユーザー、リソースおよび組織です。これらのエンティティ名をParam DataType要素で指定する必要があります。

注意:

<Param DataType>要素は、必須要素ではありません。ただし、使用する際は、エンティティ名にUser、ResourceまたはOrganizationを指定する必要があります。

- Resolver class: リゾルバ・クラスは、通知ごとに定義する必要があります。これは、通知作成画面で使用できるパラメータと、それらのパラメータを通知の送信時に置き換える方法を定義します。つまり、リゾルバ・クラスは、ランタイム時にデータを動的に解決し、UIに属性を表示します。リゾルバ・クラスの実装の詳細は、「リゾルバ・クラスの作成」を参照してください。

通知サービスはMDSからXMLファイルを読み込みます。イベントXMLファイルは、MDSインポートおよびエクスポート・ユーティリティを使用してMDSにアップロードされます。詳細は、「通知イベントのデプロイ」を参照してください。

3.1.1 リゾルバ・クラスの作成

すべてのクラスが、NotificationEventResolverインタフェースを実装する必要があります。このインタフェースは、次のメソッドを提供します。

getAvailableDataメソッド

public List<NotificationAttribute> getAvailableData(String eventType, Map<String, Object> params);

このAPIは、使用可能なデータ変数のリストを戻します。この変数は、テンプレートの作成時や変更時にUI上で使用でき、ユーザーはこの変数を選択して、この変数をテンプレート上のメッセージの一部にすることができます。

eventTypeパラメータは、テンプレートが読み取られるイベント名を指定します。

paramsパラメータは、使用可能なデータがフェッチされるエンティティ名および対応する値を持つマップです。次に例を示します。

map.put("Resource", "laptop");

これは、リゾルバ・クラスで指定したコードに従って、laptopリソースまたはその他のデータに関連付けられたフィールドをフェッチする際に役立ちます。

サンプル・コードを次に示します。

/**
* this is a dummy implementation and uses hardcoded values
* Implementors need to iterate the XML as found through the event type
* params : will have all the specific values that your resolver needs
* for instance resource name = "laptop" that you may want here to be resolved through your custon implementation
*/

List<NotificationAttribute> list = new ArrayList<NotificationAttribute>(); NotificationAttribute subatr = new NotificationAttribute(); subatr.setName("Dynamic1"); subatr.setType("91-Entity"); subatr.setEntityName("Resource"); subatr.setRequired(false); subatr.setSearchable(true); subatr.setSubtree(lookup91EntityMetaData("resource"), params.get(0)); list.add(subatr);

メイン・ツリーにはエンティティ情報が含まれ、サブツリーにはUIで使用可能なすべてのノードが含まれます。サブツリー内の各ノードからの名前フィールドは、UI上で選択できます。

getReplacedDataメソッド

HashMap<String, String> getReplacedData(String eventType, Map<String, Object> params);

このAPIは、通知を送信するときに、実行時にテンプレートで提示された変数の解決された値を戻します。

eventTypeパラメータは、テンプレートが読み取られるイベント名を指定します。

paramsパラメータは、テンプレート内の残りの変数を解決するためにリゾルバで必要とされるベース値(usr_key、obj_keyなど)を持つマップです。

サンプル・コードを次に示します。

HashMap<String, Object> resolvedData = new HashMap<String, Object>(); resolvedData.put("shortDate", new Date()); resolvedData.put("longDate", new Date());
String firstName = getUserFirstname(params.get("usr_key")); resolvedData.put("fname", firstName); resolvedData.put("lname", "lastname"); resolvedData.put("count", "1 million");
return resolvedData;

3.1.2 通知イベントのデプロイ

通知イベントをデプロイするには、次の手順を実行します。

1. イベント・メタデータXMLファイルをメタデータ・ストア(MDS)にアップロードします。Oracle Identity Managerでは、MDSリポジトリに対してエクスポートとインポートを行うためのユーティリティが提供されています。
MDSユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

2. リゾルバ・クラスを含むJARファイルを、Oracle Identity Managerデータベースにアップロードします。リソース・バンドルおよびJARファイルをOracle Identity Managerデータベースにアップロードするためのユーティリティは、OIM_HOME/bin/ディレクトリにあります。
リソース・バンドルとJARをアップロードするためのユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのJARおよびリソース・バンドルのアップロード・ユーティリティに関する説明を参照してください。

3.2 通知テンプレートの作成

注意:

発生する各イベントに対してXMLファイルを構成する必要があります。XMLファイルは、各イベントの動作を定義します。最初に、イベントのXMLを構成する必要があります。これを行った後で、イベントに対して通知テンプレートを作成できます。

イベントXMLファイルの作成については、「イベント・メタデータの定義」を参照してください。

通知テンプレートを作成するには:

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

2. 「システム管理」タブをクリックし、次に「通知」タブをクリックします。

3. 左ペインの「アクション」メニューから、「作成」を選択します。

4. 「作成」ページで、「テンプレート情報」セクションの下の次のフィールドに値を入力します。

- テンプレート名: テンプレート名を入力します。

- 説明テキスト: テンプレートの簡単な説明を入力します。

注意:

「説明テキスト」フィールドは翻訳できず、表示は英語のみになります。

5. 「イベントの詳細」セクションの下で、次の内容を実行します。

- 「使用可能なイベント」リストから、通知テンプレートを作成するイベントを選択します。選択内容に応じて、他のフィールドが「イベントの詳細」セクションに表示されます。

- 「リソース」フィールドで、検索からリソースを選択します。これは、XML定義のParam DataType要素によって定義された動的データです。この要素の詳細は、「イベント・メタデータの定義」を参照してください。

6. 「ロケール情報」セクションの下で、次のフィールドに値を入力します。

注意:

デフォルトのロケールの情報はPTY表に格納されており、そこから取得されます。

- エンコーディング形式を指定するには、UTF-8かASCIIのいずれかを選択します。

- 「メッセージの件名」フィールドに、通知の件名を入力します。

- 「タイプ」オプションから、メッセージを送信するデータ・タイプを選択します。「HTML」か「Text/Plain」のどちらかを選択できます。

- 「ショート・メッセージ」フィールドに、メッセージの短縮バージョンを入力します。

- 「ロング・メッセージ」フィールドに、通知として送信されるメッセージを入力します。ステップ7を参照してください。

7. 通知として送信するメッセージ内で、使用可能なデータのトークンを使用するには、次の手順を実行します。

1. リストから属性を選択します。この属性は、「選択したデータ」フィールドに表示されます。

2. 属性をコピーして${}の内側に配置し、メッセージ・テキストに追加します。たとえば、選択したデータがFA_Territoryの場合、${FA_Territory}としてテキスト内に含めます。

図3-1に、サンプル値を使用した「通知テンプレートの作成」ページを示します。

図3-1 「通知テンプレートの作成」ページ

「図3-1 「通知テンプレートの作成」ページ」の説明

8. すべてのフィールドに必要な値を入力し終わったら、「保存」をクリックします。

9. 通知テンプレートの作成を確認するメッセージが表示されます。「OK」をクリックします。

3.3 通知テンプレートの検索

拡張管理を使用して、通知テンプレートの単純検索または拡張検索を実行できます。

通知テンプレートの単純検索を実行するには:

1. Oracle Identity Administrationにログインします。

2. 「システム管理」タブをクリックし、次に「通知」タブをクリックします。

3. 「検索」フィールドの横のアイコンをクリックします。図3-2に示すように、左ペインに既存の通知テンプレートすべてが表示されます。

図3-2 通知検索の結果

「図3-2 通知検索の結果」の説明

4. 表示するテンプレートを選択します。選択した通知テンプレートの詳細が、右ペインに表示されます。

通知テンプレートの拡張検索を実行するには:

1. Oracle Identity Administrationの左ペインで、「拡張検索」をクリックします。図3-3に示すように、「拡張検索」ページが表示されます。

図3-3 「拡張検索」ページ

「図3-3 「拡張検索」ページ」の説明

2. 次の一致オプションのいずれかを選択します。

- すべて: このオプションを選択すると、検索はAND条件で実行されます。つまり、ユーザー入力されたすべての「検索」フィールドに基づいて検索操作が行われます。ユーザー入力がない「検索」フィールドは考慮されません。

- いずれか: このオプションを選択すると、検索はOR条件で実行されます。つまり、指定された選択基準のいずれかに一致する場合に検索操作が成功します。

3. 「テンプレート名」、「イベント名」、「件名の詳細」フィールドで検索基準を指定します。これらのフィールドのうち、検索に含めたくないフィールドは、そのフィールドの横にあるアイコンをクリックして削除できます。検索に含めるフィールドを追加するには、「フィールドの追加」をクリックして、リストからフィールド名を選択します。

4. 「検索」をクリックします。図3-4に示すように、検索結果表にテンプレート名、イベント名および件名の詳細が表示されます。

図3-4 拡張検索の結果

「図3-4 拡張検索の結果」の説明

3.4 通知テンプレートの変更

通知テンプレートを変更するには:

1. Oracle Identity Administrationにログインします。

2. 「システム管理」タブをクリックし、次に「通知」タブをクリックします。

3. 「検索」フィールドの横のアイコンをクリックします。左ペインに既存の通知テンプレートがすべて表示されます。変更するテンプレートを選択します。図3-5に通知テンプレートの詳細を示します。

図3-5 通知テンプレートの変更

「図3-5 通知テンプレートの変更」の説明

4. 目的の値を変更し、「保存」をクリックします。

5. 通知テンプレートの変更を確認するメッセージが表示されます。「OK」をクリックします。

3.5 通知テンプレートの削除

通知テンプレートを削除するには:

1. Oracle Identity Administrationにログインします。

2. 「システム管理」タブをクリックし、次に「通知」タブをクリックします。

3. 「検索」フィールドの横のアイコンをクリックします。左ペインに既存の通知テンプレートがすべて表示されます。削除するテンプレートを選択します。

4. 「アクション」リストから、「削除」をクリックします。削除操作の確認を求めるメッセージが表示されます。「OK」をクリックします。削除操作を確認するメッセージが表示されます。

3.6 通知テンプレートに対するロケールの追加と削除

通知テンプレートにロケールを追加するには:

1. Oracle Identity Administrationにログインします。

2. 「システム管理」タブをクリックし、次に「通知」タブをクリックします。

3. 「検索」フィールドの横のアイコンをクリックします。左ペインに既存の通知テンプレートがすべて表示されます。ロケールを追加するテンプレートを選択します。

4. 「アクション」リストから、「ロケールの追加」を選択します。「ロケールの追加」ページが表示されます。「ロケール名」フィールドで、このフィールドの横のアイコンをクリックしてリストからロケールを選択します。ロケールの選択後、「確認」をクリックします。「次へ」をクリックします。「ロケール情報」ページが表示され、追加したロケールがページのタブとして表示されます。

5. 「ロケール情報」セクションで、「通知テンプレートの作成」のステップ6の説明に従って、すべてのフィールドに値を指定し、「保存」をクリックします。ロケールがテンプレートに追加されます。

注意:

通知は、通知テンプレートに追加されたすべてのロケールに送信できます。ユーザーは、ユーザー・プリファレンスで指定されたのと同じロケールで通知を受け取ります。ユーザー・プリファレンスでロケールが指定されていない場合は、通知はデフォルトのロケールで送信されます。デフォルトのロケールは、インストール時にOracle Identity ManagerデータベースのPTY表に指定されたものです。

通知テンプレートからロケールを削除するには:

1. Oracle Identity Administrationの左ペインで、検索結果表からテンプレートを選択し、「アクション」リストから「ロケールの削除」を選択します。あるいは、テンプレートを右クリックして「ロケールの削除」を選択することもできます。

2. 「ロケールの削除」ページで、「ロケール名」フィールドの横のアイコンをクリックし、リストからロケールを選択します。テンプレートに複数のロケールが含まれている場合のみ、テンプレートからロケールを削除できることに注意してください。テンプレートに関連付けられたロケールが1つのみの場合は、ロケールを削除することはできません。「保存」をクリックします。

3. ロケールの削除を確認するメッセージが表示されます。「OK」をクリックします。

注意:

デフォルトのロケールは削除しないでください。ユーザー優先ロケールが設定されていない場合や、通知テンプレートにユーザー優先ロケールに一致するロケール・テンプレートが含まれていない場合でも通知が必ず送信されるようにするためには、これが必要です。

3.7 プロキシ用の通知の構成

プロキシ用の通知を構成するには、次の手順を使用します。

1. 新しい電子メールITリソースを構成します。

2. 新しいエンド・ユーザーを作成します。(たとえば、ユーザーJane Doeを作成します。)

3. 2人目のエンド・ユーザーを作成します。(たとえば、ユーザーJohn Doeを作成します。)

4. ユーザーJane DoeをJohn Doeのマネージャとして割り当てます。

5. John Doeに自分の電子メールIDを指定し、通知を自分の受信ボックスで受信できるようにします。

6. Jane Doeとしてログインし、Oracle Identity Managerセルフ・サービスに移動します。

7. 「プロファイル」、「プロキシ」を選択します。「プロキシ」画面が表示されるため、John DoeをJane Doeのプロキシとして追加します。

注意:

プロキシが正常に追加されると、ユーザー(この場合はJohn Doe)は次のような電子メール通知メッセージを受け取ります。

Jane Doe [JANED]のプロキシが2010年4月7日12:00:00 AMから2010年4月30日12:00:00 AMまで作成されています。

4 システム・プロパティの管理

システム構成サービスにより、Oracle Identity Managerで使用するシステム・プロパティを管理できます。このサービスを使用して、既存のシステム・プロパティをそのロールに応じて作成、変更、削除または検索できます。

システム・プロパティは、Oracle Identity Managerの動作を管理する特性を定義します。システム・プロパティを使用して、Oracle Identity AdministrationおよびOracle Identity Managerセルフ・サービスなどのコンソールの機能を定義できます。たとえば、ユーザーが何回連続してOracle Identity Managerへのログインに失敗すると、Oracle Identity Managerでユーザー・アカウントがロックされるかを定義できます。言い換えれば、システム・プロパティとは、Oracle Identity Managerの構成を制御できるエンティティです。

この章の内容は、次のとおりです。

- Oracle Identity Managerのシステム・プロパティ

- システム・プロパティの作成と管理

4.1 Oracle Identity Managerのシステム・プロパティ

表4-1に、Oracle Identity Managerのデフォルトのシステム・プロパティのリストと説明を示します。

表4-1 Oracle Identity Managerのデフォルトのシステム・プロパティ

プロパティ名

説明

キーワード

デフォルト値

適用しない場合にアクセス・ポリシーを失効させる機能拡張

アクセス・ポリシー内の、適用されなくなった場合に失効するフラグを適用できるかどうかを定義します。

値がtrueの場合、このフラグは親データに加えて子表のデータ(エンタイトルメント)に適用できます。このフラグに基づいてユーザーにアクセス・ポリシーが適用されなくなったときに、子データを削除するか保持するかはユーザーが定義できます。

値がfalseの場合、アクセス・ポリシーが適用されなくなると、子表のデータ(エンタイトルメント)は常に削除されます。

XL.AccessPolicyRevokeIfNoLongerAppliesEnhancement

FALSE

リソースの複数インスタンスのアクセス・ポリシー・ベースのプロビジョニングを許可します

リソースの複数のインスタンスを複数のターゲット・リソースにプロビジョニングできるかどうかを定義します。

値がfalseの場合、アクセス・ポリシー経由でのリソース・オブジェクトの複数インスタンスのプロビジョニングは許可されません。

値がtrueの場合、アクセス・ポリシー経由でのリソース・オブジェクトの複数インスタンスのプロビジョニングが許可されます。

XL.AllowAPBasedMultipleAccountProvisioning

false

OIMではチャレンジ質問は無効です

Oracle Identity Managerに最初にログインしたときにチャレンジ質問を有効にするか無効にするかを定義します。

値がFalseの場合、チャレンジ質問は有効です。

値がTrueの場合、チャレンジ質問は無効です。

このプロパティは主にOracle Adaptive Access Manager (OAAM)構成のコンテキストで使用されます。値がTRUEの場合、チャレンジ質問はOAAMによって処理されます。

OIM.DisableChallengeQuestions

FALSE

コネクタのコンパイラ・パス

アプリケーション・サーバーに応じてJavaホームを指定します。

注意: JDKディレクトリのパスがシステム・パス変数に含まれていない場合、JDKディレクトリのパスをXL.CompilerPathシステム・プロパティに設定する必要があります。これが行われていない場合、デプロイメント・マネージャを使用したXMLファイルのインポート時に実行されるプロセスのアダプタ・コンパイル・ステージでエラーが発生します。

XL.CompilerPath

デフォルトの日付書式

APIの呼出しによってリコンシリエーション・イベントを作成し、日付書式がAPIへの引数として渡されない場合、Oracle Identity Managerでは、すべての日付フィールド値はDefault Date Formatで指定されているものとみなされます。

XL.DefaultDateFormat

yyyy/mm/dd hh:mm:ss z

一般名の生成に関するデフォルト・ポリシー

一般名の生成時に選択される一般名の生成ポリシーを定義します。

XL.DefaultCommonNamePolicyImpl

oracle.iam.identity.usermgmt.impl.plugins.FirstNameLastNamePolicy

ユーザー名の生成に関するデフォルト・ポリシー

ユーザー名を生成するときに使用されるユーザー名ポリシーを定義します。

XL.DefaultUserNamePolicyImpl

oracle.iam.identity.usermgmt.impl.plugins.DefaultComboPolicy

デフォルト・ユーザー名ドメイン

このプロパティは、DefaultComboPolicyによって電子メール形式でユーザー名を生成するために使用されます。

XL.UserNameDomain

oracle.com

ダイレクト・プロビジョニングとアクセス・ポリシー・リクエストとの競合

デフォルトでは、このプロパティの値はTRUEです。ユーザーが複数のアクセス・ポリシーを持ち、これらのポリシーで特定のリソースが複数回プロビジョニングされ、かつ1つ以上のポリシーでリソースを直接プロビジョニングできるよう指定されている場合、リソースはリクエストの作成なしにプロビジョニングされます。

このプロパティをFALSEに設定すると、直接プロビジョニングされないリソースのリクエストを作成することで競合が解決されます。競合がない場合は、リソースはアクセス・ポリシー内の定義に基づきプロビジョニングされます。

XL.DirectProvision

TRUE

ユーザーは登録時にチャレンジ情報を指定する必要があるか

値がTRUEの場合、ユーザーは登録時にチャレンジ情報を設定する必要があります。

PCQ.PROVIDE_DURING_SELFREG

TRUE

重複するチャレンジ・レスポンスは許可されています

このプロパティは、重複するチャンレンジ・レスポンスが許可されているかどうかを示すために使用されます。

XL.IsDupResponsesAllowed

FALSE

電子メール・サーバー

電子メール・サーバーの名前です。

注意: 電子メール・サーバーのシステム・プロパティ値を変更後、変更を有効にするにはサーバーを再起動する必要があります。

XL.MailServer

電子メール・サーバー

例外レポートの有効化

このプロパティは、例外レポート機能の有効化に使用されます。値がTRUEに設定されている場合にのみ、例外レポートが有効になります。

XL.EnableExceptionReports

FALSE

ユーザーが有効化された場合、無効化されたリソース・インスタンスを有効化

値がTRUEの場合、ユーザーが有効になると、無効なリソース・インスタンスが有効になります。

XL.EnableDisabledResources

TRUE

初回ログイン時にパスワードの変更を強制

Oracle Identity Manager 11g リリース1(11.1.1)では、このシステム・プロパティは使用されません。このプロパティを設定しても影響はありません。

XL.ForcePasswordChangeAtFirstLogin

TRUEまたはFALSE

このプロパティのデフォルト値は、自己登録でユーザーが作成された場合はFALSE、他の方法でユーザーが作成された場合はTRUEです。

起動時に質問を設定するよう強制

ユーザーが初めて管理およびユーザー・コンソールにログインするときに、ユーザーはパスワードのリセット用のデフォルトの質問を設定する必要があります。

PCQ.FORCE_SET_QUES

False

ターゲットLDAPディレクトリで参照整合性が有効であるかどうかを示します

ターゲットLDAPディレクトリの参照整合性がオンの場合、このプロパティの値はTRUEです。

ターゲットLDAPディレクトリの参照整合性がオフの場合、このプロパティの値はFALSEです。

XL.IsReferentialIntegrityEnabledInLDAP

FALSE

自己登録は許可されているか

値がTRUEの場合、ユーザーが自己登録を行えます。

XL.SelfRegistrationAllowed

TRUE

LDAP予約プラグイン

このプロパティは、ユーザー属性の予約用に選択するLDAP予約プラグインの実装を定義します。

XL.LDAPReservationPluginImpl

oracle.iam.identity.usermgmt.impl.plugins.reservation.ReservationInOID

ログインの最大試行回数

ユーザーが何回連続してOracle Identity Managerへのログインに失敗すると、Oracle Identity Managerでユーザー・アカウントがロックされるかを定義します。

注意: ユーザー・アカウントがロックされている場合、次のいずれかの方法でロックを解除できます。

- 「パスワードを忘れた場合」を使用したパスワードのリセット

- 委任管理者によるユーザーのロック解除

- ロック期間が終了した後の自動ロック解除(毎日実行されるユーザーの自動ロック解除スケジュール済タスクを使用して行われます)

XL.MaxLoginAttempts

10

パスワード・リセットの最大試行回数

ユーザーが何回連続してパスワードのリセットに失敗すると、Oracle Identity Managerでユーザー・アカウントがロックされるかを定義します。

重要: ユーザー・アカウントがロックされた場合、ユーザーはこれを解除できません。この場合はシステム管理者に連絡してください。

XL.MaxPasswordResetAttempts

3

チャレンジ・レスポンスの最小長

このプロパティでは、チャレンジ質問に対する回答の最小長を設定します。

XL.ResponseMinLength

0

正答数

この値は、ユーザー・パスワードをリセットするために、ユーザーが正解する必要のある質問の数を表します。

PCQ.NO_OF_CORRECT_ANSWERS

3

質問数

Webアプリケーションを使用するユーザーがユーザーのパスワードをリセットするために完了する必要のある質問の数を設定します。

PCQ.NO_OF_QUES

3

注意: PCQ.NO_OF_QUESに設定する値は、PCQ.NO_OF_CORRECT_ANSWERSに設定する値より小さくしないでください。

組織の削除/無効化アクション

このプロパティがTRUEに設定されている場合、組織にユーザーと下位組織が含まれている場合でも、ユーザーは組織を無効化および削除できます。

このプロパティがFALSEに設定されている場合、組織にユーザーと下位組織が含まれていると、ユーザーは組織を無効化および削除できません。

デフォルト値は、FALSEです。

ORG.DisableDeleteActionEnabled

FALSE

組織プロセス継承

リソースが許可されたリソースとして組織に追加された場合、このプロパティをTRUEに設定することにより、同じリソースがサブ組織に対して許可されたリソースとして自動的に追加されます。

XL.OrganizationProcessInherit

TRUE

組織プロセス制限

このプロパティはOracle Identity Managerによる内部使用のためのものです。このプロパティは使用しないでください。

XL.OrganizationProcessRestrict

FALSE

組織のセルフサービス可能

プロセスのデフォルト値がセルフ・サービス可能かどうか、またこれが設定されているかどうかを決定します。

これは、セルフ・リクエスト可能なリソースの決定に使用されます。これは、Oracle Identity Manager Design Consoleからのオプション選択と同様です。唯一の違いは、このシステム・プロパティを使用すると、特定の組織に対して許可されることです。

ORG.SELF_SERVICEABLE_DEFAULT

FALSE

取消保留中のタスク

このプロパティをTRUEに設定し、タスクの保留中の取消しを許可した場合、対応するプロセス・インスタンスが取り消されると、これらのタスクは「Pending Cancelled (PX)」ステータスに移動されます。プロパティをFALSEに設定した場合、対応するプロセス・インスタンスが取り消されると、タスクは「Cancelled (X)」ステータスに移動されます。対応するリソース・インスタンスが失効した場合、Oracle Identity Managerによってプロセス・インスタンスが呼び出されることに注意してください。

XL.PendingCancelled

true

遅延ユーザー削除までの期間

このプロパティはユーザーを削除するまでの期間を指定するために使用されます。このプロパティが設定されており、ユーザーが削除される場合は、ユーザーの状態は無効に変更され、「自動削除日」に現在の日付に遅延期間を加えた日付が設定されます。

XL.UserDeleteDelayPeriod

0

データベース名を表示するかどうかを指定するプロパティ

値がTRUEの場合、データベース名がDesign Consoleに表示されます。

XL.TOOLBAR_DBNAME_DISPLAY

TRUE

保留中承認について設定された日数制限を示すプロパティ

アクティブ/非アクティブ・タスクの分離機能の実行前に使用され、保留中の承認タスクが取得される期間を指定します。APIレベルで使用され、保留中の承認に関連するカウンタが取得されます。

注意: このプロパティは使用しないでください。このリリースでは、内部使用の目的でのみ残されています。Oracle Identity Managerの今後のリリースで削除される予定です。

XL.OpenTask.DayLimit

30

オープン・タスクと保留中承認の期間を月数で示すプロパティ

注意: このプロパティは使用しないでください。このリリースでは、内部使用の目的でのみ残されています。Oracle Identity Managerの今後のリリースで削除される予定です。

XL.OpenTasksPendingApprovalsDuration

3

監査エンジンがJMSメッセージを送信する必要があるかどうかを示すプロパティ

このプロパティの値がTrueに設定され、XL.UserProfileAuditDataCollectionプロパティが監査日収集レベルに設定されている場合は、アカウント・リコンシリエーションによってバッチレベルでデータベース・レイヤーでのマッチングが実行され、プロビジョニングAPIを使用してイベント処理が実行されます。これによって、アカウント・リコンシリエーション用の監査イベント・ハンドラがトリガーされます。アカウント・リコンシリエーションの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのアカウント・リコンシリエーションに関する項を参照してください。

注意: このプロパティはOracle Identity Managerによる内部使用のためのものです。このプロパティは使用しないでください。

XL.SendAuditJMSMessage

false

プロキシ・ユーザー電子メール通知

対応するPTY_VALUEは、プロキシ・ユーザーの作成時に送信される電子メール定義名です。ユーザーに他のユーザーのプロキシが作成されると、通知電子メールがユーザーに届きます。

XL.ProxyNotificationTemplate

Notify Proxy User

リコンシリエーション・バッチ・サイズ

このプロパティは、リコンシリエーションのバッチ・サイズを指定するために使用されます。リコンシリエーションがバッチで実行されないことを示すには、この値に0を指定します。

注意: このプロパティの設定後は、Oracle Identity Managerを再起動する必要があります。

OIM.ReconBatchSize

500

レコード読取り制限

管理およびユーザー・コンソールで問合せの結果セットに表示できる最大レコード数を設定します。

XL.READ_LIMIT

500

リクエスト通知レベル

このプロパティは、リクエストの作成時またはリクエスト・ステータスの変更時に、リクエスタと受益者に通知を送信するかどうかを示します。

このプロパティの値が0の場合、通知機能は無効です。値が1の場合は、通知機能は有効です。

RequestNotificationLevel

0

生成されたパスワードでリセット

ユーザーのパスワードをリセットする場合、委任管理者によってパスワードがリセットされる方法をこのプロパティで定義します。

このプロパティをtrueに設定すると、パスワードは常に自動生成されます。falseに設定すると、パスワードを手動で設定する追加オプションが提供されます。

XL.ResetWithGeneratedPwd

TRUE

検索停止件数

このプロパティは、詳細検索の結果に表示されるレコードの最大数を定義します。指定された検索条件でこのプロパティの値を超える数のレコードが返される場合は、表示されるレコードの数はこの値に制限されます。さらに、結果が最大数を超えることを示す警告が表示され、追加属性を使用して検索を絞り込む必要があります。

XL.IDADMIN_STOP_COUNT

300

グループ・ユーザーに割り当てられたタスクのうち、負荷が最も少ないタスクのみを表示

値がTRUEの場合、割当てタイプが「最小ロードのグループ・ユーザー」の場合のみ、負荷が最も低いグループ・ユーザーにタスクが割り当てられます。

XL.ShowTaskAssignedToGroupUserOnly

FALSE

使用されるLDAPコンテナ・マッパー・プラグインを指定します

Oracle Identity ManagerをLDAP同期を有効にしてインストールした場合、このプラグインでユーザーおよびロールをどのコンテナに作成するかを指定します。このシステム・プロパティの値は、コンテナ値の算出に使用されるデフォルトのOracle Identity Managerプラグイン名を示します。デフォルトのプラグインが要件を満たさない場合は、コンテナを指定する独自のプラグインを定義し、このシステム・プロパティでそのプラグインの名前を指定できます。

注意: このプラグインの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのLDAPコンテナ・ルールの開発に関する説明を参照してください。

LDAPContainerMapperPlugin

oracle.iam.ldapsync.impl.DefaultLDAPContainerMapper

チャレンジ質問変更用URL

ユーザーがロックされると、所定の期間が経過した後で自動ロック解除が発生します。このプロパティは、この期間を秒単位で定義します。たとえば、ユーザー・アカウントがロックされ、このプロパティの値が86400秒(1日)の場合は、アカウントは1日後に自動的にロック解除されます。

このプロパティの値は、チャンレンジ質問を処理するOAAM内のURLです。次に例を示します。

http://OAAM_HOST:OAAM_PORT/OAAM_SERVER/userPreferences.do?showView=registerQuestions

OIM.ChallengeQuestionsModificationURL

NONE

パスワードの変更用URL

このプロパティは、OIM.DisableChallengeQuestionsプロパティと組み合わせて使用します。このプロパティの値は、パスワードの変更機能を処理するOAAM内のURLです。次に例を示します。

http://OAAM_HOST:OAAM_PORT/OAAM_SERVER/userPreferences.do?showView=changePassword

OIM.ChangePasswordURL

NONE

パスワードを忘れた場合のURL

このプロパティは、OIM.DisableChallengeQuestionsプロパティと組み合わせて使用します。このプロパティの値は、パスワード忘れの機能を処理するOAAM内のURLです。次に例を示します。

http://OAAM_HOST:OAAM_PORT/OAAM_SERVER/forgotPassword.do

OIM.ForgtoPasswordURL

NONE

一定期間後にアカウントを自動ロック解除

このプロパティは、指定された期間後にユーザー・アカウントのロックを自動的に解除するために使用されます。

XL.UnlockAfter

86400秒(1日)

行制限の使用

注意: このプロパティはOracle Identity Managerによる内部使用のためのものです。このプロパティは使用しないでください。

XL.UseRowRestriction

FALSE

デフォルト質問の使用

顧客がUIをカスタマイズしてエンドユーザーが独自のチャレンジ質問を設定できるようにしている場合、このプロパティによりユーザーがWebアプリケーションで事前定義されたリストからチャレンジ質問を選択する必要があるかどうか、また、ユーザーが独自の質問を設定する必要があるかどうかを決定します。

注意: エンドユーザーが独自のチャレンジ質問を設定する機能は、標準のすぐに使用できるユーザー・インタフェースでサポートされています。

PCQ.USE_DEF_QUES

TRUE

APIパラメータでセミコロンをデリミタとして使用

このプロパティは、APIの入力パラメータ値のデリミタとしてセミコロンを使用するかどうかの指定に使用されます。一部のAPIでは、セミコロンで区切られた文字列入力値を受け入れていました。これは、かわりに縦線(|)を使用するように変更されています。下位互換性を保つために、この新しいプロパティを使用してセミコロンを使用するように戻すことができます。デフォルト値はFALSEで、"|"の使用を表します。TRUEに設定すると、APIの入力でセミコロンを区切り文字として受け入れます。

XL.UseSemiColonAsDelimiter

FALSE

ユーザー属性予約有効

このプロパティは、ユーザー属性予約を有効にするために使用されます。

XL.IsUsrAttribReservEnabled

TRUE

ユーザーID再利用プロパティ

削除されたユーザー・アカウントを再利用可能にするかどうかを決定します。削除されたユーザー・アカウントを再利用するには、このプロパティにTRUEの値を割り当て、USR表のUSR_LOGIN列の一意の索引を削除して、一意でない索引を作成します。ユーザー・アカウントが再利用されないようにするには、このプロパティにFALSEの値を割り当てます。

XL.UserIDReuse

FALSE

ユーザー言語

user.languageの値は、インストール時にサーバー側のロケール処理用に構成されます。

user.language

en

ユーザー・リージョン

user.regionの値は、インストール時にサーバー側のロケール処理用に構成されます。

user.region

US

ユーザー設定

user.variantの値は、インストール時にサーバー側のロケール処理用に構成されます。

user.variant

ユーザー・プロファイル監査データ収集レベル

このプロパティは、ユーザーの作成、修正または削除、ロールの付与または取消し、リソースのプロビジョニングまたはプロビジョニング解除など、ユーザーに対する操作を実行するときに監査目的で収集されるユーザー・プロファイルデータを管理します。「リソース・フォーム」や「なし」などのプロパティ値に応じて、データがUPA表に移入されます。

監査レベルはこのプロパティの値として指定されます。サポートされるレベルは次のとおりです。

- プロセス・タスク: リソース・ライフサイクル・プロセスでユーザー・プロファイル・スナップショット全体をまとめて監査します。

- リソース・フォーム: ユーザー・レコード、ロール・メンバーシップ、プロビジョニングされたリソースおよびリソースに関連付けられたすべてのフォーム・データを監査します。

- リソース: ユーザー・レコード、ロール・メンバーシップおよびプロビジョニングされたリソースを監査します。

- メンバーシップ: ユーザー・レコードおよびロール・メンバーシップのみを監査します。

- コア: ユーザー・レコードのみを監査します。

- なし: 監査データは格納されません。

XL.UserProfileAuditDataCollection

リソース・フォーム

XL.SoDCheckRequired

このプロパティは、職務の分離(SoD)チェックが必要かどうかを指定します。

XL.SoDCheckRequired

FALSE

Xellerateユーザー・リソースのプロビジョニング・モード

このプロパティは、ユーザーの組織に対するXellerateユーザー・リソースのプロビジョニングが、ストアド・プロシージャを通じてデータベース・レイヤーで、またはイベント・ハンドラを介してJavaレイヤーで行われるかどうかを決定します。

注意: イベント・ハンドラの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドを参照してください。

このプロパティに設定できる値は次のとおりです。

- Db: ユーザーの組織に対するXellerateユーザー・リソースのプロビジョニングは、ストアド・プロシージャを通じてデータベース・レイヤーで行われます。これによりさらにプロセスがトリガーされることはありません。そのため、Xellerateユーザー・リソースに関連付けられたXellerateユーザー・プロビジョニング・プロセスに関連付けられているカスタム・タスクが実行されます。

- Java: ユーザーの組織に対するXellerateユーザー・リソースのプロビジョニングは、イベント・ハンドラを介してデータベース・レイヤーで行われます。Xellerateユーザー・リソースに関連付けられたXellerateユーザー・プロビジョニング・プロセスに関連づけられているカスタム・タスクが実行されます。これは、以前のリリースのOracle Identity Managerでプロビジョニング・プロセスに関連付けられている独自のタスクがあり、11gにアップグレード後もこれを継続して実行するようなアップグレード・シナリオにも適用できます。このようなシナリオでは、このプロパティの値をJavaに設定します。

XL.UserResource.ProvisionMode

Db

ロール付与はリクエストをトリガー

このプロパティが存在し、その値がtrueの場合、ロール付与には承認を条件とするリクエストが使用されます。これによってSODチェックが有効化または無効化されることはありません。

このプロパティの値がfalseの場合、ロール付与にリクエストが使用されることなく実行されます。

注意: ロール付与はリクエストをトリガーシステム・プロパティの変更後は、その変更を反映するためにOracle Identity Managerを再起動する必要があります。

XL.RM_REQUEST_ENABLED

false

ロール割当てテンプレート名

RM_REQUEST_ENABLEDプロパティが存在しないか、その値がfalseの場合、RM_ROLE_ASSIGN_TEMPLATEの影響はありません。

RM_REQUEST_ENABLEDの値がtrueで、かつRM_ROLE_ASSIGN_TEMPLATEが存在しないか、その値として有効なテンプレート名を持っていない場合、エラー・メッセージが表示され、ロール付与は実行されません。デフォルトのリクエスト・テンプレートはありません。

RM_REQUEST_ENABLEDの値がtrueで、かつRM_ROLE_ASSIGN_TEMPLATEの値として有効なテンプレート名が指定されている場合、ロール付与にそのリクエスト・テンプレートが使用されます。

XL.RM_ROLE_ASSIGN_TEMPLATE

エンティティ変更のLDAPコンテナ・ルールの評価

このプロパティの値がTRUEの場合、LDAPContainerRules.xmlに定義されているLDAPコンテナ・ルールがエンティティ変更に対して評価されます。ただし、ルールのいずれも一致しない場合、デフォルト・コンテナは戻されません。エンティティの元の親コンテナが戻されます(つまりエンティティDNは変更されません)。詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのLDAPコンテナ・ルールの構成に関する説明を参照してください。

このプロパティの値がFALSEの場合、LDAPContainerRules.xmlに定義されているLDAPコンテナ・ルールは評価されません。エンティティDNは変更されません。

注意: このプロパティは、変更シナリオにのみ適用され、エンティティの作成シナリオには適用されません。

LDAPEvaluateContainerRulesForModify

FALSE

リコンシリエーションの通知送信

信頼できるソース・リコンシリエーション経由で、ユーザー作成のための後処理イベント・ハンドラによってユーザー・ログインおよびパスワードが生成されたときに、ユーザーに通知を送信するかどうかを定義します。

この値をtrueに設定すると、信頼できるソース・リコンシリエーション経由で、ユーザー作成のための後処理イベント・ハンドラによってユーザー・ログインおよびパスワードが生成されたときに、通知が送信されます。

この値をfalseに設定すると、信頼できるソース・リコンシリエーション経由で、ユーザー作成のための後処理イベント・ハンドラによってユーザー・ログインおよびパスワードが生成されたときに、通知が送信されません。

Recon.SEND_NOTIFICATION

true

電子メールの一意性を検証するかどうか

このプロパティは、Oracle Identity Managerの以前のリリースからアップグレードしたOracle Identity Manager 11g リリース1(11.1.1)デプロイメントで使用できます。

このプロパティの値がFALSEの場合、Oracle Identity Managerで電子メールの一意性チェックは実行されません。

値がTRUEの場合、Oracle Identity Managerで電子メールの一意性チェックが実行されます。

注意: このプロパティが存在しない場合は、Oracle Identity Managerで電子メールの一意性チェックが実行されます。

OIM.EmailUniqueCheck

TRUE

組織の検索時に9.x権限チェックを有効化

このプロパティは、ユーザーが実行する組織検索での組織の表示を制御します。XL.EnableOrgPermissionCheck = falseの場合、ユーザーが組織を検索したときに、すべての組織が表示されます。XL.EnableOrgPermissionCheck = trueであるか、またはこのプロパティが削除されている場合は、検索を実行しているユーザーに割り当てられている組織のみが表示されます。

XL.EnableOrgPermissionCheck

TRUE

Oracle Identity Managerでは、PTY表にデフォルトでは存在しない、一連のシステム・プロパティが提供されています。管理およびユーザー・コンソールを使用してこれらのシステム・プロパティをPTY表に追加し、これらのプロパティを使用してOracle Identity Managerのデフォルト設定の一部を変更できます。たとえば、汎用テクノロジ・コネクタ(GTC)の作成時に生成されるデプロイメント・マネージャXMLファイルを保存する必要がある場合は、それが実行されるようにGTC自動インポート・システム・プロパティを構成できます。

関連項目:

GTCの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドを参照してください。

表4-2に、PTY表に追加できるシステム・プロパティを示します。

表4-2 デフォルト以外のシステム・プロパティ

プロパティ名

説明

キーワード

サンプル値

OIMデータベース問合せ再試行回数

Oracle RACの失敗を処理するために再試行されるSQL問合せの回数。

このプロパティがPTY表にない場合、Oracle RACの失敗を処理するSQL問合せはデフォルトで3回再試行されます。

OIM.DBQueryRetryAttempts

5

OIMデータベース問合せ再試行間隔

Oracle RACの失敗に対して行われるSQL問合せの各再試行の間隔秒数。

このプロパティがPTY表にない場合、SQL問合せはデフォルトで7秒間隔で実行されます。

OIM.DBQueryRetryInterval

10秒

JDBC接続再試行回数

JDBC接続に失敗したときにOracle Identity Managerが接続を取得するために再試行する回数。

このプロパティがPTY表にない場合、JDBC接続はデフォルトで3回再試行されます。

OIM.JDBCConnectionRetryAttempts

5

値が0の場合、再試行は行われません。

JDBC接続再試行間隔

JDBC接続の各再試行の間隔秒数。

このプロパティがPTY表にない場合、JDBC接続再試行は7秒間隔で行われます。

OIM.JDBCConnectionRetryInterval

10秒

GTC自動インポート

このプロパティの値に応じて、GTC作成時に生成されたDM xmlがディレクトリに保存されます。

このプロパティのデフォルト値はtrueです。

このプロパティの値をFalseに設定すると、GTCの作成時にGTCフレームワークによって作成されたDM xml (GTC作成時にGTCがデプロイメント・マネージャを使用して内部的に作成してインポートするxml)は、次のディレクトリに格納されます。

OIM_HOME/GTC/XMLOutput

DM xmlは次のネーミング規則に従います。

GTCNAME_CURRENTDATE_ TIMESTAMP、日付形式は"yyyy-MM-dd-HH-mm-ss".xmlを使用

次に例を示します。

TRUSTEDCSV_2009-02-05-22-41-11.xml

XL.GTCAutoImport

False

FA cookie-http-onlyフラグがオンで

このプロパティは、FAプロビジョニング・システムによって、RoleCategorySeedMXBeanImplMBeanを使用してシードされます。

デフォルトでは、このプロパティの値はtrueです。Oracle Identity Managerを非HTTPのcookieのみの環境で実行する必要がある場合は、このプロパティの値をfalseに設定します。

FA.CookieHTTPOnly

true

4.2 システム・プロパティの作成と管理

この項の内容は次のとおりです。

- システム・プロパティの作成

- キャッシュのパージ

- システム・プロパティの検索

- システム・プロパティの変更

- システム・プロパティの削除

4.2.1 システム・プロパティの作成

Oracle Identity Managerには、独自のシステム・プロパティを作成する機能があります。「Oracle Identity Managerのシステム・プロパティ」にリストされている事前定義済システム・プロパティを使用しないで、要件に合わせてシステム・プロパティを作成できます。

システム・プロパティは、Oracle Identity Manager管理で「システム・プロパティの作成」ページを使用して作成できます。このページは、システム・プロパティを作成する権限がある場合のみ開くことができます。

システム・プロパティの作成時に、「プロパティ名」、「キーワード」、「値」フィールドの値を指定します。これらの値はOracle Identity ManagerデータベースのPTY表に保存されます。

システム・プロパティを作成するには:

1. 「システム管理」タブをクリックし、次に「システム構成」をクリックします。

2. 左ペインの「アクション」メニューから、「作成」を選択します。または、ツールバーの作成アイコンをクリックします。図4-1に示すように、「システム・プロパティの作成」ページが表示されます。

図4-1「システム・プロパティの作成」ページ

「図4-1「システム・プロパティの作成」ページ」の説明

3. 「システム・プロパティの作成」フォームで、システム・プロパティの詳細を入力します。表4-3にこのフォームのフィールドを示します。

表4-3「システム・プロパティの作成」フォームのフィールド

フィールド

説明

プロパティ名

システム・プロパティの名前を入力します。

キーワード

システム・プロパティの一意のIDを入力します。キーワードは、任意の形式で入力できます。

注意: プロパティ名は様々なロケールに変換できますが、キーワードは変換できません。

値

システム・プロパティの値(たとえば4)を入力します。

注意:

システム・プロパティを作成または更新する場合、「キーワード」フィールドの先頭または末尾に特殊文字(.)を使用できません。「値」フィールドの場合は、先頭または末尾に特殊文字を使用できます。

4. 「実行」をクリックしてシステム・プロパティを作成します。システム・プロパティが作成されたことを確認するメッセージが表示されます。作成された新しいシステム・プロパティに対して、デフォルトで「データ・レベル」は2に、login_requiredはtrueに設定されます。
システム・プロパティの作成後、SQLを使用して、次のシステム・プロパティ・フィールド(データベースのPTY表に記録されるシステム・プロパティに自動的に追加されます)の値を設定できます。

- データ・レベル: 各システム・プロパティにはデータ・レベルが関連付けられています。「「データ・レベル」フィールドは、システム・プロパティで実行できる操作の種類を定義します。データ・レベルによって、システム・プロパティで実行できる操作を指定します。たとえば、システム・プロパティのデータ・レベルの値が1の場合、システム・プロパティは変更も削除もできないことを示します。このフィールドのデフォルト値は2です。
「「データ・レベル」フィールドは、UIを使用して変更できません。これはSQLスクリプトでのみ変更できます。表4-3に、システム・プロパティに関連付けられる各種データ・レベルのリストと説明を示します。

表4-4 システム・プロパティに関連付けられるデータ・レベル

データ・レベル

説明

0

システム・プロパティを変更または削除できることを示します。

1

システム・プロパティを変更または削除できないことを示します。

2

システム・プロパティを変更のみできることを示します。

3

システム・プロパティを削除のみできることを示します。

- ログイン必須: このフィールドはシステム・プロパティにアクセスするためにログインが必要かどうかを指定します。このフィールドのデフォルト値は1で、システム・プロパティにアクセスするにはログインが必要なことを意味します。このフィールドの値は、SQLスクリプトを使用して0に変更できます。

- LKU_KEY: このフィールドでは、システム・プロパティの「値」フィールドで指定できる値セットを定義します。新規作成されたシステム・プロパティに対するこのフィールドのデフォルト値はnullです。
Oracle Identity Managerでは、2つの表(LKU表およびLKV表)を使用してセットを表します。LKU表には、各セットを識別するキーが保持されます。LKV表では各セットのメンバーが定義され、LKV表の各行ではセットを識別する1列(LKU表のLKU_KEY列)、およびセットのメンバーとなる値を宣言する別の列が使用されます。

LKU_KEYは、Oracle Identity ManagerデータベースのLKU表の列です。LKU_KEY列の値がnullでないシステム・プロパティでは、LKV表にある事前定義済の値セットからこの列に値を挿入できます。これはSQLスクリプトを使用して行い、LKU表から取得したLKU_KEY列の有効な値を含めて、複数の値をシステム・プロパティに関連付けます。詳細はステップ7を参照してください。

5. システム・プロパティのデータ・レベルを変更する必要がある場合は、次のSQL文を実行します。

UPDATE PTY SET PTY_DATA_LEVEL=DATA_LEVEL_VALUE WHERE PTY_KEYWORD = SYSTEM_PROPERTY_KEYWORD;

このSQL文の説明は次のとおりです。

- DATA_LEVEL_VALUEは、表4-4の「「データ・レベル」列にリストされている値です。

- SYSTEM_PROPERTY_KEYWORDは、ステップ3で「キーワード」フィールドに入力したシステム・プロパティの一意のIDです。

注意:

システム・プロパティを作成または更新する場合、「キーワード」フィールドの先頭または末尾に特殊文字(.)を使用できません。「値」フィールドの場合は、先頭または末尾に特殊文字を使用できます。

6. 「ログイン必須」フィールドの値を変更するには、次のコマンドを実行します。

UPDATE PTY SET PTY_LOGINREQUIRED=LOGIN_REQUIRED_VALUE WHERE PTY_KEYWORD = SYSTEM_PROPERTY_KEYWORD;

このコマンドにおいて:

- LOGIN_REQUIRED _VALUEの値は0か1のいずれかです。
システム・プロパティにアクセスする際にログインを必要とする場合は1.、その他の場合は0.を入力します。

- SYSTEM_PROPERTY_KEYWORDは、ステップ3で「キーワード」フィールドに入力したシステム・プロパティの一意のIDです。

7. システム・プロパティの「値」フィールドで指定できる値セットを定義するには、次のコマンドを実行します。

1. 次のコマンドを実行し、LKU表に行を挿入します。

INSERT INTO LKU (LKU_KEY, LKU_LOOKUP_KEY, LKU_TYPE, LKU_GROUP, LKU_REQUIRED, LKU_TYPE_STRING_KEY, LKU_FIELD, LKU_DATA_LEVEL, LKU_CREATE, LKU_CREATEBY, LKU_UPDATE, LKU_UPDATEBY, LKU_NOTE, LKU_ROWVER) VALUEs (LKU_KEY_VALUE, LKU_LOOKUP_KEY_VALUE,...);

たとえば、Titleフィールド用の値セットを更新するには、次のINSERT文を実行します。

INSERT INTO LKU (LKU_KEY, LKU_LOOKUP_KEY, LKU_TYPE, LKU_GROUP, LKU_REQUIRED, LKU_TYPE_STRING_KEY, LKU_FIELD, LKU_DATA_LEVEL, LKU_CREATE, LKU_CREATEBY, LKU_UPDATE, LKU_UPDATEBY, LKU_NOTE, LKU_ROWVER) VALUES (201, Title, ...);

ここで、LKU_KEY_VALUEは201で、LKU表でレコードを一意に識別します。LKU_LOOKUP_KEY_VALUEはTitleです。

注意:

LKU_KEYの値はLKVの挿入文で使用されるため、LKU表にレコードを挿入してからLKV表にレコードを挿入する必要があります。

2. LKV表に行を挿入するには、次のコマンドを実行します。

INSERT INTO LKV (LKV_KEY, LKU_KEY, LKV_ENCODED, LKV_DECODED, LKV_LANGUAGE, LKV_COUNTRY, LKV_VARIANT, LKV_DISABLED, LKV_DATA_LEVEL, LKV_CREATE, LKV_CREATEBY, LKV_UPDATE, LKV_UPDATEBY, LKV_NOTE, LKV_ROWVER) VALUES (LKV_KEY_VALUE, LKU_KEY_VALUE, LKV_ENCODED_VALUE, LKV_DECODED_VALUE, ...);

たとえば、Titleフィールド用の値セットにMr、Ms、Drを定義するには、次のINSERT文を実行します。

INSERT INTO LKV (LKV_KEY, LKU_KEY, LKV_ENCODED, LKV_DECODED, LKV_LANGUAGE, LKV_COUNTRY, LKV_VARIANT, LKV_DISABLED, LKV_DATA_LEVEL, LKV_CREATE, LKV_CREATEBY, LKV_UPDATE, LKV_UPDATEBY, LKV_NOTE, LKV_ROWVER) VALUES (1001, 201, 'Ms', 'Miss', ...);

INSERT INTO LKV (LKV_KEY, LKU_KEY, LKV_ENCODED, LKV_DECODED, LKV_LANGUAGE, LKV_COUNTRY, LKV_VARIANT, LKV_DISABLED, LKV_DATA_LEVEL, LKV_CREATE, LKV_CREATEBY, LKV_UPDATE, LKV_UPDATEBY, LKV_NOTE, LKV_ROWVER) VALUES (1002, 201, 'Mr', 'Mister', ...);

INSERT INTO LKV (LKV_KEY, LKU_KEY, LKV_ENCODED, LKV_DECODED, LKV_LANGUAGE, LKV_COUNTRY, LKV_VARIANT, LKV_DISABLED, LKV_DATA_LEVEL, LKV_CREATE, LKV_CREATEBY, LKV_UPDATE, LKV_UPDATEBY, LKV_NOTE, LKV_ROWVER) VALUES (1003, 201, 'Dr', 'Doctor', ...);

この例において:

- LKV_KEY_VALUEはそれぞれ、1001、1002、1003で、LKV表のレコードを一意に識別します。

- LKV_ENCODED_VALUEはそれぞれ、Ms、Mr、Drです。

- LKV_DECODED_VALUEはそれぞれ、Miss、Mister、Doctorです。

関連項目:

LKUおよびLKV表の詳細は、第13章「ユーザー属性の構成」を参照してください。

3. PTY表のLKU_KEY列の値を更新するには次のコマンドを実行します。
UPDATE PTY SET LKU_KEY=LKU_KEY_COLUMN_IN_THE_LKV_TABLE WHERE PTY_KEYWORD = SYSTEM_PROPERTY_KEYWORD;

このコマンドにおいて:

- LKU_KEY_COLUMN_IN_THE_LKV_TABLEは、LKV表のLKU_KEY列の値です。

- SYSTEM_PROPERTY_KEYWORDは、ステップ3で「キーワード」フィールドに入力したシステム・プロパティの一意のIDです。

注意:

ORACLE Identity Manager拡張管理で変更内容を表示するには、システム・プロパティの変更直後にMicrosoft SQLを使用してキャッシュのパージを実行する必要があります。

4.2.2 キャッシュのパージ

拡張管理以外の方法でシステム・プロパティを変更した場合は、必ずパージのキャッシュを実行してOracle Identity Managerに変更を反映させる必要があります。

サーバー・キャッシュをクリアするには、次の手順を実行します。

注意:

PurgeCacheユーティリティを実行する前に、DOMAIN_HOME/bin/setDomainEnv.shスクリプトを実行する必要があります。

1. 使用しているオペレーティング・システムに応じて、次のディレクトリに移動します。

- Microsoft Windowsの場合:
OIM_HOME\server\bin\

- UNIXの場合:
OIM_HOME/server/bin/

2. 次のいずれかのコマンドを実行します。

- Microsoft Windowsの場合:
PurgeCache.bat CATEGORY_NAME

- UNIXの場合:
PurgeCache.sh CATEGORY_NAME

CATEGORY_NAME名前引数は、パージするOracle Identity Managerのカテゴリ名(FormDefinitionなど)を表します。すべてのカテゴリをパージするには、"All"という値をPurgeCacheユーティリティに渡します。カテゴリはすべて消去することをお薦めします。

4.2.3 システム・プロパティの検索

Oracle Identity Manager拡張管理により、システム・プロパティに対して次のタイプの検索操作を実行できます。

- 単純検索の実行

- 拡張検索の実行

4.2.3.1 単純検索の実行

システム・プロパティの単純検索を実行するには:

1. Oracle Identity Manager管理の「ようこそ」ページの「システム管理」で、「システム構成」をクリックします。または、システム管理」タブ、「システム構成」の順にクリックします。

2. 左ペインの「検索」フィールドに、検索するシステム・プロパティの検索基準を入力します。検索基準にはワイルドカード文字(*)を使用できます。
「検索」フィールドに*を入力すると、すべてのシステム・プロパティが表示されます。文字とワイルドカード文字を組み合わせて検索をフィルタできます。たとえば、pで始まるシステム・プロパティを検索するには、「検索」フィールドにp*を入力します。

3. 「検索」フィールドの横のアイコンをクリックします。図4-2に示すように、検索基準を満たすすべてのシステム・プロパティのリストが表示されます。

図4-2 システム・プロパティのリスト

検索結果表にシステムプロパティの名前とキーワードが表示されます。プロパティ名をクリックすると、そのシステム・プロパティの詳細が表示されます。

4.2.3.2 拡張検索の実行

システム・プロパティの拡張検索を実行するには:

1. 「システム構成」セクションの左ペインで、「拡張検索」をクリックします。「プロパティ: 拡張検索」ページが表示されます。

2. 「プロパティ名」フィールドの横に表示されるリストから、検索条件を選択します。

3. 「プロパティ名」フィールドで、検索するシステム・プロパティの検索基準を入力します。検索基準にはワイルドカード文字(*)を使用できます。フィールドの横に表示されるリストから検索条件を選択します。検索条件には、「次を含まない」、「次で始まらない」、「次と等しくない」、「次と等しい」、「次で終わる」、「次で終わらない」、「次を含む」および「次で始まる」があります。

4. 「検索」をクリックします。図4-3に示すように、検索結果表に検索基準に一致するシステム・プロパティが表示されます。

図4-3 拡張検索結果

「図4-3 拡張検索結果」の説明

検索結果には、各システム・プロパティのキー、プロパティ名、キーワード、値、許可された値および日付レベルが表示されます。

4.2.4 システム・プロパティの変更

修正操作により、「システム・プロパティ詳細」ページを使用して既存のシステム・プロパティを変更できます。システム・プロパティを許可された値セットでタグ付けすると、そのセットのみから値を指定する必要があります。

注意:

複数の値が割り当てられたシステム・プロパティを変更する場合、変更する値がLKU表およびLKV表で定義された値の一部でない場合はメッセージが表示されます。システム・プロパティへの複数の値の関連付けについての詳細は、「システム・プロパティの作成」のステップ7を参照してください。

システム・プロパティを変更するには:

1. 変更するシステム・プロパティを検索します。

2. 検索結果表の「プロパティ名」列で、変更するシステム・プロパティをクリックします。
表4-4に示すように、「システム・プロパティ詳細」ページが表示されます。

図4-4「システム・プロパティ詳細」ページ

「図4-4「システム・プロパティ詳細」ページ」の説明

3. 「プロパティ名」、「キーワード」、「値」フィールドを変更する場合は、「システム・プロパティの作成」のステップ3を参照してください。

4. 「ログイン必須」を変更する場合は、「システム・プロパティの作成」のステップ6を実行してください。

5. 「許可された値」列を変更する場合は、「システム・プロパティの作成」のステップ7を実行してください。

6. システム・プロパティに関連付けられたデータ・レベルを変更するには、「システム・プロパティの作成」のステップ5を実行してください。

7. 変更モードを保存するには、「保存」をクリックします。
システム・プロパティが変更されたことを確認するメッセージが表示されます。

4.2.5 システム・プロパティの削除

システム・プロパティを削除するには:

注意:

システム・プロパティは、そのシステム・プロパティのデータ・レベルが0または3のいずれかに設定されている場合のみ削除できます。システム・プロパティに関連付けられたデータ・レベルが適切でない場合は、システム・プロパティの削除時にメッセージが表示されます。データ・レベルについては、表4-4 「システム・プロパティに関連付けられらたデータ・レベル」を参照してください。

1. 「システム管理」タブをクリックし、次に「システム構成」をクリックします。

2. 左ペインで、削除するシステム・プロパティを検索します。

3. 検索結果表の「プロパティ名」列で、削除するシステム・プロパティを選択します。

4. 「アクション」メニューから「削除」を選択します。確認を求めるメッセージが表示されます。「OK」をクリックします。

5. システム・プロパティが削除されたことを確認するメッセージが表示されます。「OK」をクリックします。

5 デプロイメント・マネージャを使用したデータのインポートおよびエクスポート

デプロイメント・マネージャは、Oracle Identity Manager構成のエクスポートおよびインポートに使用するツールです。デプロイメント・マネージャを使用すると、Oracle Identity Manager構成を形成しているオブジェクトをエクスポートできます。デプロイメント・マネージャは通常、あるデプロイメントから別のデプロイメントへ、たとえばテスト・デプロイメントから本番デプロイメントへの構成の移行や、システムのバックアップの作成に使用します。

重要:

デプロイメント・マネージャを使用するには、Oracle Identity Manager管理およびユーザー・コンソールを実行するコンピュータにJRE 1.4.2以上のバージョンがインストールされている必要があります。

構成内のオブジェクトの一部またはすべてを保存することができます。これにより、テスト環境で構成を開発およびテストしてから、テスト済オブジェクトを本番環境にインポートすることができます。オブジェクトとその依存オブジェクトや関連オブジェクトすべてを同時にエクスポートおよびインポートできます。または、各オブジェクトを個別にエクスポートおよびインポートすることも可能です。

デプロイメント・マネージャにより、ソース・システムから構成情報を取り出し、XMLファイルに情報を格納し、それからXMLファイルからターゲット・システムに情報をインポートできます。Oracle Identity Manager 11g リリース1(11.1.1)では、デプロイメント・マネージャにより、Oracle Identity Managerデータベース、メタデータ・ストア(MDS)リポジトリまたはAPIリポジトリからデータをインポートできます。結果として、これらのリポジトリから、システム・プロパティ、ジョブ、スケジュール済タスクなど、同じリポジトリにないあらゆるタイプのオブジェクトをインポートできます。たとえば、データベースのかわりにMDSリポジトリにあるスケジュール済タスクをインポートすることも可能です。

あるタイプのリポジトリからエクスポートされたオブジェクトは、それと同じタイプのリポジトリにインポートされます。たとえば、スケジュール済タスクがMDSリポジトリからエクスポートされた場合、そのスケジュール済タスクはターゲット・システムの同じリポジトリ、つまりMDSにインポートされます。

この章の内容は次のとおりです。

- デプロイメント・マネージャの機能

- デプロイメントのエクスポート

- デプロイメントのインポート

- エンティティの水平移行

- デプロイメント・マネージャの使用に関連するベスト・プラクティス

- 水平移行ユーティリティの使用に関連するベスト・プラクティス

- トラブルシューティング

5.1 デプロイメント・マネージャの機能

Oracle Identity Managerデプロイメントをあるサーバー環境から別のサーバー環境に移行する場合、たとえばテスト環境からステージング環境、あるいはステージング環境から本番環境に移行する場合には、デプロイメント・マネージャを使用します。

デプロイメント・マネージャにより、次のことをが可能になります。

- デプロイの個々のコンポーネントを、異なるテスト環境で更新します。

- エクスポートするコンポーネントに関連するオブジェクトを特定し、リソースに含めることができます。

- エクスポート済ファイルの情報を提供します。

- コメントを追加します。

デプロイメント・マネージャは、次のタイプの情報を処理します。

- ロール

- 組織

- アクセス・ポリシー

- アテステーション・プロセス

- 認可ポリシー

- ユーザー・メタデータ

- ロールおよび組織のメタデータ

- スケジュール済タスク

- スケジュール済ジョブ

- ITリソース

- リソース・オブジェクト

- 参照定義

- プロセス・フォーム

- プロビジョニング・ワークフローおよびプロセス・タスク・アダプタ

- データ・オブジェクト定義

- ルール

- 通知テンプレート

- 汎用テクノロジ・コネクタ(GTC)プロバイダ

- エラー・コード

- システム・プロパティ

- 電子メール定義

- イベント・ハンドラ

- パスワード・ポリシー

- 汎用テクノロジ・コネクタ

- ITリソース定義

- リクエスト・テンプレート

- リクエスト・データセット

- 承認ポリシー

- イベント・ハンドラ

- パスワード・ポリシー

- 事前移入アダプタ

- プロセス定義

デプロイメント・マネージャには、次のような制限があります。

- マージ・ユーティリティ: デプロイメント・マネージャはマージ・ユーティリティではありません。
本番環境とテスト環境の両方の変更の処理はできません。ターゲット・システムのオブジェクトはXML内のオブジェクトに置き換えられます。

- バージョン管理ユーティリティ: デプロイメント・マネージャでは、インポートしたファイルのバージョンを追跡せず、ロールバック機能は提供されません。
環境間でデータを移動する手段としてのみ使用します。

- コードの移動: デプロイメント・マネージャでは、JavaTasksディレクトリまたはその他の場所にあるJARファイルを移動しません。

- カスタム・ラベルの移動: デプロイメント・マネージャではcustomResources.propertiesファイルまたはconnectorResourcesディレクトリのプロパティ・ファイルで定義されたラベルを移動しません。これらの移動は手動で行う必要があります。

5.2 デプロイメントのエクスポート

オブジェクトは、Oracle Identity Managerシステムからエクスポートして、XMLファイルに保存できます。デプロイメント・マネージャにあるエクスポート・ウィザードを使用して、エクスポート・ファイルを作成することができます。オブジェクトをタイプ別に、一度に1タイプずつ、たとえばロール、フォーム、プロセスなどの順で追加します。

子オブジェクトや依存性を持つオブジェクトを選択した場合は、それらを追加するかどうかを選択できます。1つのタイプのオブジェクトを追加したら、戻って別のオブジェクトをXMLファイルに追加できます。必要なオブジェクトをすべて追加すると、デプロイメント・マネージャによりすべてのオブジェクトが1つのXMLファイルに保存されます。

注意:

ユーザー定義フィールドが特定のリソース・オブジェクトに関連付けられている場合、エクスポート・プロセス中に、次のいずれかのイベントが発生します。

- ユーザー定義フィールドに値(入力された情報)が含まれている場合、デプロイメント・マネージャはそれを依存性とみなします。

- ユーザー定義フィールドに値が含まれていない場合(フィールドは空)、デプロイメント・マネージャはそれを依存性とみなしません。

デプロイメントをエクスポートするには:

1. Oracle Identity Manager管理にログインします。

2. 「ようこそ」ページで、「システム管理」の下にある「デプロイメント・マネージャ・ファイルのエクスポート」をクリックします。あるいは、「システム管理」タブ、「デプロイメント・マネージャ」、「エクスポート」の順にクリックします。
「デプロイメント・マネージャ」が開き、エクスポート・ウィザードのオブジェクトの検索ページが表示されます。

注意:

Mozilla Firefox Webブラウザを使用して「デプロイメント・マネージャ」を開く場合は、追加認証ダイアログ・ボックスが表示されることがあります。このダイアログ・ボックスで認証が行われると、デプロイメント・マネージャにアクセスできるようになります。この追加認証を回避するには、次のようにします。

1. Mozilla Firefox Webブラウザの「ツール」メニューから、「オプション」を選択します。「オプション」ダイアログ・ボックスが表示されます。

2. 「プライバシー」をクリックします。

3. 「サードパーティのCookieも保存する」オプションを選択します。

4. 「OK」をクリックします。

Microsoft Internet Explorer、Google ChromeおよびApple Safari Webブラウザを使用してデプロイメント・マネージャを開く場合は、追加認証は必要ありません。

3. オブジェクトの検索ページで、メニューからオブジェクト・タイプを選択し、検索基準を入力します。基準フィールドを空のままにしておくと、自動的にアスタリスク(*)が表示され、選択したタイプのすべてのオブジェクトが検索されます。
デプロイメント・マネージャによって移行がサポートされているすべてのオブジェクトをエクスポートに使用できます。デプロイメント・マネージャによって移行がサポートされているオブジェクトのリストは、「デプロイメント・マネージャの機能」を参照してください。

4. 「検索」をクリックすると、選択したタイプのオブジェクトが検索されます。
オブジェクトを選択するには、オブジェクトのオプションを選択します。

5. 「子の選択」をクリックします。
「子の選択」ページに、選択したオブジェクトとそのすべての子オブジェクトが表示されます。

6. エクスポートする子オブジェクトを選択します。
項目を選択または削除するには、適切なオプションを選択します。

「戻る」 をクリックすると、オブジェクトの検索ページに戻ります。

7. 「依存性の選択」をクリックします。
「依存性の選択」ページに、選択したオブジェクトで必要とされるすべてのオブジェクトが表示されます。

8. エクスポートする依存オブジェクトを選択します。
項目を選択または削除するには、項目のオプションを選択します。

「戻る」をクリックすると「子の選択」ページに戻ります。

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

10. 必要な項目がすべて選択されていることを確認し、「エクスポート用に追加」をクリックします。
「エクスポート用に追加」をクリックした後でも、このエクスポート・ファイルに項目をさらに追加することができます。

さらに追加を選択し、「OK」をクリックして検索オブジェクト・ページに進み、エクスポートするオブジェクトをさらに追加します。

11. ウィザードを使用して項目をさらに追加し、完了したらウィザードを終了します。目的のオプションを選択し、「OK」をクリックします。
さらに追加を選択した場合は、ステップ2 - 7を繰り返します。選択していない場合は、「エクスポート」ページが表示されます。

「エクスポート」ページに現在のエクスポート項目が表示されます。選択項目の横にあるアイコンは、選択されているオブジェクトのタイプを示しています。サマリー情報ペインに、エクスポートするオブジェクトが表示されます。「未選択の依存性」ペインには、エクスポート用に選択されなかった依存オブジェクトまたは子オブジェクトのリストが表示されます。

12. エクスポート・ファイルに変更を加えるには、次の手順を実行します。

- フォームをクリアするには「リセット」をクリックします。

- アイコン定義を表示するには「凡例」をクリックします。

- 「オブジェクトの追加」をクリックしてウィザードを再起動し、エクスポート・ファイルにさらに項目を追加します。

オブジェクトを「現在の選択」リストから削除するには:

- 削除するオブジェクトを右クリックし、ショートカット・メニューから「削除」を選択します。オブジェクトに子オブジェクトがある場合は、ショートカット・メニューから「子も含めて削除」を選択し、子オブジェクトを一度にすべて削除します。

- 「削除」をクリックして確認します。オブジェクトが、選択した項目の子または依存性の場合は、「未選択の子」または「未選択の依存性」リストに追加されます。

オブジェクトを「未選択の子」または「未選択の依存性」リストから「現在の選択」リストに戻すには、次のようにします。

1. オブジェクトを右クリックして、「追加」を選択します。

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

3. 「エクスポート用に追加」をクリックします。

13. 「エクスポート」をクリックします。
説明の追加ダイアログ・ボックスが表示されます。

14. ファイルの説明を入力します。
この説明は、ファイルがインポートされるときに表示されます。

15. 「エクスポート」をクリックします。
「別名で保存」ダイアログ・ボックスが表示されます。

16. ファイル名を入力します。
参照してファイルの場所を探すことができます。

17. 「保存」をクリックします。
エクスポート完了ダイアログ・ボックスが表示されます。

18. 「閉じる」をクリックします。

5.3 デプロイメントのインポート

デプロイメント・マネージャを使用してXMLファイルにエクスポートしたオブジェクトは、デプロイメント・マネージャを使用してOracle Identity Managerにインポートできます。XMLファイルの全部または一部をインポートすることも、複数のXMLファイルを同時にインポートすることもできます。デプロイメント・マネージャは、インポートするオブジェクトの依存性が、インポート時に、または使用するシステムで確実に利用できるかどうかを確認します。インポート中、システム内のオブジェクトをインポート中のオブジェクトに置換できます。たとえば、システムのグループをXMLファイル内で指定されているグループに置換できます。

注意:

- ユーザーが、「インポート」メニュー項目が割り当てられているグループに属している場合、そのユーザーは、インポートするオブジェクトに対して必要な権限も持っている必要があります。これらのオブジェクト固有の権限がない場合、インポート操作は失敗します。メニュー権限付与モデルに基づいてUIで「デプロイメント・マネージャ」メニュー項目を確認するには、ユーザーはデプロイメント・マネージャ管理者である必要があります。

- デプロイメント・マネージャを使用して1000を超えるリソース、プロセス定義、親フォーム、子フォーム、アクセス・ポリシー、ロール、ルールをインポートする場合、EIF表のサイズが大きくなります。EIFから「削除」などの簡単なSQL問合せを実行することにより、この表からデータを切り捨てることができます。

この項の内容は次のとおりです。

- スケジュール済タスクの再インポート時のデプロイメント・マネージャの動作

- XMLファイルのインポート

注意:

メニュー項目への参照を含むデータをインポートする場合は、まずターゲット・システムでそのメニュー項目を作成してからインポートする必要があります。

5.3.1 スケジュール済タスクの再インポート時のデプロイメント・マネージャの動作

スケジュール済タスクは、デプロイメント・マネージャを使用してインポートできるオブジェクトの1つです。通常、スケジュール済タスクをOracle Identity Manager環境にインポートし、実際の本番環境にあわせて後からスケジュールされた属性の値を変更します。ただし、同じOracle Identity Managerサーバーに同一のスケジュール済タスクをインポートするのが2回目である場合、デプロイメント・マネージャはデータベースにある属性値を上書きしません。その場合、デプロイメント・マネージャは再インポートしたXMLファイルの属性値を、対応するデータベース内の属性値と比較します。

次の表に、スケジュール済タスクの再インポート時にデプロイメント・マネージャによって実行される動作についてまとめます。

スケジュール済タスクのインポートするXMLファイルに属性値があるか

対応する属性値がデータベースにあるか

デプロイメント・マネージャの動作

はい

いいえ

属性値をデータベースに格納します

いいえ

はい

データベース内の既存の属性値を削除します

はい

はい(タイムスタンプで示される新しい属性値)

データベースは変更されません

はい(タイムスタンプで示される新しい属性値)

はい

新しい属性値でデータベースを更新します。

5.3.2 XMLファイルのインポート

XMLファイルをインポートするには:

1. Oracle Identity Manager管理にログインします。

2. 「ようこそ」ページで、「システム管理」の下の「デプロイメント・マネージャ」下にある「インポート」をクリックします。あるいは、「システム管理」タブ、「デプロイメント・マネージャ」、「インポート」の順にクリックします。
「デプロイメント・マネージャ」が開き、エクスポート・ウィザードのオブジェクトの検索ページが表示されます。

注意:

Mozilla Firefox Webブラウザを使用して「デプロイメント・マネージャ」を開く場合は、追加認証ダイアログ・ボックスが表示されることがあります。このダイアログ・ボックスで認証が行われると、デプロイメント・マネージャにアクセスできるようになります。この追加認証を回避するには、次のようにします。

1. Mozilla Firefoxの「ツール」メニューから、「オプション」を選択します。「オプション」ダイアログ・ボックスが表示されます。

2. 「プライバシー」をクリックします。

3. 「サードパーティのCookieも保存する」オプションを選択します。

4. 「OK」をクリックします。

Microsoft Internet Explorer、Google ChromeおよびApple Safari Webブラウザを使用してデプロイメント・マネージャを開く場合は、追加認証は必要ありません。

3. ファイルを選択します。
「インポート」ダイアログ・ボックスが表示されます。

4. 「開く」をクリックします。
「ファイル・プレビュー」ページが表示されます。

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

6. 名前を置換するには、置換する項目に隣接した「新しい名前」フィールドをクリックし、名前を入力します。
ターゲット・システムに存在する項目のみ置換できます。

7. 「次へ」をクリックします。ITリソース・インスタンスをエクスポートする場合、「ITリソース・インスタンス・データの提供」ページが表示されます。それ以外の場合は、「確認」ページに切り替わります。

8. 現在のリソース・インスタンスの値を変更して「次へ」をクリックするか、「スキップ」をクリックして現在のリソース・インスタンスをスキップするか、「新規インスタンス」をクリックして新しいリソース・インスタンスを作成します。
確認ページが表示されます。

9. 「確認」ページに表示される情報が正しいことを確認します。
戻って変更するには「戻る」をクリックします。それ以外の場合は「選択内容の表示」をクリックします。

デプロイメント・マネージャの「インポート」ページに現在の選択項目が表示されます。

「インポート」ページでは、現在の選択項目の横にアイコンが表示されます。このアイコンは、選択されているオブジェクトのタイプを示しています。右側のアイコンは選択項目のステータスを示しています。選択されたファイルの名前、インポートするオブジェクトのサマリー情報および置換情報がページの左側に表示されます。右側には、「インポートから削除したオブジェクト」リストにインポートされないXML内のすべてのオブジェクトが表示されます。

10. 必要に応じて次の調整を行います。

- フォームをクリアするには「リセット」をクリックします。

- アイコン定義を表示するには「凡例」をクリックします。

- 「現在の選択」リストからオブジェクトを削除するには、オブジェクトを右クリックしてショートカット・メニューから「削除」を選択し、「削除」をクリックしてオブジェクトの削除を確認します。
オブジェクトに子オブジェクトがある場合、ショートカット・メニューから「子も含めて削除」を選択し、子オブジェクトを一度にすべて削除します。項目が「インポートから削除したオブジェクト」リストに追加されます。

- 「現在の選択」リストに項目を戻すには、リストを右クリックして、「追加」をクリックします。
オブジェクトに子オブジェクトがある場合、ショートカット・メニューから「子も含めて追加」を選択してすべての子オブジェクトを一度に追加します。

- 置換するには、「置換の追加」をクリックします。

- 別のXMLファイルからオブジェクトを追加するには、「ファイルの追加」をクリックして、ステップ2 - 7を繰り返します。

- インポートした情報に関する情報を表示するには、「情報の表示」をクリックします。
「情報」ページが表示されます。

詳細情報を表示するには、「情報レベル・メッセージの表示」オプションを選択し、「メッセージの表示」をクリックします。「閉じる」をクリックして「情報」ページを閉じます。

11. 現在の選択項目をインポートするには、「インポート」をクリックします。
「確認」ダイアログ・ボックスが表示されます。

12. 「インポート」をクリックします。
インポート完了ダイアログ・ボックスが表示されます。

13. 「OK」をクリックします。
オブジェクトがOracle Identity Managerにインポートされます。

5.4 エンティティの水平移行

デプロイメント・マネージャは、Oracle Identity Managerデプロイメント間のメタデータ・エンティティの移行を実行するために使用します。ただし、Oracle Identity Manager 11g リリース1(11.1.1)には、デプロイメント・マネージャでサポートされていない他の非メタデータ・エンティティがあります。これらのエンティティには、カスタム・リソース・バンドルおよびプラグインが含まれます。そのため、エンティティを完全に移行するには、水平移行ユーティリティと呼ばれるコマンドライン・ユーティリティをデプロイメント・マネージャとともに使用します。

水平移行コマンドライン・ユーティリティは、デプロイメント・マネージャでサポートされない次のメタデータ・エンティティの移行をサポートしています。

- カスタム・リソース・バンドル

- プラグイン

メタデータ・エンティティの移行は、次の手順で行われます。

1. データのエクスポート: Oracle Identity Managerデプロイメントからのデータが、デプロイメント・マネージャと水平移行コマンドライン・ユーティリティの実行によってエクスポートされる場合、アーティファクトのセットが生成されます。デプロイメント・マネージャによってXMLファイルが生成され、水平移行ユーティリティによってバイナリとXMLファイルが生成されます。

注意:

デプロイメント・マネージャは、XMLのフォームのすべてのエンティティの移行をサポートしています。コマンドライン・ユーティリティは、XMLのフォームでエクスポートおよびインポートできないエンティティであるバイナリの移行をサポートしています。

図5-1にデータのエクスポートを示します。

図5-1 移行データのエクスポート

「図5-1 移行データのエクスポート」の説明

2. データのインポート: デプロイメント・マネージャおよび水平移行ユーティリティは、図5-2に示すように、2回目のOracle Identity Managerデプロイメントでメタデータをインポートするために実行されます。

図5-2 移行データのインポート

「図5-2 移行データのインポート」の説明

水平移行コマンドライン・ユーティリティは、デプロイメント・マネージャでサポートされていないエンティティを移行するために使用します。次の項では、水平移行ユーティリティを使用したエンティティのエクスポートおよびインポートについて説明します。

- 既存エンティティのバックアップの作成

- 水平移行ユーティリティの実行

- サポートされるエンティティのデータ移行

- 水平移行レポート

5.4.1 既存エンティティのバックアップの作成

移行を実行する前に、Oracle Identity Managerデプロイメントで既存エンティティのバックアップを作成します。エンティティをインポートする場合は、必要に応じてロールバックできるように、既存エンティティのバックアップを作成します。

バックアップを作成するには、水平移行ユーティリティをエクスポート・モードで使用して既存エンティティを抽出します。ユーティリティをエクスポート・モードで実行する方法は、「水平移行ユーティリティの実行」を参照してください。

5.4.2 水平移行ユーティリティの実行

水平移行ユーティリティをエクスポート・モードで実行すると、移行されるエンティティのすべてのアーティファクトを含むZIPファイルが作成されます。そのZIPファイルをデータをインポートして戻す2回目のデプロイメントに移行する必要があります。ユーティリティをインポート・モードで実行すると、ZIPファイルの内容が一時的な場所に抽出され、すべてのアーティファクトがOracle Identity Managerデプロイメントにインポートされます。プロパティ・ファイルの構成によりエクスポートとインポートが制御されます。このファイルの構成はすべてランタイム時に定義されます。

エクスポート・モードで、OIM_HOME/binディレクトリにあるexportMetaData.shまたはexportMetaData.batスクリプトを実行します。

水平移行ユーティリティをエクスポート・モードで実行するには:

1. Config.xmlファイルの場所を確認します。Config.xmlファイルにはエクスポートするエンティティをフィルタするためのフィルタ基準が含まれています。このファイルを変更してカスタム・フィルタを指定できます。
ユーティリティを実行する前に、Config.xmlファイルを保存します。

2. テキスト・エディタで、exportMetaData.shまたはexportMetaData.batスクリプトを編集して次のパラメータを指定します。

- CONTEXT_FACTORY: Oracle Identity Managerに接続するためのコンテキスト

- PACKAGE_LOCATION: エクスポートするパッケージの宛先パス

- CONFIGURATION_FILE: パラメータとフィルタ基準の定義を含むメタデータのエクスポート用に作成する必要がある構成ファイル
次に構成XMLファイルの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<MigrationDetails operation ="Export">
<entityDetails>
<EntityType>Jars</EntityType>
<FilteringCriteria>
<Attribute>
<Name>OJ_NAME</Name>
<Filter>*</Filter>
</Attribute>
</FilteringCriteria>
</entityDetails>

<entityDetails>
<EntityType>Plugins</EntityType>
<FilteringCriteria>
<Attribute>
<Name>PLUGIN_NAME</Name>
<Filter>*</Filter>
</Attribute>
</FilteringCriteria>
</entityDetails>

<entityDetails>
<EntityType>CustomResourceBundles</EntityType>
<FilteringCriteria>
<Attribute>
<Name>RES_NAME</Name>
<Filter>*</Filter>
</Attribute>
</FilteringCriteria>
</entityDetails>
</MigrationDetails>

構成ファイルでは、JAR、プラグイン、CustomResourceBundlesの3つのエンティティ・タイプをサポートしています。各エンティティ・タイプでは、次のフィルタがサポートされています。

- Jars: Jar_TypeまたはOJ_TYPE、Jar_NameまたはOJ_NAME

- Plugins: PLUGIN_NAMEまたはplugins.ID

- CustomResourceBundles: Resource_TypeまたはRES_TYPE、Resource_NameまたはRES_NAME

- TEMP_LOCATION_TO_EXTRACT: エクスポート用にパッケージ化する前にファイルを一時的に置いておく一時的な場所

3. exportMetaData.shまたはexportMetaData.batスクリプトを実行します。

4. 次の項目は入力を求められた場合に指定します。

- Oracle Identity Managerに接続するためのOracle Identity Manager管理者のユーザー名

- Oracle Identity Managerに接続するためのOracle Identity Manager管理者のパスワード

- Oracle Identity Managerに接続するためのJNDI URL: t3://localhost:PORT_NUMBER

- ログ・ファイルの生成場所であるLogFileLocationのパス

5. 表示されるエクスポート・リストを検証します。

6. 確認を求められた場合は、「はい」を入力します。

7. エクスポートを検証します。リストされたすべての項目が入力に指定された宛先にエクスポートされます。宛先で作成されるZIPパッケージの中身を確認します。

インポート・モードでは、OIM_HOME/binディレクトリにあるimportMetaData.shまたはimportMetaData.batスクリプトを実行します。

インポート・モードで水平移行ユーティリティを実行するには:

1. ユーティリティを実行する前に、次のコマンドを使用してクライアント・ターゲットを実行します。

ant fullbuild XellerateClient.view-install
ant assemble-ear client-archive

2. importMetaData.shまたはimportMetaData.batスクリプトを実行する前に、ユーティリティ・スクリプトで次の入力パラメータを指定します。

- Oracle Identity Managerに接続するためのユーザー名

- Oracle Identity Managerに接続するためのパスワード

- Oracle Identity Managerに接続するためのJNDI URL

- Oracle Identity Managerに接続するためのコンテキスト

- インポートされるパッケージのパス

- インポートされる項目に関する情報を使用して更新される構成ファイル。インポートでこの構成を使用しない場合は、パッケージ内容全体がインポートされます。

- インポート前にパッケージを抽出する一時的な場所。

3. 次の項目は入力を求められた場合に指定します。

- Oracle Identity Manager管理者のユーザー名

- Oracle Identity Manager管理者のパスワード

- サーバーURL: t3://localhost:PORT_NUMBER

4. 表示されるインポート・リストを検証します。

5. 確認を求められた場合は、YESを入力します。

6. インポートを検証します。パッケージ内のすべての項目がアプリケーションにインポートされます。スキーマにアクセスして、インポート・ユーティリティによってすべてのパッケージ内容に対応したエントリがデータベース表に作成されているか確認します。作成されていないものがある場合は、アプリケーションのユーティリティ出力ログを確認して、すべての内容が正常にインポートされているか検証します。

5.4.3 サポートされるエンティティのデータ移行

この項では次のエンティティの移行について説明します。

- カスタム・リソース・バンドル

- プラグイン

5.4.3.1 カスタム・リソース・バンドル

Oracle Identity Managerでは、ユーザー・インタフェースに表示するローカライズされたテキスト文字列をリソース・バンドルに格納しています。デフォルトのリソース・バンドルに追加される、Oracle Identity Managerデータベースに保存されているカスタム・リソース・バンドルは、水平移行ユーティリティを使用してインポートおよびエクスポートできます。

デフォルトのパッケージ化されたリソース・バンドルは、次のプロパティ・ファイルで使用できます。

- oim.ear/xlWebApp.war/WEB-INF/classes/xlRichClient_*.properties

- デプロイメントの各機能用のAgent_*.properties

デフォルトのパッケージ化されたリソース・バンドルをカスタマイズして、カスタム・リソース・バンドルを作成できます。

5.4.3.2 プラグイン

プラグインはOracle Identity Managerデータベースに格納されています。水平移行ユーティリティは、あるデプロイメントのプラグイン・データベース・ストアから別のデプロイメントにバイナリを移行します。

関連項目:

プラグインの定義および使用の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのプラグイン・フレームワークの使用に関する項を参照してください。

5.4.4 水平移行レポート

水平移行ユーティリティの実行後、次の情報を含むレポートが生成されます。

- このユーティリティを使用して移行されたすべてのエンティティ

- メタデータのエクスポートおよびインポート全体のステータス

- メタデータのインポート時に発生したエラー

次にレポートのサンプルを示します。

Plugins :
Failed to process element Plugin1".
Exception details are java.io.FileNotFoundException: C:\Plugin1.zip (The system cannot find the path specified) at java.io.FileInputStream.open(Native Method)at java.io.FileInputStream.<init>(Unknown Source)at java.io.FileReader.<init>(Unknown Source)at file.main(file.java:13)

5.5 デプロイメント・マネージャの使用に関連するベスト・プラクティス

デプロイメント・マネージャの使用に関する推奨プラクティスと注意点を次に示します。

- 必要な場合にのみ行うシステム・オブジェクトのエクスポート

- 関連するオブジェクトのグループのエクスポート

- 定義データおよび操作データの個別のグループ化

- フォーム・バージョンに対する論理的なネーミング規則の使用

- ルートのエクスポートによる完全な組織階層の保持

- わかりやすいエクスポートの説明

- インポート前のすべての警告のチェック

- データ・エクスポート前の依存性のチェック

- 一致するスケジュール済タスク・パラメータ

- アダプタのコンパイルおよびスケジュール済タスクの有効化

- エンティティ・アダプタの個別のエクスポート

- ロールの権限のチェック

- データベースのバックアップ

- システム静止中のデータのインポート

- SDK表の更新

- 依存性としてイベント・ハンドラをインポートする前のデータ・オブジェクト・フィールドの削除

5.5.1 必要な場合にのみ行うシステム・オブジェクトのエクスポート

リクエスト、Xellerateユーザー、システム管理者などのシステム・オブジェクトのエクスポートまたはインポートは、本当に必要な場合にのみ行ってください。システム・オブジェクトをテスト環境やステージング環境から本番環境にエクスポートすると、問題が発生する場合があります。可能であれば、データのエクスポートまたはインポートの際には、システム・オブジェクトを除外してください。

Xellerateユーザー・リソース・オブジェクトで信頼できるソースのリコンシリエーションを定義する場合などに、システム・オブジェクトをエクスポートまたはインポートすることがあります。

注意:

デプロイメント・マネージャでは、インポートしたコンポーネントおよび構造を追跡しますが、終了したインポートの追跡は行いません。インポートが完了した後は、前のバージョンにロールバックできません。新たにインポートする必要があります。

5.5.2 関連するオブジェクトのグループのエクスポート

デプロイメント・マネージャを使用して、関連するオブジェクトをセットにしてエクスポートすることをお薦めします。グループ化する論理項目を1つにまとめて、エクスポートの単位にしてください。

1回の操作でデータベース内のすべてをエクスポートしたり、1回に項目を1つずつエクスポートすることは避けてください。たとえば、プロセス、リソース・オブジェクト、アダプタ、ITリソース・タイプ定義、ITリソース定義、スケジュール済タスクなどを含むターゲット・システムと、Oracle Identity Managerとの間の統合を管理するとします。このような環境では、エクスポートの前に関連するオブジェクトのグループを作成します。

たとえば、複数の統合で同一の電子メール定義を使用する場合、電子メール定義を1つの単位としてエクスポートし、統合は別の単位としてエクスポートする必要があります。これにより、電子メール定義の変更を、ターゲット・システム統合の変更とは別にインポートできます。また、複数のリソースで同一のITリソース・タイプ定義を使用する場合、タイプ定義をその他のデータとは別個にエクスポートおよびインポートできます。

エクスポート済データの1つ以上のセットを一度にインポートできます。たとえば、リソース・オブジェクト定義、電子メール定義およびITリソース・タイプ定義を、1回の操作でインポートできます。

5.5.3 定義データおよび操作データの個別のグループ化

定義データおよび操作データは、別々のグループに分けてエクスポートしてください。

定義データはテスト環境およびステージング環境で構成します。定義データには、リソース・オブジェクト、プロセスおよびルールが含まれます。

一般的に、操作データは、本番環境で構成します。操作データには、グループおよびグループ権限が含まれます。テスト・サーバーおよびステージング・サーバーには、通常このデータは含まれません。

変更される場所に応じてデータをグループ化すると、どのデータがテストおよびステージングに属し、どのデータが本番に属するかを判別できます。たとえば、本番で承認プロセスが変更された場合、承認プロセスをグループ化してその他の操作データと一緒にエクスポートします。

5.5.4 フォーム・バージョンに対する論理的なネーミング規則の使用

エクスポートする前に、フォームを何度も修正することがあります。「v23」のような一般的な名前で、フォームのバージョンを区別しないでください。「Before Production」または「After Production Verification」など、意味のある名前を作成します。バージョン名には二重引用符などの特殊文字を使用しないでください。

5.5.5 ルートのエクスポートによる完全な組織階層の保持

組織階層内のリーフや組織をエクスポートすると、1つの依存性レベルのみがエクスポートされます。組織階層を完全にエクスポートするには、階層のルートをエクスポートする必要があります。

5.5.6 わかりやすいエクスポートの説明

デプロイメント・マネージャでは、エクスポート日、エクスポートの実行者、ソース・データベースなどの一部の情報は自動的に記録されます。また、「xxx属性がリコンシリエーションに追加された後のリソース定義」など、エクスポートのコンテンツのわかりやすい説明も指定する必要があります。ファイルのインポート担当者は、これを元にインポートされるデータのコンテンツを把握します。

5.5.7 インポート前のすべての警告のチェック

本番環境に情報をインポートする場合、インポート操作が完了する前にすべての警告をチェックしてください。すべての警告に慎重に対応します。

5.5.8 データ・エクスポート前の依存性のチェック

右上ペインのウィザードには、ターゲット・システムで使用可能であることが必要なリソースが表示されます。

次のタイプの依存性について考慮します。

- ターゲット・システムですでに使用可能なリソースは、エクスポートする必要がありません。

- (ターゲット・システムにない)新規のリソースは、エクスポートする必要があります。

- 再利用される参照、ITリソース定義またはその他のリソースがターゲット・システムに含まれていない場合は、必要に応じてインポートできるように、データを記録して別個のファイルでエクスポートします。

注意:

リソースをエクスポートする際に、そのフォームに対してデータ・オブジェクト権限を持つグループはリソースと一緒にエクスポートされません。

5.5.9 一致するスケジュール済タスク・パラメータ

スケジュール済タスクが正しく実行されるかどうかは、特定のパラメータに依存します。スケジュール済タスクのパラメータを、本番サーバーにインポートできます。表5-1に、スケジュール済タスクのインポート方法を決定するためのルールを示します。パラメータは、ターゲット・システムに存在しないタスクでも使用できる場合があります。

表5-1 パラメータのインポート・ルール

ターゲット・システムにパラメータがある

XMLファイルにパラメータがある

動作

はい

いいえ

パラメータをターゲット・システムから削除します。

いいえ

はい

XMLファイルのパラメータおよび現行の値を追加します。

はい

はい

パラメータのより新しい値を使用します。

5.5.10 アダプタのコンパイルおよびスケジュール済タスクの有効化

インポート操作の後、アダプタは再コンパイルするように設定され、スケジュール済タスクは無効化されます。クラスをインポートしてタスク属性を調整してから、手動でアダプタを再コンパイルし、スケジュール済タスクを有効化してください。

5.5.11 エンティティ・アダプタの個別のエクスポート

エンティティ・アダプタを変更すると、エンティティ・アダプタのみが更新され、使用方法は更新されません。エンティティ・アダプタの使用方法をエクスポートする場合は、データ・オブジェクトをエクスポートすることにより、各使用方法をデータ・オブジェクトとともに個別にエクスポートする必要があります。データ・オブジェクトをエクスポートすると、オブジェクトにアタッチされたすべてのアダプタとイベント・ハンドラ、およびオブジェクトに対する権限がエクスポートされます。データ・オブジェクトのエクスポートには、細心の注意が必要です。たとえば、フォームをエクスポートする場合、フォームに関連するデータ・オブジェクトも必ず追加するようにしてください。これにより、関連付けられたエンティティ・アダプタでフォームを使用できます。

5.5.12 ロールの権限のチェック

ロールをエクスポートする際に、異なるデータ・オブジェクトに対するロール権限もエクスポートされます。ただし、データをインポートする際は、欠落しているデータ・オブジェクトに対する権限はすべて無視されます。ロール権限の設定をエクスポートする手段としてロールをエクスポートする場合は、権限の要件が満たされるように、警告を慎重にチェックしてください。たとえば、ロールにオブジェクトA、B、Cに対する権限があるが、ターゲット・システムにはオブジェクトA、Bしかない場合、オブジェクトCの権限は無視されます。後でオブジェクトCを追加した場合、Cのロール権限を手動で追加するか、ロールを再インポートする必要があります。

特定のレポートの表示権限を持つロールのエクスポートでは、そのレポートがターゲット環境に存在することを確認してください。レポートがない場合、ロールのエクスポートの前に権限を削除することを考慮してください。

5.5.13 データベースのバックアップ

データを本番環境にインポートする前に、データベースをバックアップします。これにより、インポートで問題が発生しても、データをリストアできます。データベースをバックアップしておくことは、大きな変更を行う前の大切な予防措置です。

注意:

フォームおよびユーザー定義フィールドをインポートする際は、データベースにエントリを追加します。これらのデータベース・エントリは、ロールバックまたは削除できません。各インポート操作の前に、フォームの正しいバージョンがアクティブになっていることを確認してください。

5.5.14 システム静止中のデータのインポート

インポート操作はスキーマの変更を伴うため、単一のトランザクションでは完了できません。これらの変更は、現在システムで実行中のトランザクションに影響を与えます。インポート操作の影響を抑えるためには、一般使用のためのWebアプリケーションを一時的に無効化し、システムのアクティビティが低下する夜間などに操作を行うようにしてください。

5.5.15 SDK表の更新

SDK表には、ユーザー定義データ・オブジェクトのメタデータ定義が含まれます。XMLファイルからSDK表にデータをインポートすると、SDK_SCHEMA列の値は、XMLファイルが作成されたソース・システムのスキーマ名で変更されることがあります。このため、XMLファイルからSDK表にデータをインポートした後には、SDK_SCHEMA列のスキーマ名をチェックし、必要に応じてOracle Identity Managerデータベースが稼働しているターゲット・システムのスキーマ名に手動で変更してください。SDK_SCHEMA列のスキーマ名を更新するには、Oracle Databaseインストール環境でSQL*Plusを使用するか、Microsoft SQL Serverインストール環境でSQL Query Analyzerを使用して、次のようなSQL問合せを実行します。

UPDATE SDK SET SDK_SCHEMA='target system schema name'

SDK_SCHEMA列のスキーマ名を更新しない場合は、ユーザー定義フィールド(UDF)の定義を変更する別のXMLファイルのインポート時に次のようなエラーが生成されることがあります。

CREATE SEQUENCE UGP_SEQ
java.sql.SQLException: ORA-00955: name is already used by an existing object

5.5.16 依存性としてイベント・ハンドラをインポートする前のデータ・オブジェクト・フィールドの削除

イベント・ハンドラを依存性としてインポートする場合、デプロイメント・マネージャでは、データ・オブジェクト・フィールドを含むイベント・ハンドラはインポートされません。このため、デプロイメント・マネージャを使用して、依存性としてインポートする必要があるすべてのイベント・ハンドラからデータ・オブジェクト・フィールドを削除してください。

5.6 水平移行ユーティリティの使用のベスト・プラクティス

水平移行ユーティリティの使用に関する推奨プラクティスと注意点を次に示します。

- システム・オブジェクトは必要な場合にのみエクスポートします。「必要な場合にのみ行うシステム・オブジェクトのエクスポート」を参照してください。

- 関連するオブジェクトのグループをエクスポートします。「関連するオブジェクトのグループのエクスポート」を参照してください。

- インポートまたはエクスポート前にすべてのリストをチェックします。「インポート前のすべての警告のチェック」を参照してください。

- データベースのバックアップを作成します。「データベースのバックアップ」。

- Config.xmlファイルではできるだけ特定されるフィルタ基準を指定します。「水平移行ユーティリティの実行」のステップ3を参照してください。
たとえば、フィルタ基準では次の点を考慮します。

<entityDetails>
<EntityType>CustomResourceBundles</EntityType>
<FilteringCriteria>
<Attribute>
<Name>FileName</Name>
<Filter>*</Filter>
</Attribute>
</FilteringCriteria>
</entityDetails>

フィルタ基準としてアスタリスク(*)ワイルドカード文字を使用するかわりに、ファイル名を指定するか、<Filter>*.properties</Filter>のようにファイル名とワイルドカード文字を組み合わせます。

5.7 トラブルシューティング

表5-2に、障害が発生した場合に実行できるトラブルシューティングの手順を示します。

表5-2 デプロイメント・マネージャのトラブルシューティング

問題

解決策

Oracle Identity Manager 11g リリース1(11.1.1)では、スケジュール済ジョブはスケジュール済タスクに依存しています。したがって、スケジュール済ジョブの前にスケジュール済タスクをインポートする必要があります。この結果、XMLファイルでスケジュール済タスク・エントリより前にスケジュール済ジョブ・エントリがある場合、デプロイメント・マネージャを使用したXMLのインポートが失敗し、次のエラー・メッセージが表示されます。

[exec] Caused By: oracle.iam.scheduler.exception.SchedulerException: InvalidScheduleTask definition
[exec] com.thortech.xl.ddm.exception.DDMException

XMLファイルを開き、すべてのスケジュール済タスク・エントリをスケジュール済ジョブ・エントリの上に移動します。

デプロイメント・マネージャで、エクスポートがいずれのオブジェクトに対しても失敗します。ユーザーには「エクスポートに失敗しました」ダイアログ・ボックスが表示されますが、サーバー・ログに例外は見つかりません。

JREコンソールを確認すると、次のように表示されています。

java.security.AccessControlException: access denied (java.io.FilePermission PATH_AND_NAME_OF_THE_FILE)

次のステップを実行します。

1. JRE_HOME/lib/security/ディレクトリでjava.policyを変更します。

2. 既存のポリシー・ファイルの内容を次のように置き換えます。

grant{
permission java.security.AllPermission;
};

3. ブラウザを再起動してポリシーを再度ロードします。データをエクスポートできるようになります。

XMLファイルのインポート中に次のエラーが発生します。

Caused by:
oracle.iam.reconciliation.exception.ConfigException: Profile :Xellerate User InvalidAttributes :

次のいずれかを実行します。

- エラーが生成された属性をXMLから削除し、インポートを試します。

- 構成サービスを使用して、欠落しているUDFまたは他の属性を作成し、インポートを再び試します。

- 欠落している依存性として示されるUDFをエクスポートします。現在のXMLをインポートする前に、まずこのUDFをインポートします。

承認ポリシーのインポートにより、次のエラーが発生することがあります。

weblogic.kernel.Default (self-tuning)'] [userId: xelsysadm] [ecid:
f9e72ab2a292a346:-188377b2:12f96ae9676:-8000-0000000000000047,0] [APP:
oim#11.1.1.3.0] Exception thrown {0}[[
oracle.iam.platform.entitymgr.ProviderException: USER_NOT_FOUND

承認ポリシー・ルールは、Oracle Identity Managerに存在しないエンティティ(ユーザーまたは組織)を指す場合、無効です。これらの無効な承認ルールは、インポートする前に有効なエンティティ(ユーザーまたは組織)を指すように修正する必要があります。

6 コネクタ・ライフサイクルの管理

Oracle Identity Managerには、組織内の各種のITベース・リソースとの統合を可能にする様々なソリューションが用意されています。Oracle Identity Managerと、ユーザー・データを格納および使用するリソースとの統合に推奨されるソリューションは、Oracle Identity Managerコネクタです。コネクタにより、Oracle Identity Managerと特定のリソースまたはターゲット・システムとの間におけるユーザー・データの交換が可能になります。

Oracle Identity Managerサーバーはコネクタを使用し、ターゲット・システムに対する操作を実行します。Oracleでは、一般的な企業リソース用のコネクタを用意しています。ユーザーは、独自のリソース用のカスタム・コネクタを開発できます。

コネクタは、次のアーティファクトで構成されています。

- コネクタ・コードが格納されたバイナリ(JARおよびDLLファイル)

- Oracle Identity Managerで定義されているオブジェクト(ITリソース、リソース・オブジェクト、プロビジョニング・プロセスとプロセス・タスク、プロセス・フォームと子フォーム、アダプタとアダプタ・タスク、参照定義、リコンシリエーション・ルール、スケジュール済タスクなど)

- アダプタがターゲット・システムに対するアクションを実行できるようにする統合ライブラリ
一部のターゲット・システムでは、ターゲット・システムとの通信またはターゲット・システムでの特定の機能を実行するためにサード・パーティ製の統合ライブラリが必要になることがあります。

関連項目:

コネクタおよびコネクタ・オブジェクトの概念は、『Oracle Identity Manager Connector概要』を参照してください。

この章では、コネクタ・ライフサイクル管理機能について説明します。この章の内容は次のとおりです。

- コネクタのライフサイクル

- コネクタ・ライフサイクルおよび変更管理の用語

- コネクタの詳細の表示

- コネクタのインストール

- コネクタの定義

- コネクタのクローニング

- コネクタ・オブジェクトの定義のコネクタXML形式でのエクスポート

- コネクタのアップグレード

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

6.1 コネクタのライフサイクル

コネクタのライフサイクルには次のステージがあります。

デプロイメント

コネクタは、Oracle Identity Manager管理およびユーザー・コンソールの拡張管理セクションで「コネクタの管理」メニューをクリックすることによってインストールできます。デプロイメント・プロシージャを完了するには、コネクタ・ファイルおよび外部コード・ファイルをOracle Identity Managerとターゲット・システムのホスト・コンピュータ上のコピー先ディレクトリにコピーすることが必要になる場合があります。一部のコネクタには、リモート・マネージャ(通常、ターゲット・システムのホスト・コンピュータ上にインストールされます)が必要になります。他のいくつかのコネクタ、特にアイデンティティ・コネクタには、ローカルおよびリモートのコネクタ・サーバーが必要です。

関連項目:

- コネクタ・ファイルおよび外部コード・ファイルをOracle Identity Managerとターゲット・システムのホスト・コンピュータ上のコピー先ディレクトリにコピーする方法の詳細は、Oracle Identity Managerコネクタのドキュメントを参照してください。コネクタのドキュメントは、次のURLにあるOracle Webサイトから入手可能です。
http://download.oracle.com/docs/cd/E22999_01/index.htm

- アイデンティティ・コネクタ・フレームワークおよびそれを使用してアイデンティティ・コネクタを作成する方法の詳細は、『Oracle Fusion Middleware Oracle Identity Manager開発者ガイド』のIdentity Connectorフレームワークに関する説明を参照してください。

別の方法として、デプロイメント・マネージャを使用して、コネクタを構成するオブジェクトの定義をインポートすることもできます。ただし、この章で後述するように、コネクタのインストール機能を使用する方法をお薦めします。

カスタマイズ

デプロイメントの後、コネクタのデフォルト構成で対処されていないビジネス要件を満たすようにコネクタをカスタマイズできます。たとえば、ターゲット・システムを使用したリコンシリエーションおよびプロビジョニング用の新しい属性を追加します。このタイプの機能拡張の場合は、リソース・オブジェクト、プロセス定義、プロセス・フォームなど、複数のコネクタ・オブジェクトで変更を行う必要があります。コネクタ・オブジェクトで必要となる変更の詳細は、コネクタのドキュメントを参照してください。

クローニング

ターゲット・システムの複数のインストールがある場合があります。複数のインスタンスが含まれるターゲット・システムがあり、データが同じか、共有されているか、またはレプリケートされている場合(Microsoft ExchangeまたはActive Directoryコネクタでの場合のように)、コネクタのクローニングは必要ありません。インスタンス用に複数のITリソースを作成する必要があります。ターゲットは単一のリソース・オブジェクトとして機能します。

ターゲット・システムに様々なインストール、スキーマまたはデータが含まれる場合(内部ユーザー用のLDAPサーバーと、外部の契約者、コンシューマ用の別のLDAPなど)、コネクタをクローニングする必要があります。コネクタは2つの別個のターゲットとして機能します。

コネクタ属性が異なるというシナリオもあり得ます。この場合、新しいコネクタを作成するかわりに、元のコネクタのXMLを使用して既存のコネクタをクローニングできます。拡張管理のコネクタのクローニング機能を使用して、一連のコネクタ・オブジェクトのコピーを自動的に生成できます。

アップグレード

コネクタの新しいリリースで導入された機能を利用するために、オラクル社がリリースしたパッチ・セットを適用することによって、コネクタをアップグレードできます。一般的には、コネクタの新しいリリースにアップグレードする際には、単純な変更(JARファイルのアップグレードなど)から、コネクタの一部として出荷されたアダプタ・タスクのほとんどに影響するような変更まで、様々な処理が必要になります。コネクタのアップグレード機能を使用して、コネクタをアップグレードできます。

注意:

コネクタをアップグレードしても、コネクタでの既存のカスタマイズは保持されます。

アンインストール

注意:

コネクタのアンインストールは、本番環境ではなく開発環境で実行されます。

コネクタの使用を停止すると、このアクションはシステム統合テスト、ユーザー承認テスト、ステージングなどの追加の環境にも影響し、これらの環境でもコネクタが停止されます。

不要なOracle Identity Managerオブジェクトのないクリーンな開発環境を保つ必要があるため、使用する必要がなくなった特定のバージョンのコネクタをアンインストールします。コネクタのアンインストール・ユーティリティを使用して、コネクタおよび個々のコネクタ・オブジェクトをアンインストールできます。

注意:

コネクタのインストール、デプロイメント・マネージャを使用したコネクタXMLファイルのインポート、コネクタのクローニング、定義、アップグレード、アンインストールなど、コネクタ・ライフサイクル管理タスクを実行するには、システム管理者ロールが必要です。

図6-1にコネクタ・ライフサイクルを示します。

図6-1 コネクタ・ライフサイクル

「図6-1 コネクタ・ライフサイクル」の説明

6.2 コネクタ・ライフサイクルおよび変更管理の用語

この章では、次の用語が使用されています。

- オラクル社がリリースしたコネクタは、オラクル社によってリリースされたコネクタを指します。

- カスタム・リリースまたはカスタム・コネクタは、ユーザーが開発したコネクタ、およびオラクル社がリリースしたコネクタをユーザーがなんらかの方法でカスタマイズまたは再構成したものを指します。

- ソース・リリースまたはソース・コネクタは、別(つまり、新しい)リリースにアップグレードする、既存のリリースのコネクタを指します。たとえば、SAP User Managementコネクタをリリース9.1.2からリリース9.1.2.1にアップグレードする場合は、リリース9.1.2がソース・リリースになります。

- ターゲット・リリースまたはターゲット・コネクタは、ソース・リリースのアップグレード先となるリリースを指します。前述の例で、SAP User Managementリリース9.1.2.1がターゲット・リリースになります。

注意:

前述の用語のいくつかを組み合せて、説明中のコネクタのタイプを短縮して表すこともあります。たとえば、カスタム・ソース・リリースとは、ユーザーが作成、カスタマイズまたは再構成したコネクタで、ターゲット・リリースにアップグレードしようとしているものを指します。

- 構成XMLファイルには、コネクタのインストール機能によるコネクタのインストール中に使用される情報が格納されています。オラクル社がリリースしたコネクタの場合、構成XMLファイルはデプロイメント・パッケージに含まれています。カスタム開発のコネクタの場合、個々のコネクタ・オブジェクトをステージング(テスト)サーバー上で開発してから、本番サーバーにコネクタをデプロイすることがあります。このようなケースで、コネクタのインストール機能を使用して本番サーバーにコネクタをインストールする場合は、コネクタの構成XMLファイルを作成できます。

関連項目:

コネクタのインストール機能の詳細は、「コネクタのインストール」を参照してください。

- コネクタXMLファイルには、コネクタを構成する個々のオブジェクトの定義が格納されています。デプロイメント・マネージャによりOracle Identity ManagerにXMLファイルがインポートされると、これらのオブジェクト定義を使用して、Oracle Identity Managerデータベースにコネクタ・オブジェクトが作成されます。Oracle Identity ManagerへのXMLファイルのインポート方法は、コネクタのタイプにより異なります。

- オラクル社がリリースしたコネクタに、コネクタのインストール機能との互換性がある場合、コネクタのインストール機能を使用するとコネクタXMLファイルが自動的にインポートされます。この機能では、暗黙的にデプロイメント・マネージャが呼び出されて、コネクタXMLファイルがインポートされます。

- オラクル社がリリースしたコネクタに、コネクタのインストール機能との互換性がない場合、デプロイメント・マネージャを使用してXMLファイルをインポートします。

- カスタマ・コネクタの場合、デプロイメント・マネージャを使用して、ステージング・サーバーで作成したオブジェクトの定義を最初にエクスポートします。この処理による出力はコネクタXMLファイルです。次に、そのファイルを本番サーバーにインポートできます。または、コネクタの完全なデプロイメント・パッケージ(構成XMLファイルを含む)を作成する場合は、コネクタのインストール機能を使用してコネクタをインストールできます。この機能では、暗黙的にデプロイメント・マネージャが呼び出されて、ファイルがインポートされます。

関連項目:

デプロイメント・マネージャを使用したコネクタ・オブジェクトの定義のエクスポートの詳細は、「コネクタ・オブジェクトの定義のコネクタXML形式でのエクスポート」を参照してください。

6.3 コネクタの詳細の表示

コネクタの詳細を表示するには、次の手順を実行します。

注意:

Oracle Identity Managerのこのリリースでは、コネクタの定義、クローニング、アップグレード、アンインストールなどのコネクタ・ライフサイクル管理機能が導入されています。これらすべての機能について、完全なコネクタDM-XMLがデータベース内に存在する必要があり、これがすべてのコネクタ・ライフサイクル管理アクティビティのソースになります。

Oracle Identity Managerをリリース9.1.xまたは11g リリース1(11.1.1.3)から11g リリース1(11.1.1.5)にアップグレードする場合、コネクタに対するすべてのライフサイクル管理操作が実行可能になるように、コネクタを定義する必要があります。コネクタを定義しないと、インストール済コネクタの検索やアップグレード、コネクタのクローニングおよびコネクタのアンインストールを行うことができません。コネクタの定義の詳細は、「コネクタの定義」を参照してください。

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

2. 拡張管理に移動し、「システム管理」→「デプロイメント・マネージャ」を展開し、「コネクタの管理」をクリックします。

3. 「コネクタ名」フィールドにコネクタの名前を入力し、「検索」をクリックします。

4. 検索結果にコネクタの詳細が表示されます。
コネクタの完全名がわからない場合は、ワイルドカード検索でコネクタを探すことができます。たとえば、動作環境にインストールされているMicrosoft Active Directoryコネクタの詳細を表示するには、検索文字列Directを使用します。

すべてのインストール済コネクタの詳細を表示するには、「コネクタ名」フィールドを空白にして「検索」をクリックします。

図6-2に検索結果表を示します。

図6-2 コネクタの詳細が表示された検索結果表

「図6-2 コネクタの詳細が表示された検索結果表」の説明

検索結果表に、コネクタ名、リリース番号、ステータスおよびコネクタのインストール日時が表示されます。表の残りの列に表示されたアイコンを使用して、コネクタに対していずれかのライフサイクル管理操作を開始できます。

6.4 コネクタのインストール

拡張管理セクションで、「システム管理」→「デプロイメント・マネージャ」→「コネクタの管理」をクリックし、「インストール」をクリックしてコネクタをインストールします。次の項では、この機能およびこの機能を使用した手順について説明します。

注意:

オラクル社がリリースしたコネクタを、コネクタのインストール機能を使用してインストールできるかどうかを確認するには、コネクタ・ガイドを参照してください。

- コネクタのデプロイメント・プロセスの概要

- コネクタのインストールのためのユーザー・アカウントの作成

- コネクタのインストール

6.4.1 コネクタのデプロイメント・プロセスの概要

コネクタをインストールするには、次のタスクの一部またはすべてを実行します。

1. インストール要件の確認

2. ターゲット・システムの構成

3. Oracle Identity Managerサーバー上のディレクトリへのコネクタ・ファイルおよび外部コード・ファイルのコピー

4. Oracle Identity Managerの構成

5. コネクタXMLファイルのインポート

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

7. プロビジョニングの構成

8. Secure Sockets Layer(SSL)の構成

これらのタスクのうち、コネクタのインストール機能で自動的に実行されるタスクは次のとおりです。

注意:

残りのタスクは手動で実行します。手順については、コネクタのドキュメントを参照してください。

- Oracle Identity Managerサーバー上のディレクトリへのコネクタ・ファイルおよび外部コード・ファイルのコピー

- コネクタXMLファイルのインポート

- アダプタのコンパイル(プロビジョニングの構成の手順の一部)

正常なインストールの最後に、インストール済コネクタに関するデータが格納されるOracle Identity Managerデータベース内の表に、エントリが作成されます。データベースに格納されるデータの詳細は、「コネクタの定義」を参照してください。

6.4.2 コネクタのインストールのためのユーザー・アカウントの作成

Oracle Identity ManagerのSYSTEM ADMINISTRATORSグループに属しているユーザーがコネクタをインストールできます。また、必要なメニュー項目および権限を割り当てられているグループのメンバーもコネクタをインストールできます。

関連項目:

グループの作成とグループへのメニュー項目および権限の割当ての詳細は、コネクタ・ガイドのユーザー・グループの作成と管理に関する説明を参照してください。

必要な権限は次のとおりです。

- フォーム・デザイナ(挿入の許可、書込み権限、削除権限)

- 構造ユーティリティ.追加の列(挿入の許可、書込み権限、削除権限)

- メタ表の階層(挿入の許可、書込み権限、削除権限)

- ユーザーがSYSTEM ADMINISTRATORSグループに属していること

必要なメニュー項目は「デプロイメント管理のコネクタ・インストール」です。

SYSTEM ADMINISTRATORSグループに属していないユーザー・アカウントを使用する場合、コネクタをインストールするには、そのユーザー・アカウントが属するグループの1つに前述の権限とメニュー項目を適用する必要があります。

6.4.3 コネクタのインストール

注意:

このリリース以上では、コネクタの再インストールがサポートされていません。Oracle Identity Managerにすでにインストールされているコネクタ・バージョンはインストールできません。ただし、インストール処理に失敗した場合は、コネクタを再インストールできます。

コネクタをインストールするには、次の手順を実行します。

1. 「コネクタのインストールのためのユーザー・アカウントの作成」に記載されているユーザー・アカウントを使用してOracle Identity Manager管理およびユーザー・コンソールにログインします。

2. 拡張管理→「システム管理」→「デプロイメント・マネージャ」をクリックし、「コネクタの管理」をクリックします。

3. ページの右上隅にある「インストール」をクリックします。

4. 「コネクタ・リスト」リストから、インストールするコネクタを選択します。このリストには、インストール・ファイルがデフォルト・コネクタ・インストール・ディレクトリにコピーされているコネクタの、名前およびリリース番号が表示されます。

OIM_HOME/server/ConnectorDefaultDirectory

インストール・ファイルを異なるディレクトリにコピーした場合は、次のようにします。

1. 「代替ディレクトリ」フィールドに、該当するディレクトリのフルパスおよび名前を入力します。

2. 「リフレッシュ」をクリックして、「コネクタ・リスト」に含まれるコネクタのリストを再移入します。

3. 「コネクタ・リスト」リストから、インストールするコネクタを選択します。
図6-3に、コネクタのインストール・ウィザードの「インストールするコネクタの選択」ページを示します。

図6-3 「インストールするコネクタの選択」ページ

「図6-3 「インストールするコネクタの選択」ページ」の説明

5. 「ロード」をクリックします。
次の情報が表示されます。

- コネクタのインストール履歴
コネクタのインストール履歴は、同じコネクタの以前にインストールされていたリリースに関する情報です。

- コネクタの依存性の詳細
コネクタの中には、使用を開始する前に別のコネクタのインストールが必要なものがあります。たとえば、Novell GroupWiseコネクタを使用する前に、Novell eDirectoryコネクタをインストールする必要があります。この場合、Novell eDirectoryはNovell GroupWiseの依存コネクタになります。

コネクタの依存性の詳細には、選択したコネクタをインストールして使用するために事前にインストールが必要なコネクタのリストが含まれます。これらの詳細には、すでにインストールされている依存コネクタに関する情報や、インストールされている依存コネクタの中でアップグレードが必要なものがあるかどうかに関する情報も含まれます。ただし、依存性情報を表示した後、コネクタのインストール・ウィザードでコネクタをインストールできます。

現在のインストールを完了した後、正しいバージョンの依存コネクタがインストールされているかどうかを確認する必要があります。

図6-4に、コネクタの履歴の詳細およびコネクタの依存性の詳細が表示されたページを示します。

図6-4 コネクタの履歴および依存性

「図6-4 コネクタの履歴および依存性」の説明

6. 「続行」をクリックして、インストール処理を開始します。
次のタスクが順番に実行されます。

1. コネクタ・ライブラリの構成

2. コネクタのXMLファイルのインポート(デプロイメント・マネージャを使用)

3. アダプタのコンパイル
図6-5に、コネクタのインストール・ウィザードの「コネクタのインストール」ページを示します。

図6-5 「コネクタのインストール」ページ

「図6-5 「コネクタのインストール」ページ」の説明

正常に完了したタスクには、チェックマークが表示されます。タスクが失敗すると、Xマークおよび失敗の理由を示すメッセージが表示されます。失敗の理由に応じて必要な修正を行い、次のいずれかの手順を実行します。

- エラーの原因を修正し、「再試行」をクリックしてインストールを再試行します。

- インストールを取り消して、インストール手順のステップ1から再度実行します。

インストールが失敗する理由の1つとしては、構成XMLファイル内のファイルおよびディレクトリ・パスに関する情報と、実際のファイルおよびディレクトリ・パスとの不一致があります。この場合は、エラー・メッセージが表示されます。

たとえば、リコンシリエーションの対象のJARファイルの実際の名前がrecon.jarであるとします。この名前が構成XMLファイルでrecon1.jarと指定されている場合、エラー・メッセージが表示されます。

このようなエラー・メッセージが表示された場合は、次のいずれかの手順を実行します。

- 構成XMLファイルで変更を行い、「ステップ1: インストールするコネクタの選択」ページからインストールを再試行します。
前述の例では、JARファイルの名前を構成XMLファイルでrecon.jarに変更し、「ステップ1: インストールするコネクタの選択」ページからインストールを再試行します。

- ファイルまたはディレクトリの実際の名前またはパスを変更し、「再試行」オプションを使用します。
前述の例では、JARファイルの名前をrecon1.jarに変更し、「再試行」ボタンをクリックします。

7. コネクタのインストール手順の3つのタスクがすべて正常に終了すると、インストールの成功を示すメッセージが表示されます。また、インストール後に実行するステップのリストが表示されます。これらのステップは次のとおりです。

1. コネクタ使用の前提条件が満たされていることの確認

注意:

一部のコネクタには、前提条件はありません。

2. コネクタ用のITリソースの作成
ITリソース・タイプが表示されます。指定したタイプのITリソースを作成する必要があります。これを行うには、拡張管理→「構成」→「リソース管理」→「ITリソースの作成」に移動します。詳細は、コネクタ・ガイドのITリソースの作成に関する説明を参照してください。

3. コネクタのインストール時に作成されたスケジュール済タスクの構成
XMLファイルのインポート・プロセス中に作成したスケジュール済タスクの名前が表示されます。これらのスケジュール済タスクを構成する必要があります。これを行うには、拡張管理→「システム管理」→「スケジューラ」に移動します。または、「システム管理」ページでスケジュール済ジョブを検索できます。詳細は、コネクタ・ガイドのスケジュール済タスクの管理に関する説明を参照してください。

6.5 コネクタの定義

アップグレード、クローニング、アンインストールなどのコネクタLCM操作には、コネクタごとに、すべてのコネクタ・オブジェクトが存在するソースが必要です。コネクタのインストールにより、デプロイメント・マネージャ(DM)XMLがOracle Identity Managerデータベースに格納されます。

通常、出荷されたコネクタをインストールしてから、次の操作のいずれかまたは両方を実行します。

- 既存のオブジェクト定義を追加または変更したり、さらにアダプタを追加するなどして、コネクタをカスタマイズします。

- 属性名およびキー・フィールドを変更するなどしてコネクタを構成または再構成します。

すべてのコネクタLCM操作の参照となるOracle Identity Managerデータベース内のDM XMLは、カスタマイズによる変更のために更新する必要があります。Oracle Identity Managerには、Oracle Identity Managerデータベースに格納されているDM XMLをカスタマイズによる変更で更新するための定義機能があります。定義機能は、特定のコネクタに関連するすべてのコネクタ・オブジェクトをユーザーが追加する必要があるという点で、エクスポートに似ています。コネクタの定義による最終の結果としてXMLファイルが生成され、これがOracle Identity Managerデータベース内で更新されます。

この時点で、カスタマイズまたは再構成したコネクタは、オラクル社がリリースしたコネクタとは異なるものになっています。オラクル社がリリースしたコネクタのコネクタXMLファイルは、カスタマイズまたは再構成したコネクタに対して無効になっている可能性があります。

Oracle Identity Manager管理およびユーザー・コンソールの拡張管理ページで、カスタマイズまたは再構成したコネクタを定義できます。コネクタを定義することは、コネクタをOracle Identity Managerに登録することと同じです。

注意:

このコネクタ固有のこれらのOracle Identity Managerアーティファクトのみを追加する必要があり、また、デフォルトのオブジェクトまたは複数のコネクタ間で共有される他のコネクタ・オブジェクトは追加しないでください。定義済XMLは、アップグレード、クローニング、アンインストールなどのライフサイクル操作のソースになります。オブジェクトが定義で使用され、複数のコネクタで共有される場合、またはデフォルトのOracle Identity Managerオブジェクトの場合、意図しない動作になります。たとえば、Oracle Identity Managerにデフォルトで存在する参照定義が定義の一部として追加されると、クローニング操作によりオブジェクトの不要なコピーがもう1つ作成されます。このデフォルト・オブジェクトはコネクタ固有で定義されているため、アンインストールによりOracle Identity Managerから削除されます。このような不正な定義は、Oracle Identity Managerの機能に影響を与えます。このため、コネクタの定義時にオブジェクトを追加する際には注意が必要です。

コネクタを定義すると、コネクタを表すレコードがOracle Identity Managerデータベースに作成されます。このレコードがすでに存在する場合は、次の項目が更新されます。

- コネクタの名前。たとえば、Microsoft Active Directoryなどです。

- コネクタのリリース番号。たとえば、9.1.1などです。

- コネクタXML定義。

注意:

- コネクタXML定義は、XMLファイルの形式で定義できます。詳細は、コネクタ・ガイドで、コネクタXML形式でのコネクタ・オブジェクトの定義のエクスポートに関する説明を参照してください。このコネクタXMLファイルを使用して、別のOracle Identity Managerインストールにコネクタをインストールするためのインストール・パッケージを構築できます。

- コネクタの定義は、コネクタをカスタマイズするか、カスタマイズによる変更でDM XMLファイルを更新した後すぐに行うことをお薦めします。

コネクタは、コネクタのインストール機能を使用してインストールするか、またはコネクタのアップグレード機能を使用してアップグレードすると、自動的に定義されます。したがって、コネクタをインストールし、コネクタをカスタマイズすることなくクローニングする場合は、コネクタを定義する必要がありません。

次のような場合に、コネクタを手動で定義する必要があります。

- デプロイメント・マネージャを使用してコネクタをインポートする場合

- コネクタをカスタマイズまたは再構成する場合

注意:

コネクタをカスタマイズまたは再構成した後、またはOracle Identity Managerをアップグレードした後は、定義しなくても引き続き使用できます。ただし、コネクタをアップグレード、クローニングまたはアンインストールする場合は、まずコネクタを定義する必要があります。

- Oracle Identity Managerをアップグレードする場合

- カスタム・コネクタを開発している場合

コネクタを定義するには:

注意:

Oracle Identity Manager管理およびユーザー・コンソールを使用して特定のリリースのコネクタを定義できるかどうかを確認するには、そのリリースのコネクタのドキュメントを参照してください。

1. Oracle Identity Manager管理およびユーザー・コンソールにログインし、拡張管理をクリックします。

2. 左ペインで「システム管理」→「デプロイメント管理」を展開し、「コネクタの管理」をクリックします。

3. 「コネクタの管理」ウィンドウで、「定義」をクリックします。図6-6に示すようにコネクタ管理ウィザードが表示されます。

図6-6 コネクタを定義するためのコネクタ管理ウィザード

「図6-6 コネクタを定義するためのコネクタ管理ウィザード」の説明

4. ウィザードの最初のページで、「検索」リストから「リソース」または「プロセス」のいずれかを選択します。隣接するフィールドで、検索文字列と、ワイルドカード文字としてアスタリスク(*)を入力し、コネクタに属しているリソース・オブジェクトまたはプロセス定義の検索を絞り込みます。次に「検索」をクリックします。
コネクタを構成するオブジェクトのほとんどは、コネクタのリソース・オブジェクトおよびプロセス定義にリンクされています。リソース・オブジェクトまたはプロセス定義を選択することによって、それらにリンクされているオブジェクトが自動的に選択されます。スケジュール済タスクなど一部のコネクタ・オブジェクトには、リソース・オブジェクトとの依存性がありません。定義時には、すべての属性を検索し、追加していることを確認してください。

「検索」をクリックすると、指定した検索基準を満たすリソース・オブジェクトおよびプロセス定義のリストが表示されます。

5. コネクタの一部であるリソース・オブジェクトまたはプロセス定義のチェック・ボックスを選択します。
図6-7に、コネクタ・オブジェクトの検索結果が表示されたコネクタ管理ウィザードのステップ1を示します。

図6-7 コネクタ管理ウィザードのステップ1

「図6-7 コネクタ管理ウィザードのステップ1」の説明

6. 「子の選択」をクリックします。

7. 表示されたコネクタ・オブジェクトのリストで、コネクタに属しているすべてのオブジェクトが選択されていることを確認します。次に「依存性の選択」をクリックします。

注意:

オラクル社がリリースしたコネクタの場合、コネクタの一部になっているアダプタのリストについてはコネクタ・ガイドに記載されています。これらのアダプタのチェック・ボックスを選択します。

図6-8に、コネクタ管理ウィザードのステップ2を示します。

図6-8 コネクタ管理ウィザードのステップ2

「図6-8 コネクタ管理ウィザードのステップ2」の説明

8. 選択したオブジェクトのリストを確認した後、「確認」をクリックします。
図6-9に、選択したコネクタ・オブジェクトのリストが表示されたコネクタ管理ウィザードのステップ3を示します。

図6-9 コネクタ管理ウィザードのステップ3

「図6-9 コネクタ管理ウィザードのステップ3」の説明

9. 「定義用に追加」をクリックします。
図6-10に、コネクタ管理ウィザードのステップ4を示します。

図6-10 コネクタ管理ウィザードのステップ4

「図6-10 コネクタ管理ウィザードのステップ4」の説明

10. 作業を進めるには、次のいずれかのオプションを選択して「OK」をクリックします。

- 追加(ステップ1に移動): このオプションは、コネクタ管理ウィザードのステップ1に進み、追加のコネクタ・オブジェクトを選択する場合に選択します。

- ウィザードを終了し、すべての選択を表示します: このオプションは、コネクタ管理ウィザードを終了し、選択したコネクタ・オブジェクトの完全なリストを表示します。

図6-11に、コネクタ・オブジェクトを追加するオプションまたはウィザードを終了するオプションが表示されたページを示します。

図6-11 追加のオブジェクトを選択するか終了するオプション

「図6-11 追加のオブジェクトを選択するか終了するオプション」の説明

11. 表示されるページで、「現在の選択」リストに表示されているオブジェクトのみが、コネクタ定義に含まれます。リスト間でオブジェクトをドラッグできます。たとえば、「現在の選択」リストから「未選択の子」リストにアダプタをドラッグできます。必要な変更を行った後、「定義」をクリックします。

注意:

定義しているコネクタに固有のOracle Identity Managerコネクタ・オブジェクトをすべて追加したことを確認します。コネクタの定義時に特定のコネクタ・オブジェクトがないと、アップグレード、クローニングまたはアンインストールで未定義のオブジェクトを処理できないことがあります。

一般的にほぼすべてのコネクタに関連付けられているOracle Identity Managerアーティファクトは、次のとおりです。

- リソース・オブジェクト

- イベント・ハンドラ

- プロセス・フォーム

- ITリソース

- データ・オブジェクト定義

- 事前移入アダプタ

- プロセス

- ITリソース・タイプ定義

- タスク・アダプタ

- 参照

- スケジュール済タスク

図6-12に、コネクタ定義に含める、選択したコネクタ・オブジェクトの完全なリストと、未選択のコネクタの依存性が表示されたページを示します。

図6-12 選択されたコネクタ・オブジェクト

「図6-12 選択されたコネクタ・オブジェクト」の説明

12. 表示されるダイアログ・ボックスで、次のいずれかのオプションを選択します。

- コネクタの名前を選択し、そのリリース番号を入力してください。: このオプションは、このコネクタの以前のリリースがこのOracle Identity Managerインストールにすでに存在する場合に選択します。また、コネクタ名を選択し、リリース番号を入力します。

- コネクタの名前とリリース番号を入力してください: このオプションは、このコネクタの以前のリリースがこのOracle Identity Managerインストールに存在しない場合に選択します。また、コネクタ名およびリリース番号を入力します。

図6-13に、コネクタ名およびリリース番号を指定するダイアログ・ボックスを示します。

図6-13 コネクタ名およびリリース番号

「図6-13 コネクタ名およびリリース番号」の説明

13. 「定義」をクリックします。

14. 処理の最後に、操作が正常に行われたことを示すメッセージが表示されます。「閉じる」をクリックします。

6.6 コネクタのクローニング

注意:

このガイドでは、コネクタのクローニング機能という用語は、コネクタのクローニングに使用できる、Oracle Identity Manager管理およびユーザー・コンソールの一連のページのことを示しています。

この項では、コネクタを構成するオブジェクトのいくつかに新しい名前を設定することによって、コネクタのコピーを作成する手順について説明します。この処理により、新しいコネクタXMLファイルが生成されます。リソース・オブジェクト、プロセス定義、プロセス・フォーム、ITリソース・タイプ定義、ITリソース・インスタンス、参照定義、アダプタ、リコンシリエーション・ルールなど、新しいコネクタXMLファイル内のほとんどのコネクタ・オブジェクトの名前が新しくなります。

注意:

Oracle Identity Managerには、単一のコネクタを使用して次の項目を統合するための別の機能があります。

- 特定のターゲット・システムの複数のインストールとOracle Identity Manager

- 複数のユーザー・タイプ(たとえば、従業員および契約者)に関するデータを格納し、それぞれのユーザー・タイプに異なるリソース・オブジェクトを提供するためにOracle Identity Managerを必要とするターゲット・システム

アクセス・ポリシーを使用して特定のターゲット・システム上の様々なユーザー・タイプ用のリソース・オブジェクトを作成する方法の詳細は、コネクタ・ガイドを参照してください。

この項の内容は次のとおりです。

- コネクタのクローニングのガイドライン

- コネクタのクローニング

- クローニング後の手順

6.6.1 コネクタのクローニングのガイドライン

コネクタのクローニング機能を使用する際には、次のガイドラインが適用されます。

- コネクタのクローニング機能では、リクエスト・データセットのクローニングはサポートされません。これは、リクエスト・データセット定義が通常はコネクタXMLファイルに含まれていないためです。同じターゲットの属性に変更があったが、別のインスタンスでは変更がない場合、コネクタのクローニングされたコピーが必要になります。属性が異なる場合、同じリクエスト・データセットを使用できません。

- このユーティリティを使用してコネクタのクローンを作成するには、コネクタにコネクタのクローニング機能との互換性があることが必要です。オラクル社がリリースしたコネクタの場合、コネクタがコネクタのクローニング機能でサポートされているかどうかの詳細は、コネクタ・ガイドを参照してください。

- コネクタ・オブジェクトの名前に対して実行される検証は、他のコネクタに属しているオブジェクトの名前には適用されません。ただし、コネクタのクローニング機能により作成されたコネクタXMLファイルをインポートする際に、オブジェクト名の重複があるとデプロイメント・マネージャによりエラーがスローされます。これについて、次の例で説明します。
Microsoft Active Directoryコネクタに、AD USERという名前のリソース・オブジェクトが属しています。Oracle Identity Managerデータベースに、My_ROという名前の既存のリソース・オブジェクトが定義されているとします。AD_USERリソース・オブジェクトに指定した新しい名前がMy_ROの場合、コネクタのクローニング機能では、指定した名前のリソース・オブジェクトがすでに存在することを示すエラー・メッセージは表示されません。

6.6.2 コネクタのクローニング

コネクタのクローニングでは2段階の手順を実行します。

- 手順1: クローニングされるコネクタのコネクタXMLファイルの作成

- 手順2: クローン・コネクタのインストール

手順1: クローニングされるコネクタのコネクタXMLファイルの作成

クローニングされるコネクタのコネクタXMLファイルを作成するには、次の手順を実行します。

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

2. 拡張管理に移動し、左ペインで「システム管理」→「デプロイメント・マネージャ」を展開し、「コネクタの管理」をクリックします。

3. 次の手順は、クローンの作成に使用するソースXMLによって異なります。

- コネクタXMLファイルをソースとして使用する場合:

1. 右上隅にある「クローン」をクリックします。

2. 「ステップ1: ファイル・システムからのXML選択」ページで、「参照」オプションを使用してコネクタXMLファイルに移動して選択します。
図6-14に、コネクタ管理 - クローニング・ウィザードのファイル・システムからのXML選択ページを示します。

図6-14 ファイル・システムからのXML選択ページ

「図6-14 ファイル・システムからのXML選択ページ」の説明

3. 「続行」をクリックします。

- コネクタの定義時にデータベースに格納されたコネクタXMLを使用する場合:

1. 「検索」機能を使用して、コネクタを検索します。図6-15に、コネクタを検索するページを示します。

図6-15 コネクタの検索

「図6-15 コネクタの検索」の説明

2. 表示される検索結果で、クローニング対象のコネクタの行にある「クローン」アイコンをクリックします。

4. 「ステップ2: リソース・オブジェクトの新しい名前の指定」ページで、クローンのリソース・オブジェクトの新しい名前を入力します。
コネクタに複数のリソース・オブジェクトがある場合、それぞれのリソース・オブジェクトに指定する新しい名前は、そのコネクタの既存のリソース・オブジェクトのどの名前とも異なっている必要があります。

すべてのリソース・オブジェクトに新しい名前を指定してから、「続行」をクリックします。

図6-16に、コネクタ管理 - クローニング・ウィザードの「リソース・オブジェクトの新しい名前の指定」ページを示します。

図6-16 「リソース・オブジェクトの新しい名前の指定」ページ

「図6-16 「リソース・オブジェクトの新しい名前の指定」ページ」の説明

5. 「ステップ3: プロセス定義の新しい名前の指定」ページで、クローンのプロセス定義の新しい名前を入力します。
コネクタに複数のプロセス定義がある場合、それぞれのプロセス定義に指定する新しい名前は、そのコネクタの既存のプロセス定義のどの名前とも異なっている必要があります。

すべてのプロセス定義に新しい名前を指定してから、「続行」をクリックします。

図6-17に、コネクタ管理 - クローニング・ウィザードの「プロセス定義の新しい名前の指定」ページを示します。

図6-17 「プロセス定義の新しい名前の指定」ページ

「図6-17 「プロセス定義の新しい名前の指定」ページ」の説明

6. 「ステップ4: プロセス・フォームの新しい名前の指定」ページで、クローンのプロセス・フォームの新しい名前を入力します。
コネクタに複数のプロセス・フォームがある場合、それぞれのプロセス・フォームに指定する新しい名前は、そのコネクタの既存のプロセス・フォームのどの名前とも異なっている必要があります。

すべてのプロセス・フォームに新しい名前を指定してから、「続行」をクリックします。

図6-18に、コネクタ管理 - クローニング・ウィザードの「プロセス・フォームの新しい名前の指定」ページを示します。

図6-18 「プロセス・フォームの新しい名前の指定」ページ

「図6-18 「プロセス・フォームの新しい名前の指定」ページ」の説明

7. 「ステップ5: ITリソース・タイプ定義の新しい名前の指定」ページで、クローンのITリソース・タイプ定義の新しい名前を入力します。
コネクタに複数のITリソース・タイプ定義がある場合、それぞれのITリソース・タイプ定義に指定する新しい名前は、そのコネクタの既存のITリソース・タイプ定義のどの名前とも異なっている必要があります。

すべてのITリソース・タイプ定義に新しい名前を指定してから、「続行」をクリックします。

図6-19に、コネクタ管理 - クローニング・ウィザードの「ITリソース・タイプ定義の新しい名前の指定」ページを示します。

図6-19 「ITリソース・タイプ定義の新しい名前の指定」ページ

「図6-19 「ITリソース・タイプ定義の新しい名前の指定」ページ」の説明

8. 「ステップ6: ITリソースの新しい名前の指定」ページで、クローンのITリソースの新しい名前を入力します。
コネクタに複数のITリソースがある場合、それぞれのITリソースに指定する新しい名前は、そのコネクタの既存のITリソースのどの名前とも異なっている必要があります。

すべてのITリソースに新しい名前を指定してから、「続行」をクリックします。

図6-20に、コネクタ管理 - クローニング・ウィザードの「ITリソース・タイプ定義の新しい名前の指定」ページを示します。

図6-20 「ITリソースの新しい名前の指定」ページ

「図6-20 「ITリソースの新しい名前の指定」ページ」の説明

9. 「ステップ7: スケジュール済タスクの新しい名前の指定」ページで、クローンのスケジュール済タスクの新しい名前を入力します。
スケジュール済タスクの新しい名前を入力します。ただし、クローンおよび元のコネクタに、スケジュール済タスクの同一のセットを使用することはできません。

「続行」をクリックします。

図6-21に、コネクタ管理 - クローニング・ウィザードの「スケジュール済タスクの新しい名前の指定」ページを示します。

図6-21 「スケジュール済タスクの新しい名前の指定」ページ

「図6-21 「スケジュール済タスクの新しい名前の指定」ページ」の説明

10. 「ステップ8: 参照タイプ定義の新しい名前の指定」ページで、クローンの参照定義の新しい名前を入力します。
「続行」をクリックします。

図6-22に、コネクタ管理 - クローニング・ウィザードの「参照タイプ定義の新しい名前の指定」ページを示します。

図6-22 「参照タイプ定義の新しい名前の指定」ページ

「図6-22 「参照タイプ定義の新しい名前の指定」ページ」の説明

11. 「ステップ9: アダプタの接頭辞の指定」ページで、アダプタのコピーの接頭辞として設定される文字列を入力します。次に、「続行」をクリックします。
指定する接頭辞により、アダプタの完全名が80文字を超えないようにする必要があります。コネクタのクローニング機能では、この制限を超えたかどうかをチェックできません。ただし、クローンに対して作成されたコネクタXMLファイルをインポートする際に、デプロイメント・マネージャによりエラーがスローされます。クローンのデプロイメント・パッケージを構築し、コネクタのインストール機能を使用してクローンをインストールする場合にもデプロイメント・マネージャが呼び出されることに注意してください。

Design Consoleを使用して、最も長いアダプタ名の文字長を決定できます。

図6-23に、コネクタ管理 - クローニング・ウィザードのアダプタの接頭辞の指定ページを示します。

図6-23 アダプタの接頭辞の指定ページ

「図6-23 アダプタの接頭辞の指定ページ」の説明

12. 「ステップ10: リコンシリエーション・ルールの新しい名前の指定」ページで、クローンのリコンシリエーション・ルールの新しい名前を入力します。
図6-24に、コネクタ管理 - クローニング・ウィザードの「リコンシリエーション・ルールの新しい名前の指定」ページを示します。

図6-24 「リコンシリエーション・ルールの新しい名前の指定」ページ

「図6-24 「リコンシリエーション・ルールの新しい名前の指定」ページ」の説明

13. 「ステップ11: オブジェクト名のサマリー」ページで、クローンのコネクタ・オブジェクトに設定した名前を確認し、「続行」をクリックします。
図6-25に、コネクタ管理 - クローニング・ウィザードの「オブジェクト名のサマリー」ページを示します。

図6-25 「オブジェクト名のサマリー」ページ

「図6-25 「オブジェクト名のサマリー」ページ」の説明

14. 「ステップ12: オブジェクト・クローン生成」ページで、「XMLの生成」をクリックします。
図6-26に、コネクタ管理 - クローニング・ウィザードの「オブジェクト・クローン生成」ページを示します。

図6-26 「オブジェクト・クローン生成」ページ

「図6-26 「オブジェクト・クローン生成」ページ」の説明

15. ファイルのダウンロード・ダイアログ・ボックスで、「保存」オプションを使用し、クローンのコネクタXMLファイルを任意の場所に保存します。
図6-27に、ファイルのダウンロード・ダイアログ・ボックスを示します。

図6-27 ファイルのダウンロード・ダイアログ・ボックス

「図6-27 ファイルのダウンロード・ダイアログ・ボックス」の説明

手順2: クローン・コネクタのインストール

クローン・コネクタは、次のいずれかの方法を使用してインストールできます。

注意:

クローン・コネクタは、同じOracle Identity Managerインストール上または別のOracle Identity Managerインストールにインストールできます。

- デプロイメント・マネージャを使用して、コネクタXMLファイルをインポートします。デプロイメント・マネージャのインポートを使用してコネクタをインストールする場合、クローニングされるコネクタを定義する必要があります。これにより、「コネクタ管理」の「検索」で、コネクタのリストにクローニングされるコネクタが含まれるようになります。元のコネクタが存在しない別のOracle Identity Manager環境にコネクタをインポートする場合、JarUploadユーティリティを使用して、コネクタに関連するJarファイルをアップロードする必要があります。

- クローニングされるコネクタのデプロイメント・パッケージを作成し、コネクタのインストール機能を使用してそれをインストールします。サンプルについては、オラクル社がリリースしたコネクタのデプロイメント・パッケージの内容を確認してください。

6.6.3 クローニング後の手順

コネクタ・オブジェクトの新しい名前を設定することによってコネクタのコピーを作成した後、一部のオブジェクトに以前のコネクタ・オブジェクトの詳細が含まれていることがあります。このため、次のOracle Identity Managerオブジェクトを変更して、ベース・コネクタのアーティファクトまたは属性参照を、対応するクローニングされるアーティファクトまたは属性と置き換える必要があります。

- 参照定義: 参照定義に以前の参照定義の詳細が含まれる場合は、それを変更してクローニングされる参照定義の新しい名前を指定する必要があります。エンコード値およびデコード値がベース・コネクタの属性参照を参照している場合、これらを、クローニングされる新しい属性と置き換える必要があります。

- スケジュール済タスク: スケジュール済タスク内のベース・コネクタのリソース・オブジェクト名は、クローニングされるリソース・オブジェクト名と置き換える必要があります。スケジュール済タスクのパラメータに、ベース・コネクタのアーティファクトまたは属性を参照しているデータがある場合、これらを、クローニングされるコネクタの新しいアーティファクトまたは属性と置き換える必要があります。

6.7 コネクタ・オブジェクトの定義のコネクタXML形式でのエクスポート

前述のように、Oracle Identity Managerデータベースには、すべてのコネクタ・オブジェクトの定義が格納されています。特定のコネクタ用のコネクタXMLファイルを作成するためにこれらの定義をエクスポートできます。デプロイメント・マネージャを使用して、別のOracle Identity Managerインストールでコネクタ・オブジェクト定義を作成するためにコネクタXMLファイルをインポートできます。

または、コネクタ用に作成するデプロイメント・パッケージの1つのコンポーネントとしてコネクタXMLファイルを使用できます。その後、コネクタのインストール機能を使用してこのデプロイメント・パッケージをインストールできます。サンプルについては、オラクル社がリリースしたコネクタのデプロイメント・パッケージの内容を確認してください。デプロイメント・パッケージのもう1つの重要なコンポーネントは構成XMLファイルであり、コネクタのインストール機能で使用されます。構成XMLファイルは手動で作成する必要があります。

関連項目:

構成XMLファイルの内容の詳細は、コネクタ・ガイドを参照してください。

コネクタ・オブジェクト定義をコネクタXML形式でエクスポートするには:

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

2. 左ペインで「システム管理」→「デプロイメント管理」を展開し、「コネクタの管理」をクリックします。

3. 次のいずれかのオプションを使用してコネクタXMLファイルをエクスポートできます。

- XMLファイルに特定のコネクタ・オブジェクトの定義のみを含める場合は、「エクスポート」ボタンを使用して「デプロイメント・マネージャ」を開きます。この機能を使用してコネクタXMLファイルに定義を含めるコネクタ・オブジェクトを選択する方法の詳細は、コネクタ・ガイドのデプロイメント・マネージャの使用に関する説明を参照してください。

- コネクタの定義時にデータベースに格納されたコネクタXMLからコネクタXMLファイルを作成する場合は、次を実行します。

1. 「コネクタ管理」ページで、「検索」機能を使用して、コネクタXMLファイルを作成するコネクタを表示します。

2. コネクタ行に表示されている「エクスポート」アイコンを使用して、コネクタ定義時にデータベースで作成されたエントリからコネクタXMLファイルをエクスポートします。
図6-28に、「コネクタ管理」ページを示します。

図6-28 「コネクタ管理」ページ

「図6-28 「コネクタ管理」ページ」の説明

6.8 コネクタのアップグレード

コネクタのアップグレードが必要となるサンプルのシナリオを次に示します。

- 既存のコネクタの再構成またはカスタマイズ
コネクタをインストールした後に、要件に従ってカスタマイズまたは再構成する場合があります。たとえば、リコンシリエーションおよびプロビジョニングのために新しい属性を追加し、リコンシリエーションまたは参照フィールド同期のスケジュール済タスクを変更する場合があります。原則として、コネクタに対するこれらの変更はステージング・サーバーで行います。次に、本番サーバーにデプロイされているコネクタを、ステージング・サーバーで変更を加えて作成したバージョンにアップグレードします。

- カスタマ開発のコネクタのアップグレード
独自のコネクタを開発している場合があります。オラクル社がリリースしたアップグレードをコネクタに使用できる場合、現在のコネクタからオラクル社がリリースしたコネクタにアップグレードすることがあります。たとえば、IBM Lotus Notes and Domino用のコネクタを開発し、使用しているとします。オラクル社がOracle Identity Manager Connector for IBM Lotus Notes and Dominoの新しいリリースを出荷した場合、その新しいリリースに含まれている一部の機能を使用することがあります。コネクタのアップグレード機能を使用して、現在のコネクタからオラクル社がリリースしたコネクタにアップグレードできます。

- オラクル社がリリースしたコネクタのアップグレード
オラクル社がコネクタのアップグレードを出荷します。アップグレードに、必要とする機能拡張および修正が含まれていることがあります。たとえば、現在SAP User Managementリリース9.1.2を使用しており、同じコネクタのリリース9.1.2.3が使用可能になった場合、そのリリースへのアップグレードが必要になることがあります。

これらのシナリオでは、コネクタのアップグレード機能を使用して、コネクタをアップグレードできます。

コネクタのアップグレードは、次の2つの方法で実行できます。

- サイレント・モード・アップグレード: ステージングおよび本番環境で使用されます。

- ウィザード・モード・アップグレード: 開発環境で使用されます。

このガイドでは、Oracle Identity Managerの管理およびユーザー・コンソールの各ページを使用して実行するウィザード・アップグレードについて説明します。

この項の内容は次のとおりです。

- コネクタのアップグレード機能でサポートされているアップグレード・ユースケース

- アップグレード手順のサマリー

- コネクタのアップグレード手順

6.8.1 コネクタのアップグレード機能でサポートされているアップグレード・ユースケース

次のタイプのソース・コネクタが、コネクタのアップグレード機能でサポートされています。

- カスタマ開発のコネクタ

- コネクタのインストール機能でサポートされていない、オラクル社がリリースしたコネクタ

- コネクタのインストール機能でサポートされている、オラクル社がリリースしたコネクタ

- コネクタのインストール機能でサポートされ、カスタマイズされている、オラクル社がリリースしたコネクタ

- クローニングされたコネクタ

このアップグレード・プロセスでは、次のオブジェクトは対象としていません。

- 電子メール定義

- パスワード・ポリシー

- エラー・メッセージ定義

- ビジネス・ルール定義

- オブジェクト・フォーム

- アクセス・ポリシー

注意:

- コネクタ・ライフサイクル管理では、ソース・コネクタが信頼できるソース構成にXellerateユーザー・リソース・オブジェクトを使用している場合、信頼できるコネクタのアップグレードはサポートしません。そのため、コネクタを手動でアップグレードする必要があります。詳細は、Oracleサポートに連絡してください。

- コネクタ・ライフサイクル管理では、ターゲット・モード(ソース・バージョン)から信頼できるモード(ターゲット・バージョン)へのコネクタのアップグレードはサポートしていません。同様に、信頼できるモードからターゲット・モードへのアップグレードもサポートされていません。

ユースケース1: カスタム開発のソース・コネクタ

カスタム開発のソース・コネクタは、コネクタのアップグレード機能と互換性を持たせるために、次の要件を満たす必要があります。

- コネクタは、Oracle Identity Managerで定義されている必要があります。コネクタを手動で定義する場合は、「コネクタの定義」を参照してください。

- コネクタには構成XMLファイルが必要です。構成XMLファイルの詳細は、コネクタ・ガイドを参照してください。

カスタム開発のソース・コネクタをアップグレードする前に発生する可能性のあるサンプル・イベントを次に示します。

- コネクタおよびその構成XMLファイルを開発します。

- コネクタのインストール機能と互換性のあるデプロイメント・パッケージを作成します。この機能を使用してコネクタを本番サーバーにデプロイする場合、そのコネクタはインストール・プロセスの最後に自動的に定義されます。

- このコネクタをリコンシリエーションおよびプロビジョニングに使用します。ターゲット・システム・リソースが、(リコンシリエーションおよびプロビジョニングを介して)OIMユーザーに割り当てられます。

- ステージング・サーバーでコネクタを変更し、再定義して、コネクタXMLファイルを再生成します。

ユースケース2: コネクタのインストール機能でサポートされていない、オラクル社がリリースしたコネクタ

コネクタのインストール機能でサポートされていないコネクタは、コネクタのアップグレード機能と互換性を持たせるために、次の要件を満たす必要があります。

- コネクタは、Oracle Identity Managerで定義されている必要があります。コネクタを手動で定義する場合は、「コネクタの定義」を参照してください。

- コネクタには構成XMLファイルが必要です。構成XMLファイルの詳細は、コネクタ・ガイドを参照してください。

このユースケースのサンプル・イベントとアップグレード手順は、ユースケース1の場合と同じです。

ユースケース3: コネクタのインストール機能を使用してインストールされた、オラクル社がリリースしたコネクタ

コネクタのインストール機能を使用してインストールされたコネクタは、ユースケース1および2で示されている要件を満たしています。

ユースケース4: インストールされ、その後カスタマイズされた、オラクル社がリリースしたコネクタ

コネクタのインストール機能でサポートされているコネクタは、ユースケース1および2で示されている要件を満たしています。ただし、カスタマイズは、アップグレード・プロセス中に上書きされます。たとえば、スケジュール済タスクに属性を追加し、リコンシリエーション対象のJARファイルも変更した場合、このカスタマイズはアップグレード後に失われます。この問題を回避するには、次の操作を実行します。

1. コネクタに実装したカスタマイズのレコードを保持します。

2. コネクタのアップグレード後に、このカスタマイズを再適用します。

ユースケース5: クローニングされたコネクタ

コネクタのクローニング機能を使用してインストールされたコネクタは、ユースケース1および2で示されている要件を満たしています。

アップグレード操作の後、各クローンを使用して、アップグレード前にクローンにより収集されたリソース・データを管理できます。

6.8.2 コネクタのアップグレード機能でサポートされるコネクタ・オブジェクト変更

コネクタをアップグレードする前に、個々のコネクタ・オブジェクトに変更を加えて、コネクタを再構成またはカスタマイズしている場合があります。アップグレード・プロセス自体により、個々のコネクタ・オブジェクトが変更されます。次の項では、コネクタのアップグレード機能でサポートされているコネクタ・オブジェクト変更を示します。これらの変更は、手動で(つまり、コネクタのアップグレード機能の使用前の任意の時点で)実行されたか、またはコネクタのアップグレード機能自体によって実行された可能性があります。

- リソース・オブジェクトの変更

- プロセス定義の変更

- コネクタ・コード・ファイルの変更

- プロセス・フォームの変更

- 参照定義の変更

- アダプタの変更

- ルールの変更

- ITリソース・タイプの変更

- ITリソースの変更

- スケジュール済タスクの変更

6.8.2.1 リソース・オブジェクトの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が行われたリソース・オブジェクトで実行できます。また、アップグレード操作によりリソース・オブジェクトに次の任意の組合せの変更が行われることがあります。

- ステータス定義を追加または削除できます。

- 管理者を割り当てるか、または削除できます。

- パスワード・ポリシーを追加または削除できます。

- ユーザー定義フィールド(UDF)を追加または削除できます。

- 他のリソース・オブジェクトとの依存性を割り当てるか、または削除できます。

- オブジェクト認可ユーザーを割り当てるか、または削除できます。また、認可ユーザーに割り当てられた優先度番号を変更できます。

- プロセス決定ルールを割り当てるか、または削除できます。

- イベント・ハンドラ・アダプタを割り当てるか、または削除できます。

- ターゲット・コネクタのコネクタXMLに存在しないリソース・オブジェクト・フィールドは、廃止としてマークされます。

- リソース・オブジェクトで実行されたカスタマイズは保持されません。

アップグレード後、リソース・オブジェクトの新しい名前はターゲット・コネクタのコネクタXMLで指定した名前になります。

6.8.2.2 プロセス定義の変更

コネクタのアップグレード機能は、次の任意の組合せの変更が行われたプロセス定義に対して実行できます。また、アップグレード操作によりプロセス定義に次の任意の組合せの変更が行われることがあります。

- 既存のプロセス定義は、新しいプロセス定義で置き換えることができます。

- 既存のプロビジョニング定義の名前を変更できます。

- 既存のリコンシリエーション・フィールド・マッピングは、変更なしで保持するか、または修正できます。

- 新しいプロセス・タスクを追加できます。

- カスタム・プロセス・タスクは、変更なしで保持できます。

- デフォルトのプロセス・タスクを保持できますが、新しいバージョンにおいてデフォルトのプロセス・タスクに変更がないことを確認する必要があります。詳細は、コネクタ・ガイドを参照してください。

- 次の任意の組合せの変更を、既存のプロセス・タスクに対して実行できます。

- タスクの名前およびプロパティを変更できます。

- 付加されたイベント・ハンドラ・アダプタを変更できます。

- 先行タスクまたは依存タスクを追加、変更または削除できます。

- 新しいレスポンス・コードを追加できます。

- 既存のレスポンス・コードを変更または削除できます。

- 新しいタスクを生成できます。

- 取消しタスクおよびリカバリ・タスクを変更できます。

- タスクからオブジェクトへのステータス・マッピングを変更できます。

- 割当てルールを変更できます。

- 既存のプロセス・タスクを削除できます。

アップグレード後、プロセス定義の新しい名前は、ターゲット・コネクタのコネクタXMLで指定した名前になります。

6.8.2.3 コネクタ・コード・ファイルの変更

アップグレード操作中、JARファイルおよびスクリプトが含まれているコネクタ・コード・ファイルを、指定したディレクトリにコピーする必要があります。これを行うには、次のようにします。

1. UpdateJarsユーティリティ(OIM_HOME/server/binにあります)を使用して、コネクタ配布バンドルのlibフォルダにあるすべてのコネクタ固有jar(共通ライブラリ・ファイルのCommon.jar、FAMILYCommon.jarおよびicf-Common.jarを除く)を手動でOracle Identity Managerデータベースにアップロードします。

2. DownloadJarユーティリティ(OIM_HOME/server/binにあります)を使用して、共通ライブラリ(Common.jar、FAMILYCommon.jarおよびicf-Common.jar)をOracle Identity Managerデータベースからダウンロードします。

3. ダウンロードしたライブラリからMANIFEST.MFを抽出します。このバージョンのMANIFEST.MFを、収束された配布バンドルの一部として使用可能な共通ライブラリのMANIFEST.MFのバージョンと比較します。配布ライブラリのバージョンが、Oracle Identity Managerデータベースからダウンロードしたバージョン以上の場合は、UploadJarユーティリティ(OIM_HOME/server/binにあります)を使用して、共通ライブラリをOracle Identity Managerデータベースにアップロードします。

6.8.2.4 リソース・オブジェクトの変更

リソース・バンドルを更新するには、次の手順を実行します。

1. コネクタ・リソース・バンドルへの新しいエントリの追加など、リソース・バンドルに対してなんらかのカスタマイズを行っている場合は、コネクタ配布バンドルのリソース・フォルダに存在するリソース・バンドルに変更内容を適用する必要があります。Oracle Identity Managerデータベースに存在する既存のリソース・バンドルは、OIM_HOME/server/binにあるDownloadResourceBundlesユーティリティを使用してダウンロードできます。

2. DownloadResourceBundlesユーティリティ(OIM_HOME/server/binにあります)を使用して、コネクタに固有のすべてのリソース・バンドルをOracle Identity Managerデータベースから削除します。

3. UploadResourceBundlesユーティリティ(OIM_HOME/server/binにあります)を使用して、コネクタに固有のすべてのリソース・バンドルをOracle Identity Managerデータベースにアップロードします。

6.8.2.5 プロセス・フォームの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行されたプロセス・フォームで実行できます。また、アップグレード操作によりプロセス・フォームに次の任意の組合せの変更が行われることがあります。

注意:

- アップグレード操作は、プロセス・フォームのアクティブなバージョンにのみ作用します。以前のバージョンは変更されません。

- 既存のプロセス・フォームの名前は変更できません。

- 列を追加、変更または削除できます。

- 子フォームを追加、変更または削除できます。

- 事前移入アダプタを追加できます。

- 既存の事前移入アダプタの名前、マッピング、順序およびルールを変更できます。

- 既存のフォームに存在していた特定のフィールドを新しいバージョンに追加する場合、ユーザーは、アクティブなバージョンに手動でカスタマイズを追加できます。

- フォーム属性が保持され、この属性が参照する対応コネクタ・オブジェクト(参照定義やITリソース・タイプ定義など)が削除されている場合、適切なコネクタ・オブジェクトを指すようにすることによってフォーム属性プロパティを変更する必要があります。

アップグレード後、プロセス・フォームの名前はアップグレードされたコネクタのバージョン番号になります。

6.8.2.6 参照定義の変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行された参照定義で実行できます。また、アップグレード操作により参照定義に次の任意の組合せの変更が行われることがあります。

- 参照定義を追加できます。

注意:

アップグレード操作中に既存の参照定義が削除されることはありません。

- 既存の参照定義を保持または変更できます。アップグレード操作中、既存の参照定義内の新しいエントリが既存のエントリの後ろに追加されます。

6.8.2.7 アダプタの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行されたアダプタで実行できます。また、アップグレード操作によりアダプタに次の任意の組合せの変更が行われることがあります。

注意:

アップグレード操作中に既存のアダプタが削除されることはありません。

- 新しいアダプタを追加できます。

- カスタム・アダプタは、アップグレードの一部として保持されます。デフォルト・アダプタに対してカスタマイズを行っている場合は、すべてのデフォルト・アダプタが上書きされるため、これらの変更内容をアップグレード後に適用する必要があります。

- デフォルト・アダプタにカスタマイズ(ある場合)を適用した後に、プロセス・タスク、フォーム・フィールドおよびデータ・オブジェクト・マネージャでこれらのアダプタの対応するマッピングを検証する必要があります。

6.8.2.8 ルールの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行されたルールで実行できます。また、アップグレード操作によりルールに次の任意の組合せのの変更が行われることがあります。

- 新しいルールを追加できます。

- デフォルト・ルールに対してカスタマイズを行っている場合は、すべてのデフォルト・ルールが上書きされるため、アップグレード後にこれらのカスタマイズを適用する必要があります。

6.8.2.9 ITリソース・タイプの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行されたITリソース・タイプで実行できます。また、アップグレード操作によりITリソース・タイプに次の任意の組合せの変更が行われることがあります。

- 既存のITリソース・タイプを新しいITリソース・タイプに置き換えることができます。

- 既存のITリソース・タイプで、新しいパラメータを追加し、既存のパラメータのデフォルト値とタイプを変更または削除できます。

- ITリソース・タイプ定義のマッピング時に、すべてのカスタム・パラメータが表示されます。これらのカスタム・パラメータを保持できます。

6.8.2.10 ITリソースの変更

コネクタのアップグレード機能は、次の任意の組合せの変更が実行されたITリソースで実行できます。また、アップグレード操作によりITリソースに次の任意の組合せの変更が行われることがあります。

- ITリソース・タイプ定義用に保持されているパラメータは、このタイプのすべてのITリソース・インスタンスで使用できます。ITリソース・タイプ定義の既存のパラメータが保持されていない場合、このパラメータはこのタイプのすべてのITリソース・インスタンスで使用できません。

- 既存のITリソースで、新しいパラメータを追加し、既存のパラメータのデフォルト値とタイプを変更または削除できます。

アップグレード後、ITリソース・タイプ定義の新しい名前は、ターゲット・コネクタのコネクタXMLで指定した名前になります。

6.8.2.11 スケジュール済タスクの変更

コネクタのアップグレード機能を保持されているスケジュール済タスクで実行できるか、または既存のスケジュール済タスクは新しいスケジュール済タスクに置換されています。

6.8.3 コネクタをアップグレードした場合の処理

コネクタのアップグレード時に実施される可能性のある変更の詳細は、「コネクタのアップグレード機能でサポートされているアップグレード・ユースケース」を参照してください。

また、アップグレード操作の結果の一部として次のイベントが発生します。

- アップグレード操作の実行中、新しいコネクタ・オブジェクトを既存のオブジェクトにマッピングするように要求されます。たとえば、ターゲット・コネクタ内の各リソース・オブジェクトをソース・コネクタ内のリソース・オブジェクトにマッピングするように要求されます。オブジェクト名がソースとターゲットで同じである場合は、新しいオブジェクトに関して、対応する古いオブジェクトをマッピングする必要があります。ソースとターゲットでオブジェクト名に変更がある場合は、ソースおよびターゲット・コネクタのリリース・ドキュメントを参照してオブジェクトを適切にマッピングする必要があります。ソース・オブジェクトとターゲット・オブジェクトを適切にマッピングするのはユーザーの責任です。オブジェクトが適切にマッピングされていないと、ソース・オブジェクトはアップグレード・プロセスにより破損します。したがって、ソースとターゲットのすべてのコネクタ・オブジェクトについて把握しておく必要があります。

6.8.4 アップグレード手順のサマリー

コネクタをアップグレードする手順のサマリーを次に示します。

注意:

この章で説明する手順は、テスト開発環境で最初にアップグレードを実行する際のベスト・プラクティスに基づいています。本番サーバーでアップグレードを適用する前に、機能可能なすべてのユースケースをテストする必要があります。本番ではウィザード・モード・アップグレードは使用できないため、本番サーバーではサイレント・モードのみを使用する必要があります。

1. アップグレード手順を最後まで読みます。
これにより、コネクタおよびターゲット・システムをOracle Identity Managerユーザーが使用できなくなる時間を見積もることができます。また、すべてのアップグレード手順とアップグレード後の手順を完了するために必要なOracle Identity Managerの専門知識を自分が持っているかどうかも判断できます。

2. ソース・コネクタのオブジェクトと他のOracle Identity Managerオブジェクトとの間のアソシエーションを書き留めます。たとえば、リソース・オブジェクトとアクセス・ポリシーとの間のアソシエーションを書き留めます。

3. 必要に応じて、ソース・コネクタのクローン用のコネクタXMLファイルを作成します。
ターゲット・コネクタでのオブジェクト名がソース・コネクタでのオブジェクト名と異なる場合は、まずクローン・コネクタ用のコネクタXMLファイルを作成することをお薦めします。手順は、「手順1: クローニングされるコネクタのコネクタXMLファイルの作成」で説明されています。この手順の実行中、ターゲット・コネクタのオブジェクト名と同じオブジェクト名を指定します。これにより、コネクタのアップグレード後にコネクタ・オブジェクトの名前を変更する必要がなくなります。

4. ソース・コネクタをステージング・サーバー上のターゲット・コネクタにアップグレードします。
XMLファイルには、ターゲット・コネクタのコネクタ・オブジェクトに変換されるように、ソース・コネクタのオブジェクトに対して行った変更の詳細が含まれています。これらの変更内容は、アップグレード・プロセス中に自動的に適用されます。

ソース・コネクタをアップグレードするには、次の手順を実行します。

1. 本番サーバー上のOracle Identity Managerデータベースをバックアップします。

2. 「アップグレード前の手順」で説明している手順を実行します。

3. 「ステージングおよび本番環境でのサイレント・モード・アップグレード」で説明している手順を実行し、結果として生成される変換済XMLは本番サーバーで使用できます。

5. コネクタ・アップグレード用のサイレント・デルタXMLを使用します。
デルタXMLファイルを使用するには、次の手順を実行します。

1. ステージング・サーバー上で本番データベースをリストアします。

2. 「アップグレード前の手順」で説明している手順を実行します。

3. 「ステージングおよび本番環境でのサイレント・モード・アップグレード」で説明している手順を実行します。

4. 「アップグレード後の手順」で説明している手順を実行します。

6. 本番サーバー上のソース・コネクタが、ステージング・サーバー上のソース・コネクタと同じであることを確認します。ステージング・サーバー上と本番サーバー上のソース・コネクタが異なると、デルタXMLファイルは本番サーバーで適切にインポートされません。

7. 本番サーバーでデルタXMLファイルをインポートします。
アップグレードされたターゲット・コネクタがステージング・サーバーで想定どおりに動作していることを確認した後に、次の手順を実行します。

1. 「アップグレード前の手順」で説明している手順を実行します。

2. 「ステージングおよび本番環境でのサイレント・モード・アップグレード」で説明している手順を実行します。

3. 「アップグレード後の手順」で説明している手順を実行します。

6.8.5 コネクタのアップグレード手順

次の項では、コネクタをアップグレードする手順について説明します。

- 「アップグレード前の手順」

- 「アップグレード手順」

- 「アップグレード後の手順」

6.8.5.1 アップグレード前の手順

アップグレード手順を開始する前に、次の前提条件に対処していることを確認してください。

- この章に記載されているアップグレード手順を最後まで読みます。

- ソース・コネクタのコネクタ・オブジェクトに加えられたカスタマイズを書き留めます。

- 進行中のワークフローを処理するために、Java APIを呼び出します。このコネクタの一部であるリソース・オブジェクトに保留状態のリクエストがないことを確認する必要があります。コネクタのアップグレードに進む前に、すべてのリクエストを完了する必要もあります。リクエストがクローズ可能な状態の場合は、リクエストをクローズできます。コネクタ・リソース・オブジェクトに関連付けられているすべてのリクエストは、アップグレード・プロセスを開始する前に次のいずれかの状態である必要があります。

- リクエストが完了しました

- リクエストがクローズされました

- リクエストが取り消されました

- リクエストに失敗しました

- テンプレート承認が却下されました

- リクエスト承認が却下されました

- 操作承認が却下されました

- 必要に応じて、ソース・コネクタのクローン用のコネクタXMLファイルを作成します。

- すべてのスケジュール済タスクを無効化します。

6.8.5.2 アップグレード手順

コネクタのアップグレードは、次に示す2段階の手順です。

- ステージング環境でのウィザード・モード・アップグレード

- ステージングおよび本番環境でのサイレント・モード・アップグレード

ステージング環境でのウィザード・モード・アップグレード

注意:

ウィザード・モード・アップグレードの実行中に、アップグレード前の手順およびアップグレード後の手順を実行する必要があります。

ステージング・サーバーでウィザード・モード・アップグレードを実行するには、次の手順を実行します。

1. Oracle Identity Managerデータベースのバックアップを作成します。

2. Oracle Identity Managerメタデータ(MDS)のバックアップを作成します。Oracle Identity Managerメタデータの変更に使用できるユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

3. コネクタのアップグレード準備ユーティリティを実行します。
Oracle Identity Managerには検証スクリプトが用意されています。このスクリプトでは、次の機能が実行されます。

- アップグレードするコネクタがOracle Identity Managerで定義されているかどうかを判断します。
つまり、このスクリプトでは、コネクタがインストールまたは定義されたときにデータベースに格納されたコネクタXMLが、データベース内のコネクタ・オブジェクト定義と一致しているかどうかを確認します。コネクタXMLの一貫性の確認とは別に、コネクタXMLがOracle Identity Managerデータベースに存在するかどうかも確認します。存在しない場合は、アップグレードを続行する前にコネクタを定義するための対応するメッセージが表示されます。コネクタを定義する手順を実行するには、「コネクタの定義」を参照してください。

- 現在実行中のOracle Identity Managerスケジュール済タスクを識別します。
アップグレード手順を続行する前に、ソース・コネクタに属しているすべてのスケジュール済タスクを無効化する必要があります。また、アップグレード手順を続行する前に、その他のすべてのスケジュール済タスクを無効化することをお薦めします。

- コネクタのリソース・オブジェクトと関連付けられているアテステーション・タスクを識別します。
アップグレード手順を続行する前に、ソース・コネクタに属しているすべてのアテステーション・タスクを完了する必要があります。

- コネクタのリソース・オブジェクトと関連付けられているすべての保留リクエストを識別します。
アップグレード手順を続行する前に、ソース・コネクタに属しているすべての保留リクエストをクローズまたは完了する必要があります。

検証スクリプトを実行するには、次の手順を実行します。

1. Oracle Identity Managerが稼働していることを確認します。

2. コマンド・ウィンドウで、OIM_HOME/server/binディレクトリに移動します。

3. スクリプトを次のように実行します。
Unixの場合:

sh ConnectorPreUpgradeUtil.sh

Windowsの場合:

ConnectorPreUpgradeUtil.bat

次の詳細を指定するように要求されます。

- Oracle Identity Manager管理者のユーザー名の入力: Oracle Identity Manger管理者のユーザー名を入力します。

- Oracle Identity Manager管理者のパスワードの入力: Oracle Identity Manger管理者のパスワードを入力します。

- t3 Oracle Identity ManagerサーバーのURLの入力: Oracle Identity ManagerサーバーのURLを入力します。例: t3://hostname:hostport。

- OIMデータベースのユーザー名の入力: Oracle Identity Managerデータベースのユーザー名を入力します。

- OIMデータベースのパスワードの入力: Oracle Identity Managerデータベースのパスワードを入力します。

- OIMデータベースのJDBC URLの入力: Oracle Identity ManagerデータベースのJDBC URLを入力します。例:
jdbc:oracle:thin:@HOST_NAME:DB_PORT:iam/ORACLE_SID

ログインに成功すると、次の詳細を指定するように要求されます。

- コネクタ名の入力: アップグレード前に検証するコネクタ名を入力します。

- コネクタのバージョンの入力: アップグレード前に検証するコネクタのバージョンを入力します。

Oracle Identity Managerデータベースに正常に接続すると、メッセージが表示されます。

スクリプトにより生成された出力は、コマンド・ウィンドウに表示されるとともに、OIM_HOME/server/bin/validateUtil.logファイルにも記録されます。

実行する必要があるアクションは、スクリプトにより生成されたメッセージに応じて異なります。

- データベース内のコネクタXMLがデータベースで定義されているコネクタ・オブジェクトと一貫性がないことがメッセージで示された場合は、コネクタ・ガイドのコネクタの定義に関する説明で示されている手順を実行します。

- メッセージでコネクタXMLがOracle Identity Managerデータベースに存在しないこと、したがってアップグレード前にコネクタを定義するように求められた場合は、アップグレードを続行する前に、コネクタ・ガイドのコネクタの定義に関する説明で示されている手順を実行します。

- メッセージに現在実行中のスケジュール済タスクの名前が含まれている場合は、すべてのスケジュール済タスクを無効化する必要があります。スケジュール済タスクを無効化するには、拡張管理で、「システム管理」をクリックし、スケジュール済ジョブを検索し、特定のスケジュール済ジョブをクリックしてから、「停止」をクリックします。

- メッセージに、コネクタのリソース・オブジェクトに関連付けられているアテステーション・タスクの一部が保留中となっているアテステーション・プロセスの名前が含まれている場合は、アップグレード・プロセスを続行する前に、アップグレードするコネクタに属しているすべてのアテステーション・タスクを完了する必要があります。

- コネクタのリソース・オブジェクトに関連付けられている保留リクエストの名前がメッセージに含まれている場合は、アップグレード・プロセスを続行する前に、アップグレードするコネクタに属しているすべての保留リクエストをクローズまたは完了する必要があります。

4. JARおよびリソース・バンドルを、指定したディレクトリにコピーします。
ターゲット・リリースに新しいまたは更新されたJARやリソース・バンドルも含まれている場合は、そのバージョンのjarをOracle Identity Managerにダウンロードし、Oracle Identity Managerに付属のjarのバージョンを確認し、これらのファイルを比較して、JARを宛先ディレクトリに手動でコピーします。オラクル社が出荷しているコネクタの場合、宛先ディレクトリの詳細はコネクタ・ガイドに示されています。詳細は、「コネクタ・コード・ファイルの変更」を参照してください。

5. コネクタのアップグレード機能を使用します。

1. Oracle Identity Manager拡張管理コンソールにログインします。

2. 左ペインで、「システム管理」→「デプロイメント・マネージャ」→「コネクタの管理」の順に展開します。

3. 「検索」機能を使用して、アップグレードするソース・コネクタを検索します。検索結果の表で、ソース・コネクタの「アップグレード」アイコンをクリックします。

4. ユーティリティの「ステップ1: アップグレードするコネクタXMLの選択」ページで、ソース・リリースのコネクタXMLファイルのフルパスおよび名前をウィザード・モード・アップグレードのXMLフィールドに入力します。「参照」オプションを使用して、XMLファイルに移動できます。適切なターゲット・コネクタXMLを選択していることを確認します。アップグレード機能では、ターゲット・バージョンまたはその他のコネクタ・オブジェクト詳細に関してXMLを検証しません。

注意:

収束されたすべてのコネクタには、信頼できるソース・リコンシリエーションおよびターゲット・リソース・リコンシリエーションの両方に対してXMLファイルが1つのみ存在します。複数のXMLファイルがある場合、つまり信頼できるソース・リコンシリエーション用とターゲット・リソース・リコンシリエーション用に1つずつある場合は、ターゲット・リソース・リコンシリエーション用のXMLファイルを選択する必要があります。XMLファイル名については、コネクタ・ガイド(CI-XML)を参照してください。

図6-29に、コネクタ管理 - アップグレード・ウィザードの「アップグレードするコネクタXMLの選択」ページを示します。

図6-29 「アップグレードするコネクタXMLの選択」ページ

「図6-29 「アップグレードするコネクタXMLの選択」ページ」の説明

5. 「続行」をクリックします。

6. 「ステップ2: リソース・オブジェクトのマッピング」ページで、次のガイドラインを適用して、新しい各リソース・オブジェクトを既存のリソース・オブジェクトにマッピングします。各マッピングの作成後、「続行」をクリックします。

- 「新規のリソース・オブジェクト」フィールドに、ターゲット・リリースのリソース・オブジェクトの名前が示されます。「既存のリソース・オブジェクト」リストから、ターゲット・リリースのリソース・オブジェクトにマッピングする、ソース・リリースのリソース・オブジェクトを選択します。リソース・オブジェクト名が変更されている場合があります。リソース・オブジェクトを適切にマッピングするのはユーザーの責任です。

- 対応するリソース・オブジェクトがソース・リリースに存在しない新しいリソース・オブジェクトがある場合は、「既存のリソース・オブジェクト」リストから「なし」を選択します。これは、ターゲット・コネクタ・バージョンで、ソース・バージョンに存在しない新しいリソース・オブジェクトが追加された場合にのみ発生します。

注意:

オラクル社がリリースしたソース・コネクタから、オラクル社がリリースしたターゲット・コネクタにアップグレードする場合、作成する必要があるマッピングの詳細はコネクタ・ガイドを参照してください。

図6-30に、コネクタ管理 - アップグレード・ウィザードの「リソース・オブジェクトのマッピング」ページを示します。

図6-30 「リソース・オブジェクトのマッピング」ページ

「図6-30 「リソース・オブジェクトのマッピング」ページ」の説明

7. 「ステップ3: リソース・スコープの定義」ページに、作成したリソース・オブジェクトのマッピングのサマリーが表示されます。ソース・リリースに、対応するリソース・オブジェクトがターゲット・リリースに存在しないリソース・オブジェクトがある場合は、このページの2つ目の表に表示されます。これらのリソース・オブジェクトを削除する場合は、そのチェック・ボックスを選択します。リソース・オブジェクトが削除対象として選択されている場合、そのリソースはOracle Identity Managerデータベースから削除されません。対応するリソース・オブジェクトのOBJ_IS_SOFT_DELETEフラグが単に1に更新されるだけです。このリソースは、すべてのプロビジョニングおよびリコンシリエーションに対して使用可能なままになります。このフラグは将来使用されます。
図6-31に、コネクタ管理 - アップグレード・ウィザードの「リソース・スコープの定義」ページを示します。

図6-31 「リソース・スコープの定義」ページ

「図6-31 「リソース・スコープの定義」ページ」の説明

8. 「続行」をクリックします。

9. 「ステップ4: プロセス定義マッピングの定義」ページで、新しい各プロセス定義を既存のプロセス定義にマッピングします。リソース・オブジェクトのマッピングに関するステップfで示されているガイドラインに従います。各プロセス定義マッピングの作成後、「続行」をクリックします。ソースとターゲットでプロセス定義名に変更がある場合、それらを適切にマッピングするのはユーザーの責任です。指定したターゲット・プロセス定義の対応するソース・プロセス定義を選択すると、このページにソース・プロセス定義で使用可能なプロセス・タスクのリストが表示されます。ソース・プロセス定義からのプロセス・タスクを保持できます。ソース・プロセス定義に追加したカスタム・プロセス定義がある場合、それらを保持できます。デフォルト・プロセス・タスクに対してカスタマイズを行っている場合は、そのようなタスクを保持する前に、コネクタ・ガイドを参照して、新しいコネクタ・リリース・バージョンにおけるこのプロセス・タスクに変更がないことを確認する必要があります。特定のデフォルト・プロセス・タスクを保持するように選択した場合、このプロセス・タスクに対する変更(ある場合)が新しいコネクタ・リリースで失われる可能性があります。このプロセス・タスクがソース・コネクタの一部であり、ターゲット・コネクタでは必要ない場合、そのようなプロセス・タスクは保持しないでください。ユーザーがソース・コネクタのカスタマイズの一部として追加したタスクのみを保持することをお薦めします。
図6-32に、コネクタ管理 - アップグレード・ウィザードの「プロセス定義マッピングの定義」ページを示します。

図6-32 「プロセス定義マッピングの定義」ページ

「図6-32 「プロセス定義マッピングの定義」ページ」の説明

10. 「ステップ5: プロセス定義マッピングのサマリー」ページに、作成したプロセス定義マッピングのサマリーが表示されます。「続行」をクリックして続行します。
図6-33に、コネクタ管理 - アップグレード・ウィザードの「プロセス定義マッピングのサマリー」ページを示します。

図6-33 「プロセス定義マッピングのサマリー」ページ

「図6-33 「プロセス定義マッピングのサマリー」ページ」の説明

11. 「ステップ6: フォーム・マッピングの定義」ページで、新しい各フォームを既存のフォームにマッピングします。リソース・オブジェクトのマッピングに関するステップfで示されているガイドラインに従います。また、各フォームのマッピングを作成した後に、次のガイドラインを適用してから「続行」をクリックします。各ターゲットに対応するソース・プロセス・フォームが選択されると、このページには、ターゲット・プロセス・フォームでは使用できない、ソース・プロセス・フォーム属性のプロセス・フォーム・フィールドのリストが表示されます。これらの属性は、カスタマイズの一部としてソース・プロセスに追加されたか、またはソース・プロセス・フォームのデフォルト属性部分であったが、ターゲットでは必要ない可能性があります。カスタマイズの一部として追加された属性を選択できますが、保持する前に、デフォルト属性がターゲットで必要かどうかを検証する必要があります。
図6-34に、コネクタ管理 - アップグレード・ウィザードの「フォーム・マッピングの定義」ページを示します。

図6-34 「フォーム・マッピングの定義」ページ

「図6-34 「フォーム・マッピングの定義」ページ」の説明

12. 「ステップ7: フォーム・マッピングのサマリー」ページに、作成したフォーム・マッピングのサマリーが表示されます。「続行」をクリックして続行します。
図6-35に、コネクタ管理 - アップグレード・ウィザードの「フォーム・マッピングのサマリー」ページを示します。

図6-35 「フォーム・マッピングのサマリー」ページ

「図6-35 「フォーム・マッピングのサマリー」ページ」の説明

13. 「ステップ8: ITリソース・タイプ定義マッピングの定義」ページで、新しい各ITリソース定義を既存のITリソース定義にマッピングします。リソース・オブジェクトのマッピングに関するステップfで示されているガイドラインに従います。各ITリソース定義のマッピングを作成した後に、「続行」をクリックします。ITリソース・タイプ定義の名前に変更がある場合は、それらを適切にマッピングするのはユーザーの責任です。デフォルトのITリソース・タイプ定義名の変更を確認するには、コネクタ・ガイドを参照してください。ターゲットITリソース・タイプ定義が、対応するソースITリソース・タイプ定義にマッピングされている場合、このページには、ソース定義の一部であるがターゲット定義では使用できないITリソース・タイプ定義パラメータのリストが表示されます。これらは、カスタマイズの一部として追加されたか、またはソース定義の一部であったかのいずれかです。これらのパラメータがカスタマイズの一部として追加されている場合は、保持する必要があります。
図6-36に、コネクタ管理 - アップグレード・ウィザードの「ITリソース・タイプ定義マッピングの定義」ページを示します。

図6-36 「ITリソース・タイプ定義マッピングの定義」ページ

「図6-36 「ITリソース・タイプ定義マッピングの定義」ページ」の説明

14. 「ステップ9: ITリソース・タイプ定義マッピングのサマリー」ページに、作成したITリソース・タイプ定義マッピングのサマリーが表示されます。「続行」をクリックして続行します。
図6-37に、コネクタ管理 - アップグレード・ウィザードの「ITリソース・タイプ定義マッピングのサマリー」ページを示します。

図6-37 「ITリソース・タイプ定義マッピングのサマリー」ページ

「図6-37 「ITリソース・タイプ定義マッピングのサマリー」ページ」の説明

15. 「ステップ12: アップグレード前のステップ」ページで、コネクタの新しいリリース番号を「コネクタのバージョン」フィールドに入力します。「続行」をクリックして続行します。アップグレード・プロセスでは、コネクタ・リリース・バージョンで指定されたバージョンを検証しません。コネクタ・ガイドを参照して、正しいバージョンをここで指定する必要があります。
図6-38に、コネクタ管理 - アップグレード・ウィザードの「アップグレード前のステップ」ページを示します。

図6-38 「アップグレード前のステップ」ページ

「図6-38 「アップグレード前のステップ」ページ」の説明

16. 「ステップ13: アップグレードするコネクタ・オブジェクトの選択」ページ。
図6-39に、コネクタ管理 - アップグレード・ウィザードの「アップグレードするコネクタ・オブジェクトの選択」ページを示します。

図6-39 「アップグレードするコネクタ・オブジェクトの選択」ページ

「図6-39 「アップグレードするコネクタ・オブジェクトの選択」ページ」の説明

注意:

Microsoft Internet Explorerを使用してコネクタ管理 - アップグレード・ウィザードが開かれている場合、ステップ13のアップグレード対象のコネクタ・オブジェクトの選択ページのすべてのフィールドおよびボタンが表示されない可能性があります。このページには使用可能なスクロールバーがありません。したがって、ウィンドウを最大化してページ内のすべてのコントロールを表示してください。

17. 「コネクタのアップグレード・ステータス」ページで情報を確認した後に、「アップグレード」をクリックして、アップグレード・プロセスを開始します。
図6-40に、コネクタ管理 - アップグレード・ウィザードの「コネクタのアップグレード・ステータス」ページを示します。

図6-40 「コネクタのアップグレード・ステータス」ページ

「図6-40 「コネクタのアップグレード・ステータス」ページ」の説明

プロセス定義名および対応するプロセス・タスク名を書き留めます。これらのプロセス・タスクは、今後Oracle Identity Managerで使用されません。したがって、保留中および却下されたすべてのインスタンスを取り消す必要があり、それにはOIM_HOME/server/binにあるcancelProcessTaskユーティリティを使用します。このユーティリティは、プロセス定義名およびプロセス・タスク名を入力として受け取ります。各プロセス・タスクに対してこのユーティリティを実行する必要があり、実行すると、コネクタのアップグレード機能により次の方法でコネクタ・オブジェクト・マッピングが処理されます。

- 新しいコネクタ・オブジェクトが「なし」にマッピングされている場合は、新しいコネクタ・オブジェクトがデータベースに挿入されます。

- 新しいリソース・オブジェクト、プロセス定義またはフォームにより、マッピングされた古いリソース・オブジェクト、プロセス定義またはフォームが置換されます。

- プロセス・フォームの新しい名前は、古いプロセス・フォーム名に変換されます。

- 古い参照定義と新しい参照定義が同じ名前である場合は、それらの内容がマージされます。

- コネクタのアップグレード機能で、アップグレードされたコネクタ・バージョンでは使用されないオブジェクトを削除しようとすると、そのオブジェクトのインスタンスがOracle Identity Managerデータベースに存在する場合は例外がスローされます。そのようなオブジェクトは、Oracle Identity Managerで使用されないように、名前を変更してソフト削除します。

6. 次のステップを実行します。

1. 次のオブジェクトのフォーム名およびフォーム・フィールド列名参照を変更します。

注意:

オラクル社がリリースしたコネクタの場合は、加える変更の詳細をコネクタ・ガイドで参照してください。

- 参照定義

- プロセス・タスク・リテラル

- アダプタ・リテラル

2. すべてのデフォルト・アダプタが上書きされます。したがって、顧客がなんらかのカスタマイズを行っている場合、それらの変更をコネクタのアップグレード後に適用する必要があります。

3. アップグレード後、既存の参照定義と新しい参照定義の内容がマージされます。これらの参照定義で、不要なエントリを手動で削除する必要があります。

7. FVCユーティリティを使用して、コネクタにより作成された既存のユーザー・データを更新します。
FVCユーティリティの使用方法の詳細は、Oracle Fusion Middleware Oracle Identity Manager管理者ガイドのフォーム・バージョン制御ユーティリティの使用方法に関する説明を参照してください。

8. プロビジョニングおよびリコンシリエーションを含む、ターゲットに固有のすべてのユースケースが、正常に動作していることを確認します。

9. XMLファイルを生成します。XMLファイルには、ソース・リリースからターゲット・リリースへのオブジェクト定義変更の詳細が含まれています。
このファイルを生成するには、次の手順を実行します。

1. Oracle Identity Manager拡張管理コンソールにログインします。

2. 左ペインで、「システム管理」→「デプロイメント・マネージャ」の順に展開し、「コネクタの管理」をクリックします。

3. 「検索」機能を使用して、コネクタを検索します。

4. 検索結果の表で、コネクタの「サイレント・アップグレードXMLのエクスポート」アイコンをクリックします。

5. ファイルを保存する場所を指定します。

注意:

アップグレードが失敗した場合は、次の手順を実行します。

1. 例外について調べ、適切なアクションを実行します。

2. Oracle Identity ManagerデータベースおよびMDSをリストアします。

3. アップグレードを続行します。

ステージングおよび本番環境でのサイレント・モード・アップグレード

注意:

ウィザード・モード・アップグレードの実行中に、アップグレード前の手順およびアップグレード後の手順を実行する必要があります。

注意:

XMLファイルをインポートする前に、本番サーバー上のソース・コネクタがステージング・サーバー上のソース・コネクタと同じであることを確認します。ステージング・サーバー上と本番サーバー上のソース・コネクタが異なると、XMLファイルが本番サーバーで正しくインポートされません。

本番サーバーでサイレント・モード・アップグレードを実行するには、次の手順を実行します。

1. ファイルをインポートするOracle Identity Managerインストールのホスト・コンピュータに、XMLファイルをコピーします。または、Oracle Identity Managerホスト・コンピュータからアクセス可能な別のコンピュータ上の共有フォルダにXMLファイルをコピーします。

2. Oracle Identity Manager拡張管理コンソールにログインします。

3. 左ペインで、「システム管理」→「デプロイメント・マネージャ」→「コネクタの管理」の順に展開します。

4. 「検索」機能を使用して、アップグレードするソース・コネクタを検索します。

5. 検索結果の表で、ソース・コネクタの「アップグレード」アイコンをクリックします。

6. ユーティリティの「ステップ1: アップグレードするコネクタXMLの選択」ページで、ソース・リリースのコネクタXMLファイルのフルパスおよび名前をサイレント・モード・アップグレードのXMLフィールドに入力します。「参照」オプションを使用して、XMLファイルに移動できます。

注意:

収束されたすべてのコネクタには、信頼できるソース・リコンシリエーションおよびターゲット・リソース・リコンシリエーションの両方に対してXMLファイルが1つのみ存在します。複数のXMLファイルがある場合、つまり信頼できるソース・リコンシリエーション用とターゲット・リソース・リコンシリエーション用に1つずつある場合は、ターゲット・リソース・リコンシリエーション用のXMLファイルを選択する必要があります。XMLファイル名については、コネクタ・ガイド(CI-XML)を参照してください。

図6-41に、コネクタ管理 - アップグレード・ウィザードの「アップグレードするコネクタXMLの選択」ページを示します。

図6-41 「アップグレードするコネクタXMLの選択」ページ

「図6-41 「アップグレードするコネクタXMLの選択」ページ」の説明

7. 「続行」をクリックします。

8. 「ステップ12: アップグレード前のステップ」ページで、「続行」をクリックして続行します。
図6-42に、コネクタ管理 - アップグレード・ウィザードの「アップグレード前のステップ」ページを示します。

図6-42 「アップグレード前のステップ」ページ

「図6-42 「アップグレード前のステップ」ページ」の説明

9. 「ステップ13: アップグレードするコネクタ・オブジェクトの選択」ページで、アップグレード用に選択したコネクタ・オブジェクトのサマリーを確認します。
図6-43に、コネクタ管理 - アップグレード・ウィザードの「アップグレードするコネクタ・オブジェクトの選択」ページを示します。

図6-43 「アップグレードするコネクタ・オブジェクトの選択」ページ

「図6-43 「アップグレードするコネクタ・オブジェクトの選択」ページ」の説明

10. このページで情報を確認した後に、「アップグレード」をクリックして、アップグレード・プロセスを開始します。
「コネクタのアップグレード・ステータス」ページには、図6-44に示すように、成功したアップグレード終了時のステータスが表示されます。

図6-44 「コネクタのアップグレード・ステータス」ページ

「図6-44 「コネクタのアップグレード・ステータス」ページ」の説明

6.8.5.3 アップグレード後の手順

次の項では、アップグレード操作後に実行する必要がある手順について説明します。

- PurgeCacheユーティリティの実行

- cancelProcessTaskユーティリティの実行

- FVCユーティリティの実行

- アクセス・ポリシーの更新

- 承認ポリシーの更新

- ITリソースの構成

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

- その他のアップグレード後の手順

PurgeCacheユーティリティの実行

アップグレードの実行時、パージが必要な失効データがキャッシュに存在する場合があります。PurgeCacheユーティリティはキャッシュをパージします。キャッシュのパージの詳細は、「キャッシュのパージ」を参照してください。

cancelProcessTaskユーティリティの実行

このユーティリティを使用して、プロセス・タスクの保留中および却下されたインスタンスを取り消します。プロセス定義のプロセス・タスクがソース・コネクタに存在し、ターゲットでは必要ない場合、そのプロセス・タスクはアップグレード・プロセスでソフト削除されます。Oracle Identity Managerでは、そのようなソフト削除されたタスクは、アップグレード後のプロビジョニング・ワークフローの一部として使用されることはありません。そのような削除されたプロセス・タスクのインスタンスで、保留中および却下ステータスのものはすべて取り消す必要があります。

このユーティリティは、OIM_HOME/server/binにあります。このユーティリティは、プロセス・タスク名および対応するプロセス定義名を入力として受け取ります。

FVCユーティリティの実行

コネクタのアップグレード・プロセスでは、新しいプロセス・フォーム・バージョンが作成されます。ソース・コネクタを使用して作成されたアカウント・データには、ソース・コネクタ・プロセス・フォーム・バージョンとのアソシエーションがあります。したがって、アップグレード後、FVCユーティリティを実行して、アップグレード・プロセスで作成された新しいプロセス・フォーム・バージョンを更新する必要があります。この他に、FVCでは、古いフォーム・フィールド・データを新しいフォーム・フィールドにコピーする機能を提供します。FVCユーティリティを使用して、ソース・リリースのプロセス・フォーム・データをターゲット・リリースのプロセス・フォームにコピーできます。ターゲット・リリースのプロセス・フォームに加えた変更と一貫性を持たせるように、リソース・データに加える変更を指定します。このユーティリティの使用方法の詳細は、Oracle Identity Managerツール・リファレンスを参照してください。

アクセス・ポリシーの更新

Oracle Identity Managerでは、アクセス・ポリシーがリソース・オブジェクトと関連付けられています。アクセス・ポリシーの作成中に、ユーザーがプロセス・フォーム属性にデータを指定している場合があります。コネクタ・アップグレードの一環としてフォーム属性に変更がある場合は、アクセス・ポリシーを編集して、既存のフィールドと新しいフィールドのデータを確認する必要があります。たとえば、コネクタ・アップグレードによって新しいプロセス・フォーム属性が追加された場合は、アクセス・ポリシーを編集して新しい属性のデータを指定できます。

承認ポリシーの更新

Oracle Identity Managerでは、承認ポリシーがリソース・オブジェクトと関連付けられています。ポリシーの作成中に、ユーザーがプロセス・フォーム属性にデータを指定している場合があります。コネクタ・アップグレードの一環としてリソース・オブジェクト名に変更がある場合、ユーザーはそのリソースに関連付けられているすべての承認ポリシーを確認して、リソース名を新しいリソース名に変更する必要があります。

ITリソースの構成

アップグレード後、ITリソース・インスタンスに適切な値が設定されていることを確認します。

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

ターゲット・リリースのスケジュール済タスクの属性に値を設定します。オラクル社がリリースしたターゲット・コネクタの場合は、スケジュール済タスク属性の詳細をコネクタ・ガイドで参照してください。

ITリソース・タイプ定義パラメータに変更がある場合のアダプタ更新

ITリソース・タイプ定義パラメータの名前に変更がある場合は、そのパラメータ変更に応じてカスタム・アダプタを更新する必要があります。これを行うには、次のようにします。

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

2. アダプタ・ファクトリを使用してカスタム・アダプタを開きます。

3. 図6-45に示すように、変数リストに移動し、タイプ「ITリソース」の変数があるかどうかを確認します。

図6-45 「アダプタ・ファクトリ」フォームの変数リスト・タブ

「図6-45 「アダプタ・ファクトリ」フォームの変数リスト・タブ」の説明

4. ITリソースの変数がある場合は、タスク詳細に移動し、ITリソース・パラメータ・マッピングのマッピングを新しいターゲット・フィールドに変更します(パラメータが変更または削除されている場合)。
図6-46に、ITリソース・パラメータ・マッピングのマッピングを新しいターゲット・フィールドに変更できるアダプタ・ファクトリ・タスク・パラメータの編集ダイアログ・ボックスを示します。

図6-46 アダプタ・ファクトリ・タスク・パラメータの編集ダイアログ・ボックス

「図6-46 アダプタ・ファクトリ・タスク・パラメータの編集ダイアログ・ボックス」の説明

5. アダプタがITリソース・タイプ定義パラメータにマッピングされている場合は、マッピングされているパラメータが削除されていないかどうかを確認する必要があります。パラメータが削除されている場合は、適切なパラメータに再マッピングする必要があります。
アダプタのマッピングを確認するには、次の手順を実行します。

1. 次のようにして、プロセス・タスク・アダプタのマッピングを確認します。
i) Design Consoleにログインします。

ii) 「プロセス定義」に移動します。

iii) 図6-47に示すように、タスクをクリックし、次に統合タブをクリックします。

図6-47 タスクの編集ダイアログ・ボックスの統合タブ

「図6-47 タスクの編集ダイアログ・ボックスの統合タブ」の説明

iv) アダプタ変数が、削除または変更されたフォーム属性にマッピングされているかどうかを確認します。該当する場合は、そのような属性をアダプタ変数に再マッピングします。コネクタのすべてのプロセス定義のすべてのプロセス・タスクに対してこのステップを繰り返します。

図6-48に、フォーム属性へのアダプタ変数マッピングを表示および編集できる変数のデータ・マッピングの編集ダイアログ・ボックスを示します。

図6-48 変数のデータ・マッピングの編集ダイアログ・ボックス

「図6-48 変数のデータ・マッピングの編集ダイアログ・ボックス」の説明

2. 次のようにして、アダプタ・マッピングを事前移入します。
i) Design Consoleにログインします。

ii) 図6-49に示すように、「フォーム・デザイナ」→事前移入アダプタに移動します。

図6-49 事前移入アダプタ・ダイアログ・ボックス

「図6-49 事前移入アダプタ・ダイアログ・ボックス」の説明

iii) 「マップ」をクリックしてアダプタ変数をマッピングし、いずれかのフィールドがプロセス・データ属性にマッピングされているかどうかを確認します。マッピングされている場合は、プロセス・フォーム属性がアップグレードの一環として削除されていないことを確認します。プロセス・フォーム属性が削除されている場合は、適切なフォーム属性データに再マッピングします。

図6-50に、アダプタ変数のマッピング・ダイアログ・ボックスを示します。

図6-50 アダプタ変数のマッピング・ダイアログ・ボックス

「図6-50 アダプタ変数のマッピング・ダイアログ・ボックス」の説明

注意:

コネクタのすべてのプロセス・フォームのすべての事前移入フィールドに対してこの手順を繰り返します。エンティティ・アダプタがある場合は、データ・オブジェクト・マネージャでこれらのアダプタのアダプタ変数マッピングを確認します。

その他のアップグレード後の手順

次のアップグレード後の手順を実行します。

1. 次のオブジェクトのフォーム名およびフォーム・フィールド列名参照を変更します。

注意:

オラクル社がリリースしたコネクタの場合は、加える変更の詳細をコネクタ・ガイドで参照してください。

- 参照定義

- プロセス・タスク・リテラル

- アダプタ・リテラル

2. リソース・オブジェクトでのリコンシリエーション・フィールドおよびプロセス定義での対応するリコンシリエーション・フォーム・フィールド・マッピングをすべて確認します。古いデフォルト・リコンシリエーション・フィールドが存在する場合、これらはアップグレードの一環として保持されないプロセス・フォーム・フィールドにマッピングされているため削除します。

3. アップグレード・プロセスですべてのカスタマイズ(リソース・オブジェクト、プロセス定義およびプロセス・フォームに対するカスタマイズなど)が保持されていることを確認します。

4. アップグレード後、既存の参照定義と新しい参照定義の内容がマージされます。これらの参照定義で、不要なエントリを手動で削除する必要があります。

5. 参照リコンシリエーションを再度実行します。古い参照リコンシリエーション・データは、アップグレード後の参照で使用できます。参照値の形式が変更された場合は、参照の再実行が必要です。参照リコンシリエーションの詳細は、特定のコネクタ・ガイドを参照してください。

6. 統計を再計算し、アップグレード・プロセスにより削除または無効化された索引およびその他のデータベース・オブジェクトを再作成します。詳細は、Oracle Identity Managerデータベースのガイドを参照してください。

7. コネクタに関連するアダプタ・ステータスを確認します。アダプタがコンパイルされていない場合は、コンパイルする必要があります。

8. カスタム・パラメータがアップグレード後に使用できることを確認します。スケジュール済タスクのカスタム・パラメータは、アップグレード・プロセスの一環として保持されます。パラメータがアップグレード後に使用できない場合は、スケジュール済タスクを変更して、パラメータを追加します。

9. リソース・オブジェクト名に変更があった場合、ユーザーは、そのリソースに関連付けられているすべての承認ポリシーを確認して、リソース名を新しいリソース名に変更する必要があります。

10. コネクタに付属の新しいリクエスト・データセットに変更があるかどうかを確認します。該当する場合、リソースの既存のリクエスト・データセットをMDSから削除します。すべてのカスタマイズの新しいリクエスト・データセットを変更し、この新しいデータセットをMDSにインポートします。MDSへのデータのインポートとMDSからのデータのエクスポートの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

6.8.6 非収束コネクタから収束されたコネクタへのアップグレード手順

非収束コネクタから収束されたコネクタにアップグレードするには、次の手順を実行します。

1. Common.jarファイルを除き、非収束コネクタに関連する既存のすべてのjarファイル(Javatasks、ScheduleTask、ThirdPartyのjarなど)を削除します。

2. Common.jarをダウンロードし、そのMANIFEST.MFを抽出します。このバージョンのMANIFEST.MFを、収束されたコネクタ配布バンドルの一部として使用可能なCommon.jarのMANIFEST.MFバージョンと比較します。UploadJarsユーティリティを使用して、Oracle Identity Managerデータベース内のより高いバージョンのCommon.jarを保持またはアップロードします。

3. Oracle Identity Managerデータベース内のUploadJarsユーティリティ(OIM_HOME/server/binにあります)を使用して、収束されたコネクタの配布バンドルのlibフォルダにあるすべてのjarを手動でアップロードします。

4. 一時フォルダ内の(org.identityconnectors.*というネーミング規則の)コネクタ・バンドルを展開します。同じ一時フォルダにlibという名前のフォルダを作成し、サード・パーティのすべてのライブラリをそのフォルダにコピーします。

5. 展開された前述のバンドルのMANIFEST.MFを保持します。

6. 同じ名前、および保持された同じMANIFEST.MFを使用して、コネクタを再パッケージします。これで、再パッケージ化されたコネクタ・バンドルにもサード・パーティのライブラリが含まれるようになります。

7. Oracle Identity Managerデータベース内の再パッケージ済コネクタをjarタイプICFBundleとしてアップロードします。

8. ステップ4で作成した一時フォルダを削除します。

9. アップグレード・プロセスに従って、コネクタをアップグレードします。

10. キャッシュをパージするか、またはサーバーを再起動します。

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

警告:

このユーティリティは本番で使用しないでください。このユーティリティは、データをOracle Identity Managerデータベースから直接削除するものであり、開発やステージング環境での使用を想定しています。

コネクタのアンインストール・ユーティリティは、アンインストール対象として選択したコネクタ関連データをOracle Identity Managerデータベースから削除します。コネクタのリソース・オブジェクトに関連付けられているすべてのアカウント関連データを削除します。

このユーティリティで削除されないものを次に示します。

- ターゲット・システムの実際のユーザー・アカウント

- Oracle Identity Managerのアイデンティティ(ただし、ユーザーは信頼できるリコンシリエーションにより信頼できるソースからOracle Identity Managerに取り込まれる)

- 監査データ

- アーカイブ・データ

コネクタのアンインストール・ユーティリティでは、オブジェクト依存性が存在するかどうかの検証およびユーザーへの通知は行われません。たとえば、Microsoft Active Directory(AD)コネクタのアンインストール時、依存コネクタ(Microsoft Exchangeコネクタなど)がすでに存在するかどうかは検証しません。コネクタをアンインストールする前に、そのコネクタに依存する他のコネクタが存在するかどうかを確認する必要があります。存在する場合は、コネクタをアンインストールすると、依存コネクタの機能に影響を与えるのでアンインストールしないでください。ベース・コネクタをアンインストールする前に、すべての依存コネクタをアンインストールする必要があります。

この項の内容は次のとおりです。

- コネクタのアンインストール・ユーティリティでサポートされるユースケース

- コネクタのアンインストール・プロセスの概要

- コネクタのアンインストール・ユーティリティの設定

- コネクタのアンインストールおよびコネクタ・オブジェクトの削除

6.9.1 コネクタのアンインストール・ユーティリティでサポートされるユースケース

次のユースケースがコネクタのアンインストール・ユーティリティでサポートされています。

- ターゲット・システムが廃止され、そのターゲット・システムとOracle Identity Managerとのリンクに使用していたコネクタをアンインストールする必要があります。

- 最新リリースのコネクタに直接アップグレードするのではなく、以前のリリースをアンインストールしてから、最新リリースのフレッシュ・インストールを実行する必要があります。

- 個々のコネクタ・オブジェクトをOracle Identity Managerデータベースから削除する必要があります。たとえば、ターゲット・システムで定義した「インターン」ユーザー・タイプを表すリソース・オブジェクトをOracle Identity Managerで作成したとします。このユーザー・タイプがターゲット・システムから削除されたので、このリソース・オブジェクトをOracle Identity Managerから削除する必要があります。
コネクタのアンインストール・ユーティリティでは、次のコネクタ・アーティファクトを個別に削除できます。

- アダプタ

- 参照定義

- リソース・オブジェクト

- スケジュール済タスク

6.9.2 コネクタのアンインストール・プロセスの概要

コネクタのアンインストール・ユーティリティを実行すると、このユーティリティは、コネクタのリソース・オブジェクトを削除する前に、次の手順を実行します。

1. コネクタのリソース・オブジェクトに関連付けられているアクセス・ポリシーが存在するかどうかを確認します。アクセス・ポリシーが存在する場合、このユーティリティは、リソース・オブジェクトに関連付けられているアクセス・ポリシーのリストを表示し、アクセス・ポリシーを変更するように要求し、データを削除せずに終了します。アクセス・ポリシーを変更して、リソース・オブジェクトをアクセス・ポリシーから削除する必要があります。アクセス・ポリシーが1つのリソース・オブジェクトのみに関連付けられている場合は、ダミー・リソース・オブジェクトを作成し、それをアクセス・ポリシーに割り当ててから、アクセス・ポリシーからのリソース・オブジェクトの削除に進みます。

2. このリソース・オブジェクトに関連付けられているすべてのリクエストをクローズします。

3. リソース・オブジェクトに関連付けられているリクエストの作成時に使用されたリクエスト・テンプレートのリストを表示します。リクエスト・テンプレートは、本来汎用的であるため、このユーティリティはリクエスト・テンプレートを削除しません。リソース・オブジェクトがOracle Identity Managerから削除されるため、これらのテンプレートを削除または変更するように促すメッセージが表示されます。リクエスト・テンプレートがリソース・オブジェクトに関連付けられている場合は、リクエスト・テンプレートを変更して、リソース名を削除する必要があります。リクエスト・テンプレートがそのリソース・オブジェクト専用に作成されている場合は、そのリクエスト・テンプレートを削除できます。

4. リソース・オブジェクトに関連付けられているアテステーション・プロセスのリストを表示します。アテステーション・プロセスは本来汎用的であるため、このユーティリティはアテステーション・プロセスをOracle Identity Managerから削除しません。リソース・オブジェクトがOracle Identity Managerから削除されるため、これらのプロセスを変更するように要求されます。

5. リソース・オブジェクトに関連付けられている、操作レベルの承認ポリシーのみを削除します。このユーティリティは、リソース・オブジェクトに関連付けられていない、リクエスト・レベルの承認ポリシーおよびその他の操作レベルの承認ポリシーを削除または変更しません。

コネクタを構成する次のオブジェクトが、Oracle Identity Managerデータベースから削除されます。

1. リソース・オブジェクト、およびリソース・オブジェクトに関連するオブジェクト

1. 権限割当て、権限割当て履歴および権限データ。

2. リソース・オブジェクトにリンクされているプロビジョニング・プロセスに関連付けられているタスクおよびタスク履歴。

3. リソース・オブジェクトに関連付けられているプロセス・フォーム。

4. リソース・オブジェクトに関連付けられているプロセス・インスタンスおよびオブジェクト・インスタンス。

5. リソース・オブジェクトに関連付けられているリコンシリエーション・イベントおよびデータ。

6. リソース・オブジェクト用のアテステーション・イベント・データ。

7. リソース・オブジェクトに関連付けられているリクエストおよびリクエスト・データ。

8. リソース・オブジェクトの電子メール定義。

9. リソース・オブジェクトに関連付けられている権限。

10. リソース・オブジェクトに関連付けられている標準ルール。

11. リソース・オブジェクトのリコンシリエーション所有者一致ルール。

12. リソース・オブジェクトのリコンシリエーション・アクション・ルール。

13. リソース・オブジェクトに対応するステータス・コード。

14. リソース・オブジェクトのリコンシリエーション・プロセス・マッピング。

15. リソース・オブジェクトのリコンシリエーション・オブジェクト・フィールド。

16. リソース・オブジェクトのフォーム・マッピングを処理するリクエスト・データセット。

17. リソース・オブジェクトの親フォームと子フォーム用のオブジェクト依存性表。

18. 組織のリソース・オブジェクト。

19. リソース・オブジェクトに関連付けられているプロセス決定ルール。

20. リソース・オブジェクトに関連付けられているパスワード・ポリシー・ルール。

21. プロビジョニング・プロセスにリンクされているフォームで定義されたITリソース・タイプに関連付けられているITリソース・インスタンス。デフォルトのITリソース・インスタンスがある場合(リモート・マネージャのITリソース・インスタンスなど)、それらは削除されません。

22. プロセス・インスタンスおよびリソース・オブジェクト・インスタンス。

23. プロビジョニング・プロセスに関連付けられているタスク。

24. リソース・オブジェクトに関連付けられている実際のオブジェクトとプロセス、親表と子表。

2. スケジュール済タスクおよびスケジュール済ジョブ

3. アダプタ/イベント・ハンドラ

4. 参照定義

6.9.3 コネクタのアンインストール・ユーティリティの設定

コネクタのアンインストール・ユーティリティを設定するには、次の手順を実行します。

- コネクタのアンインストール・ユーティリティを構成するファイルは、OIM_HOME/server/binディレクトリにあります。これらのファイルは次のとおりです。

- ConnectorUninstall.properties

- uninstallConnector.bat

- uninstallConnector.sh

6.9.4 コネクタのアンインストールおよびコネクタ・オブジェクトの削除

要件に応じて、コネクタのアンインストール・ユーティリティを使用して次のタスクを実行できます。

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

- アダプタ、参照定義、リソース・オブジェクトおよびスケジュール済タスクの削除

次の項では、ConnectorUninstallスクリプトを使用してOracle Identity Managerデータベースからコネクタ・オブジェクトを削除する詳細な手順について説明します。前の各項では、この項へのリンクが提供されています。

- コネクタおよびコネクタ・オブジェクトをアンインストールするスクリプトの実行

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

注意:

Oracle Identity Managerがアイドル状態で、いずれの操作にも使用できないようにしておくことをお薦めします。次のことを確認する必要があります。

- コネクタまたはコネクタ・オブジェクトのアンインストールの実行中、Oracle Identity Managerでいずれの操作も行われていないこと。

- すべてのスケジュール済タスクが無効化され、処理が保留中の非同期メッセージ(監査メッセージ、オフライン・プロビジョニング・メッセージ、オフライン・タスク・メッセージ、今後のスケジュール済リクエストなど)が存在しないこと。

ConnectorUninstallスクリプトを使用して、コネクタをアンインストールできます。このスクリプトを実行すると、コネクタの一部を形成しているすべてのオブジェクト、およびコネクタにより収集されたすべてのリソース・データが、データベースから削除されます。

注意:

アンインストール・ユーティリティを実行する前に:

- アンインストール・ユーティリティは本番データベースでは使用できません。

- すでにアーカイブされているデータは削除できません。

- アンインストール・ユーティリティが正常に完了しなかった場合のリストアに役立つため、Oracle Identity ManagerスキーマおよびMDSバックアップが最新であることを確認する必要があります。

- UNDO表領域が適切にサイズ指定されていることを確認する必要があります。これは、開発/テスト環境で大量のデータを削除する場合に必須です。

このガイドで前述しているように、コネクタの定義時に、Oracle Identity Managerデータベースにコネクタのエントリが作成されます。このエントリには、コネクタXMLの内容も含まれています。コネクタのアンインストールを選択した場合、このユーティリティは、コネクタXMLの内容を解析して、削除するコネクタ・オブジェクトを識別します。

警告:

- コネクタのアンインストールでは、コネクタのインストール時または定義時に作成されたコネクタXMLからオブジェクト情報を収集します。このコネクタに関係しないその他のオブジェクトがコネクタの定義時に追加されている場合、アンインストールによりそのオブジェクトも削除されます。たとえば、ADコネクタの定義時、ユーザーがシステム参照または他のコネクタに関連する参照を追加した場合、アンインストールによりその参照が削除されます。

- コネクタを定義するときは、そのコネクタに固有のオブジェクトのみを追加してください。

手順については、「コネクタおよびコネクタ・オブジェクトをアンインストールするスクリプトの実行」を参照してください。

6.9.4.2 アダプタ、参照定義、リソース・オブジェクトおよびスケジュール済タスクの削除

注意:

Oracle Identity Managerがアイドル状態で、いずれの操作にも使用できないようにしておくことをお薦めします。次のことを確認する必要があります。

- コネクタまたはコネクタ・オブジェクトのアンインストールの実行中、Oracle Identity Managerでいずれの操作も行われていないこと。

- すべてのスケジュール済タスクが無効化され、処理が保留中の非同期メッセージ(監査メッセージ、オフライン・プロビジョニング・メッセージ、オフライン・タスク・メッセージ、今後のスケジュール済リクエストなど)が存在しないこと。

ConnectorUninstallスクリプトを使用して、アダプタ、参照定義、リソース・オブジェクトまたはスケジュール済タスクを削除できます。指定したオブジェクトのみがOracle Identity Managerから削除されます。

6.9.4.3 コネクタおよびコネクタ・オブジェクトをアンインストールするスクリプトの実行

コネクタおよびコネクタ・オブジェクトをアンインストールするスクリプトの実行には、次の手順が含まれます。

- アンインストール前

- アンインストール

- アンインストール後

6.9.4.3.1 アンインストール前

注意:

アンインストールを実行する前に、すべてのスケジュール済タスクが無効化されていることを確認する必要があります。

コネクタをアンインストールする前に、次を実行する必要があります。

1. アンインストール中に問題が発生した場合にデータをリストアできるように、Oracle Identity Managerデータベースのバックアップを作成します。バックアップの作成の詳細は、Oracle Identity Managerデータベースのドキュメントを参照してください。

2. Oracle Identity Managerメタデータ(MDS)のバックアップを作成します。Oracle Identity Managerメタデータの変更に使用できるユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

3. アンインストール・ユーティリティが完了するまで、Oracle Identity Managerでいずれの操作も行われないようにします。Oracle Identity ManagerおよびSOAサーバーが、起動され、実行中である必要があります。

4. すべてのJMSメッセージが処理されていることを確認します。

6.9.4.3.2 アンインストール

コネクタをアンインストールするConnectorUninstallスクリプトを実行するには、次の手順を実行します。

1. このスクリプトが使用するpropertiesファイルに値を設定します。

注意:

ConnectorNameおよびReleaseとともにObjectTypeとObjectValuesを指定している場合、ObjectValuesの削除はユーティリティによって実行され、コネクタ情報はスキップされます。

ConnectorUninstall.propertiesファイルは、OIM_HOME/server/binにあります。このファイルには、コネクタ・オブジェクトを削除するスクリプトで使用される情報が含まれています。

propertiesファイルをテキスト・エディタで開き、次のプロパティの値を設定します。

- DatabaseURL: Oracle Identity ManagerデータベースのJDBC URLを次の形式で入力します。

jdbc:oracle:thin:@HOST_NAME:DATABASE_PORT:DATABASE_NAME/ORACLE_SID

For example: jdbc:oracle:thin:@localhost:1521:orcl

- DBUserName: Oracle Identity Managerデータベースのユーザー名を入力します。

- DBType: データベースのタイプを指定します。

- LogLevel: ログ・レベルとしてDEBUG、WARN、INFOまたはERRORのいずれかを入力します。

- Location: アンインストール・ユーティリティが生成するすべてのログ・ファイルを格納するディレクトリの場所を入力します。
アンインストール・ユーティリティが正常に完了すると、ConnectorUninstall.logファイルとともに<ResourceObject>.logファイルが生成されます。

アンインストール・ユーティリティが失敗すると、ConnectorUninstall.logファイルとともにConnectorUninstall_Error.logファイルが生成されます。

注意:

アンインストール・ユーティリティがエラーで失敗した場合は、ConnectorUninstall.logおよびConnectorUninstall_Error.logを確認して、適切なアクションを実行してください。その後、アンインストール・ユーティリティを再度実行します。

たとえば、ActiveDirectoryコネクタのアンインストール・ユーティリティが成功すると、次のログが生成されます。

- ConnectorUninstall.log

- AD User.log

- AD Group.log

- AD Oraganization Unit.log

- AD User Trusted.log

ActiveDirectoryコネクタのアンインストール・ユーティリティが失敗すると、次のログが生成されます。

- ConnectorUninstall.log

- ConnectorUninstall_Error.log

- ConnectorName: このプロパティに設定する値は要件に応じて異なります。特定のコネクタを削除する場合は、そのコネクタの名前を入力します。入力した名前は、コネクタの管理機能により表示される検索結果に示される名前と同じである必要があります。たとえば、Microsoft Active Directoryコネクタを削除する場合は、Active Directoryと入力します。

- Release: このプロパティに設定する値は要件に応じて異なります。特定のコネクタを削除する場合は、そのコネクタのリリース番号を入力します。入力したリリース番号は、コネクタの管理機能により表示される検索結果に示されるリリース番号と同じである必要があります。たとえば、Microsoft Active Directory 9.1.0.1コネクタを削除する場合は、9.1.0.1と入力します。

- ObjectType: このプロパティに設定する値は要件に応じて異なります。

- コネクタをアンインストールする場合は、ObjectTypeプロパティに値が割り当てられていないことを確認します。

- アダプタ、参照定義、リソース・オブジェクトまたはスケジュール済タスクを削除する場合は、Adapter、Lookup、ResourceObjectまたはScheduledTaskをそれぞれ入力します。
例: ResourceObject

- ObjectValues: セミコロン区切りのオブジェクト値のリストを入力します。
例: AD User; AD Group

2. コマンド・ウィンドウで、OIM_HOME/server/binディレクトリに移動し、スクリプトsh uninstallConnector.sh(またはbatファイル)を実行します。
スクリプトが実行されると、指定した場所にログが生成されます。

ユーティリティの実行後、次の情報を入力するように要求されます。

1. Oracle Identity Managerデータベースのパスワード

2. Oracle Identity Manager管理者名

3. Oracle Identity Manager管理者のパスワード

4. Oracle Identity Manager Server t3 URL

5. コネクタやオブジェクトの削除の確認

6.9.4.3.3 アンインストール後

コネクタのアンインストール後、次の手順を実行する必要があります。

1. DeleteJarsユーティリティを使用して、コネクタに関連付けられているjarをOracle Identity Managerデータベースから削除します。

2. DeleteResourceBundlesユーティリティを使用して、コネクタに関連付けられているすべてのリソースをOracle Identity Managerデータベースから削除します。

3. ログを再確認し、次の情報を探して、それぞれで説明されている手順を実行します。

1. リクエスト・テンプレートのリスト: これらのテンプレートを使用していたリソース・オブジェクトは削除されているため、これらのテンプレートを削除または変更します。

2. アテステーション・プロセスのリスト: これらのアテステーション・プロセスを使用していたリソース・オブジェクトは削除されているため、これらのアテステーション・プロセスを削除または変更します。

3. リクエストおよび承認ポリシーを手動で変更して、アンインストール・ユーティリティによりクリーニングされたリソース・オブジェクト名を削除します。

4. コネクタのアンインストールの一環として、承認プロセス(承認ワークフロー/SOAコンポジット)は削除されません。承認プロセスが汎用的で、削除されたリソース・オブジェクトとのアソシエーションがある場合は、承認プロセスを変更する必要があります。

4. 統計を再計算し、コネクタのアンインストール・ユーティリティにより削除された索引およびその他のデータベース・オブジェクトを再作成します。詳細は、「パフォーマンス・チューニングとベスト・プラクティス」を参照してください。

5. Oracle Identity Managerを再起動するか、またはPurgeCacheユーティリティを使用して、キャッシュをパージします。
キャッシュのパージの詳細は、「キャッシュのパージ」を参照してください。

第II部

システム管理

この部では、Oracle Identity Managerでのシステム管理タスクについて説明します。

この部に含まれる章は、次のとおりです。

- 第7章「サーバーの開始と停止」

- 第8章「システム・ロギングの有効化」

- 第11章「他のOracleコンポーネントとの統合」

- 第12章「ライフサイクル管理の変更処理」

7 サーバーの起動と停止

パスワード・ポリシーの作成や更新など、ほとんどのOracle Identity Manager機能の構成では、変更を有効にするためにサーバーを再起動する必要があります。この章では、Oracle WebLogic Serverを起動および停止するための手順について説明します。

コマンド・プロンプト、Oracle WebLogic Server管理コンソールまたはOracle Enterprise Manager Fusion Middleware Controlから、管理対象WebLogic Serverのすべての起動および停止操作を実行できます。次の項は、参照用に提供されています。詳細は、Oracle WebLogic Server管理者ガイドを参照してください。

注意:

Oracle WebLogic Server管理コンソールまたはOracle Enterprise Manager Fusion Middleware Controlを使用してOracle Identity Manager WebLogic管理対象サーバーおよびSOA WebLogic管理対象サーバーを制御(起動または停止)するには、ノード・マネージャを実行している必要があります。

- ノード・マネージャの構成

- ノード・マネージャの起動

- WebLogic管理サーバーの起動または停止

- WebLogic管理対象サーバーの起動または停止

すべての起動および停止操作は、コマンド・プロンプトまたはOracle WebLogic Server管理コンソールのいずれかから実行できます。

注意:

Oracle WebLogic Server管理コンソールから管理サーバー、管理対象サーバーおよびSOAサーバーを起動および停止できるようにするには、その前にノード・マネージャを実行している必要があります。

7.1 ノード・マネージャの構成

Oracle Identity ManagerおよびSOAサーバーをインストールして構成した後で、それをWebLogic管理コンソールまたはOracle Enterprise Manager Fusion Middleware Controlで使用するには、ノード・マネージャを構成する必要があります。この構成は一度のみ行います。

ノード・マネージャを構成するには、nodemanager.propertiesファイルでStartScriptEnabled=trueを設定する必要があります。これを行うには、次のスクリプトを実行します。

UNIXの場合:

MIDDLEWARE_HOME/oracle_common/common/bin/setNMProps.sh

Microsoft Windowsの場合:

MIDDLEWARE_HOME\oracle_common\common\bin\setNMProps.cmd

7.2 ノード・マネージャの起動

ノード・マネージャを起動するには:

1. WL_HOME/server/binに移動します。

2. コマンド・プロンプトで、次のように入力します。
./startNodeManager

7.3 WebLogic管理サーバーの起動または停止

WebLogic管理サーバーを起動または停止するには:

1. DOMAIN_HOME/binに移動します。

注意:

- Linuxインストールの場合、binフォルダには./startWebLogic.shのみで、startWebLogic.cmdはありません。

- Microsoft Windowsインストールでは、binフォルダに./startWebLogic.shとstartWebLogic.cmdの両方があります。

2. サーバーを起動するには、次のように入力します。
UNIXの場合:

./startWebLogic.sh

Microsoft Windowsの場合:

startWebLogic.cmd

サーバーを停止するには、次のように入力します。

UNIXの場合:

./stopWebLogic.sh

Microsoft Windowsの場合:

stopWebLogic.cmd

7.4 WebLogic管理対象サーバーの起動または停止

この項の内容は次のとおりです。

- コマンド・プロンプトを使用した管理対象サーバーの起動または停止

- Oracle Enterprise Manager Fusion Middleware Controlを使用した管理対象サーバーの起動または停止

- Oracle WebLogic Server管理コンソールを使用したサーバーの起動または停止

7.4.1 コマンド・プロンプトを使用した管理対象サーバーの起動または停止

コマンド・プロンプトを使用して管理対象サーバーを起動または停止するには:

1. DOMAIN_HOME/bin/ディレクトリに移動します。

2. サーバーを起動するには、コマンド・プロンプトで次のように入力します。
UNIXの場合:

./startManagedWebLogic.sh MANAGED_SERVER_NAME ADMIN_SERVER_URL

次に例を示します。

startManagedWebLogic.sh oim_server1 http://mywlsadminhost.mycompany.com:7001

startManagedWebLogic.sh soa_server1 http://mywlsadminhost.mycompany.com:7001

Microsoft Windowsの場合:

startManagedWebLogic.cmd MANAGED_SERVER_NAME ADMIN_SERVER_URL

サーバーを停止するには、コマンド・プロンプトで次のように入力します。

UNIXの場合:

./stopManagedWebLogic.sh MANAGED_SERVER_NAME ADMIN_SERVER_URL

Microsoft Windowsの場合:

stopManagedWebLogic.cmd MANAGED_SERVER_NAME ADMIN_SERVER_URL

次に例を示します。

stopManagedWebLogic.cmd OIM_server1 http://mywlsadminhost.mycompany.com:7001

stopManagedWebLogic.cmd soa_server1 http://mywlsadminhost.mycompany.com:7001

7.4.2 Oracle Enterprise Manager Fusion Middleware Controlを使用した管理対象サーバーの起動または停止

Oracle Enterprise Manager Fusion Middleware Controlを使用して管理対象サーバーを制御するには、コンピュータ上でノード・マネージャが実行されている必要があります。

Oracle Enterprise Manager Fusion Middleware Controlを使用して管理対象サーバーを起動または停止するには、次の手順を実行します。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. 「WebLogicドメイン」、「ドメイン名」、 SERVER_NAMEに移動します。

3. 右クリックし、「コントロール」に移動します。

4. 「起動」をクリックして、サーバーを起動します。
「停止」をクリックして、サーバーを停止します。

7.4.3 Oracle WebLogic Server管理コンソールを使用したサーバーの起動または停止

Oracle WebLogic管理コンソールを使用してサーバーを起動または停止するには:

1. Oracle WebLogic Server管理コンソールにログインします。

2. 左ペインの「ドメイン構造」の下で、「環境」、「サーバー」を選択します。

3. 右ペインの「サーバーのサマリー」の下で、「コントロール」タブをクリックします。

4. サーバー名を選択します。

5. 「起動」をクリックして、サーバーを起動します。
「停止」をクリックして、サーバーを停止します。

8 システム・ロギングの有効化

Oracle Identity Managerでは、2つのロギング・サービス、大多数のOracle Fusion Middlewareアプリケーションで使用されるロギング・サービスOracle Diagnostic Logging (ODL)とApache log4jが使用されます。

Oracle Identity Manager のロギングは、主としてODLを使用して行われます。Apache log4jは、デプロイメント・マネージャやワークフロー・デザイナでのNexaweb、キャッシングでのOSCacheなど、サードパーティ・アプリケーションでのみ使用されます。

この章の内容は次のとおりです。

- ODLを使用したOracle Identity Managerのロギング

- log4jを使用したOracle Identity Managerのロギング

8.1 ODLを使用したOracle Identity Managerのロギング

Oracle Diagnostic Logging (ODL)は、Oracle Identity Managerが使用する主要なロギング・サービスです。ODLロギングを動作させるには、ロガーとログ・ハンドラの両方を構成する必要があります。ロガーはハンドラにメッセージを送信し、ハンドラはメッセージを受け入れてログ・ファイルに出力します。

「ログ・ハンドラとロガーの構成」で説明しているように、ロギング構成はlogging.xmlファイルによって制御されます。このファイルは、直接編集することも、Enterprise Managerを介して編集することもできます。Enterprise Managerでは、OIMサーバー・リンクをクリックして上部のWeblogic Serverドロップダウンを選択し、「ログ」→「ログ構成」をクリックしてロギング構成にアクセスできます。

Enterprise Managerでロギング構成にアクセスするには、次の手順を実行します。

1. OIMサーバー・リンクをクリックします。

2. Weblogic Serverのリストから、「ログ」→「ログ構成」を選択します。ログ構成画面に、ロギングに利用できるすべてのパッケージが表示されます。

Enterprise Managerで利用できない追加パッケージ(コネクタのためのパッケージなど)のロギングは、次の指示に従ってlogging.xmlファイルを手動で編集します。Oracle Identity Manager固有のパッケージには、oracle.iamからアクセスできます。Oracle Diagnostic Loggingレベル列で、各ログ・レベルを選択できます。特定のログ・レベルを選択し、「適用」をクリックして変更を適用します。また、「ログ・ファイル」タブをクリックして、新しいログ・ハンドラを作成して構成することもできます。

Oracle Identity Managerの各モジュールには、個別に構成できる独自のロガーがあり、それぞれ異なる情報量を1つ以上のログ・ハンドラに送信できます。表8-2「Oracle Identity Managerのロガー」に、ログ・ハンドラへのメッセージ送信を構成できるOracle Identity Managerの20種類以上のロガーを示します。

ログに出力する情報量は、各ロガーのレベル属性を調整して制御できます。ロギング・レベルを選択するには、5つのメッセージ・タイプ(INCIDENT_ERROR、ERROR、WARNING、NOTIFICATION、TRACE)からいずれか1つを選びます。各メッセージ・タイプで1(最高重大度) - 32(最低重大度)の数値を使用して、ロガーで出力されるメッセージ量をさらに制限することもできます。2ページの表1に、最もよく使用されるメッセージ・タイプとレベルの組合せを示します。

ログ・ハンドラは、ログ・メッセージを表示するターゲットを指定します。たとえば、コンソール、各種ログ・ファイルおよび追加の出力にメッセージを書き込むことができます。

この項の内容は次のとおりです。

- メッセージのタイプとレベル

- ログ・ハンドラとロガーの構成

- ログ・ハンドラの構成

- ロガーの構成

- ODLログ出力のサンプル

8.1.1 メッセージのタイプとレベル

ODLでは、INCIDENT_ERROR、ERROR、WARNING、NOTIFICATION、TRACEの5つのメッセージ・タイプを認識します。各メッセージ・タイプで1(最高重大度) - 32(最低重大度)の数値を使用して、メッセージ出力をさらに制限することもできます。

メッセージ・タイプを指定すると、ODLではそのタイプのすべてのメッセージと、指定したタイプ以上の重大度のメッセージが返されます。たとえば、メッセージ・タイプをWARNINGに設定した場合、ODLではINCIDENT_ERRORとERRORのタイプのメッセージも返されます。

メッセージのタイプとレベルの詳細は、『Oracle Fusion Middleware管理者ガイド』の「ログ・ファイルに書き込まれる情報レベルの設定」を参照してください。表8-1に、Oracle Identity Managerで最もよく使用される診断メッセージのタイプを示します。

表8-1 Oracle Identity Managerの診断メッセージのタイプ

メッセージ・タイプおよび数値

説明

INCIDENT_ERROR:1

製品のバグが原因の可能性があり、Oracleサポートに報告する必要がある重大な問題。

この例として、回復不能なエラーがあります。

ERROR:1

管理者が即時に注目する必要があり、製品のバグが原因でない重大な問題。

この例として、Oracle Fusion Middlewareがログ・ファイルを処理できないものの、ドキュメントに対する権限の調整によって問題の修正が可能な場合などがあります。

WARNING:1

管理者が確認する必要のある潜在的な問題。

この例として、パラメータ値が無効な場合や指定したファイルが存在しない場合などがあります。

NOTIFICATION:1

主要サブコンポーネントや機能のアクティブ化または非アクティブ化などの、主要なライフサイクル・イベント。

これはNOTIFICATIONのデフォルト・レベルです。

NOTIFICATION:16

正常なイベントをレポートするためのより詳細なレベル。

TRACE:1

パブリックAPIエントリや出口点など、管理者に重要なイベントに関するトレースまたはデバッグ情報。

TRACE:16

Oracleサポートが特定のサブシステムでの問題を診断するのに役立つ可能性のある、詳細なトレースまたはデバッグ情報。

TRACE:32

Oracleサポートが特定のサブシステムでの問題を診断するのに役立つ可能性のある、非常に詳細なトレースまたはデバッグ情報。

8.1.2 ログ・ハンドラとロガーの構成

ログ・ハンドラとロガーはどちらもlogging.xmlを編集して構成できます。このファイルは次の場所に格納されています。

DOMAIN_NAME/config/fmwconfig/servers/SERVER_NAME/logging.xml

ここで、DOMAIN_NAMEとSERVER_NAMEは、それぞれOracle Identity Managerのインストール時に指定されたドメイン名とサーバー名です。

logging.xmlファイルには<log_handlers>構成セクションがあり、その下に<loggers>構成セクションが続きます。各ログ・ハンドラを、<log_handlers>セクションで定義し、各ロガーを<loggers>セクションで定義します。

ファイルの基本構造は次のとおりです。

<logging configuration>
<log_handlers>
<log_handler name='console-handler' level="NOTIFICATION:16"></log_handler>
<log_handler name='odl-handler'></log_handler>
<!--Additional log_handler elements defined here....-->
</log_handlers>
<loggers>
<logger name="example.logger.one" level="NOTIFICATION:16">
<handler name="console-handler"/>
</logger>
<logger name="example.logger.two" />
<logger name="example.logger.three" />
<!--Additional logger elements defined here....-->
</loggers>
</logging_configuration>

メッセージをコンソールかファイルのどちらかに書き込むようにロガーを構成する場合は、ロガーとハンドラの両方の構成変更を行います。ロガーでのレベル属性の設定は、ロガーがハンドラに送信する詳細の量(つまりメッセージ量)を構成します。同様に、ハンドラでのレベル属性の設定は、ハンドラがロガーから受け入れる詳細の量を構成します。

注意:

ログに期待する量のメッセージが出力されない場合は、ロガーとログ・ハンドラのレベル属性が適切に設定されているか確認してください。たとえば、ロガーがTRACEに設定され、ログ・ハンドラがWARNに設定されている場合、ハンドラはWARNより詳細なメッセージは生成しません。

8.1.3 ログ・ハンドラの構成

個々のログ・ハンドラは、logging.xmlファイルの<log_handlers>セクションで構成されます。ハンドラのレベル属性を構成して、ハンドラがロガーから受け入れる詳細の量を設定します。

ログ・ハンドラのレベル属性を構成するには:

注意:

logging.xmlファイルを修正するには、XML構文の基本を理解している必要があります。

1. DOMAIN_NAME/config/fmwconfig/servers/SERVER_NAME/logging.xmlファイルを開きます。

2. レベル属性を次の例に示すように変更します。
このXMLコード例では、console-handlerのレベル属性はWARNING:32に設定されています。

<log_handler name='console-handler' class='oracle.core.ojdl.logging.ConsoleHandler' formatter='oracle.core.ojdl.weblogic.ConsoleFormatter' level='WARNING:32'/>

console-handlerがコンソールにTRACEレベルのメッセージを書き込めるようにするには、レベル属性を次のように変更します。

<log_handler name='console-handler' class='oracle.core.ojdl.logging.ConsoleHandler' formatter='oracle.core.ojdl.weblogic.ConsoleFormatter' level='TRACE:1'/>

3. 変更を保存して、アプリケーション・サーバーを再起動します。

8.1.3.1 ログ・ハンドラの構成ツール

ファイルに書き込むログ・ハンドラには、構成可能な追加プロパティがあります。たとえば、次に示すlogging.xmlからの抜粋では、odl-handlerのプロパティが構成されています。

<log_handler name='odl-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'     filter='oracle.dfw.incident.IncidentDetectionLogFilter'>
<property name='path'     value='${domain.home}/servers/${weblogic.Name}/logs/${weblogic.Name}-diagnostic.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
<property name='encoding' value='UTF-8'/>
<property name='useThreadName' value='true'/>
<property name='supplementalAttributes' value='J2EE_APP.name,J2EE_MODULE.name,     WEBSERVICE.name,WEBSERVICE_PORT.name,composite_instance_id,component_instance_id,     composite_name,component_name'/>
</log_handler>

ログ・ハンドラのプロパティは、Fusion Middleware ControlツールまたはWLSTコマンドライン・ツールを使用して変更できます。

関連項目:

- Fusion Middleware ControlツールおよびWLSTコマンドライン・ツールの詳細は、『Oracle Fusion Middleware管理者ガイド』の「ログ・ファイルの設定の構成」を参照してください。

- WLSTコマンドライン・ツールの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのカスタムWLSTコマンドのロギングに関する項を参照してください。

8.1.4 ロガーの構成

各ログ・ハンドラは、logging.xmlファイルの<loggers>セクションで構成されます。ログ・ハンドラにメッセージを送信するために構成できる、20種類を超えるOracle Identity Managerのロガーがあります。Oracle Identity Managerのロガーについては、7ページの表2で説明されています。ロガーのレベル属性の設定で、ロガーがハンドラに送信する詳細の量(つまりメッセージ量)が構成されます。1つ以上の<handler>要素を<logger>要素内にネストすると、ロガーにハンドラが割り当てられます。OIMCP.PSFTCOMMONと呼ばれるロガーを次の抜粋に示します。level属性にはWARNING:32が設定され、ロガーによって3つのハンドラにメッセージが送信されます。

<logger name="OIMCP.PSFTCOMMON" level="WARNING:32" useParentHandlers="false">
<handler name="odl-handler"/>
<handler name="wls-domain"/>
<handler name="console-handler"/>
</logger>

ロガーは、親のレベル設定やその他の属性、親のロガーのハンドラなど、親のロガーの設定を継承します。継承を無効にするには、前述の抜粋に示すように、useParentHandlers属性を「false」に設定します。

ロガーの継承ツリーの最上部にあるのがルート・ロガーです。ルート・ロガーは、次の例に示すように、名前属性が空のロガーです。

<loggers>
<logger name="" level="WARNING:1">
<handler name="odl-handler"/>
<handler name="wls-domain"/>
<handler name="console-handler"/>
</logger>

<!-- Additional loggers listed here -->
</loggers>

次の例に示すように、ロガーを名前属性のみで構成すると、ロガーは残りの属性をルート・ロガーから継承します。

<loggers>
<logger name="oracle.iam.identity.rolemgmt"/>
<!-- Additional loggers listed here -->
</loggers>

ロガーを構成するには:

1. DOMAIN_NAME/config/fmwconfig/servers/SERVER_NAME/logging.xmlファイルを開きます。

2. 構成するロガーに移動します。表8-2に、Oracle Identity Managerのロガーのリストを示します。

表8-2 Oracle Identity Managerのロガー

ロガー

説明

oracle.iam.request
oracle.iam.requestdatasetgeneration
oracle.iam.requestactions
oracle.iam.platform.workflowservice

リクエストおよびリクエスト・データセット管理に関連するイベントを記録します。

oracle.iam.requesttemplate

リクエスト・テンプレート管理に関連するイベントを記録します。

oracle.iam.selfservice

認証済および未認証のセルフサービス操作に関連するイベントを記録します。

oracle.iam.ChangePasswordtaskflow

パスワード変更機能のUIのイベントを記録します。

oracle.iam.forgotpasswordtaskflow

パスワード忘れ機能のUIのイベントを記録します。

oracle.iam.identitytaskflow

管理UIのアイデンティティ操作のイベントを記録します。

oracle.iam.identity.orgmgmt

組織マネージャのサービス操作に関連するイベントを記録します。

oracle.iam.identity.rolemgmt

ロール・マネージャのサービス操作に関連するイベントを記録します。

oracle.iam.identity.usermgmt

ユーザー・マネージャのサービス操作に関連するイベントを記録します。

oracle.iam.identity.scheduledtasks

アイデンティティ機能のスケジュールされたタスクに関連するイベントを記録します。

oracle.iam.platform.utils

プラットフォームで提供されるユーティリティ(主に他の機能で使用される)に関連するイベントを記録します。メッセージ・リソース処理、ロギング処理、国際化、キャッシングなどのユーティリティが含まれます。

oracle.iam.platformservice

主にクライアント側から実行されるユーティリティに関連するイベントを記録します。たとえば、プラグイン登録ユーティリティやキャッシュの消去ユーティリティなどがあります。日付と時間ユーティリティや例外処理ユーティリティなどの一部のサーバー側ユーティリティでも、このロガーが使用されます。

oracle.iam.platform.canonic

UIフレームワークの実行に関連するイベントを記録します。

oracle.iam.consoles.faces
oracle.iam.consoles.common

UIフレームワークから生成されるメッセージを記録します。

oracle.iam.platform.kernel

カーネルに関連するイベントを記録します。これには、プラットフォームによって編成の処理中に生成されるログを含みます。各機能内の編成で実行されるイベント・ハンドラには、その機能独自のロガーが使用されます。

oracle.iam.platform.context

コンテキスト管理機能に関連するイベントを記録します。

oracle.iam.platform.entitymgr

エンティティ・マネージャ機能に関連するイベントを記録します。この機能は、ユーザー、ロールなど、各種エンティティ・タイプの一般的な処理と、それらに対する個別操作への適切なルーティングを提供します。

oracle.iam.scheduler
oracle.iam.platform.scheduler
Xellerate.Scheduler
Xellerate.Scheduler.Task

スケジューラに関連するイベントを記録します。スケジュール済タスクのなかには、別のロガーも使用する場合があることに注意してください。

oracle.iam.reconciliation

リコンシリエーション機能に関連するイベントを記録します。

oracle.iam.accesspolicy

アクセス・ポリシー機能に関連するイベントを記録します。

oracle.iam.autoroles

ロール・メンバーシップの自動割当て機能に関連するイベントを記録します。

oracle.iam.callbacks

コールバック機能に関連するイベントを記録します。

oracle.iam.configservice

エンティティ属性の構成に使用される構成サービスAPIに関連するイベントを記録します。

oracle.iam.ldap-sync

Oracle Identity ManagerおよびLDAP同期化機能に関連するイベントを記録します。

oracle.iam.notification

電子メール・テンプレートおよび通知処理機能に関連するイベントを記録します。

oracle.iam.passwdmgnt

パスワード管理機能に関連するイベントを記録します。

oracle.iam.platform.pluginframework

プラグインの管理を処理するプラグイン・フレームワーク機能からのイベントを記録します。

oracle.iam.platform.async

非同期操作を処理するプラットフォームからのイベントを記録します。

oracle.iam.spmlws
oracle.iam.wsschema

各種操作のリクエストを生成するFusionアプリケーションで使用されるWebサービスに関連するイベントを記録します。

oracle.iam.diagnostic

診断チェックを実行するために使用される診断サービスAPIからのメッセージを記録します。

oracle.iam.oimdataproviders

Oracle Identity Managerのデータ・プロバイダに関連するイベントを記録します。Oracle Identity Managerのデータ・プロバイダは、Oracle Identity Managerデータベースのデータの更新や取得のためのコードを提供します。

Xellerate.Database

データベース操作を記録します。

Xellerate.PreparedStatement

Xellerate.Databaseと同じですが、PreparedStatementの詳細のみを記録します。

Xellerate.Performance

文(問合せ)を実行する時間、またはデータやメタデータを取得するために結果セットを繰り返す時間など、データベースのパフォーマンスを記録します。

oracle.iam.platform.auth

認証処理機能のイベントを記録します。

oracle.iam.platform.authz
oracle.iam.authzpolicydefn

認可ポリシーを処理する機能のイベントを記録します。

oracle.iam.sod
Xellerate.SoD

SoD(職務の分離)に関連するイベントを記録します。

oracle.jps

組込みのOracle Entitlements Server MicroSMエンジン用のロガーです。ログ・ファイルは、管理対象サーバー名-microsm.log(例: OIMServer1-microsm.log)という名前でOIM_ORACLE_HOMEフォルダに作成されることに注意してください。

Xellerate.Entitlement

プロビジョニング・エンタイトルメントに使用されるエンタイトルメント操作のロギングを提供します。

oracle.iam.conf

システム・プロパティの処理を含むシステム構成サービス機能に関連するイベントを記録します。

oracle.iam.transUI

11gコードからのレガシーAPIの初期化を処理するトランザクションUI機能に関連するイベントを記録します。これには、ユーザー作成時のプロビジョニングの初期化などの操作が含まれます。

Xellerate.AccountManagement

レガシーのユーザー操作APIでのロギングを提供します。

Xellerate.Server

データ・オブジェクトでのロギングを提供します。

Xellerate.ResourceManagement
Xellerate.ObjectManagement

リソース・オブジェクト操作のロギングを提供します。

Xellerate.Workflow

プロビジョニング・プロセス操作のロギングを提供します。

Xellerate.WebApp

移行のUI操作のロギングを提供します。

Xellerate.Adapters

アダプタ・ファクトリのロギングを提供します。

Xellerate.JavaClient

クライアント側データ・オブジェクトのロギングを提供します。

Xellerate.Policies

アクセス・ポリシーに関連するデータ・オブジェクトのロギングを提供します。

Xellerate.Rules

ルールに関連するデータ・オブジェクトのロギングを提供します。

Xellerate.APIs

レガシーのパブリックAPIのロギングを提供します。

Xellerate.JMS

メッセージを生成するJMS操作のロギングを提供します。

Xellerate.RemoteManager

リモート・マネージャでのロギングを提供します。

Xellerate.Auditor

監査フレームワークでのロギングを提供します。

Xellerate.Attestation

アテステーションのUIおよび操作でのロギングを提供します。

Xellerate.GC.StartUp
Xellerate.GC.ProviderRegistration
Xellerate.GC.ImageGeneration
Xellerate.GC.FrameworkProvisioning
Xellerate.GC.Provider.ProvisioningFormat
Xellerate.GC.Provider.ProvisioningTransport
Xellerate.GC.FrameworkReconciliation Xellerate.GC.Provider.Reconciliation
Format
Xellerate.GC.Provider.Validation
Xellerate.GC.Provider.Transformation
Xellerate.GC.Model
Xellerate.GC.Server

汎用テクノロジ・コネクタ(GTC)のロギングを提供します。

oracle.iam.connectors.icfcommon

コネクタ・フレームワークのロギングを提供します。

3. <logger>要素のレベル属性を定義します。この項の先頭の例を参照してください。

4. 1つ以上の<handler>要素を<logger>要素に追加します。

5. logging.xmlの<loggers>と<log_handlers>の両方のセクションの編集が終了したら、ファイルを保存します。

6. アプリケーション・サーバーを再起動して変更を有効にします。

8.1.5 ODLログ出力のサンプル

次のODLログの抜粋は、想定される出力例を示しています。

<Jun 15, 2010 2:01:20 AM IST> <Error> <oracle.iam.platform.authz.impl>
<IAM-1010032>
<No OES Policy found for the given Action.>
<Jun 15, 2010 2:02:02 AM IST> <Warning> <oracle.iam.platform.canonic.agentry>
<IAM-0091108> <readme.txt is not a valid connector resource file.>
<Jun 15, 2010 2:02:52 AM IST> <Error> <oracle.iam.configservice.impl>
<IAM-3020003> <The attribute User Type does not exist!>

ログ出力の管理および解釈の詳細は、『Oracle Fusion Middleware管理者ガイド』の「ログ・ファイルと診断データの管理」を参照してください。

8.2 log4jを使用したOracle Identity Managerのロギング

Apache log4jは、デプロイメント・マネージャやワークフロー・デザイナでのNexaweb、およびキャッシングでのOSCacheなどのサードパーティ製アプリケーションで使用されます。log4j構成ファイルは次の場所に格納されています。

OIM_HOME/config/log.properties

log4jを使用したOracle Identity Managerでのロギングについて、次の各項で説明します。

- ログ・レベル

- ロガー

- ロギングの構成と有効化

8.2.1 ログ・レベル

表8-3に、log4jのログ・レベルのリストを示します。

表8-3 log4jのログ・レベル

ログ・レベル

説明

DEBUG

DEBUGレベルは、アプリケーションのデバッグに役立つ詳細な情報イベントを示します。

INFO

INFOレベルは、アプリケーションの進捗状況を大まかなレベルで強調表示する情報メッセージを示します。

WARN

WARNレベルは、危険な状況になる可能性のあることを示します。

ERROR

ERRORレベルは、アプリケーションの続行が可能なエラー・イベントを示します。

ALL

ALLレベルは下限ランクで、すべてのロギングが有効化されます。

OFF

OFFレベルは上限ランクで、ロギングは無効化されます。

8.2.2 ロガー

サードパーティのアプリケーションには、次のロガーが使用されます。

- Nexawebの場合: com.nexaweb.server

- OSCacheの場合: com.opensymphony.oscache

8.2.3 ロギングの構成と有効化

サードパーティのアプリケーションには、次のように任意のログ・レベルを使用できます。

log4j.logger.com.nexaweb.server=WARN
log4j.logger.com.opensymphony.oscache=ERROR

9 セキュアなCookieの有効化

デフォルトでは、Oracle Identity ManagerはHTTPを介してアクセスできますが、 Secure Socket Layer (SSL)上では動作しません。これは、cookie-secureフラグがデフォルトで無効なためです。cookie-secureフラグは、HTTPS接続を介してのみCookieを送信するようにWebブラウザに伝えます。これにより、Cookieは必ずセキュアなチャンネル上でのみ送信されます。アプリケーションによって公開されたURLに対してHTTPSを有効にする必要があります。

Oracle Identity ManagerをSSL上で動作できるようにするには、cookie-secureフラグを有効にする必要があります。これを行うには、次のようにします。

1. Oracle Identity Managerデプロイメントの次のファイルに対して、<session-descriptor>要素の内側に<cookie-secure>true</cookie-secure>タグを追加します。

- OIM_HOME/apps/oim.ear/admin.war/WEB-INF/weblogic.xml

- OIM_HOME/apps/oim.ear/iam-consoles-faces.war/WEB-INF/weblogic.xml

- OIM_HOME/apps/oim.ear/xlWebApp.war/WEB-INF/weblogic.xml

2. Nexawebアプリケーション用のweblogic.xmlファイルがWEB-INF/ディレクトリにない場合は、それを新規作成します。

3. その中に次のセッション・ディスクリプタを追加します。

<?xml version='1.0' encoding='UTF-8'?>
<weblogic-web-app
xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app/1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.oracle.com/weblogic/weblogic-web-app/1.0   http://xmlns.oracle.com/weblogic/weblogic-web-app/1.0/weblogic-web-app.xsd">

<session-descriptor>
<persistent-store-type>replicated_if_clustered</persistent-store-type>
<cookie-http-only>false</cookie-http-only>
<cookie-name>oimjsessionid</cookie-name>
<cookie-secure>true</cookie-secure>
<url-rewriting-enabled>false</url-rewriting-enabled>
</session-descriptor>

</weblogic-web-app>

4. weblogic.xmlを保存します。

5. Oracle Identity Managerの管理対象サーバーを再起動します。

10 LDAP同期の有効化

Oracle Identity Managerの以前のリリースでは、Oracle Identity Managerのインストール時にのみLDAP同期を有効化でき、インストール後はLDAP同期を有効化できません。Oracle Identity Manager 11g リリース1(11.1.1)では、インストール後のLDAP同期の有効化がサポートされています。

関連項目:

LDAP同期の詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのLDAPアイデンティティ・ストアとOracle Identity Managerの統合に関する説明を参照してください。

インストール中にOracle identity ManagerとともにOracle Internet Directory(OID)、iplanet(ODSEE)またはActive Directory(AD)を選択すると、Oracle Virtual Directory(OVD)の仮想化機能が活用されます。Oracle Identity Managerには、スタンドアロンOVDサーバーのかわりにIdentity Virtualization Library(libOVD)が含まれています。Oracle Identity Managerは、Identity Virtualization Library(libOVD)の有無にかかわらずデプロイできます。Oracle Identity ManagerにIdentity Virtualization Library(libOVD)を含めると、Oracle Identity Managerは独自のOVDインスタンスを実行することなく、この共通ライブラリを使用できます。Identity Virtualization Library(libOVD)がない場合、Oracle Identity ManagerはOVDインスタンスを個別に使用する必要があります。

Oracle Identity ManagerインストーラでLDAP同期を選択するときに、AD、iPlanet(ODSEE)、OIDおよびOVDオプションのいずれかを選択できます。AD、iPlanet(ODSEE)またはOIDを選択すると、Oracle Identity ManagerはIdentity Virtualization Library(libOVD)とともにインストールされます。OVDを選択すると、LDAP同期が有効化されるため、LDAP同期を有効化するための手動の構成手順が不要になります。ただし、Oracle Identity Managerのインストール時にLDAP同期が有効化されていない場合は、LDAP同期を有効化するためのインストール後の手動構成が必要です。

この章では、インストール後にLDAP同期を有効にするための次の構成について説明します。

- インストール後のLDAP同期の有効化

- Identity Virtualization Library(libOVD)とディレクトリ・サーバーの間でのSSLの有効化

さらに、この章には次の項が含まれます。

- LDAP同期を有効化する前に作成したユーザーおよびロールのLDAPへのプロビジョニング

- LDAP同期の無効化

- Identity Virtualization Library(libOVD)アダプタの管理

- LDAP同期が有効な場合のLDAP認証の構成

10.1 インストール後のLDAP同期の有効化

Oracle Identity Managerをデプロイした後でLDAP同期を有効化するには、次の手順を実行します。

注意:

Oracle Identity Manager 11g リリース1(11.1.1)では、idmConfigToolを実行してLDAP同期を事前構成する必要があります。LDAPConfigPreSetupスクリプトを実行してLDAP同期を事前構成すると、エラーが生成されます。idmConfigToolの使用の詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』のサード・パーティ・ディレクトリの準備に関する説明を参照してください。

1. OIM_HOME環境変数に、Oracle Identity Managerがデプロイされているディレクトリを設定します。

2. 次のファイルを、MDSから一時ステージング・ディレクトリ(/tmpなど)にコピーします。

注意:

別個のステージング・ディレクトリを作成する必要があります。$OIM_ORACLE_HOME/server/metadataディレクトリには他のファイルが含まれているため、ステージング・ディレクトリとして使用することはできません。これらのファイルを誤ってインポートすると、Oracle Idenitity Managerインスタンスが破損することがあります。

- LDAPユーザー、ロール、ロール階層およびロール・メンバーシップ・リコンシリエーションのための、リコンシリエーション・プロファイルおよびリコンシリエーション水平表エンティティ定義の構成に、次のメタデータが使用されます。
/db/LDAPUser

/db/LDAPRole

/db/LDAPRoleHierarchy

/db/LDAPRoleMembership

/db/RA_LDAPROLE.xml

/db/RA_LDAPROLEHIERARCHY.xml

/db/RA_LDAPROLEMEMBERSHIP.xml

/db/RA_LDAPUSER.xml

/db/RA_MLS_LDAPROLE.xml

/db/RA_MLS_LDAPUSER.xml

これらのファイルは、インポート前に一時的な場所にコピーする必要があります。このようにしないと、同じ場所にoim-config.xmlも存在することになるため、インスタンスが破損することがあります。

- LDAPイベント・ハンドラ。事前定義済イベント・ハンドラは、/db/ldapMetadata/EventHandlers.xmlファイル内にあります。

- 作成するユーザーおよびロールのコンテナ情報で構成されるLDAPContainerRules.xml。

注意:

ディレクトリにマップされているこれらの属性のみを使用して、LdapContainerRules.xmlファイルにルールを含めることができます。外部オブジェクトからの属性またはエンティティの一部ではない属性を使用して、ルールを記述することはできません。これはユーザー・エンティティとロール・エンティティの両方に当てはまります。たとえば、「ロールの電子メール」はロールのルールには使用できず、ユーザーの「組織名」はユーザー・エンティティに使用できません。

3. LDAPContainerRules.xmlを編集します。これを行うには、LDAPContainerRules.xmlを開き、$DefaultUserContainer$と$DefaultRoleContainer$を適切なユーザー・コンテナ値とロール・コンテナ値で置換します。たとえば、次のように置換します。

- $DefaultUserContainer$をcn=ADRUsers,cn=Users,dc=us,dc=oracle,dc=comなどの値で置換

- $DefaultRoleContainer$をcn=ADRGroups,cn=Groups,dc=us,dc=oracle,dc=comなどの値で置換

4. インポートを実行します。これを行うには、次のようにします。

1. OIM_HOME/bin/ディレクトリで利用できるMDSユーティリティ(weblogicImportMetadata.shなど)を使用して、ステップ2にリストされているファイルすべてをインポートします。

注意:

- MDSユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

- MDSにインポートするときに、EventHandlers.xmlが/db/ldapMetadata/ディレクトリに存在することを確認してください。

- MDSインポート・ユーティリティではステージング・ディレクトリ内のすべてがインポートされるため、そのディレクトリにはインポートするファイルのみが含まれている必要があります。このようにしないと、Oracle Identity Managerインスタンスが破損することがあります。

2. OIM_HOME/bin/ディレクトリに移動します。

3. テキスト・エディタで、weblogic.propertiesファイルを開きます。次のプロパティに値を指定します。

- wls_servername=oim_server1
wls_servernameは、Oracle Identity ManagerがデプロイされるOracle WebLogic Serverの名前です。

- application_name=oim
デフォルトのイベント・ハンドラをインポートまたはエクスポートする場合、この値はoimです。その他の事前定義済メタデータの場合、値はOIMMetadataです。カスタム・データをインポートまたはエクスポートする場合、アプリケーション名としてOIMMetadataを使用します。

- metadata_from_loc=/tmp
これは、XMLファイルのインポート元のディレクトリの場所です。たとえば、User.xmlをインポートする必要があり、その場所が/scratc/USER/temp/oim/file/User.xmlである場合、場所の値として/scratc/USER/temp/oimを指定できます。このディレクトリおよびそのサブディレクトリに他のファイルが存在しないことを確認してください。インポート・ユーティリティは、場所のディレクトリから再帰的にすべてのファイルをインポートしようとします。このプロパティは、weblogicImportMetadata.shでのみ使用されます。

注意:

同様に、ファイル(EventHandlers.xmlなど)をエクスポートするには、パス/db/ldapMetadata/EventHandlers.xmlを使用する必要があります。weblogic.properties内のmetadata_filesの値は、次のようにする必要があります。

metadata_files=/db/ldapMetadata/EventHandlers.xml

OIM_HOME/metadataには、2つのディレクトリ(dbおよびldapReconJobs)が含まれています。metadata_from_locの場所がこのディレクトリを参照している場合、これら両方のディレクトリがMDSにインポートされます。

4. 次のコマンドを実行し、構成ファイルをMDSにインポートします。
sh ./weblogicImportMetadata.sh

WebLogicのログイン情報を求められます。次の情報を指定します。

Please enter your username [weblogic] :weblogic
Please enter your password [weblogic] :PASSWORD
Please enter your server URL [t3://localhost:7001] :t3://localhost:8003

これで、構成ファイルがインポートされます。

5. Oracle Identity ManagerでITリソース構成を編集します。これを行うには、次のようにします。

1. 管理者の資格証明を使用して、Oracle Identity Manager管理およびユーザー・コンソールにログインし、拡張管理に移動します。

2. 拡張管理の「ようこそ」ページで、「ITリソースの管理」をクリックします。または、「構成」タブをクリックし、「リソース管理」をクリックしてから、「ITリソースの管理」を選択します。

3. Directory Server ITリソースを探します。

4. このITリソースを「検索ベース」および予約コンテナの値で更新します。
「検索ベース」の推奨値は、ルート接尾辞またはベースDN(dc=us,dc=oracle,dc=comなど)です。

5. OVDサーバーでOracle Identity Managerを構成する場合は、「サーバーURL」にOVDサーバーのホストおよびポートの詳細を入力します。
Identity Virtualization Library(libOVD)でOracle Identity Managerを構成する場合は、「サーバーURL」に値を入力しないでください。空白にする必要があります。

6. バインド資格証明の値を次のように入力します。
バインドDN: cn=oimadmin

バインド・パスワード: 1111111111

注意:

Oracle Identity Managerプロキシ・ユーザーDNは、次の形式です。

PROXY_USER,cn=system,ROOT_SUFFIX

例: cn=oimadmin,cn=system, dc=us,dc=oracle,dc=com

7. 予約コンテナの値が、cn=reserve,VALUE_OF_THE_ROOT_SUFFIXであることを確認します。次に例を示します。
予約コンテナ: cn=reserve,dc=us,dc=oracle,dc=com

6. リコンシリエーション・ジョブでは、LDAPリコンシリエーション・ジョブをシードするか、LDAPリコンシリエーション・ジョブをOracle Identity Managerスキーマの一部であるクォーツ表にロードします。これを行うには、次の手順を実行します。

1. OIM_HOME/bin/にあるpatch_weblogic.sh MDSユーティリティを使用して、LDAPリコンシリエーション・ジョブをシードします。

注意:

テキスト・エディタで、$OIM_ORACLE_HOME/server/bin/weblogic.profileファイルを開き、patch_weblogic.shスクリプトを実行する前にプロパティに値を入力します。

2. ANT_HOMEおよびJAVA_HOMEを適切に設定します。

3. $OIM_ORACLE_HOME/server/setup/deploy-files/setup.xmlのバックアップを作成します。

4. テキスト・エディタで、$OIM_ORACLE_HOME/server/setup/deploy-files/setup.xmlファイルを開きます。

5. リコンシリエーション・ジョブをシードするターゲットがデフォルトでコメント化されている場合、次のようにコメントを解除し、リコンシリエーション・ジョブをシードするためのファイルに、このターゲットのみが存在するようにします。

<target name="patch" description="This contains the list of targets to be invoked post-patching">
<antcall target="explode-archived-apps"/>
<antcall target="seed-ootb-jobs"/>
<!--antcall target="seed-ldap-recon-jobs"/--> == Uncomment this line.
<antcall target="update-oes-ootb-policies"/>
<antcall target="seed-ootb-templates"/>
<antcall target="unzip-db-deliverables-archive"/>
<!--ant antfile="${appserver.type}/setup.xml" target="patch" inheritrefs="true" /-->
</target>

リコンシリエーション・ジョブをシードするために必要なターゲットは、seed-ldap-recon-jobsです。

6. patch_weblogic.shスクリプトを実行します。

10.2 Identity Virtualization Library(libOVD)とディレクトリ・サーバーの間でのSSLの有効化

SSLのために、次の項の説明に従って、ディレクトリ・サーバーからサーバー側の証明書をエクスポートし、Identity Virtualization Library(libOVD)にインポートする必要があります。

- Identity Virtualization Library(libOVD)とMicrosoft Active Directoryの間でのSSLの有効化

- Identity Virtualization Library(libOVD)とiPlanetの間でのSSLの有効化

- Identity Virtualization Library(libOVD)とOIDの間でのSSLの有効化

10.2.1 Identity Virtualization Library(libOVD)とMicrosoft Active Directoryの間でのSSLの有効化

Active Directoryからサーバー側の証明書をエクスポートし、Identity Virtualization Library(libOVD)にインポートするには、次の手順を実行します。

1. 次のMicrosoft TechNet WebサイトURLの指示を参照して、Active Directoryサーバーから証明書をエクスポートします。
http://technet.microsoft.com/en-us/library/cc732443%28WS.10%29.aspx

http://technet.microsoft.com/en-us/library/cc772898%28WS.10%29.aspx

2. CA署名証明書を取得し、ファイルに保存します。これを行うには、次のようにします。

1. ドメイン管理者としてActive Directoryドメイン・サーバーにログインします。

2. 「スタート」、「コントロール パネル」、「管理ツール」、「証明機関」の順にクリックし、証明機関用のMicrosoft管理コンソール(MMC)を表示します。

3. CAコンピュータを右クリックし、CAのプロパティを選択します。

4. 「全般」メニューから、「証明書の表示」を選択します。

5. 「詳細」ビューを選択し、ウィンドウの右下隅にある「ファイルにコピー」をクリックします。

6. 次のコマンドを実行して、証明書のエクスポート・ウィザードを使用し、CA証明書をファイルに保存します。

certutil -ca.cert OutCACertFile

注意:

CA証明書は、DER Encoded Binary X-509形式またはBased-64 Encoded X-509形式で保存できます。

3. 次のコマンドを実行して、手順3fで作成したActive Directoryサーバー証明書を、Identity Virtualization Library(libOVD)キーストアに信頼できるエントリとしてインポートします。

$ORACLE_HOME/jdk/jre/bin/keytool -importcert -keystore $DOMAIN_HOME/config/fmwconfig/ovd/CONTEXT/keystores/adapters.jks -storepass password -alias alias -file OutCACertFile -noprompt

10.2.2 Identity Virtualization Library(libOVD)とiPlanetの間でのSSLの有効化

Identity Virtualization Library(libOVD)とiPlanet(ODSEE)の間でのSSLを有効化するために、iPlanet(ODSEE)から証明書をエクスポートしてIdentity Virtualization Library(libOVD)にインポートするには、次の手順を実行します。

1. iPlanet(ODSEE)から証明書をエクスポートするには、次のコマンドを実行します。

dsadm export-cert -o OUTPUT_FILE INSTANCE_PATH CERT_ALIAS

次に例を示します。

./dsadm export-cert -o /tmp/server-cert /scratch/aime1/iPlanet/dsInst/ defaultCert
Choose the PKCS#12 file password:
Confirm the PKCS#12 file password:

ls -lrt /tmp
-rw------- 1 aime1 svrtech 1684 Jan 20 00:39 server-cert

2. ステップ1で作成したiPlanet(ODSEE)証明書を、信頼できるエントリとしてIdentity Virtualization Library(libOVD)キーストアにインポートするには、次のコマンドを実行します。

ORACLE_HOME/jdk/jre/bin/keytool -importcert -keystore $DOMAIN_HOME/config/fmwconfig/ovd/CONTEXT/keystores/adapters.jks -storepass password -alias alias -file server-cert -noprompt

10.2.3 Identity Virtualization Library(libOVD)とOIDの間でのSSLの有効化

OIDからサーバー側の証明書をエクスポートしてIdentity Virtualization Library(libOVD)にインポートするには、次の手順を実行します。

1. 次のコマンドを使用して、Oracle Internet Directoryサーバーの証明書をBase64形式でエクスポートします。

orapki wallet export -wallet LOCATION_OF_OID_WALLET -dn DN_FOR_OID_SERVER_CERTIFICATE -cert ./b64certificate.txt

注意:

orapkiコマンドで証明書別名を使用する場合、その別名がすべて小文字でないと、エラーが生成されます。

2. 次のコマンドを使用して、ステップ2で作成したOracle Internet Directoryサーバー証明書を、Identity Virtualization Library(libOVD)キーストアに信頼できるエントリとしてインポートします。

$ORACLE_HOME/jdk/jre/bin/keytool -importcert -keystore $DOMAIN_HOME/config/fmwconfig/ovd/CONTEXT/keystores/adapters.jks -storepass password -alias alias -file OutCACertFile -noprompt

10.3 LDAP同期を有効化する前に作成したユーザーおよびロールのLDAPへのプロビジョニング

LDAPを同期していないOracle Identity Managerデプロイメントでユーザーとロールを作成した後で、LDAP同期を有効化することを決めた場合、LDAP同期を有効化する前に作成したユーザーとロールを、同期の有効化後にLDAPと同期する必要があります。LDAPに対するユーザー、ロール、ロール・メンバーシップおよびロール階層のプロビジョニングは、LDAP用に事前定義された次のスケジュール済ジョブで達成できます。

- LDAPSync Post Enable Provision Users to LDAP

- LDAPSync Post Enable Provision Roles to LDAP

- LDAPSync Post Enable Provision Role Memberships to LDAP

- LDAPSync Post Enable Provision Role Hierarchy to LDAP

これらのスケジュール済ジョブの詳細は、「事前定義済のスケジュール済タスク」を参照してください。

10.4 LDAP同期の無効化

Oracle Identity ManagerデプロイメントでLDAP同期を無効化するには、次の手順を実行します。

1. MDSユーティリティを使用して、MDSから/db/ldapMetadata/EventHandlers.xmlファイルを削除します。このXMLファイルを削除するには、weblogic.propertiesファイルまたはweblogicDeleteMetadata.batスクリプト内の次の値を変更します。

- wls_servername=OIM_SERVER_NAME(oim_server1など)

- application_name=oim
事前定義済イベント・ハンドラをインポートまたはエクスポートする場合、値はoimです。その他のデフォルト・メタデータの場合、値はOIMMetadataです。カスタム・データをインポートまたはエクスポートする場合は、常にapplicationを使用します。

- metadata_files=/metadata/user/custom/EventHandlers.xml

2. 管理者のログイン資格証明で、Oracle Identity Managerの管理およびユーザー・コンソールにログインします。

3. 「LDAP同期を有効化する前に作成したユーザーおよびロールのLDAPへのプロビジョニング」で説明しているスケジュール済ジョブすべてを無効化します。

10.5 Identity Virtualization Library(libOVD)アダプタの管理

LDAP同期が有効でAD、iPlanet(ODSEE)またはOIDがディレクトリ・サーバーであるOracle Identity Managerデプロイメントでは、WLSTコマンドを使用してIdentity Virtualization Library(libOVD)アダプタを管理します。

Virtualization Library(libOVD)を管理するには、次の手順を実行します。

1. WLSTコンソールを起動します。これを行うには、oracle_common/common/bin/wlst.shを実行します。

2. WLSTコマンドラインで、次のコマンドを実行します。

connect()

入力を求められたときに、WLSTのユーザー名、パスワードおよびt3 URLを入力します。

3. 次のコマンドを実行し、Identity Virtualization Library(libOVD)のWLSTコマンドのリストを表示します。

help('OracleLibOVDConfig')

これで、Identity Virtualization Library(libOVD)、LDAPおよび結合アダプタを作成、削除および変更するためのコマンドがリストされます。次のコマンドは、パラメータとして渡される特定のOPSSコンテキストと関連付けられているIdentity Virtualization Library(libOVD)構成で動作します。

- addJoinRule: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)の既存の結合アダプタに、結合ルールを追加します。

- addLDAPHost: 既存のLDAPアダプタに、新しいホストを追加します。

注意:

High Availability(HA)シナリオ用に複数のリモート・ホストを追加する例を次に示します。

addLDAPHost(adapterName='ldap1', host='myhost.example.domain.com', port=389, contextName='myContext')

HAの詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

- addPlugin: 既存のアダプタに、またはグローバル・レベルで、プラグインを追加します。

関連項目:

Oracle Identity Managerにおけるプラグインの開発の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのプラグインの開発に関する説明を参照してください。

- addPluginParam: 既存のアダプタ・レベルのプラグインまたはグローバル・プラグインに、新しいパラメータ値を追加します。

- createJoinAdapter: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)に、新しい結合アダプタを作成します。

- createLDAPAdapter: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)に、新しいLDAPアダプタを作成します。

- deleteAdapter: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)の、既存のアダプタを削除します。

- getAdapterDetails: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)に構成されている、既存のアダプタの詳細を表示します。

- listAdapters: 指定のOPSSコンテキストと関連付けられたこのIdentity Virtualization Library(libOVD)に構成されている、すべてのアダプタの名前とタイプをリストします。

- modifyLDAPAdapter: 既存のLDAPアダプタ構成を変更します。

- removeJoinRule: 指定のOPSSコンテキストと関連付けられたIdentity Virtualization Library(libOVD)に構成された結合アダプタから、結合ルールを削除します。

- removeLDAPHost: 既存のLDAPアダプタ構成から、リモート・ホストを削除します。

- removePlugin: 既存のアダプタから、またはグローバル・レベルで、プラグインを削除します。

- removePluginParam: 構成済のアダプタ・レベルのプラグインまたはグローバル・プラグインから、既存のパラメータを削除します。

4. 使用方法を表示するには、次のように個々のコマンドに対してhelpを実行します。

help('addPluginParam')

マルチ言語サポート(MLS)のためにoimLanguages属性のADユーザー管理アダプタを更新する例を次に示します。

- addPluginParam:
このコマンドを次のように使用して、ADユーザー・アダプタのUserManagementプラグインに、oimLanguageパラメータを追加できます。

add PluginParam(adapterName='ldap1', pluginName='UserManagement', paramKeys='oimLanguages', paramValues='fr,zh-CN', contextName='oim')

- removePluginParam:
このコマンドを次のように使用して、ADユーザー・アダプタのUserManagementプラグインから、oimLanguageパラメータを削除できます。

removePluginParam(adapterName='ldap1', pluginName='UserManagement', paramKey='oimLanguages', contextName='oim')

- removePluginParam:
このコマンドを次のように使用して、Changelogプラグインから、modifierDNFilterパラメータを削除できます。

removePluginParam(adapterName='CHANGELOG_ldap1', pluginName='Changelog', paramKey='modifierDNFilter', contextName='oim')

関連項目:

Oracle Identity Managerの変更ログおよびユーザー管理のための、OVDアダプタの作成の詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』のOracle Virtual Directoryでのアダプタの作成に関する説明を参照してください。

10.6 LDAP同期が有効な場合のLDAP認証の構成

LDAP同期が有効な場合に認証にLDAPを使用できるようにするには、次の手順を実行します。

注意:

この手順では、次の機能は有効になりません。

- 最初のログイン、管理者パスワードのリセット、期限切れパスワードなどのパスワード変更の強制

- チャレンジ・レスポンスの強制設定

1. Oracle Internet Directory (OID)に動的グループを追加します。

1. 動的グループを定義するoimusers.ldifファイルを作成します。LDIFファイルは、次のような形式にします。

dn: cn=oimusers, <group search base>
objectclass: orclDynamicGroup
objectclass: groupOfUniqueNames
labeleduri:ldap://LDAP_HOST:LDAP_PORT/<UserSearchBase>??sub?(objectclass=inetOrgPerson)

次に例を示します。

dn: cn=oimusers,cn=Groups,dc=us,dc=oracle,dc=com
objectclass: orclDynamicGroup
objectclass: groupOfUniqueNames
labeleduri: ldap://LDAP_HOST:3060/cn=Users,dc=us,dc=oracle,dc=com??sub?(objectclass=inetOrgPerson)

2. ldapaddコマンドを使用してoimusers.ldifファイルをOIDにアップロードします。コマンドは次のような形式にします。

ldapadd -h LDAP_HOST -p LDAP_PORT -D <root dn> -w <password> -f oimusers.ldif

次に例を示します。

ldapadd -h LDAP_HOST -p 3060 -D cn=orcladmin -w welcome1 -f oimusers.ldif

3. ldapsearchコマンドを使用してグループ・メンバーを検証します。コマンドは次のような形式にします。

ldapsearch -h LDAP_HOST -p LDAP_PORT -D <root dn> -w <password> -b "cn=oimusers,<groupsearchbase>" -s base "objectclass=*"

次に例を示します。

ldapsearch  -h LDAP_HOST -p 3060 -Dcn=orcladmin -wwelcome1 -b "cn=oimusers,cn=Groups,dc=us,dc=oracle,dc=com" -s base "objectclass=*"

2. WLSでLDAP認証を構成します。

1. WebLogic管理コンソールにログインします。

2. 「セキュリティ・レルム」、myrealm、「プロバイダ」に進みます。

3. 「新規」をクリックします。名前を指定し、タイプとしてOracleInternetDirectoryAuthenticatorを選択します。

4. 「制御フラグ」をSUFFICIENTに設定します。

5. 「プロバイダ固有」設定をクリックし、OID接続の詳細を設定します。

6. 「動的グループ」セクションで、次の値を入力します。
動的グループ名属性: cn

動的グループ・オブジェクト・クラス: orcldynamicgroup

動的メンバーURL属性: labeleduri

ユーザー動的グループDN属性: GroupOfUniqueNames

7. 「プロバイダ」タブをクリックし、次に「並替え」をクリックします。LDAP認証がOIM認証の前に配置されるように並び替えます。

3. すべてのサーバーを再起動します。

4. ロール・メンバーシップを検証します。

1. WebLogic管理コンソールにログインします。

2. 「セキュリティ・レルム」→myrealm→「ユーザー」→「グループ」に進みます。

3. 「ユーザー」をクリックし、LDAPユーザー検索ベースですべてのユーザーを表示します。LDAPユーザーが表示されない場合は、LDAP接続にエラーがあることを意味しており、OID認証で詳細が指定されます(プロバイダ固有の設定)。

4. 任意のユーザーをクリックし、対応するグループ・エントリを表示します。リストされるエントリにOimusersが含まれている必要があります。この検証に失敗した場合は、LDAP認証のプロバイダ固有の詳細を確認してください。

11 他のOracleコンポーネントとの統合

OracleはOracle Identity Managerで利用できる機能を補完して拡張する様々な技術を提供していますが、これらのいくつかについてこの章で説明します。Oracle Identity Managerと統合可能な技術の詳細は、Oracle Fusion Middleware統合の概要に関する説明を参照してください。図11-1に、他のOracleコンポーネントに対するOracle Identity Managerの統合を示します。

図11-1 他のコンポーネントとの統合

「図11-1 他のコンポーネントとの統合」の説明

この章では、Oracle Identity Managerと次のOracleコンポーネントとの統合について説明します。

- Oracle Access Manager

- Oracle Adaptive Access Manager

- Oracle Identity Analytics

- Oracle Identity Navigator

- Oracle Virtual Directory

- Oracle Service-Oriented Architecture

- Oracle Business Intelligence Publisher

11.1 Oracle Access Manager

Oracle Access Manager (OAM)は、フレキシブル認証とシングル・サインオン(SSO)の組合せ、アイデンティティ・フェデレーション、リスクベース認証、事前対応型の企業不正防止、きめ細かい権限付与により、アプリケーション、データおよびクラウドベースのサービスを保護します。

WebベースのSSOにより、1つの認証ステップで複数のアプリケーションに安全にアクセスできます。OAMとOracle Identity Managerを組み合わせると、OAMにより、Oracle Identity Administrationや他のOracle Identity ManagementコンポーネントでSSOを有効化できます。

Oracle Identity Manager、OAMおよびOracle Adaptive Access Manager (OAAM)は、共通のLDAP属性セットを共有し、ワークフローやその他のプロセスを管理しやすくすることで効率性を向上させます。統合されたパスワード管理により、OAM、OAAMおよびOracle Identity Managerへのログインや、期限切れおよびパスワード忘れの管理が容易になります。

統合の詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』のOIMとOAM間の統合に関する項を参照してください。

11.2 Oracle Adaptive Access Manager

OAAMは、Webベースの接続に対する洗練されたマルチファクタ認証と事前対応型のリアルタイムの不正防止機能を提供します。OAAMが提供するこのような機能の1つに、リスクベース認証があります。OAAMのリスクスコアリング・エンジンは、行われるトランザクションのタイプと不正が発生する可能性に基づいてユーザーの認証を許可するかどうかを評価し、リアルタイムでなりすましに対処します。次に、OAAMリスクスコアリング・エンジンは、パブリック・データ・ソースとプライベート・データ・ソースの組合せに基づいて作成される、動的に生成された一連の質問にユーザーがどう答えるかを評価します。その後、OAAMにより不正スコアが生成され、ユーザーはトランザクションの継続を許可されるか、またはアクセスを拒否されます。Oracle Identity Managerと統合すると、OAAMの堅牢なチャレンジ質問機能セットがOracle Identity Managerのより限定的なセットに置き換わり、パスワードの検証、格納、伝播が処理されます。

Oracle Identity ManagerをOAMおよびOAAMと統合した場合のパスワード管理の実行方法の詳細は、Oracle Fusion Middleware Oracle Access Manager統合ガイドのパスワード管理のデプロイメント・オプションに関する項を参照してください。

統合の詳細は、Oracle Fusion Middleware Oracle Access Manager統合ガイドのOracle Access Manager、Oracle Adaptive Access ManagerおよびOracle Identity Managerの統合を参照してください。

11.3 Oracle Identity Analytics

Oracle Identity Analytics (OIA)(旧称Sun Role Manager)には、ユーザー・アクセスを監視、分析、検討そして管理できる豊富なアイデンティティ分析とダッシュボードが用意されており、これらを使用して、リスク軽減、透過性の構築、そしてコンプライアンス要件の達成が実現されます。

Oracle Identity Managerと統合すると、Oracle Identity Analyticsはロールベースのアクセス管理(RBAC)フレームワーク、アテステーション・プロセスおよび職務の分離(SoD)ポリシーの実施方法を定義し、Oracle Identity Managerは自動プロビジョニングとアイデンティティ同期ソリューションとしての役割を果たします。個々のアクセス・エンタイトルメントを割り当てるかわりに、組織はRBACフレームワークを使用し、各種アプリケーションのユーザー・アクセスの制御方法としてロールを割り当てたり解除することができます。

11.3.1 Oracle Identity Analyticsにおける統合の構成

Oracle Identity Analyticsにおける統合の詳細は、次のURLにあるOracle Identity Analytics 11g R1システム・インテグレーターズ・ガイドのOracle Identity Managerとの統合で推奨される方法に関する説明を参照してください。

http://wikis.sun.com/x/iIUpDg

11.3.2 Oracle Identity Managerにおける統合の構成

Oracle Identity Managerは、ユーザー、アカウントおよびエンタイトルメントに関するデータの信頼できるソースです。したがって、統合されたデプロイメントにおいて、OIAではOracle Identity Managerからの次のデータが必要となります。

- ユーザー属性

- アカウント属性(割り当てられたエンタイトルメントを含む)

- エンタイトルメント

データ同期の要件は次のとおりです。

- OIAでは、Oracle Identity Managerからのユーザー、アカウントおよびエンタイトルメントに関する増分変更ログの更新が必要となります。

- OIAでは、非定型ベースで、Oracle Identity Managerからのエンティティ(ユーザー、アカウントおよびエンタイトルメントなど)の完全なセットが必要となります。

Oracle Identity Manager 11g リリース1(11.1.1)では、次を活用してデータ同期を実行できます。

- 構成可能な数のエンティティのデータ収集をOIAが開始するためのAPI。さらに、データ収集のステータスをOIAが取得するためのAPI。
Oracle Identity Manager APIの使用についての詳細は、Oracle Fusion Middleware Oracle Identity Manager向けJava APIリファレンス、およびOracle Fusion Middleware Oracle Identity Manager開発者ガイドのAPIの使用に関する説明を参照してください。

- Oracle Identity Managerのトランザクション表からステージング表へのデータ収集を実行するストアド・プロシージャ。

この項では、次のトピックを活用したデータ収集プロセスについて説明します。

- DataCollectionOperationsIntf APIインタフェース

- ステージング表

- データ収集プロセス

11.3.2.1 DataCollectionOperationsIntf APIインタフェース

DataCollectionOperationsIntf APIインタフェースでは、次のAPIが提供されます。

- void startDataCollection(String sessionID, Map entities): このAPIは、単一セッションのデータ収集プロセスを開始します。パラメータは次のとおりです。

- sessionID: 特定のセッションを識別する一意の文字列。単一のデータ収集セッションの一部を形成するAPIを繰り返し起動するときは、この文字列が同一である必要があります。

- entities: データ収集を実行するすべてのエンティティおよび開始日を含むMap。ユーザーおよびエンタイトルメントという2つの静的エンティティがあります。残りはOracle Identity Managerにおけるリソース・オブジェクト名になります。エンティティまたはリソース・オブジェクト名が見つからない場合、それらは無視され、データ収集は実行されません。Map内の値は、タイムスタンプを表すjava.util.Dateオブジェクトです。この値がNULLの場合、そのエンティティのすべてのデータが移入されます。データがNULL以外の場合、その日付以降に変更されたエンティティのステージング表にデータが移入されます。

- String checkStatus(String sessionID): このAPIは、指定されたデータ収集セッションのステータスをチェックします。このAPIは、次のステータスを戻します。

- INITIATED

- IN PROGRESS

- COMPLETED

- FAILED

- FINALIZED

- void finalizeSession(String sessionID): このAPIは、ステージング表の切捨ておよびその他のクリーンアップ・アクティビティを実施し、データ収集セッションを終了します。

11.3.2.2 ステージング表

Oracle Identity Managerは、特定の表を介して、OIAにユーザー、アカウントおよびエンタイトルメントを作成します。これらはステージング表と呼ばれ、DataCollectionOperationsIntfインタフェース内のAPIを使用して、オンデマンドで移入できます。次のステージング表に移入できます。

- staging_users_table: ユーザー・プロファイル属性用のステージング表

- staging_user_extended_props: カスタムのユーザー定義フィールド用のステージング表

- staging_entitlements: エンタイトルメント情報用のステージング表

- staging_accounts: アカウント情報用のステージング表

- staging_account_attributes: 親フォームおよび子フォームのデータを含むアカウント属性用のステージング表

11.3.2.3 データ収集プロセス

データ収集の手順を次に示します。

1. startDataCollection() APIを適切なセッションID、および開始日を持つエンティティを使用して起動します。開始日がNULLの場合、Oracle Identity Managerはステージング表にすべてのデータを移入するように指示されます。

2. getDataCollectionStatus() APIを同じセッションIDで実行し、Oracle Identity Managerをポーリングします。

3. getDataCollectionStatus() APIからCOMPLETEDステータスが戻されると、OIAプロセスはデータをステージング表から直接読み取ることができます。

4. データ同期が完了した後で、finalizeDataCollectionSession() APIを同じセッションIDで実行し、データ収集セッションを終了します。

5. データ収集でエラーが発生した場合は、Oracle Identity ManagerによりFAILEDステータスでそのことが示されます。これが発生したときは、データ収集セッションを再開する必要があります。finalizeDataCollectionSession() APIを使用して現在のセッションを終了し、新しいセッションIDでstartDataCollection()を実行することで、データ収集セッションを再開できます。

11.4 Oracle Identity Navigator

Oracle Identity Navigator(OIN)は、Oracle Identity Managementコンポーネントのスタート地点として機能するよう設計されているブラウザベースの管理ポータルです。これは、個々のコンポーネント・コンソールにかわるものではありません。1つのサイトからOracle Identity Managementの各コンソールにアクセスできるようにするためのものです。

Oracle Identity Managerと統合されると、Oracle Identity AdministrationにかわってOINが、Oracle Identity Managerの主要ユーザー・インタフェースとなります。

OINには製品検出機能があり、これを使用して、Oracle Identity Administrationを含むドメイン内のアクティブなJ2EEコンポーネントをすべて検出できます。

統合の詳細は、Oracle Fusion Middleware Oracle Identity Navigator管理者ガイドの製品検出を使用した製品ランチャーへのコンポーネント・リンクの追加に関する項を参照してください。

11.5 Oracle Virtual Directory

Oracle Identity ManagerをLDAPとともにインストールした場合は、Oracle Virtual Directory (OVD)をインストールする必要があります。OVDは複数のエンタープライズ・ディレクトリに接続し、そのディレクトリの内容を1つのビューにまとめて表示します。たとえば、Oracle Internet Directory (OID)、iPlanetおよびActive Directoryを使用している企業の場合、OVDは3つのディレクトリすべてを結合した統合ビューを作成できます。その後、Oracle Identity Managerは単一のコネクタを使用して、OVD上で統合されたLDAPデータにアクセスできます。LDAP Syncプロバイダ(LDAPプロバイダとも呼ばれる)は、Oracle Identity ManagerとOVDを接続します。

OVDをOracle Identity Managerと統合すると、次の利点があります。

- Oracle Identity Managerのコネクタ管理が簡易化され、複数のディレクトリ・プロバイダに対して1つのLDAPコネクタだけですみます。(ただし、複数のインスタンスが必要になる場合もあります)

- LDAPコネクタの信頼性が向上しました。基礎となるLDAPサーバーにかかわらず、同じコネクタが使用されます。OVDは、以前は複数のLDAPプロバイダに対して複数のLDAPコネクタを必要としていたデータ変換を処理します。

- すべてのFusion Middlewareアプリケーションに同じアイデンティティ仮想機能が提供されるため、企業内のコンポーネント全体でのフットプリントは削減されます。

統合の詳細は、Oracle Identity ManagerとOracle Virtual Directoryを様々な環境で統合するための複数の手順が含まれている『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』を参照してください。

OVDの以前のリリースは、Blocking IO(BIO)モードでインストールされます。OVDの現在のリリースは、デフォルトで、Non Blocking IO(NIO)モードでインストールされます。ただし、Oracle Identity Managerは、NIOモードでの動作が保証されていません。したがって、NIOモードのOVDで動作するように、Oracle Identity ManagerにおけるOVD接続管理を変更する必要があります。

また、OVDの現在のリリースは、複数の変更ログをサポートするように機能強化されています。これらの機能強化により、OVD Changlogアダプタ・パラメータを変更する必要があります。

Oracle Identity Managerの変更ログおよびユーザー管理向けのOVDアダプタ作成の詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』のOracle Virtual Directoryでのアダプタの作成に関する説明を参照してください。

11.6 Oracle Service-Oriented Architecture

Oracle Identity Managerのワークフロー機能は、Oracle Service-Oriented Architecture (SOA)バックエンド・サービスと管理機能を使用して、ユーザー・アクセスを要求、承認および管理する相互作用環境を提供しています。Oracle Identity Managerをインストールするには、Oracle SOAもインストールする必要があります。

Oracle Identity Managerでは、次のSOA Suiteコンポーネントが使用されます。

- BPEL Process Manager: ビジネス・プロセスの作成と管理において、エンドツーエンドのソリューションを提供します。

- ヒューマン・ワークフロー: 作成、割り当て、締切り、期限切れ、通知などのヒューマン・タスクのライフサイクルを管理します。

- Oracle Business Rules: 複雑なビジネス・ルールを定義して、リクエスト割当て、プロセス選択および承認者の決議をサポートします。

- Oracle Web Services Manager: Oracle Identity Managerによって使用され、呼び出されるWebサービスとBPELプロセスの安全を確保します。

統合の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのOracle SOA Suiteとの統合に関する項を参照してください。

11.7 Oracle Business Intelligence Publisher

Oracle Identity Managerレポート機能はOracle Business Intelligence Publisher (BI Publisher)を利用して高品質のレポート機能を提供し、マルチチャネル環境で複雑なレポートを作成、デプロイし、使用できるようにします。

BI Publisherの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのレポート機能の使用に関する項を参照してください。

12 ライフサイクル管理変更の処理

Oracle Identity ManagerをOracle Access Manager (OAM)などの他のアプリケーションと統合してデプロイし、これらのアプリケーションで構成変更を行うと、Oracle Identity ManagerやOracle WebLogic Serverでさまざまな構成変更が必要になります。次の項では、これらの構成変更について説明します。

- Oracle Identity Managerに関連するURL変更

- Oracle Identity Managerに関連するパスワード変更

- Oracle Identity ManagerのSSLの構成

12.1 Oracle Identity Managerに関連するURL変更

Oracle Identity Mangerでは、構造上およびミドルウェアの要件により、さまざまなホスト名とポートが構成に使用されています。この項では、統合された依存アプリケーションでの変更に対応して、Oracle Identity ManagerおよびOracle WebLogic Serverで構成変更を行う方法について説明します。

この項の内容は次のとおりです。

- Oracle Identity Managerのデータベース・ホストとポートの変更

- Oracle Virtual Directoryのホストとポートの変更

- Oracle Identity Managerのホストとポートの変更

- BI Publisherのホストとポートの変更

- SOAのホストとポートの変更

- OAMのホストとポートの変更

12.1.1 Oracle Identity Managerデータベースのホストとポートの変更

この項では、データベースのホスト名とポート番号が使用される構成エリアについて説明します。

Oracle Identity Managerのインストール後に、データベースのホスト名またはポート番号を変更した場合は、次の変更が必要になります。

注意:

データベースのホストおよびポートを変更する前に、Oracle Identity Managerをホストする管理対象サーバーを停止してください。ただし、Oracle WebLogic管理サーバーは稼動したままでかまいません。

- データソースoimJMSStoreDSの構成を変更するには:

1. 「サービス」→「JDBC」→「データソース」→oimJMSStoreDSに移動します。

2. 「接続プール」タブをクリックします。

3. データベースのホストとポートの変更に合わせて、URLと「プロパティ」フィールドの値を変更します。

- データソースoimOperationsDBの構成を変更するには:

1. 「サービス」→「JDBC」→「データソース」→oimOperationsDBに移動します。

2. 「接続プール」タブをクリックします。

3. データベースのホストとポートの変更に合わせて、URLと「プロパティ」フィールドの値を変更します。

- Oracle Identity Managerのメタデータ・ストア(MDS)構成に関連するデータソースを変更するには:

1. 「サービス」→「JDBC」→「データソース」→mds-oimに移動します。

2. 「接続プール」タブをクリックします。

3. データベースのホストとポートの変更に合わせて、URLと「プロパティ」フィールドの値を変更します。

- OIMAuthenticationProviderの構成を変更するには:

1. WebLogic管理コンソールで、「セキュリティ・レルム」→「myrealm」→「プロバイダ」に移動します。

2. 「OIMAuthenticationProvider」をクリックします。

3. 「プロバイダ固有」をクリックします。

4. ホスト名とポートの変更に合わせて、DBUrlフィールドの値を変更します。

注意:

サービス指向アーキテクチャ(SOA)やOracle Web Services Manager (OWSM)で構成変更を行うと、SOAまたはOWSMに関連するデータソースにも同様の変更を行う必要があります。

データソースの変更後、Oracle WebLogic管理サーバーを再起動し、Oracle Identity Managerの管理対象WebLogicサーバーを起動します。

注意:

Enterprise Management(EM)コンソールからOIM App Config MBeansを使用してOracle Identity Managerアプリケーションの構成情報を変更する場合は、少なくとも1つのOracle Identity Manager管理対象サーバーが稼動している必要があります。稼動していない場合、EMコンソールからOIM App Config MBeansを確認できません。

- DirectDBの構成を変更するには:

1. 次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「アプリケーション定義のMBeans」の下の「システムMBeanブラウザ」に移動します。

4. 「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DirectDBConfig」→「DirectDB」に移動します。

5. ホストとポートの変更に合わせてURL属性に新しい値を入力し、変更を適用します。

注意:

Oracle Identity Managerの単一インスタンスのデプロイメントをOracle Real Application Clusters (Oracle RAC)に変更する場合、またはOracle RACを単一インスタンスのデプロイメントに変更する場合は、oimJMSStoreDS、 oimOperationsDBおよびmds-oimデータソースを変更してください。これらのデータソースをマルチデータソース構成に変更するための一般的な変更に加えて、OIMAuthenticationProviderとドメイン資格証明ストア構成をOracle RACのURLに合わせて変更してください。これらの一般的な変更の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

12.1.2 Oracle Virtual Directoryのホストとポートの変更

LDAP同期が有効な場合、Oracle Identity Managerは、Oracle Virtual Directory (OVD)を介してディレクトリ・サーバーに接続します。この接続は、LDAP/LDAPSプロトコルを使用して行われます。

OVDのホストとポートを変更するには:

1. Oracle Identity Manager管理にログインします。

2. 「拡張」をクリックします。

3. 「構成」の下の「ITリソースの管理」をクリックします。

4. 「ITリソース・タイプ」リストから「ディレクトリ・サーバー」を選択し、「検索」をクリックします。

5. ディレクトリ・サーバーのITリソースを編集します。これを行うには、次のようにします。

1. 「SSLの使用」フィールドの値がFalseに設定されている場合は、サーバーURLフィールドを編集します。「SSLの使用」フィールドの値がTrueに設定されている場合は、サーバーSSLのURLフィールドを編集します。

2. 「更新」をクリックします。

12.1.3 Oracle Identity Managerのホストとポートの変更

この項の内容は次のとおりです。

- Oracle Identity Manager構成のOimFrontEndURLの変更

- Oracle Identity Manager構成のbackOfficeURLの変更

注意:

Oracle Identity Managerの追加ノードを追加または削除する場合は、この項で説明する手順を実行して、Oracle Identity Managerのホストとポートの変更を構成してください。

12.1.3.1 Oracle Identity Manager構成のOimFrontEndURLの変更

OimFrontEndURLは、Oracle Identity Manager UIにアクセスするために使用するURLです。これは、アプリケーション・サーバーでロード・バランサまたはWebサーバーが使用されている場合は、それに応じてロード・バランサURLまたはWebサーバーURL、そうでない場合は単一アプリケーション・サーバーURLです。これはOracle Identity Managerによって、通知メールやSOA呼び出しのコールバックURLに使用されます。

クラスタ環境でのOracle Identity ManagerデプロイメントのWebサーバー用ホスト名またはポートの変更、または非クラスタ環境でのOracle Identity ManagerデプロイメントのWebLogic管理対象サーバー用ホスト名またはポートの変更により、変更が必要になる場合があります。

Oracle Identity Manager構成のOimFronEndURLを変更するには:

1. WebLogic管理サーバーとOracle Identity Manager管理対象サーバー(クラスタ化デプロイメントの場合は少なくとも1つのサーバー)が稼動しているときに、次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「システムMBeanブラウザ」に移動します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DiscoveryConfig」→「検出」に移動します。

5. OimFrontEndURL属性に新しい値を入力し、「適用」をクリックして変更を保存します。たとえば次のような値を入力できます。
http://myoim.oracle.com

https://myoim.oracle.com

http://myserver.oracle.com:7001

注意:

SPMLクライアントには、SPMLの起動とコールバック・レスポンスの送信用にOracle Identity Manager URLが格納されています。そのため、これに対応した変更が必要になります。また、Oracle Identity ManagerがOAM、OAAMやOracle Identity Navigator (OIN)と統合されている場合は、これに対応した変更が必要になる場合もあります。詳細は、Oracle Technology Network (OTN) WebサイトにあるOAM、OAAMおよびOINのドキュメントを参照してください。

12.1.3.2 Oracle Identity Manager構成のbackOfficeURLの変更

backOfficeURLの変更は、Oracle Identity Managerがフロントオフィス構成およびバックオフィス構成にデプロイされる場合のみ必要になります。この変更は、単純なクラスタ化デプロイメントまたは非クラスタ化デプロイメントには適用されません。このURLは、フロントオフィス・コンポーネントからバックオフィス・コンポーネントにアクセスするために、Oracle Identity Managerで内部的に使用されます。バックオフィスにサーバーを追加する場合や、バックオフィスからサーバーを削除する場合は、バックオフィス構成およびフロントオフィス構成の実装中にこの属性の値を変更します。

backOfficeURL属性の値を変更するには:

1. WebLogic管理サーバーとOracle Identity Manager管理対象サーバー(クラスタ化デプロイメントの場合は少なくとも1つのサーバー)が稼動しているときに、次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「システムMBeanブラウザ」に移動します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DiscoveryConfig」→「検出」に移動します。

5. BackOfficeURL属性に新しい値を入力し、「適用」をクリックして変更を保存します。たとえば次のような値を入力できます。
t3://mywls1.oracle.com:8001

t3://mywls1.oracle.com:8001,mywls2.oracle.com:9001

注意:

Oracle Identity Managerの非クラスタ化およびクラスタ化デプロイメントでは、BackOfficeURL属性の値を空にする必要があります。

12.1.4 BI Publisherのホストとポートの変更

Oracle Identity Manager管理コンソールまたはユーザー・コンソールから単純なリンクをクリックすると、BI Publisherにレポート目的でアクセスできます。このURLは、Oracle Identity Manager側の構成値に基づいたものです。BI Publisherでホストとポートが変更されると、Oracle Identity Managerで次の変更を行う必要があります。

1. WebLogic管理サーバーとOracle Identity Manager管理対象サーバー(クラスタ化デプロイメントの場合は少なくとも1つのサーバー)が稼動しているときに、次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「システムMBeanブラウザ」に移動します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DiscoveryConfig」→「検出」に移動します。

5. BIPublisherURL属性に新しい値を入力し、「適用」をクリックして変更を保存します。

12.1.5 SOAのホストとポートの変更

SOAのホストとポートを変更するには:

注意:

追加のSOAノードを追加または削除したときには、この手順を実行してSOAのホストとポートを変更してください。

1. WebLogic管理サーバーとOracle Identity Manager管理対象サーバー(クラスタ化デプロイメントの場合は少なくとも1つのサーバー)が稼動しているときに、次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「システムMBeanブラウザ」に移動します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.SOAConfig」→「SOAConfig」に移動します。

5. Rmiurl属性とSoapurl属性の値を変更し、「適用」をクリックして変更を保存します。
Rmiurl属性は、SOA管理対象サーバーにデプロイされたSOA EJBにアクセスするために使用されます。これは、アプリケーション・サーバーのURLです。Oracle Identity Managerのクラスタ化デプロイメントの場合は、すべてのSOA管理対象サーバーURLのカンマ区切りのリストです。この属性の値は、たとえば次のようになります。

t3://mysoa1.oracle.com:8001

t3s://mysoa1.oracle.com:8001,mysoa2.oracle.com:8002

t3://mysoa1.oracle.com:8001,mysoa2.oracle.com:8002,mysoa3.oracle.com:8003

Soapurl属性は、SOA管理対象サーバーにデプロイされたSOA Webサービスにアクセスするために使用されます。これは、Webサーバーおよびロード・バランサをフロントエンドに使用するSOAクラスタの場合は、WebサーバーURLおよびロード・バランサURLです。単一SOAサーバーの場合は、アプリケーション・サーバーURLです。

この属性の値は、たとえば次のようになります。

http://myoimsoa.oracle.com

http://mysoa.oracle.com:8001

12.1.6 OAMのホストとポートの変更

OAMのホストとポートを変更するには:

1. WebLogic管理サーバーとOracle Identity Manager管理対象サーバー(クラスタ化デプロイメントの場合は少なくとも1つのサーバー)が稼動しているときに、次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「Identity and Access」→「OIM」に移動します。

3. 「OIM」を右クリックし、「システムMBeanブラウザ」に移動します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.SSOConfig」→「SSOConfig」に移動します。

5. 必要に応じて、AccessServerHost属性とAccessServerPort属性およびその他の属性の値を変更し、「適用」をクリックして変更を保存します。

12.2 Oracle Identity Managerに関連するパスワード変更

Oracle Identity Manger構成では、構造上の要件やミドルウェア要件を満たすために、さまざまなパスワードが使用されます。この項では、デフォルトのパスワードと、依存製品または統合された製品でパスワードが変更された場合の、Oracle Identity MangerおよびOracle WebLogic構成のパスワードの変更方法について説明します。

この項の内容は次のとおりです。

- Oracle WebLogic管理者パスワードの変更

- Oracle Identity Manager管理者パスワードの変更

- Oracle Identity Managerデータベース・パスワードの変更

- 資格証明ストア・フレームワークのOracle Identity Managerパスワードの変更

- OVDパスワードの変更

12.2.1 Oracle WebLogic管理者パスワードの変更

Oracle WebLogic管理者パスワードを変更するには:

1. WebLogic管理コンソールにログインします。

2. 「セキュリティ・レルム」→「myrealm」→「ユーザーとグループ」→「weblogic」→「パスワード」に移動します。

3. 「新規パスワード」フィールドに、新しいパスワードを入力します。

4. 「新規パスワードの確認」フィールドに、新しいパスワードを再入力します。

5. 「適用」をクリックします。

12.2.2 Oracle Identity Manager管理者パスワードの変更

Oracle Identity Managerのインストール中に、インストーラによりOracle Identity Managerの管理者パスワードの入力を求められます。この管理者パスワードは、必要に応じてインストール完了後に変更できます。変更するには、Oracle Identity Managerセルフ・サービスにOracle Identity Manager管理者としてログインする必要があります。管理者パスワードの変更方法については、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの認証ユーザーのセルフ・サービスに関する項を参照してください。

注意:

OAMまたはOAAMがOracle Identity Managerに統合されている場合は、これらのアプリケーションで対応する変更を行う必要があります。詳細は、次のURLのOracle Technology Network (OTN) WebサイトにあるOAMおよびOAAMのドキュメントを参照してください。

http://www.oracle.com/technetwork/indexes/documentation/index.html

12.2.3 Oracle Identity Managerデータベース・パスワードの変更

Oracle Identity Managerは、2つのデータベース・スキーマを使用して、Oracle Identity Managerの操作および構成データを格納します。Oracle Identity Manager MDSスキーマを使用して構成関係の情報を格納し、Oracle Identity Managerスキーマを使用してその他の情報を格納します。スキーマ・パスワードを変更すると、Oracle Identity Manager構成も変更する必要があります。

Oracle Identity Managerデータベース・パスワードを変更すると、次の変更を行う必要があります。

注意:

データベース・パスワードを変更する前に、Oracle Identity Managerをホストする管理対象サーバーを停止してください。ただし、Oracle WebLogic管理サーバーは稼動したままでかまいません。

- データソースoimJMSStoreDSの構成を変更するには:

1. 「サービス」→「JDBC」→「データソース」→「oimJMSStoreDS」に移動します。

2. 「接続プール」タブをクリックします。

3. 「パスワード」および「パスワードの確認」フィールドに、Oracle Identity Managerデータベース・スキーマの新しいパスワードを入力します。

4. 「保存」をクリックして変更を保存します。

- データソースoimOperationsDBの構成を変更するには:

1. 「サービス」→「JDBC」→「データソース」→「oimJMSStoreDS」に移動します。

2. 「接続プール」タブをクリックします。

3. 「パスワード」および「パスワードの確認」フィールドに、Oracle Identity Managerデータベース・スキーマの新しいパスワードを入力します。

4. 「保存」をクリックして変更を保存します。

- Oracle Identity Manager MDSに関連するデータソースの構成を変更するには:

1. 「サービス」→「JDBC」→「データソース」→「mds-oim」に移動します。

2. 「接続プール」タブをクリックします。

3. 「パスワード」および「パスワードの確認」フィールドに、Oracle Identity Manager MDSデータベース・スキーマの新しいパスワードを入力します。

4. 「保存」をクリックして変更を保存します。

注意:

- Oracle Real Application Clusters (Oracle RAC)構成を使用したOracle Identity Managerのデプロイメントでは、各マルチデータソース構成の下にあるすべてのデータソースを変更する必要があります。

- SOAまたはOWSMに関連するデータソースでも、必要に応じて同様の変更を行ってください。

- OIMAuthenticationProviderの構成を変更するには:

1. WebLogic管理コンソールで、「セキュリティ・レルム」→「myrealm」→「プロバイダ」に移動します。

2. 「OIMAuthenticationProvider」をクリックします。

3. 「プロバイダ固有」をクリックします。

4. 「DBPassword」フィールドに、Oracle Identity Managerデータベース・スキーマの新しいパスワードを入力します。

5. 「保存」をクリックして変更を保存します。

- ドメインの資格証明ストアの構成を変更するには:

1. 次のURLを使用してEnterprise Managerにログインします。
http://ADMIN_SERVER/em

2. 「WebLogicドメイン」→DOMAIN_NAMEに移動します。

3. 「OIM」を右クリックし、「セキュリティ」→「資格証明」→「OIM」に移動します。

4. 「OIMSchemaPassword」を選択し、「編集」をクリックします。

5. 「パスワード」フィールドに新しいパスワードを入力し、「OK」をクリックします。

Oracle Identity Managerデータベース・パスワードを変更したら、WebLogic管理サーバーを再起動します。またOracle Identity managerが管理するWebLogicサーバーも同様に起動します。

12.2.4 資格証明ストア・フレームワークのOracle Identity Managerパスワードの変更

インストール・プロセスでは、Oracle Identity Managerインストーラによって複数のパスワードが格納されます。資格証明ストア・フレームワーク(CSF)にはさまざまな値がキーおよび値として格納されています。表12-1にキーとその対応する値を示します。

表12-1 CSFキー

キー

説明

DataBaseKey

データベースの暗号化に使用されるキーのパスワード。パスワードは、インストーラでOracle Identity Managerキーストアに入力されたユーザー入力値です。

.xldatabasekey

データベース暗号化キーを格納するキーストアのパスワード。パスワードは、インストーラでOracle Identity Managerキーストアに入力されたユーザー入力値です。

xell

xellキーのパスワードで、Oracle Identity Manager コンポーネント間の通信を保護するために使用されます。Oracle Identity Managerインストーラによって生成されるデフォルトのパスワードは、xellerateです。

default_keystore.jks

JKSキーストアdefault_keystore.jksのパスワードで、DOMAIN_HOME/config/fmwconfig/ディレクトリにあります。パスワードは、インストーラでOracle Identity Managerキーストアに入力されたユーザー入力値です。

SOAAdminPassword

パスワードはインストーラで「SOA管理者パスワード」フィールドに入力されたユーザー入力値です。

OIMSchemaPassword

Oracle Identity Managerデータベース・スキーマに接続するためのパスワードです。パスワードはインストーラで「OIMデータベース・スキーマのパスワード」フィールドに入力されたユーザー入力値です。

JMSKey

パスワードは、インストーラでOracle Identity Managerキーストアに入力されたユーザー入力値です。

CSFキーの値を変更するには:

1. Enterprise Managerにログインします。

2. ドメインを右クリックします。

3. 「セキュリティ」→「資格証明」に移動します。

4. 「OIM」を展開します。Oracle Identity Managerのキーと値のすべてのペアのリストが表示されます。この値を編集して変更できます。

12.2.5 OVDパスワードの変更

OVDパスワードを変更するには:

1. Oracle Identity Manager管理にログインします。

2. 「拡張」をクリックします。

3. 「構成」の下の「ITリソースの管理」をクリックします。

4. 「ITリソース・タイプ」リストから「ディレクトリ・サーバー」を選択します。

5. 「検索」をクリックします。

6. ディレクトリ・サーバーのITリソースを編集します。これを行うには、「管理者パスワード」フィールドに新しいOVDパスワードを入力し、「更新」をクリックします。

12.3 Oracle Identity ManagerのSSLの構成

この項では、Oracle Identity Manager、およびOracle Identity Managerが相互作用して安全な通信を確立するコンポーネントの鍵の生成、証明書への署名およびエクスポート、SSL構成の設定について手順を説明します。内容は次のとおりです。

- 鍵の生成

- 証明書への署名

- 証明書のエクスポート

- 証明書のインポート

- Oracle Identity ManagerおよびSOAサーバーのSSLの有効化

- Oracle Identity Manager DBのSSLの有効化

- LDAP同期のSSLの有効化

12.3.1 鍵の生成

keytoolコマンドを使用して、秘密と公開の証明書のペアを生成できます。

次のコマンドでは、アイデンティティ・キーストア(support.jks)が作成されます。

注意:

keytoolコマンドに渡すパラメータ値は、個別の要件に応じて変更してください。keytoolの引数には改行が含まれないようにしてください。

keytool -genkey
-alias support
-keyalg RSA
-keysize 1024
-dname "CN=localhost, OU=Identity, O=Oracle Corporation,C=US"
-keypass weblogic1
-keystore support.jks
-storepass weblogic1

12.3.2 証明書への署名

作成した証明書に署名するには、次のkeytoolコマンドを使用します。

注意:

keytoolコマンドに渡すパラメータ値は、個別の要件に応じて変更してください。keytoolの引数には改行が含まれないようにしてください。

./keytool -selfcert -alias support
-sigalg MD5withRSA -validity 2000 -keypass weblogic1
-keystore support.jks
-storepass weblogic1

12.3.3 証明書のエクスポート

証明書をアイデンティティ・キーストアからファイル(supportcert.pemなど)にエクスポートするには、次のkeytoolコマンドを使用します。

./keytool -export -alias support
-file supportcert.pem
-keypass weblogic1
-keystore support.jks
-storepass weblogic1

12.3.4 証明書のインポート

証明書をファイル(wlservercert.pemなど)からアイデンティティ・キーストアにインポートするには、次のkeytoolコマンドを使用します。

keytool -import -alias serverwl -trustcacerts -file D:\bea\user_projects\domains\mydomain\wlservercert.pem
-keystore CLIENT_TRUST_STORE -storepass CLIENT_TRUST_STORE_PASSWORD

12.3.5 Oracle Identity ManagerおよびSOAサーバーのSSLの有効化

SSLを有効化するには、Oracle Identity ManagerおよびSOAサーバーで次の構成を実行する必要があります。

- デフォルト設定を使用したOracle Identity ManagerのSSLの有効化

- カスタム・キーストアを使用したOracle Identity ManagerのSSLの有効化

- OimFrontEndURLをSSLポートを使用するように変更

- backOfficeURLをSSLポートを使用するように変更

- SOAサーバーURLをSSLポートを使用するように変更

- Design ConsoleのSSLの構成

- Oracle Identity Manager ユーティリティのSSLの構成

- MDSユーティリティのSSLの構成

- SPML/コールバック・ドメインのSSLの構成

12.3.5.1 Oracle Identity ManagerのSSLの有効化

Oracle Identity ManagerのSSLの有効化について、次の各項で説明します。

- デフォルト設定を使用したOracle Identity ManagerのSSLの有効化

- カスタム・キーストアを使用したOracle Identity ManagerのSSLの有効化

12.3.5.1.1 デフォルト設定を使用したOracle Identity ManagerのSSLの有効化

デフォルト設定を使用してOracle Identity ManagerおよびSOAサーバーのSSLを有効化するには、次の手順を実行します。

1. WebLogic Server管理コンソールにログインし、「サーバー」→「OIM_SERVER1」→「一般」に移動します。「一般」セクションで、SSLポートに任意の値を設定して有効化できます。

2. サーバーはリスニングを開始し、HTTPSプロトコルを使用してURLにアクセスできるようになります。

3. Oracle Identity ManagerはSSLが有効化されたSOAサーバーと相互作用する必要があるため、管理サーバーおよびSOAサーバーで同じ手順を実行します。

12.3.5.1.2 カスタム・キーストアを使用したOracle Identity ManagerのSSLの有効化

カスタム・キーストアを使用してOracle Identity ManagerのSSLを有効化するには、次の手順を実行します。

注意:

- keytoolコマンドに渡すパラメータ値は、個別の要件に応じて変更してください。keytoolの引数には改行が含まれないようにしてください。

- カスタム・キーの生成の詳細は、「鍵の生成」を参照してください。

1. WebLogic Server管理コンソールで、「環境」→「サーバー」→Server_Name (OIM_Server1)→「構成」をクリックし、「一般」をクリックします。

2. 「ロックして編集」をクリックします。

3. 「SSLリスニング・ポートの有効化」を選択します。デフォルトのポートは14001です。

4. 「キーストア」タブを選択します。

5. 「キーストア」リストから、「カスタムIDとJava標準信頼」を選択します。

6. 「カスタムIDキーストア」フィールドに、カスタムIDキーストア・ファイル名の絶対パスを入力します。次に例を示します。
DOMAIN_HOME/config/fmwconfig/support.jks

7. カスタムIDキーストア・タイプとして、JKSを指定します。

8. 「カスタムIDキーストアのパスフレーズ」および「カスタムIDキーストアのパスフレーズを確認」のフィールドにパスワード(weblogic1)を入力します。

9. 「保存」をクリックします。

10. 「SSL」タブをクリックします。

11. 秘密鍵のエイリアスとして、supportと入力します。

12. 「秘密鍵のパスフレーズ」および「秘密鍵のパスフレーズを確認」のフィールドにパスワード(weblogic1)を入力します。

13. 「保存」をクリックします。

14. 「変更のアクティブ化」をクリックします。

15. 変更内容を有効にするためにすべてのサーバーを再起動します。

16. 「証明書のエクスポート」でエクスポートした証明書をSPMLクライアントのトラストストアにインポートします。
証明書のインポートの詳細は、「証明書のインポート」を参照してください。

Oracle Identity ManagerとSOAサーバーでSSLを有効にした後、これらの間での安全な通信を確立するために、次の変更を行います。

- OimFrontEndURLをSSLポートを使用するように変更

- backOfficeURLをSSLポートを使用するように変更

- SOAサーバーURLをSSLポートを使用するように変更

12.3.5.2 OimFrontEndURLをSSLポートを使用するように変更

OimFrontEndURLは、oimアプリケーションのUIへのアクセスに使用されます。これはロード・バランサURLかWebサーバーURL (アプリケーション・サーバーでロード・バランサまたはWebサーバーが使用されている場合)、または単一アプリケーション・サーバーURLになります。これは、通常、Oracle Identity Managerによって、通知メール、またはSOAからOracle Identity ManagerへのコールバックWebサービスの送信に使用されます。

OimFrontEndURLをSSLポートを使用するように変更するには:

1. WebLogic管理サーバーおよびOracle Identity Manager管理対象サーバー(クラスタの場合は少なくとも1つのサーバー)が稼動しているときに、Enterprise Manager (EM)にログインします。
次に例を示します。

http://<AdminServer>/em

2. 「Identity and Access」→「Oracle Identity Manager」に移動します。

3. 右クリックして「システムMBeanブラウザ」を選択します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DiscoveryConfig」→「検出」に移動します。

5. OimFrontEndURL属性に新しい値を入力し、「適用」をクリックして変更を保存します。
次に例を示します。

http://myoim.oracle.com

https://myoim.oracle.com

http://myserver.oracle.com:7001

注意:

Fusion AppsやSPMLクライアントには、SPMLの起動やコールバック・レスポンスの送信のために、Oracle Identity Manager URLが格納されています。そのため、これに対応する変更が必要になります。また、Oracle Identity ManagerにOAM/OAAM/OINが統合されている場合は、これに対応する変更も必要になります。他のコンポーネントとの統合の詳細は、第11章「他のOracleコンポーネントとの統合」を参照してください。

12.3.5.3 backOfficeURLをSSLポートを使用するように変更

backOfficeURLを変更する必要があるのは、Oracle Identity Managerがフロントオフィス/バックオフィス構成でデプロイされている場合のみです。単純なクラスタまたは非クラスタ・インストールの場合は、次の内容は適用されません。このURLは、フロントオフィス・コンポーネントからバックオフィス・コンポーネントにアクセスするために、Oracle Identity Managerで内部的に使用されます。バックオフィスにサービスを追加したり、バックオフィスからサービスを削除するには、バックオフィス/フロントオフィス構成の実装中にこの値を内部的に変更する必要があります。

backOfficeURLをSSLポートを使用するように変更するには:

1. WebLogic管理サーバーおよびOracle Identity Manager管理対象サーバー(クラスタの場合は少なくとも1つのサーバー)が稼動しているときに、Enterprise Manager (EM)にログインします。
次に例を示します。

http://<AdminServer>/em

2. 「Identity and Access」→「Oracle Identity Manager」に移動します。

3. 右クリックして「システムMBeanブラウザ」を選択します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→「構成」→「XMLConfig.DiscoveryConfig」→「検出」に移動します。

5. backOfficeURL属性に新しい値を入力し、「適用」をクリックして変更を保存します。
次に例を示します。

t3://mywls1.oracle.com:8001

t3://mywls1.oracle.com:8001,mywls2.oracle.com:9001

注意:

単純なクラスタおよび非クラスタ・インストールの場合は、値は空にする必要があります。

12.3.5.4 SOAサーバーURLをSSLポートを使用するように変更

SOAサーバーURLをSSLポートを使用するように変更するには:

1. 管理サーバーおよびOracle Identity Manager管理対象サーバーが稼動しているときに、Enterprise Manager (EM)にログインします。
次に例を示します。

http://ADMINISTRATIVE_SERVER/em

2. 「Identity and Access」→「Oracle Identity Manager」に移動します。

3. 右クリックして「システムMBeanブラウザ」を選択します。

4. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→構成→「XMLConfig.SOAConfig」→「SOAConfig」に移動します。

5. Rmiurl属性とSoapurl属性の値を変更し、「適用」をクリックして変更を保存します。

注意:

Rmiurlは、SOA管理対象サーバーにデプロイされたSOA EJBにアクセスするために使用されます。

これは、アプリケーション・サーバーのURLです。(クラスタ・インストールの場合は、すべてのSOA管理対象サーバーURLのカンマ区切りのリストです)

次に例を示します。

t3://mysoa1.oracle.com:8001

t3s://mysoa1.oracle.com:8001,mysoa2.oracle.com:8002

t3://mysoa1.oracle.com:8001,mysoa2.oracle.com:8002,mysoa3.com:8003

注意:

Soapurlは、SOA管理対象サーバーにデプロイされたSOA Webサービスにアクセスするために使用されます。これは、Webサーバーまたはロード・バランサをフロントエンドとするSOAクラスタでは、WebサーバーURLまたはロード・バランサURLです。単一SOAサーバーでは、アプリケーション・サーバーURLです。

例:

http://myoimsoa.oracle.com

https://mysoa.oracle.com: 8001

12.3.5.5 Design ConsoleのSSLの構成

Oracle Identity ManagerとDesign console間に安全な接続を確立するようにDesign consoleを変更するには:

1. SSLをサポートするために必要なWebLogic Server JARを追加します。

2. webserviceclient+ssl.jarを次のコピー元からコピーします:
$WL_HOME/server/lib

次へ

$OIM_HOME/designconsole/ext

3. Design consoleでサーバー信頼ストアを使用します。これにアクセスするには、次のようにします。

1. WebLogic Server管理コンソールで、「環境」→「サーバー」に移動します。

2. <OIM_SERVER_NAME>をクリックして、Oracle Identity Mangerサーバーの詳細を表示します。

3. 「キーストア」タブをクリックし、「信頼」セクションに表示される信頼キーストアの場所を書き留めておきます。

Design ConsoleがOracle Identity Managerホストにデプロイされている場合

TRUSTSTORE_LOCATION環境変数を上記で書き留めた信頼キーストアの場所に設定します。

次に例を示します。

setenv TRUSTSTORELOCATION/scratch/user1/dogwoodsh100520/beahome/wlserver_10.3/server/lib/DemoTrust.jks

Design ConsoleがOracle Identity Managerとは別のコンピュータにデプロイされている場合

信頼キーストアをDesign consoleが表示されているボックスにコピーし、TRUSTSTORE_LOCATION環境変数を信頼キーストアをコピーしたローカル・ボックスの場所に設定します。

12.3.5.6 Oracle Identity ManagerユーティリティのSSLの構成

Oracle Identity Managerクライアント・ユーティリティには、PurgeCache、GenerateSnapshot、UploadJars、およびUploadResourcesがあります。

TRUSTSTORE_LOCATION環境変数を信頼キーストアの場所に設定します。

注意:

TRUSTSTORE_LOCATION環境変数を信頼キーストアの場所に設定する方法の詳細は、「Design ConsoleのSSLの構成」を参照してください。

次に例を示します。

setenv TRUSTSTORELOCATION/scratch/user1/dogwoodsh100520/beahome/wlserver_10.3/server/lib/DemoTrust.jks

12.3.5.7 MDSユーティリティのSSLの構成

WLSTスクリプトを含むすべてのOracle Identity Manager MDSユーティリティでは、スクリプトを実行しているシェルで次の環境変数を設定する必要があります。

WLST_PROPERTIES=-Dweblogic.security.SSL.ignoreHostnameVerification=true-Dweblogic.security.TrustKeyStore=DemoTrust

注意:

このプロパティを設定すると、WLSTは正常に動作するようになります。情報/注意メッセージが表示されますが、これは無視してかまいません。

12.3.5.8 SPML/コールバック・ドメインのSSLの構成

SPML/コールバック・ドメインのSSLを構成するには:

1. Oracle Identity ManagerのポートがSSL有効で、「ホスト名の検証」が「false」に設定されていることを確認します。

2. コールバック・ドメインを含むFusion ApplicationsでSSLを有効化します。

関連項目:

カスタム・キーストアを使用したOracle Identity ManagerのSSLの有効化の詳細は、「カスタム・キーストアを使用したOracle Identity ManagerのSSLの有効化」を参照してください。

3. WebLogicのデフォルトの信頼ストアを使用している場合は、SSLモードの有効化以外の変更は行わないでください。

4. デフォルト以外の証明書がある場合は、信頼できる証明書を交換して双方向の信頼を確立する必要があります。証明書への署名およびエクスポートの詳細は、「証明書への署名」および「証明書のエクスポート」を参照してください。

関連項目:

Oracle WebLogic ServerのSSLの構成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する説明を参照してください。

5. スタンドアロン・クライアントを使用して、テスト目的でSPMLリクエストを送信する場合は、次のようにする必要があります。

1. SSL対応のOIMポートにリクエストを送信するには、SPMLクライアントのコマンドに次のシステム・プロパティを追加します。

- Djavax.net.ssl.trustStore=D:\Oracle\Middleware1\wlserver_10.3\server\lib\DemoTrust.jks

注意:

Djavax.net.ssl.trustStoreパラメータの値をSSLの構成に使用されるトラストストアを指すように変更します。

WebLogicでSSLの構成に使用されるトラストストアの場所は、「Design ConsoleのSSLの構成」を参照してください。

- -Djava.protocol.handler.pkgs=weblogic.net

- -Dweblogic.security.TrustKeyStore=DemoTrust

2. webserviceclient+ssl.jarをクライアント・クラスパスに追加します。

12.3.6 Oracle Identity Manager DBのSSLの有効化

Oracle Identity Manager DBのSSLを有効化するには、次の構成を実行する必要があります。

- サーバー認証SSLモードでのDBの設定

- キーストアと証明書の作成

- Oracle Identity Managerの更新

- WebLogic Serverの更新

12.3.6.1 サーバー認証SSLモードでのDBの設定

サーバー認証SSLモードでDBを設定するには:

1. DBサーバーとリスナーを停止します。

2. listener.oraファイルを次のように構成します。

1. 次のパスに移動します。
$DB_ORACLE_HOME/network/adminディレクトリ

次に例を示します。

/scratch/user1/production-database/product/11.1.0/db_1/network/admin

2. listener.oraファイルを編集してSSLリスニング・ポートとサーバー・ウォレット・ロケーションを含めます。
次にlistener.oraファイルのサンプルを示します。

# listener.ora Network Configuration File: /scratch/rbijja/production-database/product/11.1.0/db_1/network/admin/listener.ora
# Generated by Oracle configuration tools.

SSL_CLIENT_AUTHENTICATION = FALSE

WALLET_LOCATION =
(SOURCE =
(METHOD = FILE)
(METHOD_DATA =
(DIRECTORY = /scratch/rbijja/production-database/product/11.1.0/db_1/bin/server_keystore_ssl.p12)
)
)

LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCPS)(HOST = dadvmh0175.us.oracle.com)(PORT = 2484))
)
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = dadvmh0175.us.oracle.com)(PORT = 1521))
)
)

TRACE_LEVEL_LISTENER = SUPPORT

3. sqlnet.oraファイルを次のように構成します。

1. 次のパスに移動します。
$DB_ORACLE_HOME/network/adminディレクトリ

次に例を示します。

/scratch/user1/production-database/product/11.1.0/db_1/network/admin

2. sqlnet.oraファイルを編集して次の内容を含めます。

- TCPS認証サービス

- SSL_VERSION

- サーバー・ウォレット・ロケーション

- SSL_CLIENT_AUTHENTICATIONタイプ(trueまたはfalse)

- 通信で許可されるSSL_CIPHER_SUITES(オプション)

次にsqlnet.oraファイルのサンプルを示します。

# sqlnet.ora Network Configuration File: /scratch/rbijja/production-database/product/11.1.0/db_1/network/admin/sqlnet.ora
# Generated by Oracle configuration tools.

SQLNET.AUTHENTICATION_SERVICES= (BEQ, TCPS)

SSL_VERSION = 3.0

SSL_CLIENT_AUTHENTICATION = FALSE

WALLET_LOCATION =
(SOURCE =
(METHOD = FILE)
(METHOD_DATA =
(DIRECTORY = /scratch/rbijja/production-database/product/11.1.0/db_1/bin/server_keystore_ssl.p12)
)
)

4. tnsnames.oraファイルを次のように構成します。

1. 次のパスに移動します。
$DB_ORACLE_HOME/network/adminディレクトリ

次に例を示します。

/scratch/user1/production-database/product/11.1.0/db_1/network/admin

2. tnsnames.oraファイルを編集してサービスの説明リストにSSLリスニング・ポートを含めます。
次にtnsnames.oraファイルのサンプルを示します。

# tnsnames.ora Network Configuration File: /scratch/user1/production-database/product/11.1.0/db_1/network/admin/tnsnames.ora
# Generated by Oracle configuration tools.

PRODDB =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCPS)(HOST = dadvmh0175.us.oracle.com)(PORT = 2484))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = proddb)
)
)
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = dadvmh0175.us.oracle.com)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = proddb)
)
)
)

5. DBサーバーのユーティリティを起動および停止します。

6. DBサーバーを起動します。

12.3.6.2 キーストアと証明書の作成

orapkiユーティリティを使用して、サーバー側とクライアント側のキーストアを作成できます。このユーティリティは、Oracle DBインストールの一部として出荷されます。

キーストアは、JKSやPKCS12などの任意の形式にすることができます。キーストアの形式は、プロバイダの実装によって異なります。たとえば、JKSはSun Oracleが提供する実装で、PKCS12はOraclePKIProviderが提供する実装です。

Oracle Identity Managerでは、DBサーバーにJKSクライアント・キーストアのみを使用します。これは、PKCS12などのJKS以外のキーストア形式を使用するには、リリースが差し迫っているときにインストーラ側に大きな変更を加える必要があったためです。ただし、Oracle Identity Managerにはdefault-KeyStore.jksという名前のJKS形式のキーストアがあらかじめ含まれています。

orapkiユーティリティを使用して、次のキーストアを作成できます。

- ルートCAウォレットの作成

- DBサーバー側ウォレットの作成

- クライアント側ウォレットの作成

注意:

ウォレットとキーストアは置き換え可能で、どちらも同じ意味です。これらは公開鍵および秘密鍵のリポジトリと自己署名証明書および信頼できる証明書を参照します。

ルートCAウォレットの作成

ルート認証局(CA)ウォレットを作成するには:

1. 次のパスに移動します。
$DB_ORACLE_HOME/binディレクトリ

2. 次のコマンドを使用してウォレットを作成します。

./orapki wallet create -wallet CA_keystore.p12 -pwd welcome1

3. 次のコマンドを使用して、自己署名証明書をCAウォレットに追加します。

./orapki wallet add -wallet CA_keystore.p12 -dn 'CN=root_test,C=US' -keysize 2048 -self_signed -validity 3650 -pwd welcome1

4. 次のコマンドを使用してウォレットを表示します。

./orapki wallet display -wallet CA_keystore.p12 -pwd welcome1

5. 次のコマンドを使用してCAウォレットから自己署名証明書をエクスポートします。

./orapki wallet export -wallet CA_keystore.p12 -dn 'CN=root_test,C=US' -cert self_signed_CA.cert -pwd welcome1

DBサーバー側ウォレットの作成

DBサーバー側ウォレットを作成するには:

1. 次のコマンドを使用してサーバー・ウォレットを作成します。

./orapki wallet create -wallet server_keystore_ssl.p12 -auto_login -pwd welcome1

2. 次のコマンドを使用して、証明書リクエストをサーバー・ウォレットに追加します。

./orapki wallet add -wallet server_keystore_ssl.p12/ -dn 'CN=Customer,OU=Customer,O=Customer,L=City,ST=NY,C=US' -keysize 2048 -pwd welcome1

3. 次のコマンドを使用して、証明書リクエストをファイルにエクスポートします。これは後でルートCA署名を使用して署名を受けるために使用されます。

./orapki wallet export -wallet server_keystore_ssl.p12/ -dn 'CN=Customer,OU=Customer,O=Customer,L=City,ST=NY,C=US' -request server_creq.csr -pwd welcome1

4. 次のコマンドを使用して、サーバー・ウォレットの証明書リクエストにCA署名を使用して署名を受けます。

./orapki cert create -wallet CA_keystore.p12 -request server_creq.csr -cert server_creq_signed.cert -validity 3650 -pwd welcome1

5. 次のコマンドを使用して、署名された証明書を表示します。

/orapki cert display -cert server_creq_signed.cert -complete

6. 次のコマンドを使用して、信頼された証明書をサーバー・ウォレットにインポートします。

./orapki wallet add -wallet server_keystore_ssl.p12 -trusted_cert -cert self_signed_CA.cert -pwd welcome1

7. 次のコマンドを使用して、この新規作成された署名証明書(ユーザー証明書)をサーバー・ウォレットにインポートします。

./orapki wallet add -wallet server_keystore_ssl.p12 -user_cert -cert server_creq_signed.cert -pwd welcome1

クライアント側ウォレットの作成

クライアント側(Oracle Identity Managerサーバー)ウォレットを作成するには:

1. 次のパスに移入されているdefault-keystore.jksキーストアを使用して、クライアント・キーストアを作成します。
DOMAIN_HOME/config/fmwconfig

注意:

Oracle PKCS12ウォレットをクライアント・キーストアとして使用することもできます。

2. 次のコマンドを使用して、サーバー側コマンドを使用してすでにエクスポートされている自己署名付きの信頼されたCA証明書を、クライアント・キーストア(default-keystore.jks)にインポートします。

keytool -import -trustcacerts -alias dbtrusted -noprompt -keystore default-keystore.jks -file self_signed_CA.cert -storepass xellerate

12.3.6.3 Oracle Identity Managerの更新

Oracle Identity ManagerおよびOracle Identity Manager DBでSSLモードを有効にして安全な通信を確保するには、Oracle Identity Managerで次の手順を実行する必要があります。

1. 信頼された証明書をOracle Identity Managerのdefault-keystore.jksキーストアにインポートします。

2. Enterprise Managerにログインします。

3. 「Identity and Access」→「OIM」に移動します。

4. 右クリックして「システムMBeanブラウザ」に移動します。

5. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→構成→「XMLConfig.DirectDBConfig」→「DirectDB」に移動します。

6. Sslenabled属性とUrl属性の値を変更して、「適用」をクリックします。DBでSSLモードが有効な場合は、Url属性にTCPS有効化とSSLポートを含める必要があります。
次に例を示します。

url="jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCPS)(HOST=my.domain.com)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=proddb)))"

7. Oracle Identity Managerサーバーを再起動します。

12.3.6.4 WebLogic Serverの更新

Oracle Identity Manager DBのSSLを有効にした後で、DB SSLポートを使用してOracle Identity Managerの次のデータソースと認証者を変更する必要があります。

- データソースの構成

- データソースoimJMSStoreDSの構成の更新

- データソースoimOperationsDBの構成の更新

- Oracle Identity Manager MDSに関連するデータソースの構成の更新

- Oracle Identity Manager認証者の更新

データソースの構成

データソースを構成するには:

1. Enterprise Managerにログインします。

2. ホストおよびポートの変更を行います。

注意:

データベースのホストまたはポートの変更を行う前に、Oracle Identity Managerアプリケーションをホストする管理対象サーバーを停止する必要があります。ただし、WebLogic管理サーバーは稼動させたままでかまいません。

データソースoimJMSStoreDSの構成の更新

データソースoimJMSStoreDSの構成を更新するには:

1. WebLogic Serverにログインします。

2. 「サービス」→「JDBC」→「データソース」→「oimJMSStoreDS」に移動します。

3. 「接続プール」タブをクリックして、DBのホストおよびポートの変更に合わせてURLの値とプロパティを変更します。

データソースoimOperationsDBの構成の更新

データソースoimOperationsDBの構成を更新するには:

1. Enterprise Managerにログインします。

2. 「サービス」→「JDBC」→「データソース」→「oimJMSStoreDS」に移動します。

3. 「接続プール」タブをクリックして、DBのホストおよびポートの変更に合わせてURLの値とプロパティを変更します。

Oracle Identity Manager MDSに関連するデータソースの構成の更新

Oracle Identity Manager MDSに関連するデータソースの構成を更新するには:

1. Enterprise Managerにログインします。

2. 「サービス」→「JDBC」→「データソース」→「mds-oim」に移動します。

3. 「接続プール」タブをクリックして、DBのホストおよびポートの変更に合わせてURLの値とプロパティを変更します。

注意:

必要に応じて、SOA/OWSMに関連するデータソースにも同様の更新を行ってください。

Oracle Identity Manager認証者の更新

WebLogicサーバーの既存のOracle Identity Manager認証者は、非SSL DB詳細に対して構成されており、Oracle Identity Manager DBとの通信にデータソースを使用しません。認証者でSSL DB詳細を使用するには、次の手順を実行する必要があります。

1. データソースがSSLに構成されていることを確認します。

2. WebLogic管理コンソールで、「セキュリティ・レルム」→「myrealm」→ 「プロバイダ」に移動します。

3. OIMAuthenticationProviderを削除します。

4. OIMAuthenticatorタイプの認証プロバイダを作成し、制御フラグをSUFFICIENTに設定します。

5. OIMSignatureAuthenticatorタイプの認証プロバイダを作成し、制御フラグをSUFFICIENTに設定します。

6. 認証者を次の順に並べ替えます。

1. DefaultAuthenticator

2. OIMAuthenticator

3. OIMSignatureAuthenticator

4. その他のプロバイダ(あれば)

7. すべてのサーバーを再起動します。

12.3.7 LDAP同期のSSLの有効化

Oracle Identity ManagerでSSL有効化されたOracle Virtual Directory (OVD)を使用できるようにするには、次の構成を実行する必要があります。

- OVD-OIDでのSSLの有効化

- Oracle Identity ManagerのOVDホスト/ポートの更新

12.3.7.1 OVD-OIDでのSSLの有効化

OVD-OIDでSSLを有効化するには:

1. OVD EMコンソールにログインします。

2. 「Identity and Access」を展開し、「ovd1」→「管理」→「リスナー」に移動します。

3. 「作成」をクリックし、必要なフィールドすべてに入力します。

注意:

「リスナー・タイプ」にはLDAPを選択してください。

4. 「OK」をクリックします。

5. 新規作成されたLDAPリスナーを選択し、「編集」をクリックします。

6. 「リスナーの編集 - OIM SSL ENDPOINT」ページで、新規作成されたLDAPリスナーを編集します。

7. 「OK」をクリックします。「SSL構成」ページが開きます。

8. 「SSLの有効化」チェックボックスを選択します。

9. 「拡張SSL設定」セクションで、SSL認証に対して、「認証なし」を選択します。

10. 「OK」をクリックします。

11. OVDサーバーを停止してから起動し、変更を有効にします。

注意:

再起動オプションは使用しないでください。

12.3.7.2 Oracle Identity ManagerのOVDホスト/ポートの更新

Oracle Identity ManagerでLDAPSyncが有効な場合、Oracle Identity ManagerはOVDを介してディレクトリ・サーバーに接続します。この接続にはLDAP/LDAPSプロトコルを使用します。

OVDのホストおよびポートを変更するには:

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

2. 「詳細」に移動し、「ITリソースの管理」をクリックします。

3. 「ITリソース・タイプとして「ディレクトリ・サーバー」を選択し、「検索」をクリックします。

4. ITリソース・ディレクトリ・サーバーで、サーバーURLを編集してSSLプロトコルとSSLポート詳細を含めます。

5. 「SSLの使用」がtrueに設定されていることを確認し、「更新」をクリックします。

第III部

構成

この部では、Oracle Identity Managerでの構成タスクについて説明します。

次の章で構成されています。

- 第13章「ユーザー属性の構成」

- 第14章「パスワード・ポリシーの管理」

- 第16章「非同期実行の管理」

- 第17章「オフライン・プロビジョニングの有効化」

- 第18章「Enterprise Managerを使用したOracle Identity Manager構成の管理」

- 第19章「ユーザーの言語の設定」

13 ユーザー属性の構成

ユーザー属性は、ユーザー・エンティティのプロパティです。ユーザー・エンティティに関する情報は、名、姓、ユーザー・ログイン、パスワードなどの属性の形で格納されます。Oracle Identity Managerにはデフォルトのユーザー属性があります。ただし、管理およびユーザー・コンソールでユーザー構成UIを使用して、カスタム・ユーザー属性を作成できます。

Oracle Identity Managerには、各エンティティのライフサイクル管理を行う特定の操作があります。ユーザー・エンティティの基本操作には、次のものがあります。

- 作成

- 表示/変更

- 参照

- 削除

- 無効化

- 有効化

- 一括操作

関連項目:

ユーザー・エンティティ関連の操作の詳細およびデフォルトのユーザー・エンティティ属性のリストは、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザーの管理に関する説明を参照してください。

構成管理機能を使用して管理される属性の完全なリストは、エンティティで実行される操作によって取得できます。たとえば、拡張検索を使用してユーザーを検索する場合は、検索を実行するための検索可能なユーザー属性セットが表示されます。検索操作が完了すると、属性セットを含む検索結果が表示されます。これらの属性セットは、構成管理機能を使用して管理されます。

ユーザー・エンティティのデータ構造および属性を定義するには、Oracle Identity Administrationの構成管理UIを使用します。このUIで属性を構成できるかどうかは、認可ポリシーで管理される権限によって異なります。ユーザー管理およびセルフ・サービス操作の認可ポリシーの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザー管理および認証されたユーザー・セルフ・サービスに関する説明を参照してください。

この章ではユーザー構成管理について説明します。次の項で構成されています。

- エンティティ構成操作

- 検索操作の構成

- ユーザー構成管理の認可

- リクエストでのUDFの使用の有効化

- Oracle Identity ManagerとLDAP間のユーザー定義フィールドの同期

- 構成管理アーキテクチャ

13.1 エンティティ構成操作

エンティティ構成操作により、ユーザー・エンティティの属性セットを定義できます。新規のカスタム属性定義を追加して、既存の定義を変更できます。デフォルトで定義されている属性に加えて、ユーザー・エンティティに独自の属性を定義できます。

注意:

拡張管理の構成管理セクションにアクセスするには、ユーザー属性を構成する権限を持つ必要があります。詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザー管理構成に関する項を参照してください。

エンティティ構成操作には次のものがあります。

- エンティティ属性のリスト表示

- エンティティ属性の作成

- エンティティ属性の変更

- エンティティ属性の削除

- カテゴリ構成の実行

13.1.1 エンティティ属性のリスト表示

ユーザー構成管理UIでエンティティ属性をリストするには、次の手順を実行します。

1. Oracle Identity Manager拡張管理にログインします。

2. 「ようこそ」ページの「構成」にある「ユーザー構成」をクリックします。あるいは、「構成」タブ、「ユーザー構成」タブの順にクリックします。

3. コンソールの左ペインで、「アクション」メニューから「ユーザー属性」を選択します。「ユーザー属性」ページに、User.xml構成ファイルで定義されているすべてのユーザー属性を含む表が表示されます。
表13-1に、「ユーザー属性」表の列とその説明を示します。

表13-1 「ユーザー属性」表の列

列

説明

カテゴリ名

属性が属するカテゴリ。カテゴリ分けは、ユーザー管理コンソールでデータを編成するために使用されます。

注意: 各カテゴリの詳細は、「カテゴリ構成の実行」を参照してください。

属性名

属性の一意名。この名前は、「ユーザー・プロファイル」ページにこの属性を表示する場合のキャプションとしても使用されます。

カテゴリの順序

カテゴリ内での属性の順序。属性はこの順序に基づいてユーザー管理コンソールに表示されます。

属性タイプ

属性タイプがシステムとユーザー定義フィールド(UDF)のどちらであるかを指定します。システム属性は削除できず、変更時に制限があります。

バックエンド・データ型

バックエンド・データストアにある属性のデータ型。

表示タイプ

ユーザー管理コンソールでの属性の表示タイプ。

「ユーザー属性」表の行を選択して、属性の作成や変更などの操作を実行できますが、これについては、後述の項で説明します。

注意:

Oracle Identity Manager Administrationの構成管理セクションには管理者ユーザーでもアクセスできません。アクセスするにはユーザー属性を構成するための権限が必要です。

4. 「カテゴリ名」列で、カテゴリ名の左にあるアイコンをクリックしてカテゴリ名を展開します。そのカテゴリに属する属性が属性名列にリストされます。

13.1.2 エンティティ属性の作成

エンティティに対して新しい属性を作成するには:

1. 「ユーザー属性」ページで、「アクション」メニューから「属性の作成」を作成します。「属性の作成」ウィザードが表示されます。

2. ウィザードの属性の詳細の設定ページで、フィールドに値を入力します。表13-2に、属性の詳細の設定ページのフィールドを示します。

表13-2 属性の詳細の設定ページのフィールド

フィールド

LOVタイプ

説明

属性名

属性の一意名。この名前は、「ユーザー・プロファイル」ページにこの属性を表示する場合のキャプションとしても使用されます。

バックエンド属性名

ユーザー・バックエンド・スキーマで作成されるフィールドの名前で、ユーザーの作成または修正時にこの属性に指定された値を保存するために使用されます。Oracle Identity Managerは、「バックエンド属性名」に接頭辞USR_UDFを自動的に付加します。

カテゴリ名

属性が属するカテゴリ名。カテゴリ分けはUIでデータを編成するために使用されます。

注意: カテゴリ構成の詳細は、「カテゴリ構成の実行」を参照してください。

表示タイプ

UIでの属性の表示タイプを示します。これは属性プロパティで、メタデータに付加してUser.xmlファイルに格納されます。使用可能な表示タイプは次のとおりです。

- 文字列

- 整数

- テキスト領域

- チェック・ボックス

- ダブル

- 日付

- 機密

- 値リスト

「表示タイプ」を選択すると、適切なバックエンドおよびフロントエンドのデータ型が設定されます。

バックエンド・データ型は、バックエンド・データストア内の属性データ型です。これはUser.xmlファイルに属性定義とともに格納されます。

フロントエンド・データ型は、Oracle Identity Managerによって解釈される属性データ型を示します。これはUser.xmlファイルに属性定義とともに格納されます。これはUIには表示されません。

関連項目: 各属性に対して構成されるプロパティの詳細は、「属性プロパティ」の項を参照してください。

LOVタイプ

このフィールドはデフォルトでは非表示です。表示タイプに「値リスト」が選択されると、LOV関連のフィールドが表示されます。「LOVタイプ」は 、「システム生成」、「管理者構成」および「問合せ別」から選択できます。

システム生成

既存のLOVを指定できます。次に例を示します。

1. 「LOVタイプ」として「システム生成」を選択します。

2. 「LOV検索オプション」には、デフォルトでは「次を含む」演算子が指定されています。「LOVコード」フィールドにusersと入力し、「検索」をクリックします。検索基準に一致する使用可能なLOVコードのリストが使用可能なLOVコード・リストに表示されます。

3. Lookup.Users.Roleを選択し、右矢印をクリックして選択済LOVコード・リストに移動させます。1つのLOVコードのみ、このリストに移動させてください。「次へ」をクリックし、この項の説明に従ってウィザードの残りの手順を完了します。

属性を保存すると、ユーザー詳細ページに従業員タイプ・コードを含むドロップダウン・リストが表示されます。

管理者構成

このLOVはユーザーが追加できます。次に例を示します。

1. 「LOVタイプ」として「管理者構成」を選択します。

2. 「LOVコード」フィールドにlevelと入力します。LOVコードには、複数のLOVオプションと対応するLOVの説明を追加できます。

3. 「LOVオプション」フィールドにL1と入力し、「LOVオプションの説明」フィールドにExecutiveと入力します。「追加」をクリックします。LOVオプションと説明が追加され、ページに表示されます。

4. 別の値を追加するには、「LOVオプション」フィールドにL2と入力し、「LOVオプションの説明」フィールドにSenior Executiveと入力します。「追加」をクリックします。

5. 複数の値を追加後、「次へ」をクリックし、この項の説明に従ってウィザードの残りの手順を完了します。

属性を保存後、ユーザー詳細ページに「LOVオプションの説明」フィールドで指定した値を含むドロップダウン・リストが表示されます。

問合せ別

「LOVコード」および「LOVオプション」フィールドは表示されません。そのかわりに、次のフィールドが表示されます。

- LOV問合せ: このフィールドで、Oracle Identity Managerデータベース・スキーマで有効な任意のSQL問合せを指定できます。

- 表示するLOV列: これはselect問合せからのすべての列を示すリストです。ユーザー・エンティティを作成または変更するページで検索アイコンをクリックしたときに、ここで選択された列値を表示できます。たとえば、マネージャ・キーのかわりにマネージャ名を表示することもできます。

- 保存するLOV列: これはselect問合せからのすべての列を示すリストです。ユーザーがユーザー・エンティティを作成または変更するページに表示されるドロップダウンで選択を行ったときに、ここで選択された列値がバックエンド・ストアに保存されます。たとえば、マネージャ名を表示して、保存するのはマネージャ・キーの値にすることも可能です。

注意: Oracle Identity ManagerはLKU表およびLKV表の2つの表を使用してセットを表します。LKU表には、各セットを識別するキーが保持されます。LKV表では各セットのメンバーが定義され、LKV表の各行ではセットを識別する1列(LKU表のLKU_KEY列)、およびセットのメンバーとなる値を宣言する別の列が使用されます。値のリストはすでにデータベース内のLKU表およびLKV表に定義されています。管理者指定の場合、ユーザーがLOVコードを指定する必要があります。これはLKU表に格納されます。各コードには値のリストが関連付けられています。ユーザーはここで新しい値を追加する必要があります。これらの値はLKV表に格納され、この属性のLOV値として使用されます。生成されたシステムに対して、ユーザーはLOVコードを検索して、コードを選択できます。このコードに対する値はLKV表にすでに存在し、この属性のLOV値として使用されます。LKU表およびLKV表の列のリストは、「LKU表およびLKV表の定義」を参照してください。

次に「問合せ別」LOVタイプの設定例を示します。

1. 「LOVタイプ」として「問合せ別」を選択します。

2. 「LOV問合せ」フィールドにSELECT USR_FIRST_NAME as FirstName , USR_LOGIN as UserLogin FROM USR WHERE USR_STATUS = 'Active'と入力します。

3. 「表示するLOV列」リストで、FIRSTNAMEを選択します。

4. 「保存するLOV列」リストで、USERLOGINを選択して「次へ」をクリックし、この項の説明に従ってウィザードの残りの手順を完了します。

属性の保存後、ユーザー詳細ページにこの属性に対する検索アイコンが表示されます。ユーザーは属性の値を検索して選択できます。FIRSTNAMEがユーザー詳細ページに表示され、USERLOGINはバックエンド・ストアに保存されます。

LOVコード

これはLOVを識別するコードです。システム生成されたLOVでは、この値は既存のLOVコードにする必要があります。

注意: 「LOVコード」、「LOVオプション」および 「LOVオプションの説明」フィールドは、「表示タイプ」として「値リスト」が選択されている場合のみ表示されます。他の表示タイプでは、これらのフィールドは表示されません。

LOVオプション

これは「LOVタイプ」が管理者構成の場合にのみ表示されます。ユーザーはここにLOV値を指定する必要があります。

LOVオプションの説明

LOVオプションの説明です。

注意:

値のリストから値を削除することはできません。

3. カスタムLOVタイプ属性を作成する場合は、次の手順を実行します。

注意:

ステップ3は、カスタムLOVタイプ属性を作成する場合にのみ実行します。それ以外の場合は、この手順はスキップします。

この例では、「LOVタイプ」は「管理者構成」です。

1. 属性の作成ウィザードの属性の詳細の設定ページで、「値リスト」として「表示タイプ」を選択します。

2. 「LOVタイプ」として「管理者構成」を選択します。「LOVタイプ」、「LOVコード」、「LOVオプション」および「LOVオプションの説明」フィールドが表示されます。これらのフィールドの詳細は、表13-2「属性の詳細の設定ページのフィールド」を参照してください。

3. 「LOVコード」フィールドに、departmentと入力します。

4. 「LOVオプション」フィールドに、L1と入力します。

5. 「LOVオプションの説明」フィールドに、Engineeringと入力します。

6. 「追加」をクリックします。ページの下部の表にLOVオプションが説明とともに追加されます。

7. 次のような他のLOVオプションを追加します。

- LOVオプション: L1、L2

- LOVオプションの説明: QA、Documentation

図13-1に、LOVオプションが追加された属性の詳細の設定ページを示します。

図13-1 LOVオプション

「図13-1 LOVオプション」の説明

4. 「次へ」をクリックします。属性のプロパティの設定ページが表示されます。

5. 属性プロパティの値を指定します。表13-3に、プロパティの設定ページのフィールドを示します。

表13-3 プロパティの設定ページのフィールド

フィールド

説明

読取り専用値

属性が読取り専用かどうかを定義します。

暗号化

属性値を暗号化形式とクリア形式のどちらで保存するかを定義します。

表示可能

属性をUIに表示するかどうかを定義します。

属性のサイズ

属性値に設定可能な最大サイズです。

検索可能

属性値が検索可能かどうかを定義します。

バルク更新可能

属性を変更して複数のユーザーを同時に変更できるかどうかを定義します。

デフォルト値

ユーザー詳細に表示される属性のデフォルト値です。

6. 「次へ」をクリックします。「属性の作成」ウィザードの「確認」ページに、属性を作成するために入力した情報が表示されます。

7. 属性情報を確認し、「保存」をクリックします。MDSスキーマ(User.xml)とDBスキーマが新しい属性で更新されます。追加された新しい属性は、プロパティ・セットに基づいて「ユーザー管理」セクションに表示されます。ユーザー管理の認可ポリシーの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザー管理に関する項を参照してください。

注意:

- 「ユーザー・プロファイル」で表示または変更できる属性を新規作成するには、適切な認可ポリシーを作成する必要があります。認可ポリシーの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの認可ポリシーの管理に関する項を参照してください。

- LDAPでのこれらのフィールドの使用方法については、「Oracle Identity ManagerとLDAP間のユーザー定義フィールドの同期」を参照してください。

- リクエスト・データセットの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのステップ1: リソース用のリクエスト・データセットの作成を参照してください。

ステップ3で作成したLOVタイプ属性は、図13-2に示すように、「ユーザーの作成」ページで使用できます。

図13-2 「ユーザーの作成」ページのカスタムLOV属性

13.1.2.1 属性プロパティ

各属性に対して、次のプロパティを構成する必要があります。

- 必須: リポジトリ内のすべてのユーザーがこの属性に対してnullでない値を持つ必要があるかどうかを定義します。事前定義済ユーザーの場合は、必須属性に値が設定されています。ユーザーを作成する場合は、必須属性に値を指定する必要があります。すべての既存ユーザーでその属性に値が設定されていなければ、既存の属性を必須に変更することはできません。

- 読取り専用: 属性を読取り専用にし、属性は認可ポリシーに関係なく変更できなくなります。UIの一部の属性は、必ず読取り専用にする必要があります。このような属性にはシステム制御属性が含まれ、カスタム属性が含まれることもあります。

- システム制御: 値をOracle Identity Managerでのみ設定および編集できるようにするかどうかを定義します。

- 暗号化: 値をリポジトリに可逆暗号化形式とクリア形式のどちらで保存するかを定義します。

- 検索可能: 値を単純検索および拡張検索で使用できるかどうかを定義します。検索構成を変更して単純検索または拡張検索で使用するように属性を構成する必要があります。検索操作の構成については、「検索操作の構成」を参照してください。

- バルク更新可能: バルク変更操作時に属性を更新できるかどうかを定義します。

- サイズ この属性の値に指定できる最大サイズを示します。

- デフォルト値: 属性のデフォルト値です。ユーザー・エンティティの作成時にこの値が入力されていない場合は、バックエンド・ストアで移入される値になります。

注意:

新しいUDFを作成する場合は、対応するエンティティを次のカスタム・リソース・バンドルに追加する必要があります。

OIM_ORACLE_HOME/server/customResourses/customResources_LANGUAGE.properties

ここで、LANGUAGEを英語などの適切なロケールで置き換えます。

エンティティのネーミング規則は次のとおりです。

global.udf.BACKEND_UDF_NAME=DESCRIPTION_DISPLAYED_ON_THE_UI

例: global.udf.USR_UDF_ATT=Attestation

エンティティの追加後、JARの更新ユーティリティを使用してリソース・バンドルをMDSにアップロードします。このユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのJARの更新ユーティリティに関する項を参照してください。

13.1.2.2 LKU表およびLKV表の定義

表13-4に、LKU表の列を示します。

表13-4 LKU表の列

列名

データ・タイプ

NULL

LKU_KEY

NUMBER(19, 0)

いいえ

LKU_LOOKUP_KEY

NUMBER(19, 0)

はい

LKU_TYPE

VARCHAR2(1)

はい

LKU_GROUP

VARCHAR2(255)

はい

LKU_REQUIRED

VARCHAR2(1)

はい

LKU_TYPE_STRING_KEY

VARCHAR2(255)

いいえ

LKU_FIELD

VARCHAR2(50)

はい

LKU_DATA_LEVEL

NUMBER(1, 0)

はい

LKU_CREATE

DATE

はい

LKU_CREATEBY

NUMBER(19, 0)

はい

LKU_UPDATE

DATE

はい

LKU_UPDATEBY

NUMBER(19, 0)

はい

LKU_NOTE

CLOB

はい

LKU_ROWVER

RAW(8)

はい

表13-5に、LKV表の列を示します。

表13-5 LKV表の列

列名

データ・タイプ

NULL

LKV_KEY

NUMBER(19, 0)

いいえ

LKU_KEY

NUMBER(19, 0)

はい

LKV_ENCODED

VARCHAR2(3000)

いいえ

LKV_DECODED

VARCHAR2(4000)

いいえ

LKV_LANGUAGE

VARCHAR2(2)

いいえ

LKV_COUNTRY

VARCHAR2(2)

いいえ

LKV_VARIANT

VARCHAR2(10)

はい

LKV_DISABLED

VARCHAR2(1)

はい

LKV_DATA_LEVEL

NUMBER(1, 0)

はい

LKV_CREATE

DATE

はい

LKV_CREATEBY

NUMBER(19, 0)

はい

LKV_UPDATE

DATE

はい

LKV_UPDATEBY

NUMBER(19, 0)

はい

LKV_NOTE

CLOB

はい

LKV_ROWVER

RAW(8)

はい

13.1.3 エンティティ属性の変更

「属性の変更」操作により、ユーザー・エンティティに固有の属性を編集できます。これを行うには、次のようにします。

1. 「ユーザー属性」表で、属性を選択します。

2. 「アクション」メニューから、「属性の変更」を選択します。「属性の変更」ページが表示されます。

3. 「属性の変更」ページで、属性詳細と属性プロパティを編集します。「属性名」および「表示タイプ」フィールドは編集できません。

4. (オプション)「ユーザー・プロファイルのプレビュー」をクリックしてユーザー・プロファイルのプレビューを表示します。
「ユーザー・プロファイルのプレビュー」機能は、使用可能なすべてのカテゴリと属性を含む仮想ページを表示します。この機能は、プロファイルをデータベースに保存する前に確認するのに役立ちます。ユーザーは、ユーザー権限やその他の制限のために、すべてのカテゴリおよび属性を表示できるわけではないことに注意してください。

5. 「保存」をクリックして変更を保存します。

デフォルト値を持つ属性の場合は、次の変更のみ実行できます。

- 属性のデフォルト値の変更

- 属性の表示プロパティの変更

- 属性が必須でなくデフォルト値を持つ場合は、その属性は必須に変更できます。属性が必須でなくデフォルト値を持たない場合は、その属性は必須に変更できません。

13.1.4 エンティティ属性の削除

削除操作により、属性を削除できます。属性を削除するには、次の手順を実行します。

1. 「ユーザー属性」表で、行を選択します。

2. 「アクション」メニューから、「属性の削除」を選択します。確認を求めるメッセージ・ボックスが表示されます。

3. 「OK」をクリックします。属性が削除されることを確認するメッセージが表示されます。

削除操作の実行時には、バックエンドにある実際の属性は削除されません。既存データは影響を受けず、監査ログには継続してデータが表示されます。削除はMDSスキーマ(User.xml)でのみ行われます。

注意:

デフォルト属性は削除できません。削除できるのはユーザー定義属性のみです。

13.1.5 カテゴリ構成の実行

カテゴリは、関連する情報や属性を一緒に表示する論理エンティティです。カテゴリ構成によりUIでデータを整理できます。デフォルトでは次のカテゴリが使用可能です。

- 基本ユーザー情報: これには、姓、名、電子メールおよび組織情報(たとえばマネージャか部門か)などのユーザーの個人情報が含まれます。

- アカウント設定: これにはユーザーのログインとパスワードの情報が含まれます。

- アカウントの有効日: ユーザー・アカウントが有効または無効になる日です。

- プロビジョニング日: ユーザー・アカウントがプロビジョニングまたはプロビジョニング解除される日です。

- ライフサイクル: ロックまたは手動ロックされるユーザー・アカウント、またはそのアカウントが自動的に削除される日の属性用です。これはUIには表示されません。

- システム: これには、ユーザーによるログイン試行、ユーザーが作成された日、ユーザー・パスワードが変更できなかった日など、アプリケーションによって内部的に使用される属性が含まれます。これはUIには表示されません。

- その他のユーザー属性: その他のユーザー属性が含まれます。

- カスタム属性: これは空のカテゴリです。Oracle Identity Managerリリース9.1.0 UDFからのインポート時には、デプロイメント・マネージャによってここに属性が追加されます。

- プリファレンス: ユーザー・プリファレンスを制御する属性が含まれます。たとえば、ロケールやタイムゾーンなどがあります。

次のカテゴリ構成操作を実行できます。

- カテゴリの作成

- カテゴリの名前変更

- カテゴリの削除

- カテゴリ内での属性の並替え

13.1.5.1 カテゴリの作成

カテゴリの作成操作により、新しいカテゴリを追加できます。新しいカテゴリを追加するには、次の手順を実行します。

1. 「ユーザー属性」ページで、「アクション」メニューからカテゴリの追加を追加します。「カテゴリの作成」ダイアログ・ボックスが表示されます。

2. 「カテゴリ名」フィールドにカテゴリの名前を入力します。

3. 「保存」をクリックしてカテゴリを作成します。カテゴリが正常に作成されたことを示すメッセージが表示されます。

4. 「OK」をクリックします。

13.1.5.2 カテゴリの名前変更

UIに表示されるカテゴリ名は、リソース・バンドルから取得されます。カテゴリの表示名を変更するには、たとえば、OIM_ORACLE_HOME/server/customResourses/customResources_LANGUAGE.propertiesなどのリソース・バンドルの値を変更する必要があります。

ここで、LANGUAGEを英語などの適切なロケールで置き換えます。

リソース・バンドルを編集して、デフォルトのカテゴリ名を変更することもできます。

13.1.5.3 カテゴリの削除

削除できるのは空のカテゴリのみです。カテゴリを削除するには、次の手順を実行します。

1. 「ユーザー属性」ページで、削除する空のカテゴリを選択します。

2. 「アクション」メニューから、「カテゴリの削除」を選択します。確認を求めるメッセージ・ボックスが表示されます。

3. 「OK」をクリックします。削除を確認するメッセージが表示されます。

4. 「OK」をクリックします。

13.1.5.4 カテゴリ内での属性の順序付け

カテゴリ内での属性の順序付けを指定できます。属性は「ユーザー管理」セクションにこの順序に基づいて表示されます。

カテゴリ内での属性の順序付けを行うには:

1. 「ユーザー属性」ページで、順序付けを行う属性を含むカテゴリを選択します。

2. 「アクション」メニューから「カテゴリ属性の順序付け」を選択します。「カテゴリ属性の順序付け」ダイアログ・ボックスに、選択されたカテゴリ内のすべての属性名が表示されます。

3. 各属性に対応する数値を編集し、カテゴリ内での属性の順序を指定します。

4. 「保存」をクリックします。

13.2 検索操作の構成

検索操作は、ユーザーが入力した問合せに基づいたユーザー・エンティティの検索を可能にします。単純検索および拡張検索の検索操作、検索結果表および全表に対する属性を構成できます。

検索可能属性は、この単純検索を実行するときに検索文字列に適用される属性セットを定義します。デフォルトでは、表示名、ユーザー名、名および姓の検索可能属性は、単純検索用に構成されます。デフォルトでは拡張検索に対しても同じものが構成されます。

結果属性は、検索操作によって返される属性セットを定義します。検索結果に表示する列、および単純検索に対して制限された検索結果表に表示するサブセットを定義できます。

単純検索および拡張検索の問合せで使用可能な属性を構成できます。さらに、検索結果表に表示する属性を構成できます。これを行うには、次のようにします。

1. 左ペインの「ユーザー構成」セクションで、「アクション」メニューから「検索構成」を選択します。図13-3に示すように、「ユーザー検索構成」ページが表示されます。

図13-3 検索構成フォーム

「図13-3 検索構成フォーム」の説明

2. 「単純検索: 属性の検索」セクションで、単純検索で使用可能にする属性を選択します。移動またはすべて移動アイコンをクリックし、単純検索用の属性を追加します。削除またはすべて削除アイコンをクリックして、属性を検索から削除することもできます。

3. 拡張検索: 属性の検索セクションで、拡張検索で使用可能にする属性を選択します。移動またはすべて移動アイコンをクリックして、拡張検索用の属性を追加します。

4. 「検索結果表構成」セクションで、検索結果表に表示する属性を選択します。移動またはすべて移動アイコンをクリックして、検索結果表用の属性を追加します。

5. 「保存」をクリックします。

注意:

- 修正および作成操作は、このレベルでは構成できません。次の例外を除き、「ユーザー管理」UIにはすべての属性が編集可能として表示されます。

Attributes with property Visible=No
Attributes with property System Controlled=Yes"

- 表示可能で、プロパティSystem Controlled=Yesを持つ属性は、読取り専用として表示されます。表13-6「編集不可能な属性」を参照してください。

- UIに表示される属性の最終リストは、構成される認可ポリシーよって異なります。

- ユーザー定義フィールド(UDF)は、単純検索の「使用可能な属性」リストには表示されません。

表13-6に、「表示可能」プロパティが「いいえ」に設定されているか、「システム制御」プロパティが「はい」に設定されている属性を示します。

表13-6 編集不可能な属性

属性

表示可能

システム制御

氏名

いいえ

いいえ

UID

いいえ

はい

手動ロック

いいえ

はい

ロック日時

いいえ

はい

自動削除日

いいえ

いいえ

プロビジョニングされた日

いいえ

いいえ

プロビジョニング解除された日

いいえ

いいえ

ログイン試行回数

いいえ

はい

作成日

いいえ

はい

更新日

いいえ

はい

パスワードの変更不可

いいえ

はい

パスワードの変更が必要

いいえ

はい

パスワードの有効期限なし

いいえ

はい

パスワードの有効期限

いいえ

はい

パスワードの警告日

いいえ

はい

パスワードの有効期限切れ

いいえ

いいえ

パスワードの警告

いいえ

いいえ

パスワードのリセット試行回数

いいえ

はい

次のログイン時にパスワードを変更

いいえ

いいえ

パスワードの最小期間日付

いいえ

はい

作成者

いいえ

はい

更新者

いいえ

はい

ユーザー作成日

いいえ

はい

更新されたポリシー

いいえ

いいえ

生成されたパスワード

いいえ

はい

データ・レベル

いいえ

はい

LDAP組織

いいえ

いいえ

LDAP組織単位

いいえ

いいえ

LDAP GUID

いいえ

はい

LDAP DN

いいえ

いいえ

数値書式

いいえ

いいえ

通貨

いいえ

いいえ

日付書式

いいえ

いいえ

時間書式

いいえ

いいえ

アクセシビリティ・モード

いいえ

いいえ

カラー・コントラスト

いいえ

いいえ

フォント・サイズ

いいえ

いいえ

埋込みヘルプ

いいえ

いいえ

FA言語

いいえ

いいえ

FA地域

いいえ

いいえ

ユーザー名優先言語

いいえ

いいえ

13.3 ユーザー構成管理の認証

ユーザー構成管理の認証は、デフォルトの認可ポリシーによって管理されます。カスタム認可ポリシーは、この機能には作成できません。

関連項目:

ユーザー構成管理のデフォルトの認可ポリシーの詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザー管理構成に関する項を参照してください。

システム管理者ロールのメンバーであるユーザーは、すべてのユーザー構成操作を実行する権限があります。操作はこの機能のデフォルト認可ポリシーに設定された権限によって定義されます。表13-7に権限をリストします。

表13-7 認可権限

権限

説明

属性の作成

ユーザーがUIで属性を追加できるかどうかを定義します。この権限は、APIレベルでユーザーが属性を追加できるかどうかを決定するためにも使用されます。

属性の更新

ユーザーがUIですべての属性を更新できるかどうかを定義します。この権限は、APIレベルでユーザーが属性を更新できるかどうかを決定するためにも使用されます。

属性の削除

ユーザーがUIで属性を削除できるかどうかを定義します。この権限は、APIレベルでユーザーが属性を削除できるかどうかを決定するためにも使用されます。

カテゴリの追加

ユーザーがUIでカテゴリを追加できるかどうかを定義します。この権限は、APIレベルでユーザーがカテゴリを追加できるかどうかを決定するためにも使用されます。

カテゴリ属性の順序付け

ユーザーがUIで属性を更新でききるかどうかを定義します。この権限は、APIレベルでユーザーがカテゴリを更新できるかどうかを決定するためにも使用されます。

カテゴリの削除

ユーザーがUIでカテゴリを削除できるかどうかを定義します。この権限は、APIレベルでユーザーがカテゴリを削除できるかどうかを決定するためにも使用されます。

導出属性の追加

ユーザーが導出属性を追加できるどうかを定義します。導出属性の追加オプションはAPIレベルでのみ使用できます。

検索属性の設定

ユーザーがUIで検索を構成できるかどうかを定義します。この権限は、APIレベルでユーザーが単純検索と拡張検索、および検索表属性を更新できるかどうかを定義するためにも使用されます。

13.4 リクエストでのUDFの使用の有効化

UDFを作成し、自己登録、セルフ・プロファイル変更、ユーザーの作成や変更などの様々なリクエストでそれらを使用できます。リクエストでのUDFの使用を有効にするには、次の手順を実行します。

1. ユーザー構成管理UIを使用してUDFを作成します。詳細は、「エンティティ属性の作成」を参照してください。

2. 変更操作の場合は、認可ポリシーを使用して、変更リクエストを作成できるロールまたはユーザーに変更権限を割り当てます。詳細は、Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの認可ポリシーの管理に関する説明を参照してください。

3. 作成するリクエストの対応するリクエスト・データセットを更新します。次に例を示します。

- ユーザーの自己登録の場合は、SelfCreateUserDataset.xmlを使用します。

- ユーザーのセルフ・プロファイル変更の場合は、ModifyUserDataset.xmlを使用します。

- リクエストを介した管理者によるユーザー作成の場合は、CreateUserDataSet.xmlを作成します。

- リクエストを介した管理者によるユーザー変更の場合は、ModifyUserDataset.xmlを作成します。

リクエスト・データセットの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのリクエストの構成に関する説明を参照してください。

4. リクエスト・データセットをメタデータ・ストア(MDS)にアップロードします。MDSインポート/エクスポート・ユーティリティ・ツールの使用によるMDSへのリクエスト・データセットのアップロードの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのステップ2: MDSへのリクエスト・データセットのアップロードおよびMDSユーティリティとユーザーが変更可能なメタデータ・ファイルに関する説明を参照してください。

13.5 Oracle Identity ManagerとLDAP間のユーザー定義フィールドの同期

この項では、Oracle Identity ManagerとLDAP間のユーザー定義フィールド(UDF)の同期方法について説明します。Oracle Identity Manager拡張管理の構成サービスを使用してユーザー定義フィールドを作成した場合、その属性を同期する前に、OVDおよびOIDスキーマに新しい属性を追加して拡張する必要があります。たとえば、Employee IDという名前のOracle Identity Manager属性を作成して、これに対応するUSR表内の列名がUSR_EMPLOYEE_IDであるとします。Employee ID属性をOVDとOIDの両方のorclIDXPersonオブジェクトクラスに追加する必要があります。

関連項目:

新規属性のスキーマへの追加方法の詳細は、OVDおよびOIDのドキュメントを参照してください。

Oracle Identity ManagerのUDFとLDAP間の同期は、次の方法でアーカイブできます。

- 手動による属性の同期化

- ldapsyncudfユーティリティの使用によるOracle Identity ManagerとLDAP間のUDFの同期化

13.5.1 手動による属性の同期化

属性を同期するには、次の手順を使用します。

注意:

ディレクトリの複数値属性をOracle Identity Managerの同様の複数値属性に直接マップすることはできません。したがって、単一値属性のみをLDAPからOracle Identity Managerに移入できます。

1. emplyeeid属性をOVDとOIDの両方のorclIDXPersonオブジェクトクラスに追加して、OVDおよびOIDスキーマを拡張します。

2. Oracle Identity ManagerからLDAPに属性値を移入するには、次の手順を実行します。

1. 次のファイルをMDSからエクスポートします。
/metadata/iam-features-ldap-sync/LDAPUser.xml

2. 次のエントリを<entity-attributes>タグの末尾に追加します。

<attribute name="Employee ID">
<type>string</type>
<required>false</required>
<attribute-group>Basic</attribute-group>
<searchable>true</searchable>
</attribute>

注意:

Oracle Identity Managerでは、LDAPへのBooleanタイプ属性のプロビジョニングまたはリコンシリエーションはサポートされていません。

3. 次のエントリを<target-fields>タグの後に追加します。

<field name="employeeid">
<type>string</type>
<required>false</required>
</field>

4. 次のエントリを<attribute-maps>タグの後に追加します。

<attribute-map>
<entity-attribute>Employee ID</entity-attribute>
<target-field>employeeid</target-field>
</attribute-map>

5. MDSで/metadata/iam-features-ldap-sync/ディレクトリのLDAPUser.xmlファイルをインポートします。

3. 属性値をLDAPからOracle Identity Managerへ移入するには、次の手順を実行します。

1. 新しい列を追加して、RA_LDAPUSER表を拡張します。たとえば、RECON_EMPLOYEE_ID列を追加します。

2. リコンシリエーション・プロファイル、/db/LDAPUserをMDSからエクスポートします。

3. 次のエントリを<reconFields>タグの後に追加します。

<reconAttr>
<oimFormDescriptiveName>Employee ID</oimFormDescriptiveName>
<reconFieldName
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xsi:type="xs:string">employeeid</reconFieldName>
<reconColName>RECON_EMPLOYEE_ID</reconColName>
<emDataType>string</emDataType>
<formFieldType/>
<targetattr keyfield="false" encrypted="false"
required="false"
type="String" name="usr_employee_id"/>
</reconAttr>

4. 次のエントリを<reconToOIMMappings>タグの後に追加します。

<reconAttr>
<oimFormDescriptiveName>Employee ID</oimFormDescriptiveName>
<reconFieldName
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xs="http://www.w3.org/2001/XMLSchema"
xsi:type="xs:string">employeeid</reconFieldName>
<reconColName> RECON_EMPLOYEE_ID </reconColName>
<emDataType>string</emDataType>
<formFieldType/>
<targetattr keyfield="false" encrypted="false" required="false"
type="String" name="

usr_employee_id">
<Transformation name="OneToOne">
<Parameter name=" employeeid " fieldname=" employeeid "/>
</Transformation>
</targetattr>
</reconAttr>

5. xmlファイルをMDSにインポートして戻します。インポート後、MDS内のフルパスが/db/LDAPUserであることを確認します。

6. /db/RA_LDAPUSER.xmlファイルをMDSからエクスポートします。

7. 次のエントリを<entity-attributes>タグの末尾に追加します。

<attribute name="Employee ID">
<type>string</type>
<required>false</required>
<attribute-group>Basic</attribute-group>
<searchable>true</searchable>
</attribute>

8. このエントリを<target-fields>タグの後に追加します。

<field name=" RECON_EMPLOYEE_ID">
<type>string</type>
<required>false</required>
</field>

9. 次のエントリを<attribute-maps>タグの後に追加します。

<attribute-map>
<entity-attribute>Employee ID</entity-attribute>
<target-field> RECON_EMPLOYEE_ID </target-field>
</attribute-map>

10. RA_LDAPUSER.xmlファイルをMDSにインポートして戻します。インポート後、MDS内のフルパスが/db/RA_LDAPUSER.xmlであることを確認します。

13.5.2 ldapsyncudfユーティリティの使用によるOracle Identity ManagerとLDAP間のUDFの同期化

ldapsyncudf.shユーティリティを使用して、Oracle Identity ManagerとLDAP間のUDFの同期化を自動化することができます。

このユーティリティはUDFのプロビジョニングとリコンシリエーションの両方を行うため、このユーティリティを使用してUDFを同期化することをお薦めします。UDFをリコンサイルしないでプロビジョニングする場合、またはプロビジョニングしないでリコンサイルする場合は、「手動による属性の同期化」の説明に従ってプロセスを手動で実行する必要があります。

次の項では、ldapsyncudf.shスクリプトの使用について説明します。

- プロパティ・ファイルの構成

- 入力ファイルの構成

- ユーティリティの実行

13.5.2.1 プロパティ・ファイルの構成

ldapsyncudf.shスクリプトを実行してUDFの同期化を実行する前に、ldapconfig.propsファイルにプロパティを構成できます。これらのプロパティは、Oracle Identity Managerで提供されるサービスにクライアントが接続するために使用されます。これらのプロパティは、プロパティ・ファイルが存在しない場合やプロパティ値を含まない場合、コンソールを介して指定することもできます。

次のプロパティを構成できます。

- OIMServerタイプ: アプリケーション・サーバーのタイプ(Oracle WebLogic Serverなど)。値を指定しない場合、Oracle WebLogic Serverはデフォルト値となります。

- OIMProviderURL: Oracle Identity ManagerプロバイダのURL。t3://HOST_NAME:PORTの書式で表されます。
プロパティ・ファイルで値を指定しない場合、ldapsyncudf.shスクリプトの実行時に値を入力するように要求されます。

- OIMAdminUser: Oracle Identity Manager管理者のユーザー・ログイン。
プロパティ・ファイルで値を指定しない場合、ldapsyncudf.shスクリプトの実行時に値を入力するように要求されます。

- SkipOVDValidation: OVDスキーマでのLDAP属性検証がスキップされるかどうか。
デフォルト値はfalseです。このプロパティの値がtrueの場合、LDAP属性はOVDスキーマで検証されず、ユーティリティの実行後に構成できます。ユーティリティはMDSおよび水平表に変更を加えます。

次にサンプル・プロパティ・ファイルを示します。

# OIMServer Type, Valid values can be WLS, JBOSS, WAS
OIMServerType=WLS

# OIMAdmin User Login
OIMAdminUser=OIM_ADMINISTRATOR_LOGIN

# OIM Provider URL, such as OIMProviderURL=t3://HOST_NAME:PORT
OIMProviderURL=t3://localhost:7001

# Skip Validation of OVD Schema, such as SkipOVDValidation=true or false
SkipOVDValidation=false

13.5.2.2 入力ファイルの構成

ユーティリティへの入力は、入力ファイルを介して行うか、または実行時に対話モードで要求に応じてコンソールを介して行うことができます。入力ファイルを介して入力を行う場合は、次の形式で指定する必要があります。

ENTITY_TYPE, OPER_TYPE, UDF_NAME, LDAP_ATTR

注意:

パラメータはカンマ(,)で区切る必要があります。ハッシュ文字(#)で始まる行はコメントとして扱われ、ユーティリティによって処理されません。

入力パラメータは次のとおりです。

- ENTITY_TYPE: 有効な値はUSERまたはROLEです。この値では大文字と小文字は区別されません。

- OPER_TYPE: 有効な値はADDまたはDELETEです。この値では大文字と小文字は区別されません。

ヒント:

更新はサポートされていません。更新を行う場合は、まず削除を実行してから追加を実行します。MDSにあるOracle Identity Managerエンティティ定義ファイルから新しい定義が取得されます。

- UDF_NAME: 有効な値は、正常に作成された任意のOracle Identity Managerエンティティ属性です。UDF_NAMEが存在しない場合、エラー・メッセージが表示されます。この値では大文字と小文字が区別されます。

- LDAP_ATTR: 有効な値は、LDAPディレクトリ・サーバーおよびOVDスキーマに存在する任意のLDAP属性です。LDAP_ATTRパラメータは、DELETE操作のオプションです。DELETE操作でこのパラメータ値を指定した場合、この属性値は無視されます。この値では大文字と小文字が区別されます。

次にサンプル入力ファイルを示します。

USER, ADD, udf1, ldapAttr1
ROLE, ADD, udf2, ldapAttr2
ROLE, DELETE, udf3
#This is comment
USER, DELETE, udf4
USER, ADD, UDF Number 5, ldapAttr5

13.5.2.3 ユーティリティの実行

ldapsyncudf.shスクリプトはORACLE_HOME/server/ldap_config_util/ディレクトリにあります。ldapsyncudf.shスクリプトを実行するには、次の手順を実行します。

注意:

ユーティリティを実行する前に、LDAP属性を作成し、エンティティ・タイプに応じてorclIDXPersonまたはorclIDXGroupオブジェクトクラスに含めます。

1. employeeidなどのLDAP属性をOVDとOIDの両方のorclIDXPersonオブジェクトクラスに追加して、OVDおよびOIDスキーマを拡張します。

2. ユーティリティを実行する前に、WL_HOMEおよびJAVA_HOME環境変数を設定します。

3. 次のコマンドを実行します:
ldapsyncudf.sh [-Dconfig.properties=PATH_TO_PROPERTIES_FILE] [-DinputFile=PATH_TO_INPUT_FILE]

ヒント:

使用法の詳細および全般的なヘルプを表示するには、help、–helpまたは--helpコマンドライン・パラメータを指定してldapsyncudf.shスクリプトを実行します。

次のいずれかの方法でユーティリティを実行できます。

- コマンドライン・パラメータは両方ともオプションです。コマンドライン・パラメータを指定しない場合は、次のように、実行時にコンソールを介してパラメータを入力するように要求されます。

Enter Entity Type (User / Role):

Oracle Identity Managerのエンティティ・タイプを指定します(USERまたはROLE)。

Enter Operation Type (Add / Delete):

操作タイプを指定します(ADDまたはDELETE)。

Enter OIM UDF Name to be Synchronized:

正常に作成されたOracle Identity Managerのエンティティ属性を指定します。

Enter the LDAP attribute name in LDAP schema:

LDAPディレクトリ・サーバーおよびOVDスキーマに存在するLDAP属性を指定します。これはDELETE操作のオプションのパラメータです。

1セットの操作が完了しました。操作が正常に実行された場合は、次のように要求されます。

Want to continue adding / deleting more attributes (y/n)?

別の操作の入力プロセスを開始する場合は、yを入力します。それ以外の場合は、nを入力してプログラムを終了します。

- -Dinputfileおよび-Dconfig.propertiesコマンドライン・パラメータの値を指定してユーティリティを実行します。入力は入力ファイルから読み取られます。入力ファイルには、1行に1つずつ、複数の入力を含めることができます。各入力には、ADD操作の4つのパラメータまたはDELETE操作の3つのパラメータが含まれます。DELETE操作に対して4つ目のパラメータを指定すると、そのパラメータは無視されます。

13.6 構成管理アーキテクチャ

すべての属性定義およびUIの構成管理ページに対して、ユーザー・エンティティ属性を管理するための構成ファイルはUser.xmlです。この構成ファイルに、ユーザー・エンティティおよびそのプロパティのすべての属性が定義されます。バックエンド属性または列へ属性のマッピングは、ファイルでも指定されます。属性がUIに表示されるかどうかは、属性プロパティによって決まります。たとえば、属性がシステム制御される場合は、その属性はUIには表示されません。

例13-1に、サンプルのUser.xml構成ファイルのコードを示します。

例13-1 User.xml構成ファイル

<?xml version="1.0" encoding="UTF-8"?>
<tns:entity-definition xmlns:tns="http://www.oracle.com/schema/oim/entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.oracle.com/schema/oim/entity ../entity.xsd ">
<entity-type child-entity="false">User</entity-type>
<!-- Defines the repository and data provider to use for this entity -->
<provider-instance>
<repository-instance>OperationalDB</repository-instance>
<provider-type>UserDataProvider</provider-type>
<parameters>
<parameter name="table">
<value>usr</value>
</parameter>
<parameter name="id_column">
<value>usr_key</value>
</parameter>
<parameter name="usr_foreign_key_column">
<value>usr_manager_key</value>
</parameter>
<parameter name="org_table">
<value>act</value>
</parameter>
<parameter name="org_id_column">
<value>act_key</value>
</parameter>
<parameter name="org_foreign_key_column">
<value>parent_key</value>
</parameter>
<parameter name="foreign_search_table">
<value>act:usr</value>
</parameter>
<parameter name="foreign_search_table_alias">
<value>actorg:usrmgr</value>
</parameter>
<parameter name="foreign_search_table_to_join_key">
<value>actorg.act_key:usrmgr.usr_key</value>
</parameter>
<parameter name="foreign_search_table_from_join_key">
<value>usr.act_key:usr.usr_manager_key</value>
</parameter>
<parameter name="foreign_search_column">
<value>actorg.act_name:usrmgr.usr_display_name</value>
</parameter>
<parameter name="foreign_search_column_label">
<value>Organization Name:Manager Login</value>
</parameter>
<parameter name="foreign_search_column_alias">
<value>actorg_act_name:usrmgr_usr_login</value>
</parameter>
<parameter name="foreign_search_column_outer_join">
<value>false:true</value>
</parameter>
</parameters>
</provider-instance>
<container-capability>
<enabled>false</enabled>
</container-capability>
<!-- entity-attributes define the attributes at the API level. These are the attribute names that the API will return and expects -->
<entity-attributes>
<attribute name="usr_key">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>

<attribute-group>Basic</attribute-group>
<!-- The metadata attachment defines the enttiy attribute properties. These properties will be common across all entities -->
<metadata-attachment>
<!-- Whether the attribute is searchable by the user -->
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<!-- Whether the attribute can be updated in bulk -->
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<!-- The category in the UI to which this attribute belongs -->
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<!-- The display type of the attribute on the UI -->
<metadata>
<name>display-type</name>
<value>ENTITY</value>
<category>properties</category>
</metadata>
<!-- Whether the attribute value needs to be encrypted or not -->
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<!-- The maximum size that an attribute value can take -->
<metadata>
<name>max-size</name>
<value>19</value>
<category>properties</category>
</metadata>
<!-- Whether the attribtue is single valued or multivalued -->
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<!-- Whether an attribute's value can be modified or not -->
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<!-- Whether the value is controlled only by the system -->
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <!-- Whether the attribute is custom or user defined attribute -->
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="act_key">
<type>number</type>
<searchable>true</searchable>
<required>true</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>ENTITY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Last Name">
<type>string</type>
<searchable>true</searchable>
<required>true</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="First Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Middle Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Full Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>true</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>164</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Display Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>true</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>382</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Xellerate Type">
<type>string</type>
<searchable>true</searchable>
<required>true</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>30</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.XellerateType</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_password">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>SECRET</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>ENCRYPT</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>128</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_disabled">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Status">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>25</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.WebClient.Users.Status</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Role">
<type>string</type>
<searchable>true</searchable>
<required>true</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>255</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.Role</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="User Login">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_manager_key">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>ENTITY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>382</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Start Date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Effective Dates</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="End Date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Effective Dates</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_provisioning_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Provisioning Dates</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_deprovisioning_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Provisioning Dates</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_provisioned_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_deprovisioned_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Email">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Basic User Information</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_locked">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Account Settings</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Users.Lock User</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Locked On">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Lifecycle</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Automatically Delete On">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Lifecycle</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Manually Locked">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Lifecycle</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_login_attempts_ctr">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>NUMBER</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>19</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_create">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_update">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_timezone">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TIME_ZONE</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>100</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_locale">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>100</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Notification.Languages</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_cant_change">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_must_change">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_never_expires">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_expire_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_warn_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_expired">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_warned">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_pwd_reset_attempts_ctr">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>NUMBER</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_change_pwd_at_next_logon">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_data_level">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>CHECKBOX</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>

<attribute name="usr_pwd_min_age_date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_createby">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Basic</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_updateby">
<type>number</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_created">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="usr_policy_update">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Country">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>100</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Department Number">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Description">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>2000</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Common Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>240</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Employee Number">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Fax">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Generation Qualifier">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Hire Date">
<type>date</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>DATE_ONLY</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value></value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Home Phone">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Locality Name">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Mobile">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Pager">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Home Postal Address">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Postal Address">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Postal Code">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>30</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="PO Box">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="State">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Street">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Telephone Number">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Title">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Initials">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>10</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Password Generated">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>System</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>1</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="LDAP Organization">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="LDAP Organization Unit">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>80</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="LDAP GUID">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>true</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="LDAP DN">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Other User Attributes</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>256</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="FA Language">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>TEXT</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>100</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Embedded Help">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>10</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.EmbeddedHelp</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Number Format">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>30</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.NumberFormat</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Date Format">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.DateFormat</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Time Format">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.TimeFormat</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Currency">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.Currency</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Font Size">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>10</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.FontSize</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Color Contrast">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>10</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.ColorContrast</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="Accessibility Mode">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>            <metadata>
<name>possible-values-code</name>
<value>Lookup.Users.AccessibilityMode</value>
<category>properties</category>
</metadata>

</metadata-attachment>
</attribute>
<attribute name="FA Territory">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>100</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>possible-values-code</name>
<value></value>
<category>properties</category>
</metadata>
</metadata-attachment>
</attribute>
<attribute name="User Name Preferred Language">
<type>string</type>
<searchable>true</searchable>
<required>false</required>
<MLS>false</MLS>
<multi-represented>false</multi-represented>
<attribute-group>Extended</attribute-group>
<metadata-attachment>
<metadata>
<name>user-searchable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>bulk-updatable</name>
<value>true</value>
<category>properties</category>
</metadata>
<metadata>
<name>category</name>
<value>Preferences</value>
<category>properties</category>
</metadata>
<metadata>
<name>display-type</name>
<value>LOV</value>
<category>properties</category>
</metadata>
<metadata>
<name>lookup-query</name>
<value>select+MLS_LOCALE_CODE+as+USR_NAME_PREFERRED_LANG+from+mls_locale+where+locale_flag=0+OR+locale_flag=1+order+by+mls_locale_code+asc</value>
<category>properties</category>
</metadata>
<metadata>
<name>lookup-query-display-column</name>
<value>USR_NAME_PREFERRED_LANG</value>
<category>properties</category>
</metadata>
<metadata>
<name>lookup-query-save-column</name>
<value>USR_NAME_PREFERRED_LANG</value>
<category>properties</category>
</metadata>
<metadata>
<name>encryption</name>
<value>CLEAR</value>
<category>properties</category>
</metadata>
<metadata>
<name>visible</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>max-size</name>
<value>20</value>
<category>properties</category>
</metadata>
<metadata>
<name>multi-valued</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>read-only</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>system-controlled</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>custom</name>
<value>false</value>
<category>properties</category>
</metadata>
<metadata>
<name>possible-values-code</name>
<value></value>
<category>properties</category>
</metadata>
</metadata-attachment>
</attribute>
</entity-attributes>

<!-- The target fields define the attribute columns in the DB. These are not exposed via the User Management APIs. -->
<target-fields>
<field name="usr_key">
<type>number</type>
<required>true</required>
</field>
<field name="act_key">
<type>number</type>
<required>true</required>
</field>
<field name="usr_last_name">
<type>string</type>
<required>true</required>
</field>
<field name="usr_first_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_middle_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_full_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_display_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_type">
<type>string</type>
<required>false</required>
</field>
<field name="usr_password">
<type>string</type>
<required>true</required>
</field>
<field name="usr_disabled">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_cant_change">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_must_change">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_never_expires">
<type>string</type>
<required>false</required>
</field>
<field name="usr_status">
<type>string</type>
<required>false</required>
</field>
<field name="usr_emp_type">
<type>string</type>
<required>false</required>
</field>
<field name="usr_login">
<type>string</type>
<required>true</required>
</field>
<field name="usr_pwd_expire_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_pwd_warn_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_manager_key">
<type>number</type>
<required>false</required>
</field>
<field name="usr_pwd_warned">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_expired">
<type>string</type>
<required>false</required>
</field>
<field name="usr_start_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_end_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_provisioning_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_deprovisioning_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_provisioned_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_deprovisioned_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_email">
<type>string</type>
<required>false</required>
</field>
<field name="usr_locked">
<type>string</type>
<required>false</required>
</field>
<field name="usr_locked_on">
<type>date</type>
<required>false</required>
</field>
<field name="usr_automatically_delete_on">
<type>date</type>
<required>false</required>
</field>
<field name="usr_manually_locked">
<type>string</type>
<required>false</required>
</field>
<field name="usr_login_attempts_ctr">
<type>number</type>
<required>false</required>
</field>
<field name="usr_pwd_reset_attempts_ctr">
<type>number</type>
<required>false</required>
</field>
<field name="usr_data_level">
<type>string</type>
<required>false</required>
</field>
<field name="usr_change_pwd_at_next_logon">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_min_age_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_create">
<type>date</type>
<required>false</required>
</field>
<field name="usr_update">
<type>date</type>
<required>false</required>
</field>
<field name="usr_timezone">
<type>string</type>
<required>false</required>
</field>
<field name="usr_locale">
<type>string</type>
<required>false</required>
</field>
<field name="usr_createby">
<type>number</type>
<required>false</required>
</field>
<field name="usr_updateby">
<type>number</type>
<required>false</required>
</field>
<field name="usr_created">
<type>date</type>
<required>false</required>
</field>
<field name="usr_policy_update">
<type>string</type>
<required>false</required>
</field>
<field name="usr_country">
<type>string</type>
<required>false</required>
</field>
<field name="usr_dept_no">
<type>string</type>
<required>false</required>
</field>
<field name="usr_description">
<type>string</type>
<required>false</required>
</field>
<field name="usr_common_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_emp_no">
<type>string</type>
<required>false</required>
</field>
<field name="usr_fax">
<type>string</type>
<required>false</required>
</field>
<field name="usr_gen_qualifier">
<type>string</type>
<required>false</required>
</field>
<field name="usr_hire_date">
<type>date</type>
<required>false</required>
</field>
<field name="usr_home_phone">
<type>string</type>
<required>false</required>
</field>
<field name="usr_locality_name">
<type>string</type>
<required>false</required>
</field>
<field name="usr_mobile">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pager">
<type>string</type>
<required>false</required>
</field>
<field name="usr_home_postal_address">
<type>string</type>
<required>false</required>
</field>
<field name="usr_postal_address">
<type>string</type>
<required>false</required>
</field>
<field name="usr_postal_code">
<type>string</type>
<required>false</required>
</field>
<field name="usr_po_box">
<type>string</type>
<required>false</required>
</field>
<field name="usr_state">
<type>string</type>
<required>false</required>
</field>
<field name="usr_street">
<type>string</type>
<required>false</required>
</field>
<field name="usr_telephone_number">
<type>string</type>
<required>false</required>
</field>
<field name="usr_title">
<type>string</type>
<required>false</required>
</field>
<field name="usr_initials">
<type>string</type>
<required>false</required>
</field>
<field name="usr_pwd_generated">
<type>string</type>
<required>false</required>
</field>
<field name="usr_ldap_organization">
<type>string</type>
<required>false</required>
</field>
<field name="usr_ldap_organization_unit">
<type>string</type>
<required>false</required>
</field>
<field name="usr_ldap_guid">
<type>string</type>
<required>false</required>
</field>
<field name="usr_ldap_dn">
<type>string</type>
<required>false</required>
</field>
<field name="usr_language">
<type>string</type>
<required>false</required>
</field>    <field name="usr_color_contrast">
<type>string</type>
<required>false</required>
</field>
<field name="usr_accessibility_mode">
<type>string</type>
<required>false</required>
</field>
<field name="usr_time_format">
<type>string</type>
<required>false</required>
</field>
<field name="usr_date_format">
<type>string</type>
<required>false</required>
</field>
<field name="usr_currency">
<type>string</type>
<required>false</required>
</field>
<field name="usr_number_format">
<type>string</type>
<required>false</required>
</field>
<field name="usr_font_size">
<type>string</type>
<required>false</required>
</field>
<field name="usr_embedded_help">
<type>string</type>
<required>false</required>
</field>
<field name="usr_territory">
<type>string</type>
<required>false</required>
</field>
<field name="usr_name_preferred_lang">
<type>string</type>
<required>false</required>
</field>
</target-fields>
<!-- The attribute mapping defines which backend DB columns are mapped to the frontend attributes exposed at the API level -->
<attribute-maps>
<attribute-map>
<entity-attribute>usr_key</entity-attribute>
<target-field>usr_key</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>act_key</entity-attribute>
<target-field>act_key</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Last Name</entity-attribute>
<target-field>usr_last_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>First Name</entity-attribute>
<target-field>usr_first_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Middle Name</entity-attribute>
<target-field>usr_middle_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Full Name</entity-attribute>
<target-field>usr_full_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Display Name</entity-attribute>
<target-field>usr_display_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Xellerate Type</entity-attribute>
<target-field>usr_type</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_password</entity-attribute>
<target-field>usr_password</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_disabled</entity-attribute>
<target-field>usr_disabled</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_cant_change</entity-attribute>
<target-field>usr_pwd_cant_change</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_must_change</entity-attribute>
<target-field>usr_pwd_must_change</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_never_expires</entity-attribute>
<target-field>usr_pwd_never_expires</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Status</entity-attribute>
<target-field>usr_status</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Role</entity-attribute>
<target-field>usr_emp_type</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>User Login</entity-attribute>
<target-field>usr_login</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_expire_date</entity-attribute>
<target-field>usr_pwd_expire_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_warn_date</entity-attribute>
<target-field>usr_pwd_warn_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_manager_key</entity-attribute>
<target-field>usr_manager_key</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_expired</entity-attribute>
<target-field>usr_pwd_expired</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_warned</entity-attribute>
<target-field>usr_pwd_warned</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Start Date</entity-attribute>
<target-field>usr_start_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>End Date</entity-attribute>
<target-field>usr_end_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_provisioning_date</entity-attribute>
<target-field>usr_provisioning_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_deprovisioning_date</entity-attribute>
<target-field>usr_deprovisioning_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_provisioned_date</entity-attribute>
<target-field>usr_provisioned_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_deprovisioned_date</entity-attribute>
<target-field>usr_deprovisioned_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Email</entity-attribute>
<target-field>usr_email</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_locked</entity-attribute>
<target-field>usr_locked</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Locked On</entity-attribute>
<target-field>usr_locked_on</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Automatically Delete On</entity-attribute>
<target-field>usr_automatically_delete_on</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Manually Locked</entity-attribute>
<target-field>usr_manually_locked</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Automatically Delete On</entity-attribute>
<target-field>usr_automatically_delete_on</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_login_attempts_ctr</entity-attribute>
<target-field>usr_login_attempts_ctr</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_reset_attempts_ctr</entity-attribute>
<target-field>usr_pwd_reset_attempts_ctr</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_data_level</entity-attribute>
<target-field>usr_data_level</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_change_pwd_at_next_logon</entity-attribute>
<target-field>usr_change_pwd_at_next_logon</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_pwd_min_age_date</entity-attribute>
<target-field>usr_pwd_min_age_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_create</entity-attribute>
<target-field>usr_create</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_update</entity-attribute>
<target-field>usr_update</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_timezone</entity-attribute>
<target-field>usr_timezone</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_locale</entity-attribute>
<target-field>usr_locale</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_createby</entity-attribute>
<target-field>usr_createby</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_updateby</entity-attribute>
<target-field>usr_updateby</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_created</entity-attribute>
<target-field>usr_created</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>usr_policy_update</entity-attribute>
<target-field>usr_policy_update</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Country</entity-attribute>
<target-field>usr_country</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Department Number</entity-attribute>
<target-field>usr_dept_no</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Description</entity-attribute>
<target-field>usr_description</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Common Name</entity-attribute>
<target-field>usr_common_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Employee Number</entity-attribute>
<target-field>usr_emp_no</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Fax</entity-attribute>
<target-field>usr_fax</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Generation Qualifier</entity-attribute>
<target-field>usr_gen_qualifier</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Hire Date</entity-attribute>
<target-field>usr_hire_date</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Home Phone</entity-attribute>
<target-field>usr_home_phone</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Locality Name</entity-attribute>
<target-field>usr_locality_name</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Mobile</entity-attribute>
<target-field>usr_mobile</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Pager</entity-attribute>
<target-field>usr_pager</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Home Postal Address</entity-attribute>
<target-field>usr_home_postal_address</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Postal Address</entity-attribute>
<target-field>usr_postal_address</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Postal Code</entity-attribute>
<target-field>usr_postal_code</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>PO Box</entity-attribute>
<target-field>usr_po_box</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>State</entity-attribute>
<target-field>usr_state</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Street</entity-attribute>
<target-field>usr_street</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Telephone Number</entity-attribute>
<target-field>usr_telephone_number</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Title</entity-attribute>
<target-field>usr_title</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Initials</entity-attribute>
<target-field>usr_initials</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Password Generated</entity-attribute>
<target-field>usr_pwd_generated</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>LDAP Organization</entity-attribute>
<target-field>usr_ldap_organization</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>LDAP Organization Unit</entity-attribute>
<target-field>usr_ldap_organization_unit</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>LDAP GUID</entity-attribute>
<target-field>usr_ldap_guid</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>LDAP DN</entity-attribute>
<target-field>usr_ldap_dn</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>FA Language</entity-attribute>
<target-field>usr_language</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Embedded Help</entity-attribute>
<target-field>usr_embedded_help</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Font Size</entity-attribute>
<target-field>usr_font_size</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Color Contrast</entity-attribute>
<target-field>usr_color_contrast</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Accessibility Mode</entity-attribute>
<target-field>usr_accessibility_mode</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Number Format</entity-attribute>
<target-field>usr_number_format</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Date Format</entity-attribute>
<target-field>usr_date_format</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Time Format</entity-attribute>
<target-field>usr_time_format</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>Currency</entity-attribute>
<target-field>usr_currency</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>FA Territory</entity-attribute>
<target-field>usr_territory</target-field>
</attribute-map>
<attribute-map>
<entity-attribute>User Name Preferred Language</entity-attribute>
<target-field>usr_name_preferred_lang</target-field>
</attribute-map>
</attribute-maps>
<!-- The following section defines various User configurations for the UI -->
<metadata-attachment xmlns="">
<!-- 1 -->
<!--
This section defines the categories that will be available in the UI. Each attribute must belong to one of these categories
-->
<metadata>
<!-- The unique ID of the category -->
<name>Basic User Information</name>
<!-- The display name of the category. This will be a key in a bundle which will be fetched by the config API -->
<value>Basic User Information</value>
<category>categories</category>
</metadata>
<metadata>
<name>Account Settings</name>
<value>Account Settings</value>
<category>categories</category>
</metadata>
<metadata>
<name>Account Effective Dates</name>
<value>Account Effective Dates</value>
<category>categories</category>
</metadata>
<metadata>
<name>Provisioning Dates</name>
<value>Provisioning Dates</value>
<category>categories</category>
</metadata>
<metadata>
<name>Lifecycle</name>
<value>Lifecycle</value>
<category>categories</category>
</metadata>
<metadata>
<name>System</name>
<value>System</value>
<category>categories</category>
</metadata>
<metadata>
<name>Other User Attributes</name>
<value>Other User Attributes</value>
<category>categories</category>
</metadata>
<metadata>
<!-- The unique ID of the category -->
<name>CustomAttributes</name>
<!-- The display name of the category. This will be a key in a bundle which will be fetched by the config API -->
<value>Custom Attributes</value>
<category>categories</category>
</metadata>
<metadata>
<name>Preferences</name>
<value>Preferences</value>
<category>categories</category>
</metadata>

<!-- 2 -->
<!--
This section defines the ordering amongst the categories
-->

<metadata>
<name>1</name>
<value>Basic User Information</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>2</name>
<value>Account Settings</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>3</name>
<value>Account Effective Dates</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>4</name>
<value>Provisioning Dates</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>5</name>
<value>Lifecycle</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>6</name>
<value>System</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>7</name>
<value>Other User Attributes</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>8</name>
<value>CustomAttributes</value>
<category>categories.order</category>
</metadata>
<metadata>
<name>9</name>
<value>Preferences</value>
<category>categories.order</category>
</metadata>

<!-- 3 -->
<!--
This section defines the ordering of the attributes within each category. The attributes will be displayed on the UI in the order defined here.
-->
<metadata>
<name>1</name>
<value>User Login</value>
<category>categories.Account Settings</category>
</metadata>
<metadata>
<name>2</name>
<value>usr_password</value>
<category>categories.Account Settings</category>
</metadata>
<metadata>
<name>3</name>
<value>Status</value>
<category>categories.Account Settings</category>
</metadata>
<metadata>
<name>4</name>
<value>usr_locked</value>
<category>categories.Account Settings</category>
</metadata>
<metadata>
<name>5</name>
<value>usr_key</value>
<category>categories.Account Settings</category>
</metadata>

<metadata>
<name>1</name>
<value>First Name</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>2</name>
<value>Middle Name</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>3</name>
<value>Last Name</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>4</name>
<value>Xellerate Type</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>5</name>
<value>Email</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>6</name>
<value>usr_manager_key</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>7</name>
<value>act_key</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>8</name>
<value>Role</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>9</name>
<value>Full Name</value>
<category>categories.Basic User Information</category>
</metadata>

<metadata>
<name>10</name>
<value>Display Name</value>
<category>categories.Basic User Information</category>
</metadata>
<metadata>
<name>1</name>
<value>Start Date</value>
<category>categories.Account Effective Dates</category>
</metadata>

<metadata>
<name>2</name>
<value>End Date</value>
<category>categories.Account Effective Dates</category>
</metadata>
<metadata>
<name>1</name>
<value>usr_provisioning_date</value>
<category>categories.Provisioning Dates</category>
</metadata>

<metadata>
<name>2</name>
<value>usr_deprovisioning_date</value>
<category>categories.Provisioning Dates</category>
</metadata>
<metadata>
<name>1</name>
<value>Manually Locked</value>
<category>categories.Lifecycle</category>
</metadata>
<metadata>
<name>2</name>
<value>Locked On</value>
<category>categories.Lifecycle</category>
</metadata>

<metadata>
<name>3</name>
<value>Automatically Delete On</value>
<category>categories.Lifecycle</category>
</metadata>
<metadata>
<name>1</name>
<value>usr_provisioned_date</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>2</name>
<value>usr_deprovisioned_date</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>3</name>
<value>usr_login_attempts_ctr</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>4</name>
<value>usr_create</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>5</name>
<value>usr_update</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>6</name>
<value>usr_pwd_cant_change</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>7</name>
<value>usr_pwd_must_change</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>8</name>
<value>usr_pwd_never_expires</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>9</name>
<value>usr_pwd_expire_date</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>10</name>
<value>usr_pwd_warn_date</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>11</name>
<value>usr_pwd_expired</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>12</name>
<value>usr_pwd_warned</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>13</name>
<value>usr_pwd_reset_attempts_ctr</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>14</name>
<value>usr_change_pwd_at_next_logon</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>15</name>
<value>usr_pwd_min_age_date</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>16</name>
<value>usr_createby</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>17</name>
<value>usr_updateby</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>18</name>
<value>usr_created</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>19</name>
<value>usr_policy_update</value>
<category>categories.System</category>
</metadata>

<metadata>
<name>20</name>
<value>Password Generated</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>21</name>
<value>usr_data_level</value>
<category>categories.System</category>
</metadata>
<metadata>
<name>1</name>
<value>Country</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>2</name>
<value>Department Number</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>3</name>
<value>Description</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>4</name>
<value>Common Name</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>5</name>
<value>Employee Number</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>6</name>
<value>Fax</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>7</name>
<value>Generation Qualifier</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>8</name>
<value>Hire Date</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>9</name>
<value>Home Phone</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>10</name>
<value>Locality Name</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>11</name>
<value>Mobile</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>12</name>
<value>Pager</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>13</name>
<value>Home Postal Address</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>14</name>
<value>Postal Address</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>15</name>
<value>Postal Code</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>16</name>
<value>PO Box</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>17</name>
<value>State</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>18</name>
<value>Street</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>19</name>
<value>Telephone Number</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>20</name>
<value>Title</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>21</name>
<value>Initials</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>22</name>
<value>LDAP Organization</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>23</name>
<value>LDAP Organization Unit</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>24</name>
<value>LDAP GUID</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>25</name>
<value>LDAP DN</value>
<category>categories.Other User Attributes</category>
</metadata>
<metadata>
<name>1</name>
<value>usr_locale</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>2</name>
<value>usr_timezone</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>3</name>
<value>Number Format</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>4</name>
<value>Currency</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>5</name>
<value>Date Format</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>6</name>
<value>Time Format</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>7</name>
<value>Accessibility Mode</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>8</name>
<value>Color Contrast</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>9</name>
<value>Font Size</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>10</name>
<value>Embedded Help</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>11</name>
<value>FA Language</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>12</name>
<value>FA Territory</value>
<category>categories.Preferences</category>
</metadata>
<metadata>
<name>13</name>
<value>User Name Preferred Language</value>
<category>categories.Preferences</category>
</metadata>
<!-- 4 -->
<!--
This section defines the attributes that will be available in advanced search
-->
<metadata>
<name>User Login</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>First Name</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Middle Name</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Last Name</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Display Name</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Role</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>act_key</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_manager_key</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Start Date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>End Date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Status</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Xellerate Type</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_locked</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>Email</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<!--<metadata>
<name>Phone</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>-->
<metadata>
<name>usr_locale</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_timezone</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_provisioning_date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_deprovisioning_date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_provisioned_date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>
<metadata>
<name>usr_deprovisioned_date</name>
<value></value>
<category>Advanced Search.Attributes</category>
</metadata>

<!-- 5 -->
<!--
This section defines attributes that will be used for simple search
-->
<metadata>
<name>Display Name</name>
<value></value>
<category>Simple Search.Attributes</category>
</metadata>
<metadata>
<name>User Login</name>
<value></value>
<category>Simple Search.Attributes</category>
</metadata>
<metadata>
<name>First Name</name>
<value></value>
<category>Simple Search.Attributes</category>
</metadata>
<metadata>
<name>Last Name</name>
<value></value>
<category>Simple Search.Attributes</category>
</metadata>

<!-- 6 -->
<!--
This section defines attributes and their ordering in the advanced search results table. The simple search results table will use the first two defined here.
-->
<metadata>
<name>1</name>
<value>Display Name</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>2</name>
<value>User Login</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>3</name>
<value>First Name</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>4</name>
<value>Last Name</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>5</name>
<value>act_key</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>6</name>
<value>usr_manager_key</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>7</name>
<value>Status</value>
<category>Search Results.Attributes</category>
</metadata>
<metadata>
<name>8</name>
<value>usr_locked</value>
<category>Search Results.Attributes</category>
</metadata>

<!-- 7 -->
<!--
This section defines derived attributes. That is, attributes whose value is based on other attribute values.
-->
<!--
<metadata>
<name>Full Name</name>
<value></value>
<category>Derived Attributes</category>
</metadata>
-->
<!--<metadata>
<name>1</name>
<value>Last Name</value>
<category>Derived Attributes.Full Name</category>
</metadata>
<metadata>
<name>2</name>
<value>, </value>
<category>Derived Attributes.Full Name</category>
</metadata>
<metadata>
<name>3</name>
<value>First Name</value>
<category>Derived Attributes.Full Name</category>
</metadata>-->

</metadata-attachment>
</tns:entity-definition>

User.xmlファイルは、エンティティ・スキーマ・ファイル(Entity.xsd)に準拠している必要があります。

例13-2に、サンプルのEntity.xsdファイルのコードを示します。

例13-2 エンティティXML定義

<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://www.oracle.com/schema/oim/entity" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.oracle.com/schema/oim/entity">
<element name="entity-definition"
type="tns:entity-definition-type">
</element>

<complexType name="entity-definition-type">
<all>
<element name="entity-type" minOccurs="1" maxOccurs="1">
<complexType>
<simpleContent>
<extension base="string">
<attribute name="child-entity"
type="boolean">
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
<element name="description" type="string" maxOccurs="1"
minOccurs="0">
</element>
<element name="provider-instance"
type="tns:provider-instance-type" minOccurs="1"
maxOccurs="1">
</element>
<element name="container-capability"
type="tns:container-definition-type" maxOccurs="1"
minOccurs="1">
</element>
<element name="entity-attributes" maxOccurs="1"
minOccurs="1">
<complexType>
<sequence>
<element name="attribute"
type="tns:attribute-definition-type" maxOccurs="unbounded"
minOccurs="1">
</element>
</sequence>
</complexType>
</element>
<element name="target-fields" maxOccurs="1" minOccurs="1">
<complexType>
<sequence>
<element name="field"
type="tns:field-definition-type" maxOccurs="unbounded"
minOccurs="1">
</element>
</sequence>
</complexType>
</element>
<element name="attribute-maps" maxOccurs="1"
minOccurs="0">
<complexType>
<sequence>
<element name="attribute-map"
type="tns:attribute-map-definition-type"
maxOccurs="unbounded" minOccurs="1">
</element>
</sequence>
</complexType>
</element>
<element name="child-entities" maxOccurs="1"
minOccurs="0">
<complexType>
<sequence>
<element name="entity"
type="tns:attribute-definition-type" maxOccurs="unbounded"
minOccurs="1">
</element>
</sequence>
</complexType>
</element>
<element name="metadata-attachment" maxOccurs="1"
minOccurs="0">
<complexType>
<sequence>
<element name="metadata"
type="tns:metadata-attachment-type" maxOccurs="unbounded"
minOccurs="0">
</element>
</sequence>
</complexType>
</element>
<element name="control-attributes" minOccurs="0" maxOccurs="1">
<complexType>
<sequence>
<element name="attribute" minOccurs="1" maxOccurs="unbounded">
<complexType>
<sequence>
<element name="type" type="string"
minOccurs="1" maxOccurs="1">
</element>
<element name="description"
type="string" minOccurs="0" maxOccurs="1">
</element>
<element name="required"
type="boolean" minOccurs="1" maxOccurs="1">
</element>
</sequence>
<attribute name="name"
type="string" use="required">
</attribute>
</complexType></element>
</sequence>
</complexType></element>
</all>
</complexType>

<complexType name="provider-instance-type">
<all>
<element name="repository-instance" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="provider-type" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="parameters" minOccurs="0" maxOccurs="1">
<complexType>
<sequence>
<element name="parameter" maxOccurs="unbounded" minOccurs="1">
<complexType>
<sequence>
<element name="value" type="string" maxOccurs="unbounded" minOccurs="1">
</element>
</sequence>
<attribute name="name" type="string">
</attribute>
</complexType>
</element>
</sequence>
</complexType>
</element>
</all>
</complexType>

<complexType name="parameter-definition-type">
<all>
<element name="type" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="description" type="string" maxOccurs="1" minOccurs="0">
</element>
<element name="required" type="boolean" maxOccurs="1" minOccurs="1">
</element>
<element name="multi-valued" type="boolean" maxOccurs="1" minOccurs="0">
</element>
</all>
<attribute name="name" type="string"></attribute>
</complexType>

<complexType name="attribute-definition-type">
<all>
<element name="type" type="string" maxOccurs="1"
minOccurs="1">
</element>
<element name="description" type="string" maxOccurs="1"
minOccurs="0">
</element>
<element name="required" type="boolean" maxOccurs="1"
minOccurs="1">
</element>
<element name="searchable" type="boolean" maxOccurs="1"
minOccurs="1">
</element>
<element name="MLS" type="boolean" minOccurs="0" maxOccurs="1"></element>
<element name="default-value" type="string" maxOccurs="1"
minOccurs="0">
</element>
<element name="attribute-group" type="string" maxOccurs="1"
minOccurs="1">
</element>
<element name="metadata-attachment" maxOccurs="1"
minOccurs="0">
<complexType>
<sequence>
<element name="metadata"
type="tns:metadata-attachment-type" maxOccurs="unbounded"
minOccurs="0">
</element>
</sequence>
</complexType>
</element>
</all>
<attribute name="name" type="string"></attribute>
</complexType>

<complexType name="field-definition-type">
<all>
<element name="type" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="description" type="string" maxOccurs="1" minOccurs="0">
</element>
<element name="required" type="boolean" maxOccurs="1" minOccurs="1">
</element>
</all>
<attribute name="name" type="string"></attribute>
</complexType>

<complexType name="attribute-map-definition-type">
<all>
<element name="entity-attribute" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="target-field" type="string" maxOccurs="1" minOccurs="1">
</element>
</all>
</complexType>

<element name="repository-definition"
type="tns:repository-definition-type">
</element>

<complexType name="repository-definition-type">
<all>
<element name="name" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="class" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="parameters" maxOccurs="1" minOccurs="0">
<complexType>
<sequence>
<element name="parameter-def" type="tns:parameter-definition-type" maxOccurs="unbounded" minOccurs="1">
</element>
</sequence>
</complexType>
</element>
<element name="description" type="string" maxOccurs="1" minOccurs="0"></element>
</all>
</complexType>

<element name="provider-definition"
type="tns:provider-definition-type">
</element>

<complexType name="provider-definition-type">
<all>
<element name="name" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="type" maxOccurs="1" minOccurs="1">
<complexType>
<choice>
<element name="DataProvider" type="string"></element>
<element name="RelationProvider" type="string">
</element>
</choice>
</complexType>
</element>
<element name="class" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="description" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="parameters" maxOccurs="1" minOccurs="0">
<complexType>
<sequence>
<element name="parameter-def" type="tns:parameter-definition-type" maxOccurs="unbounded" minOccurs="1">
</element>
</sequence>
</complexType>
</element>
</all>
</complexType>

<element name="repository-instance">
<complexType>
<all>
<element name="name" type="string"></element>
<element name="type" type="string"></element>
<element name="parameters" maxOccurs="1" minOccurs="0">
<complexType>
<sequence>
<element name="parameter" maxOccurs="unbounded" minOccurs="1">
<complexType>
<sequence>
<element name="value" type="string" maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="name" type="string">
</attribute>
</complexType>
</element>
</sequence>
</complexType>
</element>
</all>
</complexType>
</element>

<complexType name="container-definition-type">
<sequence>
<element name="enabled" type="boolean" maxOccurs="1" minOccurs="1"></element>
<element name="contained-entity" type="string" maxOccurs="unbounded" minOccurs="0">
</element>
</sequence>
</complexType>

<complexType name="relation-definition-type">
<all>
<element name="relation-type" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="description" type="string" maxOccurs="1" minOccurs="0"></element>
<element name="provider-instance" type="tns:provider-instance-type" maxOccurs="1" minOccurs="1">
</element>
<element name="entity1" type="tns:relation-entity-type" maxOccurs="1" minOccurs="1">
</element>
<element name="entity2" type="tns:relation-entity-type" maxOccurs="1" minOccurs="1"></element>
<element name="relation-attributes" maxOccurs="1" minOccurs="1">
<complexType>
<sequence>
<element name="attribute" type="tns:attribute-definition-type" maxOccurs="unbounded" minOccurs="0">
</element>
</sequence>
</complexType>
</element>
<element name="target-fields" maxOccurs="1" minOccurs="1">
<complexType>
<sequence>
<element name="field" type="tns:field-definition-type" maxOccurs="unbounded" minOccurs="0">
</element>
</sequence>
</complexType>
</element>
<element name="attribute-maps" maxOccurs="1" minOccurs="0">
<complexType>
<sequence>
<element name="attribute-map" type="tns:attribute-map-definition-type" maxOccurs="unbounded" minOccurs="1">
</element>
</sequence>
</complexType>
</element>
</all>
</complexType>

<element name="relation-definition"
type="tns:relation-definition-type">
</element>

<complexType name="relation-entity-type">
<all>
<element name="entity-type" type="string"></element>
<element name="attribute" type="string"></element>
<element name="attribute-in-entity" type="string"></element>
<element name="attribute-group" type="string" maxOccurs="1" minOccurs="1"></element>
</all>
</complexType>

<element name="datatype-definition"
type="tns:datatype-definition-type">
</element>

<complexType name="datatype-definition-type">
<all>
<element name="name" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="class" type="string" maxOccurs="1" minOccurs="1"></element>
<element name="base-type" type="string" maxOccurs="1" minOccurs="1"></element>
</all>
</complexType>

<complexType name="metadata-attachment-type">
<all>
<element name="name" type="string"></element>
<element name="value" type="string"></element>
<element name="category" type="string"></element>
</all>
</complexType>

<element name="derived-datatype-definition"
type="tns:derived-datatype-definition-type">
</element>

<complexType name="derived-datatype-definition-type">
<all>
<element name="name" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="class" type="string" maxOccurs="1" minOccurs="1">
</element>
<element name="parameters" minOccurs="0" maxOccurs="1">
<complexType>
<sequence>
<element name="parameter" maxOccurs="unbounded" minOccurs="1">
<complexType>
<sequence>
<element name="value" type="string" maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="name" type="string">
</attribute>
</complexType>
</element>
</sequence>
</complexType>
</element>
</all>
</complexType>
</schema>

エンティティXMLファイルはMDSに格納されます。新しい属性が追加されると、データベース・スキーマはMDS内のエンティティXMLとともに更新されます。構成サービスAPIを使用して属性情報を取得し、カスタムUIの構築時に使用できます。

14 パスワード・ポリシーの管理

Oracle Identity Manager Design Consoleの管理フォルダを使用して、Oracle Identity Managerを管理できます。

関連項目:

Oracle Identity Manager Design ConsoleおよびOracle Identity Manager Design Consoleで使用可能なすべてのフォームに関する詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドを参照してください。

Oracle Identity Manager Design Consoleの管理フォルダを使用して、次のタスクを実行できます。

- パスワード・ポリシーの作成

- パスワード・ポリシーの基準の設定

14.1 パスワード・ポリシーの作成

Oracle Identity Manager Design Consoleでパスワード・ポリシー・フォームを使用してパスワード・ポリシーを作成し、以下の操作を実行できます。

- パスワードの制限の設定、たとえばパスワードの最小長と最大長の定義など

- パスワード・ポリシーに関連付けられているルールおよびリソース・オブジェクトの参照

パスワード・ポリシーを作成するには:

1. パスワード・ポリシーフォームを開きます。図14-1にパスワード・ポリシー・フォームを示します。

図14-1 パスワード・ポリシー・フォーム

「図14-1 「パスワード・ポリシー・フォーム」の説明

2. ポリシー名フィールドに、パスワード・ポリシーの名前を入力します。

3. ポリシー説明フィールドに、パスワード・ポリシーの簡単な説明を入力します。

4. 「保存」をクリックします。

注意:

- パスワード・ポリシーは、信頼できるリコンシリエーションによるOracle Identity Managerユーザーの作成時には適用されません。

- パスワード・ポリシーの作成後、基準を指定してリソースと関連付ける必要があります。パスワード・ポリシーに基準を指定するには、このフォームのポリシー・ルール・タブを使用します。パスワード・ポリシーをリソースと関連付けるには、リソース・オブジェクト・フォームのパスワード・ポリシー・ルール・タブを使用して、リソース上でアカウントが作成または更新されたときに評価されるパスワード・ポリシーとルールの組合せを作成します。パスワード・ポリシーは、そのルールの基準が満たされる場合に適用されます。各パスワード・ポリシーを複数のリソースで使用できます。
2つの異なるパスワード・ポリシーのルールで、同じリソースが受け入れられることがあります。ただし、ルールにアタッチされたパスワード・ポリシーのうち、最も優先度が高いものが適用されます。

リソースをパスワード・ポリシーに関連付ける方法の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのリソース・オブジェクトへのパスワード・ポリシー・ルールの追加に関する説明を参照してください。

このフォームのタブは、パスワード・ポリシーを作成すると使用可能になります。これらのタブを使用して、パスワード・ポリシーに基準を設定し、現在のパスワード・ポリシーに関連付けられているルールとリソース・オブジェクトを表示します。次の各項では、これらのタブについて説明します。

- ポリシー・ルール・タブ

- 使用状況タブ

14.1.1 ポリシー・ルール・タブ

ポリシー・ルール・タブを使用して、パスワード・ポリシーの基準(たとえばパスワードの最小長と最大長)を指定します。

パスワードの制限を設定するには、次のいずれか(または両方)の方法を使用できます。

- 適切なフィールドに情報を入力するか、必要なチェック・ボックスを選択します。たとえば、パスワードの最小長を4文字にする必要があることを指定するには、最小長フィールドに4を入力します。

- 「パスワード・ファイル」フィールドに、パスワード・ポリシー・ファイルのディレクトリ・パスと名前(たとえばc:\xellerate\userlimits.txt)を入力します。このファイルには、パスワードとしての使用を避ける必要がある事前定義済の単語が含まれます。これらの単語は、パスワード・ファイル・デリミタフィールドに指定したデリミタで区切られます。このファイル内の事前定義済の単語は、パスワードとして使用できません。たとえば、このファイルにwelcomeという単語が含まれている場合、welcome、Welcomeおよびwelcome123は無効なパスワードになります。

図14-1に、パスワード・ポリシー・フォームのポリシー・ルール・タブを示します。

表14-1では、ポリシー・ルールタブのデータ・フィールドについて説明します。これらのフィールドでパスワード・ポリシーの基準を指定します。

注意:

ポリシーのデータ・フィールドが空欄の場合、パスワードを有効にするために、このポリシーに適合するパスワードがそのフィールドの基準を満たす必要はありません。たとえば、最小英数字データ・フィールドが空欄の場合、Oracle Identity Managerでは、文字数に関係なくパスワードが受け入れられます。

表14-1 パスワード・ポリシー・フォームのポリシー・ルール・タブのフィールド

フィールド名

説明

最小長

パスワードを有効にするために必要な最小文字数。

たとえば、最小長フィールドに4を入力した場合、パスワードは4文字以上にする必要があります。

このフィールドには0 - 999の値を入力できます。

有効日数

パスワードを使用できる日数。

たとえば、有効日数フィールドに30を入力した場合、パスワードを作成または最終変更したときから30日目までに変更する必要があります。

注意: 有効日数フィールドに指定された日数が経過すると、パスワードの変更を求めるメッセージが表示されます。

このフィールドには0 - 999の値を入力できます。

最近のパスワードを許可しない

旧パスワードを再利用できる頻度。このポリシーにより、一連の共通パスワードが使い回されることのないようにします。

たとえば、最近のパスワードを許可しないフィールドに10を入力した場合、10個の異なるパスワードを使用した後にのみパスワードを再利用できます。

このフィールドには0 - 24の値を入力できます。

警告までの期間(日数)

パスワードが指定の日付に期限切れになることをユーザーに通知するまでの経過日数。

たとえば、有効日数フィールドに30を入力し、警告までの期間(日数)フィールドに20を入力し、パスワードが11月1日に作成されたとします。11月21日に、パスワードが12月1日に期限切れになることがユーザーに通知されます。

このフィールドには0 - 999の値を入力できます。

パスワード・ポリシー・フォームのポリシー・ルール・タブでは、複雑なパスワードまたはカスタム・パスワード・ポリシーのいずれかを構成できます。複雑なパスワード・オプションを選択すると、カスタム・パスワード・オプション設定は使用できず、パスワードはポリシー・ルール・タブで入力した複雑なパスワードの基準に対して評価されます。

次の各項では、ポリシー・ルール・タブの残りのフィールドについて説明します。

- 複雑なパスワード

- カスタム・ポリシー

複雑なパスワード

複雑なパスワードの基準は次のとおりです。

- パスワードの長さは6文字以上であること。最小長フィールドに入力された値が6未満の場合、このパスワードの長さが最小長フィールドより優先されます。たとえば、最小長フィールドに2を入力した場合、複雑なパスワードの基準に従って最低6文字が必要であるため、パスワードには6文字以上が必要です。

- パスワードには、次の5種類のうち3種類以上の文字が含まれていること。

- 英大文字(A - Z)

- 英小文字(a - z)

- 10進法の数字(0 - 9)

- 英数字以外の文字(!、$、#、%など)

- Unicode文字

- パスワードには、3文字以上のユーザーのラスト・ネーム、ファースト・ネーム、ユーザーIDを含めてはなりません。
名前は、カンマ、ピリオド、ダッシュ/ハイフン、アンダースコア、スペース、ポンド記号、タブをデリミタとして解析されます。これらのデリミタのいずれかが検出されると、名前は分割され、すべての部分がパスワードに含まれていないか検証されます。たとえば、ユーザー名がjohn-dの場合は、dは長さが2未満のため、パスワードでチェックされません。同様に、名前がJohn Richard Doeの場合は、john、richard、doeはパスワードに含めることはできません。

ユーザーの氏名に対するチェックでは、カンマ、ピリオド、ダッシュやハイフン、アンダースコア、スペース、ポンド記号、タブなどの文字は、名前を個別のキャラクタ・セットに区切るデリミタとして扱われます。3文字以上を含む各キャラクタ・セットが、パスワード内で検索されます。そのキャラクタ・セットがパスワード内に存在する場合、パスワード変更は却下されます。たとえば、名前John Richard-Doeは、3つのキャラクタ・セット(John、RichardおよびDoe)に分けられます。このユーザーは、パスワード内のどの場所であっても、John、RichardまたはDoeからの連続した3文字で構成されるパスワードを持つことはできません。ただし、パスワードには部分文字列d-Dを含めることができます(ハイフン(-)は部分文字列RichardとDoeの間のデリミタとして扱われるため)。また、パスワード内のキャラクタ・セットの検索では、大文字と小文字は区別されません。

注意:

ユーザーのフル・ネームの長さが3文字未満の場合、パスワードが拒否される確率が高すぎるため、パスワードはフル・ネームと照合されません。

カスタム・ポリシー

カスタム・ポリシーオプションを選択すると、表14-2に示すフィールドを使用してカスタム・パスワード・ポリシーを設定できます。

表14-2 カスタム・パスワード・ポリシーを設定するためのポリシー・ルール・タブのフィールド

フィールド名

説明

最大長

パスワードに含めることができる最大文字数

たとえば、最大長フィールドに8を入力した場合、9文字以上のパスワードは使用できません。

このフィールドには1 - 999の値を入力できます。

最大限の繰返し文字数

パスワードで文字を繰り返すことができる最大回数。

たとえば、最大限の繰返し文字数フィールドに2を入力した場合、文字が3回以上繰り返されているパスワードは使用できません。たとえば、RL112211は、文字1が3回繰り返されているため、有効なパスワードではありません。

注意: この例では、文字1は4つあり、3回繰り返されていることになります。

このフィールドには1 - 999の値を入力できます。

最小限の数字数

パスワードに含める必要がある最小限の数字の数。

たとえば、最小限の数字数フィールドに1を入力した場合、パスワードには少なくとも1つの数字が含まれる必要があります。

このフィールドには0 - 999の値を入力できます。

最小限の英数字数

パスワードに含める必要がある文字または数字の最小数。

たとえば、最小限の英数字数フィールドに6を入力した場合、パスワードには少なくとも6つの文字または数字が含まれる必要があります。

このフィールドには0 - 999の値を入力できます。

最小限のユニーク文字数

パスワードに含める必要がある、繰り返されない文字の最小数。

たとえば、最小限のユニーク文字数フィールドに1を入力した場合、パスワード内の少なくとも1つの文字が繰り返されていなければパスワードは受け入れられます。たとえば、1a23321では、文字aが繰り返されていないため、他の文字が繰り返されていても有効なパスワードです。

このフィールドには0 - 999の値を入力できます。

最小限の英字数

パスワードに含める必要がある最小限の文字数。

たとえば、最小限の英字数フィールドに2を入力した場合、2文字未満のパスワードは使用できません。

このフィールドには0 - 999の値を入力できます。

特殊文字: 最小数

パスワードに含める必要がある英数字以外の文字(#、%、&など)の最小数。

たとえば、特殊文字: 最小数フィールドに1を入力した場合、パスワードには英数字以外の文字が少なくとも1つ含まれる必要があります。

このフィールドには0 - 999の値を入力できます。

特殊文字: 最大数

パスワードに含めることができる英数字以外の文字の最大数。

たとえば、特殊文字: 最大数フィールドに3を入力した場合、英数字以外の文字が4つ以上含まれるパスワードは使用できません。

このフィールドには1 - 999の値を入力できます。

最小限の大文字数

パスワードに含める必要がある大文字の最小数。

たとえば、最小限の大文字数フィールドに8を入力した場合、大文字が8文字未満のパスワードは使用できません。

このフィールドには0 - 999の値を入力できます。

最小限の小文字数

パスワードに含める必要がある小文字の最小数。

たとえば、最小限の小文字数フィールドに8を入力した場合、小文字が8文字未満のパスワードは使用できません。

このフィールドには0 - 999の値を入力できます。

Unicode文字: 最小数

パスワードに含める必要があるUnicode文字の最小数。

たとえば、Unicode文字: 最小数フィールドに3を入力した場合、Unicode文字が3文字未満のパスワードは使用できません。

このフィールドには0 - 999の値を入力できます。

Unicode文字: 最大数

パスワードに含めることができるUnicode文字の最大数。

たとえば、Unicode文字: 最大数フィールドに8を入力した場合、Unicode文字が9文字以上のパスワードは使用できません。

このフィールドには1 - 999の値を入力できます。

必須の文字

パスワードに含める必要がある文字。

たとえば、必須の文字フィールドにxを入力した場合、文字xを含むパスワードのみ使用できます。

必須の文字フィールドに指定する文字は、許可される文字フィールドで指定する必要があります。「許可された文字」フィールドに存在しない文字を「必須の文字」フィールドに入力すると、必須の文字は許可された文字のリストに含まれている必要があること、および必須の文字は許可されない文字に含まれていてはいけないことを示すエラーが表示されます。

また、2文字以上を指定する場合は、デリミタを付けないでください。このフィールドではカンマとスペースも文字として解釈されます。たとえば、「a,x,c」などの文字を指定した場合、カンマを含まないパスワードは使用できません。

許可されない文字

パスワードに含めてはならない文字。

たとえば、許可されない文字フィールドに感嘆符(!)を入力した場合、感嘆符を含むパスワードは使用できません。

許可される文字

パスワードに含めることができる文字。

たとえば、許可される文字フィールドにパーセント記号(%)を入力した場合、他の基準をすべて満たしていれば、パーセント記号を含むパスワードを使用できます。

注意: パスワードに文字が含まれており、その文字が許可される文字フィールドにない場合、パスワードは拒否されます。たとえば、許可される文字フィールドでabcが指定されており、パスワードがdadの場合、dは許可される文字フィールドにないため、このパスワードは拒否されます。

許可される文字フィールドと許可されない文字フィールドに同じ文字を指定すると、パスワード・ポリシーの作成時にエラー・メッセージが返されます。

許可されない部分文字列

パスワードに含めてはならない英数字の連続文字列。

たとえば、許可されない部分文字列フィールドにIBMを入力した場合、文字I、B、Mの順に連続して含まれるパスワードは使用できません。

英字で開始

パスワードが英字で始まる必要があるかどうか。

たとえば、このオプションを選択した場合、パスワード123welcomeは、先頭が文字でないため使用できません。ただし、このオプションを選択しない場合、パスワードは英字、数字または特殊文字で始めることができます。

ユーザーIDを許可しない

このチェック・ボックスは、パスワードの全部または一部としてユーザーIDを使用できるかどうかを指定します。

このチェック・ボックスを選択した場合、「パスワードフィールドにユーザーIDが入力されると、パスワードは無効になります。また、パスワードフィールドにパスワードの一部としてユーザーIDが入力されると、パスワードは無効になります。

このチェック・ボックスの選択を解除した場合は、ユーザーIDが含まれているパスワードを使用できます。

ファースト・ネームを許可しない

このチェック・ボックスは、パスワードの全部または一部としてユーザーのファースト・ネームを使用できるかどうかを指定します。

このチェック・ボックスを選択した場合、「パスワードフィールドにユーザーのファースト・ネームが入力されると、パスワードは無効になります。また、ユーザーのファースト・ネームがパスワードの一部として入力されると、パスワードは無効になります。

このチェック・ボックスの選択を解除した場合は、ユーザーのファースト・ネームが含まれているパスワードを使用できます。

ラスト・ネームを許可しない

このチェック・ボックスは、パスワードの全部または一部としてユーザーのラスト・ネームを使用できるかどうかを指定します。

このチェック・ボックスを選択した場合は、パスワードフィールドにユーザーのラスト・ネームが入力されると、パスワードは無効になります。また、ユーザーのラスト・ネームがパスワードの一部として入力されると、パスワードは無効になります。

このチェック・ボックスの選択を解除した場合は、ユーザーのラスト・ネームが含まれているパスワードを使用できます。

パスワード・ファイル

パスワードとして許可されない事前定義済の用語が含まれるファイルのパスと名前。このファイルは、Oracle Identity Managerがデプロイされているホストに格納する必要があります。

注意: 「ポリシー・ルール」タブ上の設定は、パスワード・ファイル内の仕様よりも優先されます。たとえば、許可されない用語が「ポリシー・ルール」タブで指定されていないときに、パスワード・ファイルの許可されない用語がポリシー内で使用されることがあります。

パスワード・ファイル・デリミタ

パスワード・ファイル内で用語を区切るために使用されるデリミタ文字。

たとえば、パスワード・ファイル・デリミタフィールドにカンマ(,)を入力した場合、パスワード・ファイル内の用語はカンマで区切られます。

注意: パスワード・ポリシー内で使用するエスケープ文字は定義されていません。

いずれかのパスワードフィールドを使用してプロセス・フォームをリソースにアタッチできます。リソースに対して入力されたパスワードは、そのリソースに関連付けられているパスワード・ポリシーと照合されます。

14.1.2 使用状況タブ

このタブは、現在のパスワード・ポリシーに関連付けられているルールおよびリソース・オブジェクトを表示するために使用します。

図14-2は、パスワード・ポリシー・フォームの使用状況タブを示しています。この例では、ルールはSolarisパスワード・ポリシー用に定義されています。

図14-2 パスワード・ポリシー・フォームの使用状況タブ

「図14-2 パスワード・ポリシー・フォームの使用状況タブ」の説明

関連項目:

パスワード・ポリシーとリソース・オブジェクト間の関係の詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのパスワード・ポリシー・ルール・タブに関する項を参照してください。

14.2 パスワード・ポリシーの基準の設定

いずれかのパスワードフィールドを使用してプロセス・フォームをリソースにアタッチできます。リソースに対して入力されたパスワードは、そのリソースに関連付けられているパスワード・ポリシーと照合されます。

パスワード・ポリシーの基準の設定手順

1. 必要なパスワード・ポリシー定義を開きます。

2. ポリシー・ルールタブをクリックします。

3. 該当するフィールドに情報を入力するか、必要なチェック・ボックスを選択します。

4. 「保存」をクリックします。

15 アイデンティティおよびリソース情報の管理

この章では、Oracle Identity Manager Design Consoleのユーザー管理について説明します。次の項で構成されています。

- ユーザー管理の概要

- 組織情報の管理

- ユーザーに対して許可されているか、または許可されていないリソースの表示

- ロール・エンタイトルメントの割当て

15.1 ユーザー管理の概要

「ユーザー管理」フォルダには、会社の組織、ユーザー、ロールおよびリソースについての情報を作成、管理するためのツールがあります。

このフォルダには次のフォームが含まれています。

- 組織デフォルト: このフォームは、組織の内部構成を反映するレコードを表示したり、これらのエンティティに関連する情報を指定するために使用します。

- ポリシーの履歴: このフォームは、従業員が必要とするユーザー・レコードを表示するために使用します。

- ロール: このフォームは、ロールのレコードを表示するために使用します。このロールは以前のリリースのOracle Identity Managerではユーザー・グループと呼ばれていたもので、これに対して共通機能を割り当てることができます。

15.2 組織情報の管理

組織デフォルト・フォームは、「ユーザー管理」フォルダにあります。このフォームは、組織の構成を反映するレコードを表示したり、組織のエンティティに関連する情報を入力および変更するために使用します。組織のレコードには、会社、部門、支店などの組織単位に関する情報が含まれます。

サブ組織は、別の組織のメンバーである組織、たとえば、会社の部門などを指します。サブ組織が所属する組織は親組織と呼ばれます。

組織デフォルト・タブは、現在の組織に対してプロビジョニングできるリソースの、カスタムのプロセス・フォームのデフォルトのパラメータ値を指定するために使用します。各プロセス・フォームは、その組織に対して許可されているリソース・オブジェクト、または関連する「リソース・オブジェクト」フォームの「すべて許可」オプションが選択されているリソースに関連付けられています。

組織デフォルト・タブで指定された値は、組織のすべてのユーザーのデフォルト値になります。パスワードや暗号化されたパラメータにはデフォルト値を指定しないことをお薦めします。

図15-1に組織デフォルト・フォームを示します。

図15-1 組織デフォルト・フォーム

「図15-1 組織デフォルト・フォーム」の説明

表15-1に、組織デフォルト・フォームのフィールドの説明を示します。

表15-1 組織デフォルト・フォームのフィールド

フィールド名

説明

組織名

組織の名前。

タイプ

組織の分類タイプ(「会社」、「部門」、「支店」など)。

ステータス

組織の現在のステータス(「有効」、「無効」または「削除」のいずれか)。

親組織

この組織が所属する組織。親組織がこのフィールドに表示される場合、この組織は親組織のサブ組織タブに表示されます。このフィールドが空の場合、この組織は最上位の組織です。

15.3 ユーザーに対して許可されているか、または許可されていないリソースの表示

ポリシーの履歴フォームは、ユーザーに対して許可されているか、または許可されていないリソースについての情報を表示するために使用します。

Oracle Identity Managerでは、次の2つのユーザー・タイプがあります。

- エンドユーザー管理者: このユーザーは、Oracle Identity Manager Design Consoleや、Oracle Identity Manager管理およびユーザー・コンソールにアクセスできます。システム管理者は、エンドユーザー管理者がOracle Identity Manager Design Consoleでフォームのサブセットにアクセスできるように権限を設定します。

- エンドユーザー: このユーザーは、Oracle Identity Manager管理およびユーザー・コンソールのみにアクセスでき、一般にはエンドユーザー管理者より少ない権限を持ちます。管理およびユーザー・コンソールを使用してリクエストをプロビジョニングする場合に、ユーザーの組織の「許可済オブジェクト」タブでセルフサービスとして定義されているリソース・オブジェクトのみを使用できます。

表15-1に、このフォームを示します。

図15-2 ポリシーの履歴フォーム

「図15-2 ポリシーの履歴フォーム」の説明

表15-2に、ポリシーの履歴フォームのフィールドの説明を示します。

Table 15-2 ポリシーの履歴フォームのフィールド

フィールド名

説明

ユーザーID

ユーザーのOracle Identity ManagerログインID。

名

ユーザーのファースト・ネーム。

ミドルネーム

ユーザーのミドル・ネーム。

姓

ユーザーのラスト・ネーム。

電子メール・アドレス

ユーザーの電子メール・アドレス。

開始日

ユーザーのアカウントがアクティブになる日付。

ステータス

ユーザーの現在のステータス(「有効」、「無効」または「削除」のいずれか)。

組織

ユーザーが所属する組織。

ユーザー・タイプ

ユーザーの分類ステータス。有効なオプションは、「エンドユーザー」と「エンドユーザー管理者」です。Oracle Identity Manager Design Consoleへのアクセス権があるのは「エンドユーザー管理者」のみです。

従業員タイプ

親組織でのユーザーの雇用ステータス(たとえば、フルタイム、パート、研修生など)。

マネージャID

ユーザーのマネージャ。

終了日

ユーザーのアカウントが無効になる日付。

作成日

ユーザー・レコードが作成された日付と時刻。

15.3.1 ポリシーの履歴タブ

このタブは、次の基準に基づいてユーザーに対して許可されているか、または許可されていないリソース・オブジェクトを表示するために使用します。

- ユーザーが所属するユーザー・グループのアクセス・ポリシー

- ユーザーが所属する組織によって許可されているリソース・オブジェクト

ポリシーの履歴タブには、表示選択領域が含まれます。このタブの内容を整理するには、次に示すように、この領域の一番上のボックスに移動し、そのメニューから項目を選択します。

- リソース・ポリシー・サマリー: ユーザーの組織および適用されるアクセス・ポリシーに基づいて許可されているか、または許可されていないリソース・オブジェクトを表示します。

- 組織による不許可: ユーザーの組織に基づいて、許可されていないリソース・オブジェクトのみを表示します。

- ポリシーによるリソース: ユーザーがメンバーであるユーザー・グループのアクセス・ポリシーが含まれる2番目のボックスを表示します。
アクセス・ポリシーに基づいてユーザーに対して許可されているか、または許可されていないリソース・オブジェクトを表示するには、このボックスからアクセス・ポリシーを選択します。

トラッキング・システムを使用すると、ユーザーがメンバーである組織と、ユーザーに適用されるアクセス・ポリシーに基づいて、ユーザーが許可されているか、または許可されていないリソースを表示できます。

ユーザーに対して許可されているリソース・オブジェクトは、許可されたリソース・リストに表示されます。このリストは、そのユーザーに対してプロビジョニングできるリソース・オブジェクトを表しています。そのユーザーに対してプロビジョニングされているリソース・オブジェクトを表しているわけではありません。

そのユーザーに対して拒否されているリソース・オブジェクトは、許可されていないリソース・リストに表示されます。

トラッキング・システムを表示するには:

1. ポリシーの履歴タブに移動します。

2. このタブで表示選択領域を見つけます。

3. ポリシーの履歴をクリックします。

ユーザー・ポリシー・プロファイルの履歴ウィンドウから、次に示す手順で選択したユーザーおよび日時に対して許可されているか、または許可されていないリソースを表示できます。

- 履歴日付ボックスで、日付を選択できます。

- 「表示タイプ」ボックスから、ユーザーがメンバーである組織と、ユーザーに適用されるアクセス・ポリシーの、いずれかまたは両方に基づいて、ユーザーが許可されているか、または許可されていないリソースを表示できます。

- 「ポリシー」ボックスから、そのユーザーに対してどのリソース・オブジェクトが許可されるか許可されないかを決定するアクセス・ポリシーを表示できます。

15.4 ロール・エンタイトルメントの割当て

グループ・エンタイトルメント・フォームは、「ユーザー管理」フォルダに表示されます。これは、フォームの作成と移動、およびロールのメンバーがエクスプローラを使用してアクセスできるフォームおよびフォルダの指定を行うために使用します。

グループ・エンタイトルメント・フォームを使用してロールに対するフォームおよびフォルダを指定するには、次のようにします。

1. エクスプローラで、グループ・エンタイトルメントをダブルクリックします。
図15-3に示すように、ユーザー・グループ情報ページが表示されます。

図15-3 ロール・フォーム

「図15-3 ロール・フォーム」の説明

2. 「グループ名」フィールドに、ロールの名前を入力します。

3. 「割当て」をクリックします。
ユーザー・フォームの「割当て」参照表が表示されます。

4. 参照表から、このロールに対するユーザー・フォームを選択します。
矢印ボタンを使用して、割当てられるフォームリストに対して追加や削除を行います。

5. 「OK」をクリックします。
新しく追加したユーザー・フォームはグループ・エンタイトルメント表にリストされます。グループ・エンタイトルメント表には、選択できるすべてのロールが表示されます。この表には、ユーザー・フォームの名前とタイプが表示されます。グループ・エンタイトルメント表には、javaformとfolderの2つのタイプがあります。javaformはJavaベースのグラフィカル・インタフェースです。folderには、1つ以上のjavaformが含まれています。

関連項目:

Oracle Identity Managerの既存ロールの詳細は、「デフォルトのロール」を参照してください。

16 非同期実行の管理

この章では、Oracle Identity and Access Management (IAM)プラットフォームによって提供される非同期サービスについて説明します。この章の内容は次のとおりです。

- 16.1項「非同期サービスの概要」

- 16.2項「非同期ルーティングと構成」

- 16.3項「失敗した非同期タスクのトラブルシューティング」

- 16.4項「診断ダッシュボードUIの操作」

16.1 非同期サービスの概要

非同期サービスは、タスクを非同期で実行するためにIAMプラットフォームによって提供されるサービスの1つです。タスクは、パフォーマンスとスループットの改善のために非同期で実行されます。

アイデンティティ管理操作によっては、完了するまでに長時間かかる場合があります。そのため、これらの操作を2つの部分に分割し、短い同期相互作用の後に長い非同期プロセスが続くようにするのは意味のあることです。同期相互作用の終わりにユーザーに応答が返され、そして残りの操作が非同期で実行されます。

非同期サービスでは、Oracle Identity Managerコンポーネントはタスクを送信して非同期で実行させることができます。送信後、呼出し元は他のタスクを実行できます。このタスクの実行は非同期サービスが担当し、コンピューティング・リソースが使用可能なときに行われます。

16.2 非同期ルーティングと構成

非同期サービスは、構成ファイルasync-messaging.xmlを使用して非同期タスクをルーティングおよび構成します。この構成ファイルは、Oracle Identity ManagerデータベースのMetaData Store (MDS)スキーマに格納されています。MDSのファイル・パスは、/file/async-messaging.xmlです。

例16-1に、構成ファイルの抜粋を示します。

例16-1 構成ファイルの例

<tns:async-config>
<task-config>
<class>oracle.iam.reconciliation.impl.ActionTask</class>
<destination>queue/oimReconQueue</destination>
</task-config>
<task-config>
<class>com.thortech.xl.schedule.jms.messagetype.AttestationTaskMessage</class>
<destination>queue/oimAttestationQueue</destination>
<priority>NORMAL</priority>
<maxRetries>2</maxRetries>
</task-config>
<task-config>
<class>com.thortech.xl.schedule.jms.messagetype.AttestationRequestMessage</class>
<destination>queue/oimAttestationQueue</destination>
<priority>HIGH</priority>
</task-config>
<default-config>
<destination>queue/oimDefaultQueue</destination>
<maxRetries>3</maxRetries>
</default-config>
</tns:async-config>

構成ファイルを修正するには、MDSインポート・ユーティリティを使用してインポートし、ファイルを修正し、それからMDSエクスポート・ユーティリティを使用して修正したファイルをエクスポートします。MDSユーティリティの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザーが修正可能なメタデータ・ファイルに関する説明を参照してください。

16.2.1 構成パラメータ

システム管理者は、非同期タスクの構成ファイルで次のパラメータを構成できます。

- 宛先: 大量のタスクをそれぞれ独自の専用キューに割り当てることができます。たとえば、例16-1では、すべての非同期タスクが同じ宛先キューattestationQueueに割り当てられています。各非同期タスクに個別の宛先キューを作成して、各メッセージの送信先を定義することができます。

注意:

タスクをキューに割り当てる前に、そのキューがアプリケーション・サーバーに存在することを確認する必要があります。キューの作成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JMSの構成と管理』を参照してください。

- 優先度: 複数のタイプの非同期タスクが同じ宛先キューに割り当てられている場合は、優先度を設定できます。次のいずれかの値を設定できます。

- 標準

- 高

- 低

- 最大再試行数: 非同期タスク実行のエラー・リカバリは、自動と手動の2とおりで処理されます。自動再試行メカニズムでは、スケジュール済タスクを使用してすべての失敗タスクを特定の間隔で再試行します。システム管理者は、「最大再試行数」パラメータを使用して、実行失敗時にタスクを再試行できる最大回数を指定できます。エラー処理とリカバリ・メカニズムの詳細は、「失敗した非同期タスクのトラブルシューティング」を参照してください。

16.3 失敗した非同期タスクのトラブルシューティング

タスクまたはメッセージの実行時にエラーが発生する場合があります。非同期タスク実行のエラー・リカバリは、自動再試行と手動操作の組合せで行われます。タスクの実行中にエラーが発生すると、そのタスクはFailedTasks表に追加され、システム管理者に通知されます。エラー処理メカニズムの詳細は、「自動再試行のエラー処理メカニズム」および「手動再試行のエラー処理メカニズム」を参照してください。

16.3.1 自動再試行のエラー処理メカニズム

スケジュール済タスクにより、失敗したタスクは定期的な間隔で自動再試行されます。スケジュール済タスクによってタスクが再試行される最大回数は、例16-2に示すように、非同期タスクの最大再試行数プロパティを使用して構成できます。

例16-2 「最大再試行数」の構成

<async-task>
<class>oracle.iam.reconciliation.impl.ActionTask</class>
<destination>reconQueue</destination>
<max-retries>2</max-retries>
</async-task>

16.3.2 手動再試行のエラー処理メカニズム

システム管理者は、Oracle Identity Manager診断ダッシュボードのユーザー・インタフェース(UI)を使用して、失敗したタスクを表示して適切な対処を行った後でタスクを再試行します。Oracle Identity Manager診断ダッシュボードUIの詳細は、「診断ダッシュボードUIの操作」を参照してください。

16.4 診断ダッシュボードUIの操作

診断ダッシュボードには、システム管理者が失敗した非同期タスクを表示して再試行できるようにするUIが備えられています。この項の内容は次のとおりです。

- 診断ダッシュボードUIの起動

- 失敗した非同期タスクの表示

- 失敗した非同期タスクの再試行

- 失敗した非同期タスクの再送信

- 失敗した非同期タスクのパージ

関連項目:

診断ダッシュボードのインストールと有効化の詳細は、第20章「診断ダッシュボードの使用」を参照してください。

16.4.1 診断ダッシュボードUIの起動

診断ダッシュボードUIを起動するには:

1. 次のURLを使用して、「診断ダッシュボード」のホーム・ページにアクセスします。
http://host:port/XIMDD

2. 左ペインのメニューで「失敗したタスクの管理」リンクをクリックします。

3. ユーザー名とパスワードを入力します。「失敗したタスクの管理」ページが表示されます。

注意:

診断ダッシュボードUIにアクセスするにはシステム管理者権限が必要です。

16.4.2 失敗した非同期タスクの表示

システム管理者は、失敗した各タスクの詳細、たとえばそのタスクが失敗した原因や対処方法などを表示できます。

失敗したタスクの詳細を表示するには、フィルタ基準を指定するか、「検索」ボタンをクリックします。

16.4.2.1 失敗した非同期タスクを表示する手順

1. 「診断ダッシュボード」のホーム・ページにログインします。詳細は、「診断ダッシュボードUIの起動」を参照してください。

2. 次のいずれかを実行して、失敗したタスクのリストを表示します。

- 「検索」をクリックして、失敗したタスクすべてのリストを表示します。

- 次のフィルタ基準に基づいて、失敗したタスクを検索します。

- タスク名: 失敗したタスクの名前を入力します。

- カテゴリ: 失敗したタスクのカテゴリを入力します。

- 間: データ範囲を指定します。

- 自動再試行がまだ一時停止中のタスクを表示しないようにするには、「再試行が残っている場合は除外」オプションを選択します。

フィルタ基準を指定したら、「検索」をクリックします。図16-1に示すように、失敗した非同期タスクのリストが表示されます。

図16-1 失敗した非同期タスク

「図16-1 失敗した非同期タスク」の説明

3. 「識別子」リンクをクリックし、失敗したタスクの詳細情報を表示します。このシナリオでは、222をクリックします。次の情報が表示されます。

- タスク名

- インスタンスID

- カテゴリ

- 最終実行時間

- 原因

- アクション

- スタック・トレース

16.4.3 失敗した非同期タスクの再試行

システム管理者は、特定の失敗タスクを診断ダッシュボードUIから直接再試行して、再試行の結果を表示できます。

16.4.3.1 失敗した非同期タスクを再試行する手順

1. 再試行する失敗タスクを検索します。詳細は、「失敗した非同期タスクを表示する手順」を参照してください。

2. 「再試行」リンクをクリックします。タスクの再試行ステータスが表示されます。次の詳細を指定します。

- 再試行ステータス

- タスク・サマリー

- スタック・トレース

- 原因

- 解決

16.4.4 失敗した非同期タスクの再送信

すべての失敗タスクは非同期キューに再送信されます。これらは後で非同期に実行されます。

失敗タスクを再送信するには、ResubmitAllをクリックします。

16.4.5 失敗した非同期タスクのパージ

失敗した非同期タスクが多数あるような状況も考えられます。システム管理者がタスクを再試行しても無駄だと感じる場合もあります。そのような状況では、失敗したタスクをパージできます。パージ処理により、失敗した非同期タスクがデータベースから削除されます。つまり、そのタスクは二度と再試行されません。

16.4.5.1 失敗した非同期タスクをパージする手順

1. 再試行する失敗タスクを検索します。詳細は、「失敗した非同期タスクを表示する手順」を参照してください。

2. 「PurgeAll」をクリックします。

17 オフライン・プロビジョニングの有効化

オンライン・プロビジョニングでは、複数のプロビジョニング操作が順々に実行されます。たとえば、5つのリソースを5人のOIMユーザーに割り当てる(プロビジョニングする)リクエストを作成すると、システムでは次のように処理が行われます。

- 1人のユーザーに対する1つのリソースのプロビジョニングを1つのプロビジョニング操作として処理

- プロビジョニング操作を順々に連続して処理

この章の内容は次のとおりです。

- オフライン処理の特徴

- オフライン・プロビジョニングの有効化と無効化

- オフライン・プロビジョニング関連のレポート

- 失敗したオフライン・メッセージの削除スケジュール済タスクの構成

注意:

ワークフローによっては、Oracle Identity Manager 11gアーキテクチャでのオフラインの有効化が必要ではない場合があります。この機能は、今後、廃止される可能性があります。

17.1 オフライン処理の特徴

オフライン・プロビジョニングの特徴は、次のとおりです。

- オフライン・プロビジョニングは、リソースのプロビジョニング(ターゲット・システム・アカウントの作成)、リソースの有効化、リソースの無効化およびリソースの失効化の各操作時にのみ適用されます。オフライン・プロビジョニングは、割当て済(プロビジョニング済)のリソースの変更が必要なプロビジョニング操作には適用されません。

- オフライン・プロビジョニングは、組織プロビジョニング時には適用されません。

- オフライン・プロビジョニングは、リソース・オブジェクト・レベルで有効化します。その方法については、この章で後述します。

- •オフライン・プロビジョニング中に生成されたJMSメッセージは、並行処理されます。各JMSメッセージは、単一のトランザクションとして、他のJMSメッセージから独立して非同期的に処理されます。この方法では、プロビジョニング操作が順々に処理されるオンライン・プロビジョニングの方法より、パフォーマンスが向上します。

- OIMユーザーのリソース・インスタンスのリソース詳細を表示すると、あるリソースに対するプロビジョニングがまだ処理されていない場合、プロビジョニング、有効化、無効化および失効操作に対して、それぞれ「イン・キューのプロビジョニング」、「イン・キューの有効化」、「イン・キューの無効化」および「イン・キューの失効」ステータスが表示されます。

- リソース・インスタンスの最終ステータスは、オンライン・プロビジョニングのステータスと同じです。たとえば、あるリソースのメッセージが正常に処理されると、「プロビジョニング済」ステータスが表示されます。オンライン・プロビジョニングの場合も同じステータスが表示されます。

- オフライン・プロビジョニングでは、失敗したメッセージの詳細は、オフライン永続ストア(OPS)表に保存されます。これらの詳細は、オフライン・リソース・プロビジョニング・メッセージ・レポートを実行することにより表示できます。このレポートについては「オフライン・プロビジョニング関連のレポート」を参照してください。

17.2 オフライン・プロビジョニングの有効化と無効化

前述のように、オフライン・プロビジョニングは、リソース・オブジェクト・レベルで有効化します。オフライン・プロビジョニングは、「プロセス定義」フォームで「自動保存フォーム」オプションがすでに選択されている場合のみ適用できます。

オフライン・プロビジョニングを有効化するには:

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

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

3. オフライン・プロビジョニングを有効化するリソース・オブジェクトを検索して開きます。

4. 「リソース・オブジェクト」フォームで、オフライン・プロビジョニングを選択します。これにより、リソースの有効化、無効化および失効化の操作に対してオフライン・プロビジョニングが有効になります。
オフライン・プロビジョニングオプションを選択していない場合は、特定のリソースのプロビジョニング、有効化、無効化および失効化の操作はオンラインで行われます。

5. 「保存」アイコンをクリックします。

オフライン・プロビジョニングを無効化するには:

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

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

3. オフライン・プロビジョニングを有効化するリソース・オブジェクトを検索して開きます。

4. 「リソース・オブジェクト」フォームで、オフライン・プロビジョニングチェック・ボックスの選択を解除します。

5. 「保存」アイコンをクリックします。

17.3 オフライン・プロビジョニング関連のレポート

オンライン・プロビジョニング、有効化、無効化または失効化の操作が失敗した場合は、エラー・メッセージとその操作に関するその他の情報がUIに表示されます。Oracle BI Publisherの「オフライン・リソース・プロビジョニング・メッセージ」レポートに、すべてのエラー・メッセージが格納されます。

17.4 失敗したオフライン・メッセージの削除スケジュール済タスクの構成

失敗したプロビジョニング操作のOPS表からの削除をスケジュールするために、失敗したオフライン・メッセージの削除スケジュール済タスクを構成します。このスケジュール済タスクの構成中に、より古い失敗したメッセージの削除(日付)属性の値を設定します。

スケジュール済タスクの処理については、第2章「スケジュール済タスクの管理」を参照してください。

18 Enterprise Managerを使用したOracle Identity Manager構成の管理

Oracle Identity Managerは構成ファイルをMDSに格納します。ほとんどの構成はMBeanとして公開されます。そのため、Enterprise Managerを使用して構成値を制御できます。次の各項で説明するように、場合によっては、ファイル一式をファイル・システムにエクスポートし、必要な変更を行い、それからリポジトリにインポートして戻す必要があります。

- MBeanを使用した構成変更

- 構成ファイルのエクスポートおよびインポート

18.1 MBeanを使用した構成変更

Mbeanを使用して構成設定を変更するには:

1. 管理サーバーと少なくとも1つのOracle Identity Manager管理対象サーバーが稼動している場合は、次の形式のURLを使用してOracle Enterprise Manager Fusion Middleware Controlにログインします。
http://ADMINSTRATION_SERVER:PORT/em

2. 「アイデンティティ」→「アクセス」→「OIM」に移動します。右クリックして「システムMBeanブラウザ」に移動します。

3. 「アプリケーション定義のMBeans」で、「oracle.iam」→「アプリケーション:OIM」→「XMLConfig」→構成に移動します。
すべての構成ファイルはこの場所に格納されています。

18.2 構成ファイルのエクスポートおよびインポート

構成ファイルをエクスポートまたはインポートするには:

関連項目:

エクスポートおよびインポートできる構成ファイルのリストは、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのMDSユーティリティとユーザー変更可能なメタデータ・ファイルに関する説明を参照してください。

1. 管理サーバーと少なくとも1つのOracle Identity Manager管理対象サーバーが稼動している場合は、次の形式のURLを使用してOracle Enterprise Manager Fusion Middleware Controlにログインします。
http://ADMINSTRATION_SERVER:PORT/em

2. 「アイデンティティ」→「アクセス」→「OIM」に移動します。右クリックして「システムMBeanブラウザ」に移動します。

3. 「アプリケーション定義のMBeans」で、「oracle.mds.lcm」→「サーバー:oim_server1」→「アプリケーション:OIM」→「MDSAppRuntime」に移動します。

4. 構成ファイルをエクスポートするには:

1. 「操作」タブをクリックし、次にexportMetaDataをクリックします。

2. toLocationフィールドに、 /tmpまたは別のディレクトリの名前を入力します。

3. createSubDirにfalseを選択します。

4. docsフィールドに、完全なファイルの場所を要素として入力します。

5. excludeAllCust、excludeBaseDocs、excludeExtendedMetadataselectに対してもfalseを選択します。次に「起動」をクリックします。
これで、docsフィールドで指定されたファイルがtoLocationフィールドで指定されたディレクトリにエクスポートされます。

5. 構成ファイルをインポートするには:

1. importMetaDataをクリックします。

2. fromLocationフィールドに、/tmpまたは構成ファイルを含むディレクトリの名前を入力します。

3. createSubDirにfalseを選択します。

4. docsフィールドに、完全なファイルの場所を要素として入力します。たとえば/db/oim-config.xmlのようにします。

5. excludeAllCust、excludeBaseDocs、excludeExtendedMetadataselectに対してもfalseを選択します。次に「起動」をクリックします。
これで、docsフィールドで指定されたファイルがtoLocation フィールドで指定されたMDSにインポートされます。

19 ユーザーの言語の設定

Oracle Identity Manager 11g リリース1(11.1.1)では、ユーザーのUI用の言語プリファレンスは、「セルフ・サービス」の「プリファレンス」セクションでユーザーが指定したロケールに応じて設定されません。ただし、このロケール・プリファレンスは、通知メッセージの言語の判断に使用されます。

UIロケールを判断するロジックでは、ブラウザのロケールを使用する前に、Fusion AppsやOracle Access Manager(OAM)などのログイン・ページを介したその他のロケール指定方法が優先されます。

Fusion Appsが存在する環境であれば、oracle.fusion.appsModeシステム・プロパティが内部的に使用され、自動的に設定されます。このプロパティの値に基づいて、ORA_FUSION_PREFS(内部的に設定および使用されます)と呼ばれるcookie内の適切な属性が使用され、ロケールが判断されます。

ユーザーのUIロケールを判断するために、内部的に次のロジックが使用されます。

1. oracle.fusion.appsModeシステム・プロパティが使用可能かどうかがチェックされます。

2. oracle.fusion.appsModeシステム・プロパティを使用できない場合、またはその値がfalseに設定されている場合は、preferredLanguage属性がチェックされます。この属性の値が、ユーザーのUIロケールになります。preferredLanguage属性は、ORA_FUSION_PREFS cookieの内部でチェックされます。

3. oracle.fusion.appsModeシステム・プロパティが使用可能で、その値がtrueに設定されている場合は、ORA_FUSION_PREFS cookie内でそのロケール属性がチェックされます。この属性の値が、ユーザーのUIロケールになります。

注意:

ORA_FUSION_PREFS cookieは、Oracle Identity Managerの内部的なものです。

4. ORA_FUSION_PREFS cookieが存在しない場合は、ブラウザの言語設定がチェックされます。ユーザーのUIロケールは、ブラウザの言語設定と同じになります。

注意:

前述のいずれでもロケール値が指定されていない場合は、サーバー設定がチェックされます。

第IV部

管理ユーティリティ

この部では、Oracle Identity Manager管理者のための多数の追加機能について説明します。

次の章で構成されています。

- 第20章「診断ダッシュボードの使用方法」

- 第21章「リモート・マネージャのインストールと構成」

- 第22章「フォームのバージョン・コントロール・ユーティリティの使用」

- 第23章「アーカイブ・ユーティリティの使用」

20 診断ダッシュボードの使用

この章では、Oracle Identity Managerに同梱される診断ダッシュボードについて説明します。内容は次のとおりです。

- 20.1項「診断ダッシュボードの概要」

- 20.2項「診断ダッシュボードのインストール」

- 20.3項「診断ダッシュボードの起動」

- 20.4項「診断ダッシュボードの使用」

- 20.5項「診断ダッシュボードを使用したテストの実行」

20.1 診断ダッシュボードの概要

診断ダッシュボードはスタンドアロン型のアプリケーションで、Oracle Identity Managerの前提条件の一部を検証し、インストールを確認することができます。

このツールを使用するには、アプリケーション・サーバーとOracle Identity Manager環境の適切なシステム管理者権限を持つ必要があります。データベース関連のテストの一部を実行するにはDBAレベルの権限が必要です。

注意:

診断ダッシュボードとOracle Identity Managerは、同一のアプリケーション・サーバーにインストールする必要があります。

20.2 診断ダッシュボードのインストール

診断ダッシュボード・ユーティリティは、Oracle Identity ManagerインストーラとともにインストールCD-ROMに収録されています。CD-ROMのDiagnostic DashboardディレクトリにEARファイルとして収録されています。

20.2.1 Oracle WebLogic Serverへの診断ダッシュボードのインストール

この項では、診断ダッシュボードをOracle WebLogic Serverにインストールするために実行する必要のある手順について説明します。

診断ダッシュボードをOracle WebLogic Serverにインストールするには:

1. Oracle WebLogic管理コンソールにログインします。

2. 左側のナビゲーション・ペインで、「デプロイメント」をクリックします。サーバーにデプロイされているすべてのアプリケーションがリストされます。

3. 「インストール」をクリックします。

4. EARファイルをデプロイする場所に移動します。通常、EARファイルは次のディレクトリに格納されています。
OIM_ORACLE_HOME/server/webapp/optional/

5. 「現在の場所」パネルからXIMDD.earを選択します。

6. 「ターゲット指定スタイルの選択」ページで、「次へ」をクリックします。

7. 「XIMDDに指定可能なターゲット」パネルからOimServer(Oracle Identity Managerサーバー)を選択し、「次へ」をクリックします。

8. 「終了」をクリックします。次のメッセージが表示されます。

All changes have been activated. No restarts are necessary.
The deployment has been successfully installed.

診断ダッシュボードには次の場所からアクセスできます。

http://OIM_server_host_ip:port/XIMDD

20.3 診断ダッシュボードの起動

診断ダッシュボードのデプロイ後、次のURL形式を使用してアクセスできます。

http://OIM_HOST:OIM_PORT/XIMDD

診断ダッシュボードに管理者権限でログインします。左メニュー・ペインの「診断ダッシュボード」リンクをクリックし、診断ダッシュボードのメイン・ページを表示します。

診断ダッシュボード・ユーティリティには、ツールがどのアプリケーション・サーバーにデプロイされているかが示されます。

20.4 診断ダッシュボードの使用

診断ダッシュボードのメイン画面には、次の表にリストするセクションが含まれます。

セクション

説明

アプリケーション・サーバー

アプリケーション・サーバーの名前が表示されます。

Oracle Identity Managerインストール

製品バージョン、ビルド番号、ホスト、製品の場所などのインストールの詳細が表示されます。

テストの詳細

テスト・パラメータ

テスト名とその説明が表示されます。

テストに必要なパラメータが表示されます。

テストを実行するには:

1. 診断ダッシュボードのメイン画面で、オプションを選択してテストを選択します。

2. 必要なパラメータを入力します。

3. 「検証」をクリックして、結果を確認します。
「診断ダッシュボード・テスト結果」画面に、次の表に示すステータス情報が表示されます。

テスト結果

説明

結果サマリー

選択されたすべてのテストが、結果を示すアイコン(合格／不合格)とともに表示されます。テスト名はWebリンクされており、結果の詳細に直接ジャンプできます。

テスト名

テスト名が表示されます。

説明

テストの説明が表示されます。

入力パラメータ

テストのパラメータが表示されます。

結果

テストの結果が表示されます。

詳細

テストの結果に関する詳細が表示されます。

4. 左ペインのメニューで「診断ダッシュボード」または「診断ダッシュボードに戻る」をクリックすると、前のテスト・ページに戻ります。

20.5 診断ダッシュボードを使用したテストの実行

次のテストは、それぞれ異なるアプリケーション・サーバーに使用できます。

- Oracle Databaseの前提条件チェック

- データベース接続性のチェック

- アカウント・ロックのステータス

- データ暗号化鍵の検証

- スケジューラ・サービスのステータス

- リモート・マネージャ・ステータス

- JMSメッセージ機能の検証

- ターゲット・システムのSSLトラストの検証

- Java VMシステム・プロパティのレポート

- Oracle Identity Managerのライブラリと拡張機能のバージョンのレポート

- Oracle Identity Managerのライブラリと拡張機能のマニフェストのレポート

- 基本接続性のテスト

- プロビジョニングのテスト

- リコンシリエーションのテスト

- SOA-OIA構成の確認

- 診断情報のリクエスト

- 編成ステータス

- 失敗した編成の再試行

- SPML Webサービス

- OWSM設定のテスト

- OIMに対するSPMLリクエスト呼出しのテスト

- OIM属性に対するSPML属性

- ユーザー名テスト

- OIMおよびLDAPにおけるユーザー作成とロール作成の診断

- OVD接続の診断

- LDAP予約コンテナの診断

20.5.1 Oracle Databaseの前提条件チェック

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

データベース・サーバー

データベース・サーバーの場所を入力します。

ポート

ポート番号を入力します。

データベース名

データベース名(SID)を入力します。

OIMデータベース・ユーザー名

Oracle Identity Managerデータベースのユーザー名を入力します。

システム・ユーザー名

システムのユーザー名を入力します。

システム・ユーザー・パスワード

システムのユーザー・パスワードを入力します。

説明: 指定されたOracle Databaseのインスタンスが、Oracle Identity Managerのインストールに必要な前提条件を満たしているかどうかを確認します。このテストにはSYSTEM権限が必要です。

結果: 次の情報が表示されます。

- ユーザーに必要な権限

- XAサポートが有効であること

- JVMが有効であること

- Oracleのバージョン情報

20.5.2 データベース接続性のチェック

前提条件: なし

説明: このテストは、Oracle Identity Managerがデータベースに接続可能かどうかを検証するために実行します。このテストは、データベース直接接続とJ2EEデータ・ソース(XA)を検証します。

結果: 次の情報が表示されます。

- データベース直接接続性

- XA実行

20.5.3 アカウント・ロックのステータス

前提条件: 次にこのテストを検証するための前提条件を示します。

前提条件

説明

ユーザー・ログイン

ユーザー名を入力します。

説明: Oracle Identity Managerは、無効なログインが複数連続して試行された場合、アカウントをロックします。このテストでは、指定したアカウントがロックされているかどうか確認します。

結果: データベース内のロックされているアカウントとロックされていないアカウントを確認します。

20.5.4 データ暗号化キーの検証

前提条件: なし

説明: Oracle Identity Managerインストールのデータ暗号化鍵は、Oracle Identity Managerデータベースのデータの暗号化に使用されるものと同じである必要があります。これは、別のOracle Identity Managerインストールに対して作成されたデータベース・スキーマにOracle Identity Managerインストールが参照される場合ではありません。あるOracle Identity Managerインストールからのデータベース・ダンプが、別のOracle Identity Managerインストールに対応する鍵をコピーせずにインポートされた場合に発生する場合があります。

結果: データベース・キーがOracle Identity Manager構成ディレクトリに存在するかどうかを確認します。

20.5.5 スケジューラ・サービスのステータス

前提条件: なし

説明: このサーバーで実行されているOracle Identity Managerスケジューラ・サービスのステータスを確認します。

結果: スケジューラ・サービスのステータスが表示されます。

20.5.6 リモート・マネージャのステータス

前提条件: なし

説明: このOracle Identity Managerのインストールが機能するようにすべて設定済であるリモート・マネージャのステータスをレポートします。

結果:リモート・マネージャのステータスが表示されます。

20.5.7 JMSメッセージ機能の検証

前提条件: なし

説明: このテストの目的は、Oracle Identity ManagerがJMSメッセージを送信し処理できることを検証することです。

結果: Oracle Identity ManagerがJMSメッセージを送信および処理できるかどうかが表示されます。

20.5.8 ターゲット・システムのSSLトラストの検証

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

ターゲット・システム

ホスト名を入力します。

ポート

ポート番号を入力します。

証明書ストアの場所

格納の場所を入力します。

証明書ストアのパスワード

格納のためのパスワードを入力します。

説明: 接続性がSSL経由の場合、Oracle Identity Managerはターゲット・システムの証明書を信頼するよう設定されている必要があります。ホスト名およびターゲット・システムがSSL接続用にリスニングしているコンピュータのポートを入力します。

結果: 次の情報が表示されます。

- 有効または無効なホストとポート・アドレス

- 信頼できる証明書

20.5.9 Java VMシステム・プロパティのレポート

前提条件: なし

説明: Java VMのシステム・プロパティすべてを表示します。

結果: Java VMのシステム・プロパティがすべて表示されます。

20.5.10 Oracle Identity Managerのライブラリと拡張機能のバージョンのレポート

前提条件: なし

説明: Oracle Identity Managerライブラリと拡張機能のバージョンをレポートします。

結果: Oracle Identity Managerライブラリと拡張機能のバージョンが表示されます。

20.5.11 Oracle Identity Managerのライブラリと拡張機能のマニフェストのレポート

前提条件: なし

説明: Oracle Identity Managerライブラリと拡張機能のマニフェスト情報をレポートします。

結果: Oracle Identity Managerライブラリと拡張機能のマニフェスト情報が表示されます。

20.5.12 基本接続性のテスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

ITリソース・タイプ名

ITリソース・タイプを入力します。

ITリソース・インスタンス名

ITリソース名を入力します。

説明: ターゲット・システム用のITリソースを使用して、ターゲット・システムへの接続をテストします。

注意:

事前定義済のコネクタをデプロイした際に、指定したITリソース・タイプが作成された場合は、Oracle Identity Manager Connector Packのリリース・ノートおよびドキュメントを参照し、このテストがデプロイしたコネクタのリリースに適用できるかどうかを確認します。

結果: 接続性テストの結果が表示されます。テストが失敗した場合は、エラーの原因も表示されます。

20.5.13 プロビジョニングのテスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

ITリソース・タイプ名

ITリソース・タイプを入力します。

ITリソース・インスタンス名

ITリソース名を入力します。

説明: ターゲット・システム上で基本的なユーザーの作成操作を実行します。

注意:

事前定義済のコネクタをデプロイした際に、指定したITリソース・タイプが作成された場合は、Oracle Identity Manager Connector Packのリリース・ノートおよびドキュメントを参照し、このテストがデプロイしたコネクタのリリースに適用できるかどうかを確認します。

結果:プロビジョニング・テストの結果が表示されます。テスト時にターゲット・システムで作成されたテスト・データは、テストの最後に削除されます。

20.5.14 リコンシリエーションのテスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

ITリソース・タイプ名

ITリソース・タイプを入力します。

ITリソース・インスタンス名

ITリソース名を入力します。

説明: ターゲット・システム上で基本的なリコンシリエーション操作を実行します。

注意:

事前定義済のコネクタをデプロイした際に、指定したITリソース・タイプが作成された場合は、Oracle Identity Manager Connector Packのリリース・ノートおよびドキュメントを参照し、このテストがデプロイしたコネクタのリリースに適用できるかどうかを確認します。

結果: リコンシリエーションのテストの結果が表示されます。テスト時にOracle Identity Managerでリコンサイルされたテスト・データは、テストの最後に削除されます。

20.5.15 SOA-Oracle Identity Managerの構成チェック

前提条件: なし

説明: SOA-ワイヤリング用に指定した詳細が有効かどうかを確認します。

結果: 次のテストのステータスを表示します。

1. Oracle Identity ManagerとのSOA接続の検証とSOAでのユーザーの認証

2. Oracle Identity Manager DBユーザーの認証と検索

20.5.16 診断情報のリクエスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

リクエストID

診断情報が必要なリクエストのIDを入力します。

説明: 編成IDおよび指定されたリクエストIDのコンポジット詳細を指定します。

結果: 次の情報が表示されます。

1. 指定されたリクエストIDに関連付けられた編成プロセスID

2. リクエストのコンポジット詳細と承認およびプロセス・タスクの詳細

20.5.17 編成ステータス

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

プロセスID

編成プロセスのIDを入力します。

説明: Oracle Identity Manager Kernelでの編成プロセスのステータスを指定します。そのプロセスに含まれるすべてのイベント・ハンドラに関する詳細およびステータスも指定します。

結果: 編成プロセスのステータスが、「失敗」、「完了」または「有効」として表示されます。

図20-1に、完了済でまだ保留中のイベントなど、編成プロセスのステータスを示します。

図20-1 編成ステータス・テストの出力例

「図20-1 編成ステータス・テストの出力例」の説明

20.5.18 失敗した編成の再試行

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

プロセスID

編成プロセスのIDを入力します。

説明: 指定された編成プロセスの失敗を処理する方法を指定するレスポンスを取得します。

結果: 失敗状態の編成プロセスが表示され、レスポンスに基づいて続けて再試行されます。

20.5.19 SPML Webサービス

前提条件: なし

説明: SPML WSDLがアクセス可能で、Webサービスが起動しており実行中であることを確認します。

結果: SPML WSDLファイルの内容が表示されます。

20.5.20 OWSM設定のテスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

SPMLユーザー名

SPMLリクエストの実行に使用されるユーザー名を入力します。

SPMLユーザー・パスワード

ユーザー・パスワードを入力します。

説明: OWSMヘッダー情報を持つリクエストを送信することによって、OWSM設定を確認します。また、OWSMヘッダー・セットを持つリクエストを送信することによって、有効なレスポンスが返されることも確認します。

結果: SPML Webサービスによってサポートされるターゲットが表示されます。

20.5.21 Oracle Identity Managerに対するSPLリクエスト呼出しのテスト

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

SPMLユーザー名

SPMLリクエストの実行に使用されるユーザー名を入力します。

SPMLユーザー・パスワード

ユーザー・パスワードを入力します。

説明: Oracle Identity Managerに対するSPML WSはシグネチャ・ベースのログインです。Oracle Identity Managerリクエストをシミュレートすることによって、この機能が動作することを確認します。

結果: シグネチャ・ベースのログインが正常に機能しているかどうかが表示されます。

20.5.22 Oracle Identity Manager属性に対するSPML属性

前提条件: なし

説明: Oracle Identity Manager属性に対するSPML属性のマッピングをすべてリストします。これは管理者が設定が正しいかどうか確認するのに役立ちます。

結果: Oracle Identity Manager属性に対するSPML属性のマッピングを示す表が表示されます。

SPML属性名

Oracle Identity Manager属性名

Number Format

Number Format

localityName

Locality Name

countryName

Country

manager

User Manager

facsimileTelephoneNumber

Fax

generationQualifier

Generation Qualifier

street

Street

state

State

surname

Last Name

Embedded Help

Embedded Help

Territory

FA Territory

organizationUnit

LDAP Organization Unit

givenName

First Name

20.5.23 ユーザー名テスト

前提条件: なし

説明: Oracle Identity Managerで定義された既存のユーザー名生成ポリシーをリストします。

結果: ポリシー名が表示されます。

20.5.24 Oracle Identity ManagerおよびLDAPにおけるユーザー作成とロール作成の診断

前提条件: このテストを実行するための前提条件は次のとおりです。

前提条件

説明

SPMLユーザー名

SPMLリクエストの実行に使用されるユーザー名を入力します。

SPMLユーザー・パスワード

ユーザー・パスワードを入力します。

説明: ユーザー作成およびロール作成が、個別にLDAPおよびOracle Identity Managerで正常に動作していることを検証します。

結果: ユーザー作成およびロール作成がOracle Identity ManagerおよびLDAPで正常に行われたかどうかを指定するステータスが表示されます。

20.5.25 OVD接続の診断

前提条件: なし

説明: Oracle Identity ManagerがOVDに接続できるかどうかを検証します。

結果: Oracle Identity ManagerがOVDに正常に接続されたかどうかが表示されます。

20.5.26 LDAP予約コンテナの診断

前提条件: なし

説明: Oracle Identity Manager構成ファイルには予約コンテナのツリー構造が含まれます。このテストでは、設定時に予約コンテナが作成されたことを検証します。

結果: 予約コンテナが正しく作成されたかどうかが表示されます。

21 リモート・マネージャのインストールと構成

この章では、次のトピックでリモート・マネージャを構成する方法について説明します。

- リモート・マネージャの構成の概要

- Remote Managerの構成

- リモート・マネージャの停止と起動

- リモート・マネージャのトラブルシューティング

21.1 リモート・マネージャの構成の概要

リコンシリエーションおよびプロビジョニング処理の実行中、Oracle Identity Managerはビジネス操作を実行するターゲットと通信する必要があります。そのために、Oracle Identity Managerはプロビジョニングおよびリコンシリエーションの際にターゲットのAPIを使用してターゲットと直接通信します。ただし、Oracle Identity Managerは次のようなインスタンスではターゲットと直接通信できません。

- ターゲットがファイアウォールの背後にあり、ターゲットの通信ポートが公開されていない。

- ターゲットにネットワークを介して呼び出せるAPIが存在しない。

- ターゲットのAPIを安全な接続を介して呼び出せない。

これらのインスタンスでは、ターゲット・システムと直接通信せずに、プロキシのように動作するOracle Identity Managerコンポーネントを使用する必要があります。このコンポーネントは、リモート・マネージャと呼ばれます。

リモート・マネージャは、次の目的で使用します。

- Oracle Identity Managerを通じた非リモート・ターゲットAPIの呼出し

- 安全なチャネルを介したSSLをサポートしていないターゲットAPIの呼出し

21.2 Remote Managerの構成

リモート・マネージャの構成は、次の手順で構成されます。

1. リモート・マネージャをインストールします。リモート・マネージャのインストールの詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』を参照してください。

2. リモート・マネージャとOracle Identity Managerの信頼関係を確立します。詳細は、「信頼関係の追加」および「独自の証明書を使用したリモート・マネージャの構成」を参照してください。

3. リモート・マネージャをテストします。詳細は、「リモート・マネージャの接続のテスト」を参照してください。

この項の内容は次のとおりです。

- 信頼関係の追加

- 独自の証明書を使用したリモート・マネージャの構成

- リモート・マネージャの接続のテスト

- リモート・マネージャのポート変更のためのxlconfig.xmlファイルの更新

21.2.1 信頼関係の追加

リモート・マネージャとOracle Identity ManagerはSSLを使用して通信します。Oracle Identity Managerとリモート・マネージャの信頼関係を有効にする必要があります。

Oracle Identity Managerでは、リモート・マネージャの証明書を信頼する必要があります。このためには、リモート・マネージャの証明書をOracle Identity Managerキーストアにインポートし、信頼できる証明書として設定する必要があります。

必要であれば、クライアント側認証を有効にすることもできます(これにより、リモート・マネージャがサーバーの証明書を信頼します)。クライアント側認証では、Oracle Identity Managerの証明書をリモート・マネージャのキーストアにインポートして、信頼できる証明書として設定します。

場合によっては、Oracle Identity Managerおよびリモート・マネージャに関連付けられた構成ファイル(xlconfig.xml)を手動で編集する必要があります。

次の手順を実行して、アプリケーション・サーバーとリモート・マネージャの間の信頼関係が証明書を通じて確立されていることを確認します。keytoolユーティリティを使用して証明書をインポートおよびエクスポートします。

1. コマンド・プロンプトを使用してXLREMOTE_HOMEディレクトリに移動し、keytoolユーティリティを使用して証明書のフィンガープリントのリストを表示します。

2. 次のコマンドを入力します。

$JAVA_HOME/jre/bin/keytool -list -keystore ./config/default-keystore.jks

注意:

Oracle Identity Managerのキーストアはdefault-keystore.jksと呼ばれます。Oracle Identity Managerでは、キーストアは$DOMAIN_HOME/config/fmwconfig/ディレクトリにあります。

リモート・マネージャでは、キーストアは$XLREMOTE_HOME/config/ディレクトリにあります。キーストア名はdefault-keystore.jksです。

この手順で示すkeytoolコマンドの実行時に、キーストアのデフォルトのパスワードを入力するように要求されます。キーストアのパスワードを入力すると、次のように、キーストアのエントリが証明書のフィンガープリント(MD5ハッシュ)とともに表示されます。

Enter the default password for xellerate keystore: KEYSTORE_PASSWORD
Your keystore contains 1 entry
xell, Jan 7, 2005, keyEntry,
Certificate fingerprint (MD5):
B0:F2:33:C8:69:E4:25:A3:CB:59:E8:51:27:EE:5C:52

証明書のフィンガープリントは、太字で表示されています。これは、キーストアの証明書を一意に識別するために使用されます。

3. Oracle Identity Managerとリモート・マネージャの信頼関係を確立するには、次の手順を実行します。

1. リモート・マネージャの証明書をサーバー・コンピュータにコピーします。リモート・マネージャのコンピュータにあるXLREMOTE_HOME/xlremote/config/xlserver.certファイルを、サーバーのコンピュータにコピーします。

2. サーバー・コンピュータでコマンド・プロンプトを開きます。

3. keytoolユーティリティを使用して証明書をインポートするには、次のコマンドを使用します。

$JAVA_HOME\jre\bin\keytool -import -alias rm_trusted_cert -file RM_CERT_LOCATION\xlserver.cert -trustcacerts -keystore $DOMAIN_HOME\config\fmwconfig\default-keystore.jks -storepass KEYSTORE_PASSWORD

JAVA_HOMEはアプリケーション・サーバーのJavaディレクトリの場所、エイリアスの値はストアの証明書に対する名前、RM_CERT_LOCATIONは証明書をコピーする場所です。

4. プロンプトでYを入力して、証明書を信頼するようにします。

5. リモート・マネージャのコンピュータで、テキスト・エディタを使用して$XLREMOTE_HOME/xlremote/config/xlconfig.xmlファイルを開きます。

6. <RMIOverSSL>プロパティを探し、次のように値がtrueに設定されていることを確認します。

<RMIOverSSL>true</RMIOverSSL>

7. <KeyManagerFactory>プロパティを探します。IBM JREを使用する場合は値をIBMX509に設定します。次に例を示します。

<KeyManagerFactory>IBMX509</KeyManagerFactory>

その他のすべてのJREの場合は値をSUNX509に設定します。次に例を示します。

<KeyManagerFactory>SUNX509</KeyManagerFactory>

8. ファイルを保存します。

注意:

OIM_HOMEにあるサーバー証明書も、名前がxlserver.certです。その証明書を上書きしないようにしてください。

9. Oracle Identity Managerを再起動します。

21.2.2 独自の証明書を使用したリモート・マネージャの構成

リモート・マネージャをインストールするときに、インストーラによってキーペアと証明書が、キー・パスワード、証明書の有効期間、CNなどのデフォルトのパラメータとともに生成されます。ただし、ビジネスのセキュリティ要件のため、一部のパラメータを変更することが必要になる場合があります。この場合は、インストールされているデフォルトの証明書のかわりに、キーペアと証明書を生成して使用する必要があります。

リモート・マネージャ・サーバーで独自の証明書を使用してリモート・マネージャを構成するには、次の手順を実行します。

注意:

この項の手順は、デフォルトのOracle Identity Managerの証明書のかわりに独自の証明書を使用する場合のみ実行してください。その他の場合、この項は実行しません。

1. 新しいカスタム・キーストアおよび証明書を生成します。生成するには、次の例のように、keytoolユーティリティを使用します。

keytool-genkeypair -keystore test.jks -alias rmcert -storepass welcome1 -keyalg DSA -keysize 1024 -dname "CN=TestUser, OU=fmw, O=Oracle, C=US" -keypass PASSWORD -validity 3650

新しいキーストアに使用するパスワードを忘れないようにしてください。

2. この新しいキーストアを$XLREMOTE_HOME/config/ディレクトリにコピーします。

3. テキスト・エディタで、$REMOTE_MANAGER/config/xlconfig.xmlファイルを開きます。

4. <RMSecurity>タグを探し、<Location>タグと<Password>タグの値を次のように変更します。

- IBM JREを使用している場合は、値を次のように変更します。

<KeyStore>
<Location>new_keystore_name</Location>
<Password encrypted="false">new_keystore_pwd</Password>
<Type>JKS</Type>
<Provider>com.ibm.crypto.provider.IBMJCE</Provider>
</KeyStore>

- その他すべてのJREでは、値を次のように変更します。

<KeyStore>
<Location>new_keystore_name</Location>
<Password encrypted="false">new_keystore_pwd</Password>
<Type>JKS</Type>
<Provider>sun.security.provider.Sun</Provider>
</KeyStore>

5. リモート・マネージャ・サーバーを再起動し、xlconfig.xmlファイルを再び開いて新しいキーストアのパスワードが暗号化されていることを確認します。

Oracle Identity Managerで独自の証明書を使用してリモート・マネージャを構成するには、次の手順を実行します。

1. 次の例のように、リモート・マネージャ・コンピュータ上の新たに作成されたキーストアから証明書をエクスポートします。

keytool-export -keystore test.jks -storepass welcome1 -alias rmcert -file test.cer

2. この新しい証明書ファイルを$DOMAIN_HOME/config/fmwconfig/ディレクトリにコピーします。

3. 次の例のように、証明書をdefault-keystore.jksにインポートします。

keytool-import -keystore test.jks -storepass welcome1 -alias test_alias -file test.cer -trustcacerts

4. 「リモート・マネージャの接続のテスト」の説明に従って、リモート・マネージャとOracle Identity Manager間の接続が確立されていることを確認します。

21.2.3 リモート・マネージャの接続のテスト

リモート・マネージャとOracle Identity Manager間の接続が確立されていることをテストするには、次の手順を実行します。

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

2. 「リモート・マネージャ」フォームを開きます。このフォームには、次のものが表示されます。

- Oracle Identity Managerと通信するリモート・マネージャの名前とIPアドレス

- リモート・マネージャが実行されているかどうか

- リモート・マネージャが、Oracle Identity Managerで使用可能なITリソースであるかどうか

関連項目:

「リモート・マネージャ」フォームの詳細は、Oracle Fusion Middleware Oracle Identity Manager開発者ガイドのリモート・マネージャ・フォームに関する説明を参照してください。

3. 構成したリモート・マネージャ・サービスの「実行中」および「ITリソース」列のチェック・ボックスが選択されていることを確認します。これにより、リモート・マネージャが実行中であり、Oracle Identity Managerで使用可能なITリソースであることを確認できます。

21.2.4 リモート・マネージャのポート変更のためのxlconfig.xmlファイルの更新

リモート・マネージャの構成時には、リモート・マネージャのポート変更は必要ありません。これは、製品の使用中にポートの変更が必要になった場合に、必要になります。

xlconfig.xmlファイルを更新して、インストール時に設定されたものとは別の新しいポートでリモート・マネージャを起動するには、次の手順を実行します。

1. テキスト・エディタで、$XLREMOTE_HOME/xlremote/config/xlconfig.xmlファイルを開きます。

2. 次のタグを編集し、ポート番号を変更します。

- RMSecurityの下にあるListenPort(リモート・マネージャSSLリスニング・ポート用)

- RMSecurityにあるRMIRegistryPort(RMIレジストリ用)

3. リモート・マネージャを再起動します。詳細は、「リモート・マネージャの停止と起動」を参照してください。

21.3 リモート・マネージャの停止と起動

リモート・マネージャを停止するには、リモート・マネージャが起動されたコンソールに移動し、[Ctrl]キーを押しながら[C]キーを押します。リモート・マネージャは、このシグナルで停止するコマンドライン・アプリケーションです。

リモート・マネージャを起動するには、次のスクリプトを実行します。

UNIXの場合:

$XLREMOTE_HOME/xlremote/remotemanager.sh

Microsoft Windowsの場合:

$XLREMOTE_HOME\xlremote\remotemanager.bat

21.4 リモート・マネージャのトラブルシューティング

表21-1に、リモート・マネージャに問題が発生した場合に実行できるトラブルシューティングの手順を示します。

表21-1 リモート・マネージャのトラブルシューティング

問題

解決策

証明書の信頼問題が発生します。

リモート・マネージャの証明書がOracle Identity Manager側で信頼されていることを確認します。

リモート・マネージャの証明書の有効期限が切れていないことを確認します。

Oracle Identity Managerのホスト上でリモート・マネージャ・ポートが正しく構成されていることを確認します。つまり、Oracle Identity Managerのホスト上で構成されているポートは、リモート・マネージャの構成と同じポートである必要があります。

xlconfig.xmlファイル内のリモート・マネージャの構成(キーストアの場所、エイリアス、パスワード、キー・パスワードなど)、およびoim-config.xmlファイル内のOracle Identity Managerホストの構成が正しいことを確認します。

クライアント認証が設定されている場合は、リモート・マネージャで正しいサーバー証明書が信頼されていることを確認します。

証明書の信頼問題を解決するすべての条件を確認した後、リモート・マネージャとOracle Identity Manager間の通信時に障害が発生します。

次のフラグを渡して、Oracle Identity Managerとリモート・マネージャを再起動します。

-Djavax.net.debug={all|ssl}

このフラグをオンにすると、SSL/TLSハンドシェイクに関連するすべての情報がログに記録されます。ここで、allではすべてのデバッグがオンになり、sslではSSLのデバッグがオンになります。

注意: このフラグはデバッグの目的でのみ使用します。オンにした場合、大量の情報がログにダンプされます。

リモート・マネージャの接続が失敗します。

Oracle Identity Managerとリモート・マネージャ間に、特定のポートでTCPトラフィックをブロックしているファイアウォールがないことを確認します。そのためには、リモート・マネージャ・ポートでOracle Identity Managerホストからリモート・マネージャ・ホストにtelnetで接続します。

リモート・マネージャによるプロビジョニングが失敗します。

アダプタJARファイル(通常は、$OIM_HOME/JavaTasks/ディレクトリまたはデータベース内になります)が、JavaTasks/ディレクトリのリモート・マネージャ・ホストにコピーされていることを確認します。

ターゲットAPIを呼び出すために、通常のアダプタはJavaタスクを使用するのに対し、リモート・マネージャベースのアダプタはリモート・タスクを使用することを確認します。

リモート・マネージャベースのコネクタについて次のことを確認します。

- リモート・マネージャのITリソースを定義します。

- 通常のITリソース上のリモート・マネージャ・フィールドでリモート・マネージャITリソースを設定します(ターゲットの接続性情報を含む)。

22 フォーム・バージョン制御ユーティリティの使用方法

OIMユーザーのアカウント・データを保持するために、プロセス・フォームおよび子フォームが使用されます。フォームは、フォーム上のフィールドを追加、変更または削除することによってアップグレードできます。たとえば、アップグレード操作の一部として、「入社日」フィールドを追加し、フォームから出生国フィールドを削除できます。さらに、親フォームから子フォームにフィールドを移動できます。Oracle Identity Managerフォーム・バージョン制御(FVC)ユーティリティを使用すると、フォームのアップグレード操作後にフォーム・データの変更を簡単に管理できます。

FVCユーティリティは、Oracle Identity Managerデータベース上で直接機能するコマンドライン・ユーティリティです。Oracle Identity Manager Design Consoleをインストールする場合、このユーティリティはOIM_DC_HOMEディレクトリにあります。このユーティリティで実行する必要があるフォーム・データの更新を指定するには、プロパティ・ファイルを使用します。

このユーティリティは、プロビジョニング・プロセス・フォームおよびその関連子フォームでのフィールド・マッピングとデータ更新をサポートしています。

注意:

FVCユーティリティでは、次の機能は実行できません。

- オブジェクト・フォームでのデータ更新の管理

- フォーム間での行の移動

さらに、リリース間でフォーム関連の変更がない場合は、FVCユーティリティを実行する必要はありません。

この章の内容は次のとおりです。

- FVCユーティリティでサポートされているユースケース

- FVCユーティリティでサポートされていないユースケース

- フォーム・バージョン制御プロセスのサマリー

- FVCユーティリティのコンポーネント

- FVCユーティリティの使用

- トラブルシューティング

22.1 FVCユーティリティでサポートされているユースケース

FVCユーティリティを使用すると、単一の実行で次のフォーム変更に対応するフォーム・データの更新を管理できます。

関連項目:

フォーム・データの処理を開始する前にユーティリティによって実行される検証の詳細は、「フォーム・バージョン制御プロセスのサマリー」を参照してください。

- 親フォームのフィールド名が変更される場合。

- 子フォームのフィールド名が変更される場合。

- フィールドが親フォームから子フォームに移動される場合。

- フィールドが親フォームから親フォームに移動される場合。

- フィールドが子フォームから親フォームに移動される場合。このシナリオは、子フォームに単一のレコードが含まれている場合にのみサポートされます。

- フィールドが子フォームから、同じ親フォームの別の子フォームに移動される場合。このシナリオは、移動元の子フォームに単一のレコードが含まれている場合にのみサポートされます。

- フィールドが子フォームから、同じ親フォームの別の子フォームに移動される場合。このシナリオは、子フォームに単一のレコードが含まれている場合にのみサポートされます。

- フィールドが子フォームから親フォームに移動され、移動されるフィールドのデータ型が、親フォームで「参照フィールド」または「コンボ・ボックス」型から「チェック・ボックス」型に変更される場合。

- 前述のいずれかのユースケースで、親フォームのフィールドのデータ型が「参照フィールド」または「コンボ・ボックス」型から「チェック・ボックス」型に変更される場合。

- 前述のいずれかのユースケースで、フィールド名の大文字と小文字が変更される場合。たとえば、フィールド名がMyFieldからmyfieldに変更される場合。

- フィールドのデータ型が「参照フィールド」または「コンボ・ボックス」型から「チェック・ボックス」型に変更され、フォームに対してそれ以外の変更は行われない場合。

- 特定のOIMユーザーについて、USR表のユーザー・レコードのステータスがDeletedでない場合にのみ、ユーティリティでアカウント・データの更新が続行される場合。
USR表のステータスがDeletedでないOIMユーザーについて、アカウントのステータスがRevokedでない場合にのみ、ユーティリティでUD_表のアカウント・データが更新される場合。

22.2 FVCユーティリティでサポートされていないユースケース

次のシナリオでは、FVCユーティリティを使用してフォーム・データを更新できません。

- フィールドが複数のプロセス(親)フォームにわたって変更される場合。

- フィールドが同じフォームの複数のフィールドにマップされる場合。

- フィールドが異なる子フォームの複数のフィールドにマップされる場合。

- フィールドのデータ型が「参照フィールド」または「コンボ・ボックス」型以外の型から変更される場合。

- フィールドのデータ型が、「参照フィールド」または「コンボ・ボックス」型から「チェック・ボックス」型以外の型に変更される場合。

- 複数のフィールドが1つのフィールドに結合される場合。

22.3 フォーム・バージョン制御プロセスのサマリー

FVCユーティリティの各実行中に、次の手順が実行されます。

1. FVCユーティリティによって実行されるデータ変換処理に関する情報は、プロパティ・ファイルに格納されます。ユーティリティはこのプロパティ・ファイルの内容を読み取ります。

2. ユーティリティはUSR表のレコードのオブジェクト・ステータスをチェックします。次の手順は、レコードのステータスによって異なります。

- ユーザーのレコードがDeleted状態の場合、ユーティリティは次のユーザーのレコードに進みます。

- ユーザーのレコードがDeleted状態でない場合、ユーティリティはそのユーザーのコネクタ固有(UD_)表のアカウント・レコードのステータスをチェックします。次の手順は、アカウント・レコードごとに、そのステータスによって異なります。

- アカウント・レコードがRevoked状態の場合、ユーティリティはそのユーザーの次のアカウント・レコードに進みます。

- アカウント・レコードがRevoked状態でない場合、ユーティリティはプロパティ・ファイルで指定されている更新を実行します。

3. 特定のアカウント・レコードについて、ユーティリティは最初にレコードのバージョンを更新し、次にプロパティ・ファイルで指定されているデータを更新します。

注意:

エラーが発生した場合、コマンド・ウィンドウにエラー・メッセージが表示されます。エラーの原因を修正してユーティリティに戻った後、エラーの発生前に更新されていたレコードは再度処理されません。

22.4 FVCユーティリティのコンポーネント

次に、FVCユーティリティのコンポーネントを示します。

注意:

Design Consoleをインストールする場合、これらのファイルはOIM_DC_HOMEディレクトリにコピーされます。

- プロパティ・ファイル: .properties拡張子の付いたファイルは、ユーティリティを実行するプロセス・フォーム、子フォームおよびリソース・オブジェクトの詳細を指定するために使用します。サンプルとしてfvc.propertiesファイルが提供されています。新しいプロパティ・ファイルを使用する場合は、このファイルの名前をfvcutil.shまたはfvcutil.cmdで変更する必要があります。

- xlFvcUtil.jar: このJARファイルには、FVCユーティリティを実行するのに必要なユーティリティのクラスが含まれます。

- fvcutil.shおよびfvcutil.cmd: このスクリプトを使用してユーティリティを実行します。

22.5 FVCユーティリティの使用

次の項では、FVCユーティリティを使用する手順について説明します。

- プロパティ・ファイルの準備

- FVCユーティリティを使用するための前提条件への対処

- ユーティリティの実行

22.5.1 プロパティ・ファイルの準備

前述のように、FVCユーティリティで実行するデータ変換処理を定義するには、プロパティ・ファイルを使用します。プロパティ・ファイルを作成または更新する必要があるかどうかは、アップグレードのシナリオによって異なります。

- コネクタの事前定義済リリースから事前定義済リリースにアップグレードする場合は、コネクタ・デプロイメント・パッケージでプロパティ・ファイルを見つけます。

- カスタム・リリースからアップグレードする場合、またはカスタム・リリースにアップグレードする場合は、プロパティ・ファイルで必要なエントリを追加する必要があります。

- コネクタのカスタム・リリースから事前定義済リリースにアップグレードする場合は、コネクタのプロセス・フォームおよび子フォームへの変更に関する情報がコネクタ・ガイドに記載されているかどうかを確認します。この情報を使用して、プロパティ・ファイルで追加する必要があるエントリを決定できます。

次に、プロパティ・ファイルのサンプル・エントリを示します。

ResourceObject;OID User
FormName;UD_OID_USR
FromVersion;8
ToVersion;9
Parent;UD_OID_USR_DEFTVAL;ABC
Child;UD_OID_GRP_NORMALFIELD;XYZ;Update
ParentChild;UD_OID_USR_FNAME;UD_OID_GRP_NORMALFIELD
ChildChild;UD_OID_GRP_GROUP_NAME;UD_OID_GRP_NORMALFIELD
ChildParent;UD_OID_GRP_NORMALFIELD;UD_OID_USR_LNAME
ParentParent;UD_OID_USR_FNAME;UD_OID_USR_LOGIN;
ParentParentLookupOrComboToCheckBox;UD_OID_USR_PREF_LANG;UD_OID_USR_CHKBOXTEST
ChildParentLookupOrComboToCheckBox;UD_OID_GRP_GROUP_NAME;UD_OID_USR_CHKBOXTEST
ChildDiffChild;UD_OID_GRP_NORMALFIELD;UD_OID_ROLE_DIFFFIELD

プロパティ・ファイルでエントリを追加または変更する際には、次のガイドラインが適用されます。

注意:

ガイドラインをよりよく理解するには、前述のサンプル・エントリを参照してください。

- プロパティ・ファイルで、各行は、ユースケース名、古いフィールド名および新しいフィールド名で構成されます。これらはセミコロンで区切られます。
たとえば、プロパティ・ファイルの次のエントリについて考えてみます。

ParentChild;UD_OID_USR_FNAME;UD_OID_GRP_NORMALFIELD

ParentChild: 親のフィールドの名前が変更されたか、または親のフィールドが新しい子フォームへ移動されたことを表します。

UD_OID_USR_FNAME: 親フォームでの古いフィールド名を表します。

UD_OID_GRP_NORMALFIELD: 新しいフォームでアップグレードされるフィールドの新しい名前を表します。

注意:

セミコロンの直後を除き、値にスペースを含めることができます。

- プロパティ・ファイルに次の行を含める必要があります。

注意:

プロパティ・ファイルでのこれらの4行の場所と順序は重要ではありません。

- ResourceObject;RESOURCE_OBJECT_NAME
この行では、RESOURCE_OBJECT_NAMEをリソース・オブジェクトの名前に置き換えます。

サンプル行:

ResourceObject;OID User

- FormName;FORM_NAME
この行では、FORM_NAMEをプロセス(親)フォームの名前に置き換えます。

サンプル行:

FormName;UD_OID_USR

- FromVersion;CURRENT_VERSION_OF_FORM
この行では、CURRENT_VERSION_OF_FORMをフォームの現在のバージョンに置き換えます。

注意:

FVCユーティリティを実行する場合、バージョンがCURRENT_VERSION_OF_FORMと同じレコードのみがユーティリティによって更新されます。

サンプル行:

FromVersion;8

- ToVersion;NEW_VERSION_OF_FORM
この行では、NEW_VERSION_OF_FORMをフォームの新しいバージョンに置き換えます。

注意:

バージョンが変更されていないフォームのフォーム・データを更新する場合は、NEW_VERSION_OF_FORMをCURRENT_VERSION_OF_FORMと同じ値に設定します。

サンプル行:

ToVersion;9

- 次の行は、任意に組み合せてプロパティ・ファイルに含めることができます。

- Parent;FIELD_NAME;DEFAULT_FIELD_VALUE;Update
親フォームのすべてのレコードに対して、ユーティリティはFIELD_NAMEフィールドの値をDEFAULT_FIELD_VALUEで更新します。

注意:

親フォームで必須(必要な)フィールドが追加された場合は、必須フィールドのプロパティ・ファイルにこの行を含める必要があります。

サンプル行:

Parent;UD_OID_USR_DEFTVAL;MyString;Update

- Child;FIELD_NAME;DEFAULT_FIELD_VALUE;Update
子フォームのすべてのレコードに対して、ユーティリティはFIELD_NAMEフィールドの値をDEFAULT_FIELD_VALUEに更新します。

注意:

子フォームで必須(必要な)フィールドが追加された場合は、プロパティ・ファイルにこの行を含める必要があります。

サンプル行:

Child;UD_OID_GRP_NORMALFIELD;XYZ;Update

- ParentParent;OLD_FIELD_NAME;NEW_FIELD_NAME
親フォームで、ユーティリティはデータをOLD_FIELD_NAMEフィールドからNEW_FIELD_NAMEフィールドに移動します。

サンプル行:

ParentParent;UD_OID_USR_FNAME;UD_OID_USR_DEFTVAL;

- ParentParentLookupOrComboToCheckBox;OLD_FIELD_NAME;NEW_FIELD_NAME;
親フォームで、「チェック・ボックス」型フィールドに変更され、名前も変更された「参照フィールド」または「コンボ・ボックス」型フィールドについて、このフィールドの値がTrue(大/小文字は区別されません)の場合、ユーティリティは各レコードのチェック・ボックスを選択済の状態に設定します。それ以外の値の場合、ユーティリティはチェック・ボックスを選択解除の状態に設定します。

サンプル値:

ParentParentLookupOrComboToCheckBox;UD_OID_USR_PREF_LANG;UD_OID_USR_CHKBOXTEST

- ChildChild;OLD_FIELD_NAME;NEW_FIELD_NAME
子フォームで、ユーティリティは以前のバージョンのOLD_FIELD_NAMEフィールドから新しいバージョンのNEW_FIELD_NAMEフィールドにデータをコピーします。

サンプル行:

ChildChild;UD_OID_GRP_GROUP_NAME;UD_OID_GRP_NORMALFIELD

- ParentChild;OLD_FIELD_NAME;NEW_FIELD_NAME
OLD_FIELD_NAMEフィールドが親フォームから子フォームへ移動され、NEW_FIELD_NAMEという名前に変更されました。ユーティリティはデータをOLD_FIELD_NAMEフィールドからNEW_FIELD_NAMEフィールドに移動します。

サンプル行:

ParentChild;UD_OID_USR_FNAME;UD_OID_GRP_NORMALFIELD

- ChildParent;OLD_FIELD_NAME;NEW_FIELD_NAME
OLD_FIELD_NAMEフィールドが子フォームから親フォームへ移動され、NEW_FIELD_NAMEという名前に変更されました。ユーティリティはデータをOLD_FIELD_NAMEフィールドからNEW_FIELD_NAMEフィールドに移動します。

サンプル行:

ChildParent;UD_OID_GRP_NORMALFIELD;UD_OID_USR_DEFTVAL

- ChildParentLookupOrComboToCheckBox;OLD_FIELD_NAME;NEW_FIELD_NAME
「参照フィールド」または「コンボ・ボックス」型フィールド(OLD_FIELD_NAME)が「チェック・ボックス」型フィールドに変更され、子フォームから親フォームに移動されます。親フォームで、このフィールドの値がTrue(大/小文字は区別されません)の場合、ユーティリティは各レコードのチェック・ボックスを選択済の状態に設定します。それ以外の値の場合、ユーティリティはチェック・ボックスを選択解除の状態に設定します。

サンプル行:

ChildParentLookupOrComboToCheckBox;UD_OID_GRP_GROUP_NAME;UD_OID_USR_CHKBOXTEST

- ChildDiffChild;OLD_FIELD_NAME;NEW_FIELD_NAME
ユーティリティは、移動元の子フォームのOLD_FIELD_NAMEフィールドから移動先の子フォームのNEW_FIELD_NAMEフィールドへデータを移動します。

注意:

この更新は、移動元の子フォームに単一の行が含まれている場合にのみ実行されます。移動元の子フォームに複数の行が含まれているシナリオはサポートされません。

サンプル行:

ChildDiffChild;UD_OID_GRP_NORMALFIELD;UD_OID_ROLE_DIFFFIELD

22.5.2 FVCユーティリティを使用するための前提条件への対処

ユーティリティを実行する前に、次の手順を実行します。

1. FVCユーティリティ・スクリプトで次のようにJavaホーム・ディレクトリ・パスを設定します。

1. 使用しているオペレーティング・システムおよびアプリケーション・サーバーに応じて、テキスト・エディタで次のいずれかのファイルを開きます。
fvcutil.sh

fvcutil.cmd

2. set JAVA_HOMEを検索します。

3. 次の例に示すように、Javaホーム・ディレクトリ・パスを設定します。

set JAVA_HOME=C:\Java\

4. ファイルを保存して閉じます。

2. ユーティリティを実行するプロセス(親)フォームのバージョンがアクティブ・バージョンであることを確認します。
フォームのバージョンがアクティブ・バージョンであるかどうかを確認するには、次の手順を実行します。

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

2. 「Development Tools」フォルダを開き、「Form Designer」をダブルクリックします。

3. このフォームを検索して開きます。

4. フォームのアクティブ・バージョン・フィールドに、フォームのアクティブ・バージョンが表示されます。

3. ユーティリティは、フィールドがエラー処理アダプタに関連付けられている場合、フォーム・フィールドを更新できません。フィールドがエラー処理アダプタに関連付けられている場合は、次のようにアダプタへの関連付けを解除します。

注意:

ユーティリティの実行後、フィールドとそのエラー処理アダプタ間の関連を再度設定できます。その方法については、この章で後述します。

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

2. 「Process Management」フォルダを開き、「Process Definition」をダブルクリックします。

3. コネクタのプロセス定義を検索して開きます。

4. フィールドを更新するタスクの名前をメモします。

5. タスクをダブルクリックします。たとえば、「userID」フィールドにエラー処理アダプタがある場合は、「updateUserID」タスクをダブルクリックします。

6. 「タスクの編集」ダイアログ・ボックスの「統合」タブで、アダプタ変数名とその説明をメモします。

7. 「削除」をクリックします。

8. イベント・ハンドラ・アダプタを削除することを確認するには、表示されたメッセージで「OK」をクリックします。

9. 「保存」をクリックします。

22.5.3 ユーティリティの実行

注意:

フォーム・バージョンが変更されるたびにFVCユーティリティを実行する必要があります。

次のスクリプトを実行します。

Unixの場合:

sh fvcutil.sh

Windowsの場合:

fvcutil.bat

これにより、次の詳細を入力するように要求されます。

1. Oracle Identity Manager管理者のユーザー名の入力: Oracle Identity Manager管理者のユーザー名を入力します。

2. Oracle Identity Manager管理者のパスワードの入力: Oracle Identity Manager管理者のパスワードを入力します。

3. ロガー・レベルの入力: ロガー・レベルを入力します。DEBUG、WARN、INFOまたはERRORを指定できます。

4. ロガーの場所の入力: ユーティリティで各実行の終了時に作成するログ・ファイルの場所と名前を入力します。たとえば、<Path name>/FVC.logのようにします。

22.6 トラブルシューティング

表22-1に、ログ・ファイルに記録される可能性があるエラー・メッセージ、および問題を修正するために実行できる対応する操作を示します。

表22-1 エラー・メッセージおよび解決策

エラー・メッセージ

解決策

名前OBJECT_NAMEのオブジェクトが見つかりませんでした

プロパティ・ファイルで指定されているリソース・オブジェクトの名前を確認します。名前の綴りが正しいことを確認してください。

名前がFORM_NAMEのフォームが見つかりませんでした

プロパティ・ファイルで指定されているフォームの名前を確認します。名前の綴りが正しいことを確認してください。

フォームのアクティブ・バージョンが見つかりませんでした。

新規に作成されたフォームがコミットされておらず、Active状態に設定されていない可能性があります。フォームがActive状態であることを確認します。

ToVersion値とフォームのアクティブ・バージョンが一致しません。

ToVersion値が現在アクティブなフォームのバージョンと同じであることを確認します。

ToVersion値またはFromVersion値が有効なバージョンではありません。

ToVersion値およびFromVersion値が正しいことを確認します。

FIELD_NAMEフィールドがOracle Identity Managerデータベースに存在しません。

フィールド名の綴りが正しいことを確認してください。

23 アーカイブ・ユーティリティの使用

この章では各種アーカイブ・ユーティリティの使用方法について説明します。次の項で構成されています。

- リコンシリエーション・アーカイブ・ユーティリティの使用

- タスク・アーカイブ・ユーティリティの使用

- リクエスト・アーカイブ・ユーティリティの使用

- 監査アーカイブおよびパージ・ユーティリティの使用

23.1 リコンシリエーション・アーカイブ・ユーティリティの使用

この項では、リコンシリエーション・アーカイブ・ユーティリティの使用方法について説明します。内容は次のとおりです。

- リコンシリエーション・アーカイブ・ユーティリティについて

- リコンシリエーション・アーカイブ・ユーティリティの実行の前提条件

- アーカイブ基準

- リコンシリエーション・アーカイブ・ユーティリティの実行

- リコンシリエーション・アーカイブ・ユーティリティにより生成されるログ・ファイル

23.1.1 リコンシリエーション・アーカイブ・ユーティリティについて

Oracle Identity Managerは、ターゲット・システムのリコンシリエーション・データを、アクティブ・リコンシリエーション表と呼ばれるOracle Identity Manager表に格納します。

リコンシリエーション・プロセス中、リコンシリエーション・マネージャはアクティブ・リコンシリエーション表のデータをOracle Identity Managerのコア表とリコンサイルします。リコンシリエーション・マネージャはリコンサイルされたデータをアクティブ・リコンシリエーション表から削除しないため、これらの表は最終的に非常に大きくなり、リコンシリエーション・プロセス中のパフォーマンスが低下することがあります。リコンシリエーション・アーカイブ・ユーティリティを使用すると、Oracle Identity Managerとリコンサイルされたデータをアーカイブできます。リコンシリエーション・アーカイブ・ユーティリティは、アーカイブされたデータを、アクティブ・リコンシリエーション表と同じ構造のアーカイブ・リコンシリエーション表に格納します。

表23-1に、アクティブ・リコンシリエーション表と、アクティブ・リコンシリエーション表のデータがアーカイブされる対応するアーカイブ・リコンシリエーション表を示します。

表23-1 アクティブ・リコンシリエーション表とアーカイブ・リコンシリエーション表

アクティブ・リコンシリエーション表(Oracle Identity Manager表)

アーカイブ・リコンシリエーション表

RECON_EVENTS

ARCH_RECON_EVENTS

RECON_JOBS

ARCH_RECON_JOBS

RECON_BATCHES

ARCH_RECON_BATCHES

RECON_EVENT_ASSIGNMENT

ARCH_RECON_EVENT_ASSIGNMENT

RECON_EXCEPTIONS

ARCH_RECON_EXCEPTIONS

RECON_HISTORY

ARCH_RECON_HISTORY

RECON_USER_MATCH

ARCH_RECON_USER_MATCH

RECON_ACCOUNT_MATCH

ARCH_RECON_ACCOUNT_MATCH

RECON_CHILD_MATCH

ARCH_RECON_CHILD_MATCH

RECON_ORG_MATCH

ARCH_RECON_ORG_MATCH

RECON_ROLE_MATCH

ARCH_RECON_ROLE_MATCH

RECON_ROLE_HIERARCHY_MATCH

ARCH_RECON_ROLE_HIER_MATCH

RECON_ROLE_MEMBER_MATCH

ARCH_RECON_ROLE_MEMBER_MATCH

RA_LDAPUSER

ARCH_RA_LDAPUSER

RA_MLS_LDAPUSER

ARCH_RA_MLS_LDAPUSER

RA_LDAPROLE

ARCH_RA_LDAPROLE

RA_MLS_LDAPROLE

ARCH_RA_MLS_LDAPROLE

RA_LDAPROLEMEMBERSHIP

ARCH_RA_LDAPROLEMEMBERSHIP

RA_LDAPROLEHIERARCHY

ARCH_RA_LDAPROLEHIERARCHY

すべての水平リコンシリエーション表

"ARCH_" + substr(HTnames,1,25)

リコンシリエーション・アーカイブ・ユーティリティを使用して、次のタスクを実行できます。

- アクティブ・リコンシリエーション表のすべてまたは特定のデータをアーカイブ・リコンシリエーション表にアーカイブ

- アクティブ・リコンシリエーション表のすべてのデータの削除

アクティブ・リコンシリエーション表からアーカイブ・リコンシリエーション表にデータを移動してアーカイブする場合は、YYYYMMDD形式の日付(たとえば、この日付以前のすべてのレコードをアーカイブするなど)とリコンシリエーション・イベント・ステータスのパラメータ値(アーカイブするデータを定義)を指定する必要があります。これらのアーカイブ基準の詳細は、「アーカイブ基準」を参照してください。

選択したデータをアーカイブする場合は、指定した日付とイベント・ステータス以前に作成された選択したイベント・ステータスに基づいて、リコンシリエーション・データがユーティリティによってアーカイブされます。

アクティブ・リコンシリエーション表のすべてのデータをアーカイブ・リコンシリエーション表にアーカイブする場合、リコンシリエーション・アーカイブ・ユーティリティによって、指定した日付以前に作成されたリコンシリエーション・データがすべてアーカイブされます。

Oracle Database版のリコンシリエーション・アーカイブ・ユーティリティを構成するファイルは、次のディレクトリにあります。

OIM_HOME/db/oim/oracle/Utilities/Recon11gArchival

23.1.2 リコンシリエーション・アーカイブ・ユーティリティの実行の前提条件

リコンシリエーション・アーカイブ・ユーティリティを実行する前に、データベースにOIM_RECON_ARCH表領域を作成する必要があります。これを行うには、次のサンプル・コマンドを実行します。

CREATE TABLESPACE OIM_RECON_ARCH
LOGGING DATAFILE 'OIM_RECON_ARCH'
SIZE 500M REUSE AUTOEXTEND ON NEXT 10M;

注意:

- Oracle Identity Managerユーティリティを実行する環境で、LD_LIBRARY_PATHをSQL*PlusなどのOracleユーティリティを開始するように設定する必要があります。

- アクティブ・リコンシリエーション表からアーカイブ・リコンシリエーション表にアーカイブされたデータは、Oracle Identity Managerから使用できなくなります。このデータにアクセスするには、Oracle Identity Managerデータベースのアーカイブ・リコンシリエーション表を問い合せる必要があります。

23.1.3 アーカイブ基準

アーカイブするリコンシリエーション・データの選択には、次の基準が設けられています。値が一致するデータがアーカイブされます。

- データはYYYYMMDDの形式にする必要があります。指定されたリコンシリエーション・イベント・パラメータ値と一致する、この日付以前のすべてのレコードがアーカイブされます。

- リコンシリエーション・イベント・パラメータで、クローズ済、リンク済、クローズ済またはリンク済または「すべて」を選択します。

- クローズ済は、リコンシリエーション・マネージャで手動で閉じられたイベントを表します。

- リンク済は、Oracle Identity Managerにリコンサイルされたイベントを表し、次の状態を含みます。

- 作成に成功しました

- 更新に成功しました

- 削除に成功しました

- 作成に失敗しました

- 更新に失敗しました

- 削除に失敗しました

- クローズ済またはリンク済

- 「すべて」は、ステータスに関係なくすべてのイベントをアーカイブします。

23.1.4 リコンシリエーション・アーカイブ・ユーティリティの実行

リコンシリエーション・アーカイブ・ユーティリティを実行するには:

1. Oracle Identity Managerデータベースが使用可能で、リコンシリエーション・プロセスが実行されていないことを確認します。また、Oracle Identity Managerデータベースが他のセッションのトランザクションに対してオープンされていないことを確認します。

注意:

リコンシリエーション・アーカイブ・ユーティリティはオフピーク時間帯に実行することをお薦めします。

2. 「サーバーの起動と停止」の章の説明に従って、Oracle Identity Managerを停止します。

3. Microsoft Windowsプラットフォームでは、短い日付書式をM/d/yyyyとして指定する必要があります。また、時間書式をH:mm:ssとして指定する必要があります。日付書式および時間書式をカスタマイズするには、「コントロール パネル」で「地域と言語のオプション」コマンドを使用します。

注意:

- 日付書式および時間書式を変更すると、Microsoft Windowsプラットフォームで実行中のすべてのアプリケーションにその変更が適用されます。

- ユーティリティを呼び出す前に、日付に関する最低限の検証が行われ、ログ・ファイルをスキャンして無効な日付関連のエラーであるORA-18xxエラーがないか確認できます。

4. LinuxまたはUNIXプラットフォームでは、次のコマンドを実行してoim_recon_archival.shファイルの実行権限を設定し、このファイルが有効なLinuxまたはUNIXテキスト・ファイルであることを確認します。

chmod 755 path/oim_recon_archival.sh
dos2unix path/oim_recon_archival.sh

5. LinuxまたはUNIXプラットフォームでは、path/oim_recon_archival.shファイルを実行してユーティリティを実行します。
Microsoft Windowsプラットフォームでは、path\oim_recon_archival.batファイルを実行してユーティリティを実行します。

6. Oracle Databaseインストール環境で、求められた場合には次のパラメータの値を入力します。

- Oracleホーム・ディレクトリ

- リモート・データベースのOracle Database名の場合は、入力として接続文字列が求められ、これは、//HOST_NAME:PORT/SERVICE_NAMEの形式で入力します。

- Oracle Identity Managerデータベースのユーザー名とパスワード

7. リコンシリエーション作成日をYYYYMMDD書式で入力します。この日付以前の必要なステータス値を持つすべてのレコードがアーカイブされます。

8. 求められた場合には、アーカイブするデータのリコンシリエーション・イベント・ステータスを選択します。

- クローズ済の場合は1を入力

- リンク済の場合は2を入力

- クローズ済またはリンク済の場合は3を入力

- 「すべて」の場合には4を入力

- 「終了」の場合には5を入力

9. 処理するバッチ・サイズを入力します。
デフォルトのバッチ・サイズは5000です。

注意:

バッチ・サイズは、アーカイブ/パージの単一のイテレーションで、データベース・レベルでの内部コミットとして処理されるレコード数の値です。実行時にアーカイブ・ユーティリティの操作を開始するときに、バッチ・サイズを入力パラメータ値として指定する必要があります。

このバッチ・サイズはデフォルトで5000です。数十万を超えるrecon_eventsをパージする場合は、より大きいバッチ・サイズを選択できます。その場合、RDBMSでより多くのリソースが必要となることがあります(たとえば、TEMP表領域やUNDO表領域でより多くの領域が必要)。

ユーティリティはリコンシリエーション・データをアーカイブし、ログ・ファイルに実行サマリーを記録します。

10. Microsoft Windowsプラットフォームでは、ユーティリティの実行後に、短い日付書式を地域またはロケールの日付書式に再設定します。「コントロール パネル」の「地域と言語のオプション」コマンドを使用して日付書式を再設定します。

11. アクティブ・リコンシリエーション表からデータが削除されるため、DBAは統計を更新するためにアクティブ・リコンシリエーション表およびその索引を分析する必要があります。Oracle Identity ManagerのデータベースとしてOracle Databaseを使用している場合のみ、この手順を実行してください。

23.1.5 リコンシリエーション・アーカイブ・ユーティリティにより生成されるログ・ファイル

リコンシリエーション・アーカイブ・ユーティリティの実行後、次のログ・ファイルが生成されます。

./logs/oim_recon_archival_summary_TIMESTAMP.log

ユーティリティの実行が失敗すると、ユーティリティが失敗したバッチ番号とそのエラー・メッセージがログ・ファイルに記録されます。

23.2 タスク・アーカイブ・ユーティリティの使用

この項では、タスク・アーカイブ・ユーティリティの使用方法について説明します。内容は次のとおりです。

- タスク・アーカイブ・ユーティリティについて

- タスク・アーカイブ・ユーティリティのためのOracle Databaseの準備

- タスク・アーカイブ・ユーティリティの実行

- タスク・アーカイブ・ユーティリティにより生成される出力ファイルの確認

23.2.1 タスク・アーカイブ・ユーティリティについて

Oracle Identity Managerでは、タスクはリソースのプロビジョニングを処理するプロセスを構成する1つ以上のアクティビティを意味します。たとえば、リソースへのアクセスを要求するプロセスには、複数のプロビジョニング・タスクが含まれます。Oracle Identity Managerでは、アクティブ・タスク表と呼ばれる次の表にタスク・データを格納します。

- OSI

- OSH

- SCH

Oracle Identity Managerのデフォルトでは、完了したタスクはアクティブ・タスク表から削除されません。アクティブ・タスク表のサイズが増加するにつれて、特にプロビジョニング・タスクの管理時に、パフォーマンスが低下する可能性があります。タスクが正常に実行されたら、タスク・アーカイブ・ユーティリティを使用してタスク・データをアーカイブし、それをアクティブ・タスク表から削除できます。タスク・アーカイブ・ユーティリティでタスク・データをアーカイブすると、パフォーマンスが改善され、データを安全に格納できます。

タスク・アーカイブ・ユーティリティは、アーカイブされたタスク・データを次のアーカイブ・タスク表に格納します。これらの表の構造は、アクティブ・タスク表と同じです。

- ARCH_OSI

- ARCH_OSH

- ARCH_SCH

タスク・アーカイブ・ユーティリティを使用して、次のタイプのタスクをアーカイブできます。

- 無効化または削除されたユーザーの失効されたリソース・インスタンスに対するプロビジョニング・タスク

- 失効されたリソース・インスタンスに対するプロビジョニング・タスク

タスク・アーカイブ・ユーティリティを使用してタスクをアーカイブする場合、アーカイブ前に、アーカイブ操作のタイプ、ユーザー・ステータス、タスク実行日および索引を削除するレコード数を指定できます。アーカイブ操作はアーカイブするタスク・データのタイプを示し、ユーザー・ステータスは削除、無効化またはその両方を行ったユーザーに関するデータをアーカイブするかどうかを決定します。タスク実行日はタスクを実行する日を示し、YYYYMMDD書式である必要があります。

指定したタスク実行日まで、実行されるすべてのタスクがアーカイブされます。アーカイブ・プロセスにかかる時間を短縮するために、アーカイブされるレコード数が200000を超えると、ユーティリティによりすべてのアクティブ・タスク表の索引が削除されます。アーカイブ・データがアクティブ・タスク表から削除された後に、索引は再作成されます。200000という値は必要な値に変更できます。OIM_TasksArch.batファイルまたはOIM_TasksArch.shファイルのコードの次の行で値を変更できます。

.batファイルの場合、set INDXRESP=200000

.shファイルの場合、indxopt=200000

Oracle Database版のタスク・アーカイブ・ユーティリティを構成するファイルは、次のディレクトリにあります。

OIM_HOME/db/oim/oracle/Utilities/TaskArchival

注意:

アクティブ・タスク表からアーカイブ・タスク表にアーカイブされたデータは、Oracle Identity Managerから使用できなくなります。このデータにアクセスするには、Oracle Identity Managerデータベースのアーカイブ・タスク表を問い合せる必要があります。

23.2.2 タスク・アーカイブ・ユーティリティのためのOracle Databaseの準備

タスク・アーカイブ・ユーティリティをOracle Databaseとともに使用するには、次の手順を実行する必要があります。

1. SQL*Plusを起動し、Oracle DatabaseにSYSユーザーとして接続します。

2. 次のコマンドを入力して、アーカイブ・タスク表用に別の表領域を作成します。DATA_DIRを、データ・ファイルを格納するディレクトリで置き換え、必要に応じてサイズなどのパラメータを環境に合せて調整します。

CREATE TABLESPACE TasksArch
DATAFILE 'DATA_DIR\tasksarch_01.dbf' SIZE 1000M REUSE
EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO;

注意:

大量のデータをアーカイブする際は、大きなサイズのUNDO表領域を割り当てることをお薦めします。また、初期化パラメータparallel_max_serversおよびparallel_min_serversを構成して、パラレル実行を有効にしてください。パラレル実行は、アーカイブ・プロセスのパフォーマンスの向上に役立ちます。

3. Oracle Identity Managerデータベース・ユーザーとしてOracle Databaseに接続します。

4. 次のコマンドを入力してcr_taskarchival_ddl_table.sqlスクリプトを実行し、OIM_TASK_ARCH_DDLという表を作成します。この表は、タスク・アーカイブ・ユーティリティで使用されます。

@ path/cr_taskarchival_ddl_table.sql

5. 次のコマンドを入力してCreate_TasksArch_Tables.sqlスクリプトを実行し、アーカイブ・タスク表を作成します。

@ path/Create_TasksArch_Tables.sql

6. 次のコマンドを入力してOIM_SP_TASKS_ARCHIVAL.sqlスクリプトを実行し、タスク・アーカイブ・ユーティリティでタスク・データをアーカイブおよび削除するために使用するストアド・プロシージャを作成します。

@ path/OIM_SP_TASKS_ARCHIVAL.sql

注意:

Oracle Identity Managerユーティリティを実行する環境で、LD_LIBRARY_PATHをSQL*PlusなどのOracleユーティリティを開始するように設定する必要があります。

23.2.3 タスク・アーカイブ・ユーティリティの実行

次の手順を実行して、タスク・アーカイブ・ユーティリティを実行します。

1. Oracle Identity Managerデータベースが使用可能になっており、他のOracle Identity Managerトランザクションに対してはオープンになっていないことを確認します。

注意:

タスク・アーカイブ・ユーティリティは、オフピーク時間帯に実行することをお薦めします。

2. OSI、SCHおよびOSH表のバックアップを作成したことを確認します。

3. 使用しているアプリケーション・サーバーに対応したOracle Identity Managerのインストレーション・ガイドの手順に従って、Oracle Identity Managerを停止します。

4. Microsoft Windowsプラットフォームでは、短い日付書式をdddd M/d/yyyyとして指定する必要があります。また、時間書式をH:mm:ssとして指定する必要があります。日付書式および時間書式をカスタマイズするには、「コントロール パネル」で「地域と言語のオプション」コマンドを選択します。

注意:

- 日付書式および時間書式を変更すると、Microsoft Windowsプラットフォームで実行されるすべてのアプリケーションに影響します。

- ユーティリティを呼び出す前に、日付に関する最低限の検証が行われ、ログ・ファイルをスキャンして無効な日付関連のエラーであるORA-18xxエラーがないか確認できます。

5. LinuxおよびUNIXプラットフォームでは、path/OIM_TasksArch.shファイルを実行します。Microsoft Windowsプラットフォームでは、path\OIM_TasksArch.batファイルを実行します。

6. Oracle Databaseインストール環境で、求められた場合には次のパラメータの値を入力します。

- Oracleホーム・ディレクトリ

- Oracle Identity Managerデータベース名またはOracle Identity Managerデータベースがリモート・コンピュータで稼働している場合はTNS文字列

- リモート・データベースの場合は、入力として接続文字列が求められます。これは、//HOST_NAME:PORT/SERVICE_NAMEの形式で入力します。

- Oracle Identity Managerデータベースのユーザー名とパスワード

7. 求められた場合には、次のオプションのいずれかを選択します。

- 無効化または削除されたユーザーの失効されたリソース・インスタンスに対するプロビジョニング・タスクをすべてアーカイブします。

- ?失効されたリソース・インスタンスに対するプロビジョニング・タスクをすべてアーカイブします。

- 終了します。

8. 無効化または削除されたユーザーの失効されたリソース・インスタンスに対するプロビジョニング・タスクをすべてアーカイブする場合、次のいずれかのオプションを選択します。

- ステータスが「削除」であるユーザー

- ステータスが「無効」であるユーザー

- ステータスが「削除」および「無効」であるユーザー

- メイン・メニューに戻る

9. 入力を求められたら、YYYYMMDDという書式でタスク実行日を入力します。指定したタスク実行日まで、実行されるすべてのタスクがアーカイブされます。現在の日付以前に実行されたすべてのタスクをアーカイブするには、日付を入力せずに[Enter]キーを押します。

10. ユーティリティがアーカイブ・プロセスを開始する前に、サマリー情報が表示されます。サマリー情報によって、アーカイブされるタスクの合計数がわかります。サマリー情報を注意深く確認し、サマリーに表示されている削除量をデータベースでサポートできることを確認します。
タスクをアーカイブするには、入力を求められたときにyまたはYの値を入力します。あるいは、nまたはNを入力して、ユーティリティを終了します。

注意:

入力を求められたときに、YまたはNの値を入力する必要があります。値を選択しないで[Enter]キーを押すと、ユーティリティでは再度アーカイブされるタスク数が計算され、アーカイブを開始せずに確認が求められます。

11. Microsoft Windowsプラットフォームでは、タスク・アーカイブ・ユーティリティの実行完了後に、短い日付書式を地域またはロケールの日付書式に再設定します。「コントロール パネル」で「地域と言語のオプション」コマンドを使用して日付書式を再設定します。

注意:

アクティブ・タスク表からデータが削除されるため、更新される統計用にアクティブ・タスク表およびその索引を分析する必要があります。Oracle Identity ManagerのデータベースとしてOracle Databaseを使用している場合のみ、この手順を実行してください。

23.2.4 タスク・アーカイブ・ユーティリティにより生成される出力ファイルの確認

表23-2に、タスク・アーカイブ・ユーティリティによって生成される出力ファイルを示します。

表23-2 タスク・アーカイブ・ユーティリティによって生成される出力ファイル

ファイル

説明

Err_DB_Conn_timestamp.log

ユーティリティが指定された資格証明を使用してデータベースに接続できなかった場合に生成されます。

Err_Arch_Tasks_timestamp.log

アーカイブ・プロセスまたは削除プロセスが失敗した場合に生成されます。

Arch_TaskData_timestamp.log

アーカイブ・プロセスまたは削除プロセスが成功した場合に生成されます。

注意:

ユーティリティを再度実行するときに、これらのエラー・ログ・ファイルは削除されます。

23.3 リクエスト・アーカイブ・ユーティリティの使用

この項では、リックエスト・アーカイブ・ユーティリティの使用方法について説明します。内容は次のとおりです。

- リクエスト・アーカイブ・ユーティリティについて

- リクエスト・アーカイブ・ユーティリティの実行の前提条件

- 入力パラメータ

- リクエスト・アーカイブ・ユーティリティの実行

- ユーティリティにより生成されるログ・ファイル

23.3.1 リクエスト・アーカイブ・ユーティリティについて

デフォルトで、Oracle Identity Managerはクローズまたは取り消されたリクエストをアクティブ・リクエスト表から削除しません。これらのリクエストをアーカイブしてディスク領域を解放し、データベースのパフォーマンスを向上させるには、リクエスト・アーカイブ・ユーティリティを使用します。リクエスト・データは、リクエスト作成日とリクエスト・ステータスに基づいてアーカイブできます。リクエスト・ステータスに基づいてリクエストをアーカイブするかどうかは任意です。リクエスト・ステータスを使用すると、次の内容をアーカイブできます。

- リクエスト・ステータスが取消し済、「クローズ済」または「完了」である完了したリクエスト。これは、オプション完了の場合は1を選択して指定されます。

- リクエスト・ステータスが取消し済、「クローズ済」、「完了」または「失敗」、一部失敗である完了または失敗したリクエスト。これは、オプション完了および失敗の場合は2を選択して指定されます。

- リクエスト作成日に基づくすべてのリクエスト。これは、オプションすべての場合は3を選択して指定されます。

表23-3に、アーカイブされる表の名前と、対応するアーカイブ表の名前を示します。

表23-3 アーカイブ表

メイン表

アーカイブ表

REQUEST

ARCH_REQUEST

REQUEST_HISTORY

ARCH_REQUEST_HISTORY

REQUEST_APPROVALS

ARCH_REQUEST_APPROVALS

REQUEST_ENTITIES

ARCH_REQUEST_ENTITIES

REQUEST_ENTITY_DATA

ARCH_REQUEST_ENTITY_DATA

REQUEST_BENEFICIARY

ARCH_REQUEST_BENEFICIARY

REQUEST_BENEFICIARY_ENTITIES

ARCH_REQUEST_BE

REQUEST_BENEFICIARY_ENTITYDATA

ARCH_REQUEST_BED

REQUEST_TEMPLATE_ATTRIBUTES

ARCH_REQUEST_TA

WF_INSTANCE

ARCH_WF_INSTANCE

REQUEST_COMMENTS

ARCH_REQUEST_COMMENTS

Oracle Database版のリクエスト・アーカイブ・ユーティリティを構成するファイルは、次のディレクトリにあります。

OIM_HOME/db/oim/oracle/Utilities/RequestArchival

リクエスト・アーカイブ・ユーティリティは、Oracle Identity Managerを停止してオフライン・モードで実行することも、Oracle Identity Managerを実行してオンライン・モードで実行することもできます。

ユーティリティをオフライン・モードで実行する前に、Oracle Identity Managerを停止する必要があります。

23.3.2 リクエスト・アーカイブ・ユーティリティの実行の前提条件

リクエスト・アーカイブ・ユーティリティを実行する前に、次のことを行います。

注意:

Oracle Identity Managerユーティリティを実行する環境で、LD_LIBRARY_PATHをSQL*PlusなどのOracleユーティリティを開始するように設定する必要があります。

- OIM_REQUEST_ARCH表領域を作成します。リクエスト・アーカイブ・ユーティリティを初めて実行する場合は、アーカイブされるすべての表に対して、対応するアーカイブ表が作成されます。アーカイブ表は、OIM_REQUEST_ARCHと呼ばれる個別の表領域に作成されます。ユーティリティを実行する前に、この表領域を作成しておく必要があります。

- oim_create_request_arch_tables.sqlスクリプトを実行して、リクエスト表に対して必要なアーカイブ表を作成します。これは、アーカイブされるすべての表に対応するアーカイブ表を作成するPL/SQLスクリプトです。

- ユーティリティをオフライン・モードで実行する場合は、ユーティリティを実行する前にOracle Identity Managerを停止する必要があります。

23.3.3 入力パラメータ

表23-4に、リクエスト・アーカイブ・ユーティリティによって使用される入力パラメータのリストを示します。

表23-4 入力パラメータ

パラメータ

説明

Oracleホーム

システムのORACLE_HOME環境変数の値。

Oracle SID

Oracle Identity ManagerデータベースのSID。リモート・データベースの場合は、//HOST_NAME:PORT/SERVICE_NAMEの形式で接続文字列を入力する必要があります。

ここで、HOST_NAMEはデータベースがデプロイされているコンピュータのホスト名、PORTはホストのポート番号、SERVICE_NAMEはデータベース・インスタンスの名前です。

OIM DBユーザー

Oracle Identity Managerデータベース・ユーザーのデータベース・ログインIDです。

OIM DBパスワード

Oracle Identity Managerデータベース・ユーザーのパスワード。

リクエスト・ステータス

ユーザー入力値1、2または3に基づいたリクエスト・ステータス。

リクエスト作成日

ユーティリティは、このリクエスト基準日またはそれ以前に作成された、必要なリクエスト・ステータスのすべてのリクエストをアーカイブします。

バッチ・サイズ

ユーティリティは、レコードのグループまたはバッチを単一トランザクションとして処理します。バッチ・サイズは、ユーティリティのパフォーマンスに影響する可能性があります。

「バッチ・サイズ」のデフォルト値は2000です。

ユーティリティ実行モード

ユーティリティを実行するモード(オンラインまたはオフライン)。オンライン・モードの場合は1を、オフライン・モードの場合は2を入力する必要があります。

ユーティリティは、オンライン・モードよりもオフライン・モードのほうが高速で実行されます。ただし、ユーティリティをオフライン・モードで実行するには、ダウンタイムが必要です。オフライン・モードで実行することによってアーカイブ操作を高速化できますが、ユーティリティがアーカイブ操作を完了するまでOracle Identity Managerを使用できません。このため、このオプションを選択する前に、Oracle Identity Managerが実行されていないことを確認してください。

23.3.4 リクエスト・アーカイブ・ユーティリティの実行

リクエスト・アーカイブ・ユーティリティを実行するには:

1. Oracle Identity Managerデータベースが使用可能であることを確認します。

注意:

リクエスト・アーカイブ・ユーティリティは、オフピーク時間帯に実行することをお薦めします。

2. ユーティリティをオフライン・モードで実行する場合は、「サーバーの起動と停止」の章の説明に従って、Oracle Identity Managerを停止します。
ユーティリティをオンライン・モードで実行する場合は、この手順を無視してステップ3に進みます。

3. Microsoft Windowsプラットフォームでは、短い日付書式をdddd M/d/yyyy.として指定する必要があります。また、時間書式を H:mm:ssとして指定する必要があります。日付書式および時間書式をカスタマイズするには、「コントロール パネル」で「地域と言語のオプション」コマンドを使用します。

注意:

- 日付書式および時間書式を変更すると、Microsoft Windowsプラットフォームで実行中のすべてのアプリケーションにその変更が適用されます。

- ユーティリティを呼び出す前に、日付に関する最低限の検証が行われ、ログ・ファイルをスキャンして無効な日付関連のエラーであるORA-18xxエラーがないか確認できます。

4. UNIXプラットフォームでは、次のコマンドを実行してOIM_request_archival.sh ファイルの実行権限を設定し、このファイルが有効なUNIXテキスト・ファイルであることを確認します。

chmod 755 path/OIM_request_archival.sh
dos2unix path/OIM_request_archival.sh

5. UNIXプラットフォームでは、path/OIM_request_archival.shファイルを実行します。Microsoft Windowsプラットフォームでは、path\OIM_request_archival.batファイルを実行します。
oim_request_archivalスクリプトではデータベース入力が検証され、データベースとの接続が確立されます。次にoim_request_archival.sqlスクリプトが呼び出され、このスクリプトはユーティリティに関連するPL/SQLプロシージャをコンパイルするために使用されます。

6. Oracle Databaseインストール環境で、求められた場合には次のパラメータの値を入力します。

- Oracleホーム・ディレクトリ

- Oracle Identity Managerデータベース名またはOracle Identity Managerデータベースがリモート・コンピュータで稼働している場合はTNS文字列。そうでない場合は、ORALE SIDを入力します。

- リモート・データベースの場合は、入力として接続文字列が求められます。これは、//HOST_NAME:PORT/SERVICE_NAMEの形式で入力します。

- Oracle Identity Managerデータベースのユーザー名とパスワード

7. 求められた場合には、次のオプションのいずれかを入力します。

- ステータスが「リクエストが取り消されました」、「リクエストがクローズされました」、「リクエストが完了しました」で、作成日がユーザーによってYYYYMMDD書式で指定されたリクエスト作成日またはそれ以前であるリクエストをアーカイブするには、1を入力します。

- ステータスが「リクエストが取り消されました」、「リクエストがクローズされました」、「リクエストが完了しました」またはリクエストの一部が失敗しましたで、作成日がユーザーによってYYYYMMDD書式で指定されたリクエスト作成日またはそれ以前であるリクエストをアーカイブするには、2を入力します。

- リクエスト作成日が、ユーザーによってYYYYMMDD書式で指定されたリクエスト作成日またはそれ以前であるすべてのリクエストをアーカイブするには、3を入力します。

8. ユーティリティを実行するモードを指定するように求められた場合、ユーティリティをオンライン・モードで実行する場合は1を入力します。それ以外の場合は、2を入力してユーティリティをオフライン・モードで実行します。

9. 求められた場合には、バッチ・サイズを指定します。

注意:

バッチ・サイズは、アーカイブ/パージの単一のイテレーションで、データベース・レベルでの内部コミットとして処理されるレコード数の値です。実行時にアーカイブ・ユーティリティの操作を開始するときに、バッチ・サイズを入力パラメータ値として指定する必要があります。

このバッチ・サイズはデフォルトで2000です。より大きいバッチ・サイズを選択できますが、その場合、データベースでより多くのリソースが必要となることがあります(たとえば、TEMP表領域やUNDO表領域でより多くの領域が必要)。

ユーティリティはリクエスト・データをアーカイブし、ログ・ファイルに実行サマリーを記録します。

10. Microsoft Windowsプラットフォームでは、ユーティリティの実行後に、短い日付書式を地域またはロケールの日付書式に再設定します。「コントロール パネル」の「地域と言語のオプション」コマンドを使用して日付書式を再設定します。

11. アクティブ・リクエスト表からデータが削除されるため、DBAは統計を更新するためにアクティブ・リクエスト表およびその索引を分析する必要があります。Oracle Identity ManagerのデータベースとしてOracle Databaseを使用している場合のみ、この手順を実行してください。

23.3.5 ユーティリティにより生成されるログ・ファイル

すべてのログは、現在のフォルダに作成されているlogs/ディレクトリに書き込まれます。表23-5にユーティリティにより生成されるログ・ファイルのリストを示します。

表23-5 DBアーカイブ・ユーティリティにより生成されるログ

ログ・ファイル

説明

oim_create_request_arch_tables.log

ユーティリティがアーカイブ表の作成に失敗したときに作成されます。

oim_request_archival.log

ユーティリティがアーカイブに必要なプロシージャの作成に失敗したときに作成されます。

validate_date.log

入力値REQUEST_CREATION_DATEが無効な場合に作成されます。

oim_request_archival_summary_TIMESTAMP.log

実行のサマリーが含まれます。

Err_DB_Conn_TIMESTAMP_ATTEMPTNUMBER.log

ユーティリティが提供される資格証明を使用してデータベースに接続できない場合に作成されます。

23.4 監査アーカイブおよびパージ・ユーティリティの使用

この項では、監査アーカイブおよびパージ・ユーティリティの使用方法について説明します。内容は次のとおりです。

- 概要

- ユーティリティの使用の前提条件

- アーカイブおよびパージのためのUPA表の準備

- UPA表のアーカイブまたはパージ

23.4.1 概要

Oracle Identity Managerデータベース・スキーマで継続的にデータが生成され、監査データが増加することにより、データベース・サーバーによる記憶域の消費量が徐々に増大します。監査データはUPA表に移入されます。UPA表のデータの増加により、ディスク領域とメンテナンスの問題が発生する場合があります。したがって、UPA表内の古い監査データを消去またはアーカイブする必要があります。

ディスク領域の消費量を制御するために、監査アーカイブおよびパージ・ユーティリティを使用できます。このユーティリティは、論理的かつ一貫した方法でデータをパージすることにより、監査データの増加を制御します。

注意:

- 監査アーカイブおよびパージ・ソリューションは、UPA表にのみ適用できます。UPA_ prefixを含む表である監査レポート表には適用できません。

- このユーティリティは、Oracle Identity Managerリリース9.1.0以降と互換性があります。

パーティションをアーカイブまたは削除できる、暦年に基づいたUPA表のパーティション化をお薦めします。パーティション化の利点は、Oracle Identity Managerでは古いパーティションにある古い監査データが使用されないため、古いパーティションをアーカイブまたはパージできることです。Oracle Identity Managerでは、最新の監査データおよび現在の暦年データが使用されます。したがって、UPA表は、EFF_TO_DATE列を使用して、日付範囲に基づいたパーティション化方法で暦年ごとにパーティション化されます。パーティション化後、EFF_TO_DATEがNULLである最新の監査データが1つのパーティションにグループ化され、暦年ごとに1つのパーティションが作成されます。Oracle Identity Managerは、現在の最新年のパーティション以外のパーティションに対する読取りや書込みは行いません。

たとえば、2005年からOracle Identity Managerの監査機能を使用していて、暦年2011年に監査アーカイブおよびパージ・ソリューションを実装する場合、暦年ごとにパーティションを作成すると仮定すると、これを実施した後に7つのパーティションが作成されることになります。これらの7つのパーティションで、Oracle Identity Managerは次のパーティションに対してのみ読取りまたは書込みを行います。

- 最新のパーティション

- 現在の年のパーティション(たとえば、2011年)

それ以前の年のパーティションはすべてアーカイブ後にパージされます。アーカイブしない場合は、それらの古いパーティションをパージできます。古いパーティションをアーカイブおよびパージすることにより、領域を再利用することができます。現在の最新年のパーティションは、Oracle Identity Managerが引き続き使用するためそのままにしておく必要があります。

23.4.2 ユーティリティの使用の前提条件

監査アーカイブおよびパージ・ユーティリティを使用するには、次の前提条件を満たす必要があります。

- データベースのパーティション化はOracle DatabaseのEnterprise Editionでのみサポートされています。したがって、監査アーカイブおよびパージ・ソリューションを実装するには、Oracle DatabaseのEnterprise Editionを実行する必要があります。

- UPA表は暦年に基づいてレンジ・パーティション化する必要があります。パーティション方法のそれ以外のモードはサポートされていません。

- UPA表の最新のバックアップが使用可能であることを確認します。UPA表のバックアップの作成は、このソリューションを適用するための必須の前提条件です。このソリューションを本番データベースに実装する前に、開発またはステージング環境で試用することをお薦めします。

- このソリューションを実装する前に、過去何年分の監査データをオンラインにしておく必要があるかを決定します。これは、事前にパーティションを作成する場合に役立ちます。

- 各パーティションは独自の表領域に置く必要があります。異なる年のパーティションや他のデータ間で表領域を共有しないでください。

- パーティション化中、各暦年の監査データは最終的な宛先に移動される前に表にコピーされます。コピーされたデータを保持するディスク領域をプロビジョニングしておく必要があります。

23.4.3 アーカイブおよびパージのためのUPA表の準備

アーカイブおよびパージ・ソリューションのためのUPA表を準備するには、次の手順を実行します。

1. Oracle Identity Managerが実行されておらず、オフライン・ユーティリティで使用できないことを確認します。

2. UPA表がパーティション化されるまで、Oracle Identity Managerデータベースに対するトランザクションが存在しないようにします。

3. UPA表に対する問合せを実行して、監査データの最小および最大の暦年を取得します。最小および最大の年を取得するには次の問合せが役立ちます。最大の年は現在の暦年である必要があります。

SELECT EXTRACT (YEAR FROM MIN (eff_to_date)) min_year,EXTRACT (YEAR FROM MAX (eff_to_date)) running_year FROM upa;

これは、最小の年から始まる各暦年のパーティションを決定する際に役立ちます。

4. 新規パーティション表を作成します。
2005年を最小の年、2011年を実行または現在の暦年とした場合、新規パーティション表を作成する前に次のことを決定しておく必要があります。

- 何年分の古い監査データを保持しますか。3年分の監査データのみを保持することが重要な場合は、2008年からの新規にパーティション化された表を作成する必要があります。2008年より古いデータは、元のUPA表が削除されるときにクリーンアップされます。

- 何年分の古いデータを保持するかを決定した後、古いデータをどのようにしてどこに保持しますか。古いデータ・パーティションをすべてアーカイブUPA表に保持しますか、または古いパーティションのバックアップを作成し、古いパーティションを削除しますか。古いパーティションをテープに移し、UPA表からパージすることをお薦めします。前述のように、最新の実行中の暦年パーティションはそのままにしておく必要があります。

次のサンプルは、3年分の監査データをUPA表に保持し、現在の暦年は2011であることを想定しています。

SQL> SELECT 'Create Table UPA_PART
(
UPA_KEY NUMBER (19) Not Null,
USR_KEY NUMBER (19) Not Null,
EFF_FROM_DATE TIMESTAMP (6) Not Null,
EFF_TO_DATE TIMESTAMP (6),
SRC VARCHAR2 (4000),
SNAPSHOT CLOB,
DELTAS CLOB,
SIGNATURE CLOB
)
PARTITION BY RANGE (EFF_TO_DATE)
(PARTITION UPA_2008 VALUES LESS THAN (TO_DATE(''01/01/2009'', ''DD/MM/YYYY'')) Tablespace upa_2008,
PARTITION UPA_2009 VALUES LESS THAN (TO_DATE(''01/01/2010'', ''DD/MM/YYYY'')) Tablespace upa_2009,
PARTITION UPA_2010 VALUES LESS THAN (TO_DATE(''01/01/2011'', ''DD/MM/YYYY'')) Tablespace upa_2010,
PARTITION UPA_2011_PART1 VALUES LESS THAN (TO_DATE('''||TO_CHAR(SYSDATE,'DD/MM/YYYY HH24:MI:SS')||''',''DD/MM/YYYY HH24:MI:SS'')) TABLESPACE UPA_2011_PART1,
PARTITION UPA_2011_PART2 VALUES LESS THAN (TO_DATE(''01/01/2012'',''DD/MM/YYYY'')) TABLESPACE UPA_2011_PART2,
PARTITION UPA_LATEST VALUES LESS THAN (MAXVALUE) TABLESPACE UPA_MAX
)
ENABLE ROW MOVEMENT;' FROM DUAL;

5. 次の文を実行して、UPA表と同様の構造を持つパーティション化されていない別の表を作成します。

SQL> Create table upa_non_part Tablespace TBS_NAME as select * from upa where 1=2;

ここで、TBS_NAMEは、交換されるパーティションと同じ表領域の名前です。

この表は本来一時的なものです。この表の目的は、新規にパーティション化されたUPA表への監査データのロードを容易にすることです。

注意:

UPA_NON_PARTまたはパーティション化されていない一時表は、交換するパーティションと同じ表領域に作成する必要があります。

6. 次に示すように、最新の監査データをパーティション化されていないUPA表にロードします。

SQL> Insert /*+ parallel */ into upa_non_part select /*+ parallel */   * from upa where eff_to_date is null;
SQL> COMMIT;

注意:

INSERT文でのヒント/*+parallel*/の使用は任意であり、使用可能なリソースに応じて他のヒントを使用してパフォーマンスを改善することもできます。

7. 次に示すように、ALTER TABLEコマンドを使用してデータをパーティション化された表に入れ替えます。

SQL> ALTER TABLE upa_part EXCHANGE PARTITION UPA_LATEST WITH TABLE UPA_NON_PART WITH VALIDATION UPDATE GLOBAL INDEXES;

8. 次に示すように、upa_non_part表を削除します。

SQL> DROP TABLE upa_non_part;

パーティションを交換する際は、データが物理的に書き込まれるのではなく、データ・ディクショナリが更新されます。したがって、交換するパーティションに関連する同じ表領域内のパーティション化されていない一時UPA_NON_PART表を削除し、再作成する必要があります。

9. 次に示すように、パーティション化されていない元のUPA表の名前をUPA_OLDに変更します。

SQL> ALTER TABLE upa rename TO upa_old;

10. 新規にパーティション化されたUPA_PART表の名前をUPAに変更します。

SQL> RENAME UPA_PART to UPA;

11. 新規UPA表の制約を管理します。これを行うには、次のようにします。

1. 次に示すように、制約を古いUPA表から他の名前に変更します。

ALTER TABLE UPA_old RENAME CONSTRAINT PK_UPA TO PK_UPA_old;
ALTER INDEX IDX_UPA_EFF_FROM_DT RENAME TO IDX_UPA_EFF_FROM_DT_old;
ALTER INDEX IDX_UPA_EFF_TO_DT RENAME TO IDX_UPA_EFF_TO_DT_old;
ALTER INDEX IDX_UPA_USR_KEY RENAME TO IDX_UPA_USR_KEY_old;
ALTER INDEX PK_UPA RENAME TO PK_UPA_OLD;

2. 必要な索引および主キー制約を、新規にパーティション化されたUPA表に作成します。表領域やサイズなどの記憶域特性を必ず追加してください。これを行うには、次のSQL問合せを実行します。

SQL>create index IDX_UPA_EFF_FROM_DT on UPA (EFF_FROM_DATE) Local;
SQL>create index IDX_UPA_EFF_TO_DT on UPA (EFF_TO_DATE) Local;
SQL>create index IDX_UPA_USR_KEY on UPA (USR_KEY) Local;
SQL>ALTER TABLE UPA add constraint PK_UPA primary key (UPA_KEY) using index;

注意:

主キーをサポートするために、パーティション化されていないグローバル索引が作成されます。グローバル索引はパーティションに変更が加えられるたびに使用できなくなります。必要に応じて、索引を再構築する必要があります。

12. 次に示すように、UPA表の統計収集を実行します。

SQL>Exec dbms_stats.gather_table_stats(ownname => 'SCHEMA_NAME',tabname => 'UPA',cascade => TRUE,granularity => 'GLOBAL and PARTITION');

注意:

デフォルトでグローバル統計が収集されます。Oracle 11gにはパーティション化されたオブジェクトの統計収集に対する改善が組み込まれているため、変更されていないパーティションは再スキャンされません。これにより、一部のパーティションに静的データが含まれる大きな表で統計収集の速度が大幅に速くなります。表に新しいパーティションが追加された場合は、新しいパーティションの統計のみを収集する必要があります。グローバル統計は、既存のパーティション一覧を使用して新しいパーティション一覧を集計することにより、自動的に更新されます。

13. Oracle Identity Managerを起動します。データベースをトランザクションに対してオープンにすることができます。テストを行って、アプリケーションが期待どおりに実行されることを確認します。

14. 現在の年のデータをUPA_2011_PART1に追加してすべてのデータが含まれるようにし、現在の年の一貫性を維持します。これを行うには、次のSQL問合せを順番に実行します。

SQL> CREATE TABLE upa_non_part Tablespace TBS_NAME AS SELECT * FROM upa WHERE 1=2;

ここで、TBS_NAMEは、交換されるパーティションと同じ表領域名です。

SQL> Alter Table UPA_NON_PART add constraint PK_UPA_NON_PART primary key (UPA_KEY) using index;

.............
.............
SQL> Insert into upa_non_part select * from upa_old where eff_to_date >= to_date('01/01/2011', 'mm/dd/yyyy');

.............
.............
SQL> COMMIT;

.............
.............

SQL> ALTER TABLE upa_part exchange partition UPA_2011_PART1 WITH table upa_non_part WITH VALIDATION UPDATE GLOBAL INDEXES;

.............
.............
SQL> Drop table upa_non_part;

15. 必要に応じて、前年のデータを新規にパーティション化されたUPA表に追加します。これを行うには、次のようにします。

1. 次のSQL問合せを順番に実行します。

SQL> CREATE TABLE upa_non_part Tablespace TBS_NAME AS SELECT * FROM upa WHERE 1=2;

ここで、TBS_NAMEは、交換されるパーティションと同じ表領域です。

.............
.............
SQL> Alter Table UPA_NON_PART add constraint PK_UPA_NON_PART primary key (UPA_KEY) using index;
.............
.............
SQL> Insert into upa_non_part select * from upa_old where eff_to_date >= to_date('01/01/YEAR', 'mm/dd/yyyy') and eff_to_date < to_date('01/01/<YEAR+1>', 'mm/dd/yyyy');

ここで、YEARは、新規にパーティション化されたUPA表にデータを追加する年です。

.............
.............
SQL>COMMIT;

.............
.............
SQL> Alter table upa exchange partition UPA_<year> with table upa_non_part with validation Update global indexes;

2. 索引が使用できない場合は、再構築します。次のSQL問合せにより、使用できない索引が表示されます。

SQL> Select index_name, partition_name, tablespace_name, status from user_ind_partitions;

3. 次に示すように、upa_non_part表を削除します。

SQL> Drop table upa_non_part;

注意:

過去の各年に対してステップ15を繰り返します。

16. UPA表に対するすべてのパーティション操作が完了し、データがすべて追加されました。次に示すように、UPA表の統計収集を実行します。

SQL>Exec dbms_stats.gather_table_stats(ownname => '<Schem_name>',tabname => 'UPA',cascade => TRUE,granularity => 'GLOBAL and PARTITION');

17. UPA_OLD表が不要な場合は、削除します。削除する前に、この表のバックアップを作成できます。

23.4.4 UPA表のアーカイブまたはパージ

次の項では、UPA表のアーカイブおよびパージについて説明します。

- アーカイブまたはパージできないパーティション

- 進行中のパーティションのメンテナンス

- UPA表のパーティションのアーカイブまたはパージ

23.4.4.1 アーカイブまたはパージできないパーティション

Oracle Identity Managerには、常に現在の最新暦年の監査データが必要です。次に、最新暦年のパーティションの名前を示します。

- UPA_LATEST: 最新のパーティション

- UPA_2011_PART1およびUPA_2011_PART2: 現在の年のパーティション(現在の年が2011の場合)

これらの2つのパーティションは、Oracle Identity Managerが引き続き使用するためそのままにしておく必要があります。これらの2つのパーティションはアーカイブまたはパージしないでください。

23.4.4.2 進行中のパーティションのメンテナンス

新しい暦年になる前にUPA表に新規パーティションを追加する必要があります。これを行うには、次のSQLテンプレートを使用します。

SQL> Alter table UPA split partition UPA_LATEST at (TO_DATE('01/01/YEAR+1','DD/MM/YYYY')) into (partition UPA_YEAR tablespace UPA_YEAR,partition UPA_LATEST tablespace UPA_MAX) update global indexes;

ここで、TO_DATE関数のYEARは、新しい暦年プラス1を表します。パーティション名および表領域名のYEARは、次の新しい暦年を示します。

新しい暦年2012年の新規パーティションを追加するSQL文の例は、次のとおりです。

SQL> Alter table UPA split partition UPA_LATEST at (TO_DATE('01/01/2013','DD/MM/YYYY')) into (partition UPA_2012 tablespace UPA_2012,partition UPA_LATEST tablespace UPA_MAX) update global indexes;

新しい暦年になる前に所定のSQLテンプレートを使用して新規パーティションを追加することをお薦めします。ただし、次の暦年になる前に新規パーティションを追加しない場合、次の年の開始後に同じSQLコマンドを使用して新規パーティションを追加できます。

23.4.4.3 UPA表のパーティションのアーカイブまたはパージ

UPA表のパーティションをアーカイブまたはパージするには、次の手順を実行します。

1. Oracle Identity Managerのアテステーション機能を使用する場合は、アーカイブまたはパージするパーティションにアクティブなアテステーション・レコードがないことを確認します。これを確認するには、次のSQLを使用します。

SQL> SELECT COUNT(1) FROM UPA PARTITION(<PARTITION_TO_BE_DROPPED>) WHERE UPA_KEY IN (select distinct (upa_key) from apt apt, atr atr, atd atd where apt.atr_key=atr.atr_key and atr.atr_completion_time is NULL and apt.apt_key = atd.apt_key);

この問合せは、アクティブなアテステーション・レコードがないことを意味するゼロ・レコードを返す必要があります。ゼロ以外の値が返される場合は、削除対象のパーティションを指すアクティブなアテステーションがまだ存在していることを意味します。このことは一般的ではありませんが、過去の年のパーティションを削除する前に、アクティブなアテステーション・レコードがないことを確認する必要があります。

2. 削除対象のパーティションのデータを必要とするカスタム・レポートまたは問合せがないことを確認します。

3. 削除対象のパーティションをテープまたは他のメディアにアーカイブします。パーティションをアーカイブするには多くの方法があります。方法の1つは、データ・ポンプまたはエクスポート・ユーティリティを使用して、削除対象のパーティションをアーカイブすることです。使用中の環境で最も効果的な方法を選択します。

4. パーティションをパージします。これを行うには、次のようにします。

SQL> Alter table UPA drop partition PARTITION_NAME UPDATE GLOBAL INDEXES;
SQL>Drop tablespace TBS_NAME including contents and datafiles;

ここで、TBS_NAMEは削除対象のパーティションに関連付けられている表領域で、ここに他のデータが含まれていてはいけません。

注意:

- 現在の年には、UPA_2011_PART1およびUPA_2011_PART2という名前の2つのパーティションが含まれています。現在の年が過去の年になり、そのデータがアーカイブまたはパージできるようになったときは、これらの2つのパーティションをアーカイブまたはパージする必要があります。

- 必要に応じて、アーカイブされたデータを後でリストアしてください。

第V部

パフォーマンス・チューニングとベスト・プラクティス

この部では、Oracle Identity Managerの各種コンポーネントのパフォーマンス・チューニングについて説明します。

次の章で構成されています。

- 第24章「Oracleデータベースのチューニング」

- 第25章「アプリケーション・サーバーのパフォーマンスのチューニング」

- 第26章「アプリケーション・キャッシュのチューニングと管理」

24 Oracle Databaseのチューニング

エンタープライズ・クラスのどのようなビジネス・アプリケーションにおいても、すべてのシステムに通用するような単純なチューニング方法はありません。この項では、構成のサンプルを1つ示し、Oracle Databaseのチューニングに関する原則の概要を説明します。

Oracle Identity Managerには、多数の構成オプションがあります。ボトルネックを特定し、パフォーマンスを最適化する最善の方法は、本番環境のキーとなるデータベース・パフォーマンスを監視し、必要に応じて構成を調整していくことです。この章では、データベース構成の初期ベースラインを選択する際に役に立つガイドラインを示します。

この章の内容は、次のとおりです。

- Oracle Identity Managerデータベースに対するデータベース・ロール/権限の使用

- インスタンス構成パラメータのサンプル

- 物理データの配置

- データベース・パフォーマンスの監視

24.1 Oracle Identity Managerデータベースに対するデータベース・ロール/権限の使用

データベース管理者は、ロールを作成して、データベース・アプリケーションの実行に必要なすべての権限を保護アプリケーション・ロールに付与します。それから保護アプリケーション・ロールを他のロールやユーザーに付与できます。アプリケーションは複数の異なるロールを持つことができ、それぞれに異なる権限セットを付与して、ユーザーに応じてアプリケーションの使用時にアクセスできるデータを制限できます。たとえば、パスワード付きのロールを作成し、ロールに付与された権限が不正に使用されるのを防止できます。アプリケーションは起動時に適切なロールが使用可能になるように設計されます。そのため、アプリケーション・ユーザーはアプリケーション・ロールのパスワードを知る必要はありません。

次に示すように、付与または取消しされるものに応じて、付与または取消しが有効になるタイミングは異なります。

- ユーザー、ロールおよびPUBLIC権限へのシステムおよびオブジェクト権限の付与および取消しはすべて、即座に有効になります。

- ユーザー、その他のロールおよびPUBLICへのロールの付与および取消しはすべて、現在のユーザー・セッションが、付与および取消し後にロールを再度有効にするためにSET ROLE文を発行した場合のみ有効になります。

SESSION_ROLESデータ・ディクショナリ・ビューを調べると、どのロールが現在有効であるかを確認できます。

Oracle Identity Managerでは、Oracle Identity Managerスキーマに前提条件となる権限が付与されており、Oracle Identity Managerをインストールする前に必要なオブジェクトを作成できるようにしています。これらの権限の一部は、Oracle Identity Managerのインストール後に取り消して、アプリケーションの要件に応じて後で特定のユーザーに付与できます。

表24-1に、データベース・アプリケーションに必要な権限を示します。

表24-1 データベース・アプリケーションに対するロール付与

ロール名

説明

Oracle Identity Managerに固有の使用方法

取り消された場合

CREATE TABLE

自分のスキーマ内での表の作成、変更および削除を可能にします。

これはリソースの権限付与の一部ですが、リソースの権限付与ではプロシージャを使用して表を作成できないため、これが明示的に必要になります。

ユーザーはプログラムで新しい表を作成できません。

この権限は、Oracle Identity Managerデプロイメントが安定したとき、つまりすべてのコンポーネントおよびコネクタがインポートされ、期待どおりに動作するようになったときに取り消すことができます。これは、各コネクタでその独自のスキーマ・オブジェクトが作成されるためです。アーカイブ・ユーティリティはプログラムで表を作成するため、アーカイブ・ユーティリティの初期実行にこの権限が必要になります。

CONNECT

セッションの作成権限を付与します。

ユーザーに対するセッションの作成

これはインストール後にCREATE SESSIONと置換できます。Oracle Identity Managerデプロイメントが安定したとき、つまりすべてのコンポーネントおよびコネクタがインポートされ、期待どおりに動作するようになったときに置換できます。これは、各コネクタでその独自のスキーマ・オブジェクトが作成されるためです。

RESOURCE

そのユーザーに関連付けられたスキーマで特定タイプのスキーマ・オブジェクトの作成、変更および削除を可能にします。このロールは開発者やスキーマ・オブジェクトの作成が必要なその他のユーザーにのみ付与されます。このロールにより、オブジェクト・システムの作成権限のサブセットが付与されます。たとえば、CREATE TABLEシステム権限は付与されますが、CREATE VIEWシステム権限は付与されません。これにより次の権限が付与されます。

- CREATE CLUSTER

- CREATE INDEXTYPE

- CREATE OPERATOR

- CREATE PROCEDURE

- CREATE SEQUENCE

- CREATE TABLE

- CREATE TRIGGER

- CREATE TYPE

さらに、このロールによりUNLIMITED TABLESPACEシステム権限が付与され、ユーザーがスキーマ・オブジェクトを作成するすべての表領域でUNLIMITEDの領域使用量割当てが効果的に割り当てられます。

シーケンス、インデックス、プロシージャ、トリガーおよびパッケージの作成

ユーザーはデータベース・オブジェクトを作成できません。SYSユーザーのみ、これを行うことができます。この権限は、Oracle Identity Managerデプロイメントが安定したとき、つまりすべてのコンポーネントおよびコネクタがインポートされ、期待どおりに動作するようになったときに取り消すことができます。これは、各コネクタでその独自のスキーマ・オブジェクトが作成されるためです。表領域割当てを正しく指定してください。

CREATE VIEW

ユーザーのスキーマでのビューの作成、変更および削除を可能にします。

Oracle Identity ManagerでのSDP_VISIBLE_V、SDP_REQUIRED_V、SDP_LOOKUPCODE_VおよびSDP_RECURSIVE_Vビューの作成

ユーザーはビューを作成できません。SYSユーザーのみ、これを行うことができます。

DBMS_SHARED_POOL

データベース・オブジェクトを共有プール・メモリーに合わせます。

Oracle Identity Managerで使用されるすべてのプロシージャと機能を共有メモリーで固定するために使用

これはインストール後に取り消せますが、プロシージャや機能によっては明示的に固定されない場合があるため、パフォーマンスに影響を与えることがあります。pin_objプロシージャはOracle Identity Managerに対してのみ作成されます。これはデータベース・オブジェクトを共有メモリーに明示的に固定するために使用されます。このロールを取り消す前に、データベースレベルのトリガーcache_seqが削除されている(作成済の場合)ことを確認してください。

SYS.DBMS_SYSTEM

XAリソース・マネージャを有効にして権限を設定し、XAリソース・マネージャがOracle databaseとアプリケーション間の相互作用を管理できるようにします。

注意: 各データベース接続は、トランザクション・リソースとしてトランザクション・マネージャとともに追加されます。トランザクション・マネージャは、グローバル・トランザクションに属する各接続に対してXAリソースを取得します。トランザクション・マネージャは開始メソッドを使用してグローバル・トランザクションとリソースを関連付け、終了メソッドを使用してトランザクションとリソースの関連付けを解除します。リソース・マネージャは、開始メソッドの起動と終了メソッドの起動との間に、グローバル・トランザクションをそのデータで実行されるすべての作業に関連付けます。

XAリソースおよびデータベース・トランザクション用

Oracle Databaseバージョン10.2.0.4以降では、これは安全に削除できます。DIST_TXN_SYNCプロシージャを、一般に公開されているDBMS_XAと呼ばれる新しいパッケージに移動することで、これのかわりとなります。そのため、新しいバージョンのOracleではXAクライアントはDBMS_SYSTEMで権限を実行する必要はありません。

SYS.DBMS_FLASHBACK

セルフサービス・リペアを有効にします。表から行を間違って削除した場合、削除された行を元に戻すことができます。

リコンシリエーション中の失敗に対して、これを使用して変更をロール・バックできます。

これは、Oracle Identity Manager 11g リリース 1 (11.1.1)の新しいリコンシリエーション・エンジンでのエラー処理に必要です。

CREATE_MATERIALIZED_VIEW

権限受領者のスキーマでマテリアライズド・ビューを作成します。

OIM_RECON_CHANGES_BY_RES_MVマテリアライズド・ビューの作成

ユーザーはマテリアライズド・ビューを作成できません。SYSユーザーのみ、これを行うことができます。このマテリアライズド・ビューは、レポート目的でのみ必要です。

SELECT ON V$XATRANS

SELECT ON PENDING_TRANS$

SELECT ON DBA_2PC_PENDING

SELECT ON DBA_PENDING_TRANSACTIONS

XAリソース・マネージャを有効にして権限を設定し、XAリソース・マネージャがOracle databaseとアプリケーション間の相互作用を管理できるようにします。

該当なし

削除はお薦めしません。XAのサポートに必要です。

ADMINISTER DATABASE TRIGGER

データベースレベルのトリガーの作成を可能にします。

Oracle Identity Managerでのddl_triggerという名前のDDLトリガーの作成

ユーザーは新しいDDLトリガーを作成できません。これはスキーマ作成後に削除できます。

24.2 インスタンス構成パラメータのサンプル

表24-2に、Oracle 11g Databaseのパフォーマンスに関連するいくつかの重要なデータベース初期化パラメータを示します。

SGA、PGAサイズは、一部のプラットフォームでは、基礎となるオペレーティング・システムの使用可能な最大メモリーの制限によって制限されます。サポート・ノート: Oracle Databaseサーバーとオペレーティング・システムのメモリー制限[ID 269495.1]を参照してください。

注意:

表24-2に示すデータベース・インスタンス・パラメータに対しては、Oracle Databaseのリリースに基づいて、次のいずれかのメモリー管理アプローチを使用できます。

- Oracle Database 11gで使用できる自動メモリー管理機能を使用し、MEMORY_TARGETおよびMEMORY_MAX_TARGETパラメータを使用してSGAとPGAを一緒に管理できます。

- Oracle Database 10g以降で使用できる自動共有メモリー管理(ASMM)を使用し、SGA_TARGETおよびSGA_MAX_SIZEパラメータを指定してSGAコンポーネントを管理できます。PGAは、PGA_AGGREGATE_TARGETを通じて個別に管理されます。

次の接続プール要件および外部プログラムに対する追加接続に対応するように、プロセス・パラメータを設定する必要があります。

- アプリケーション・サーバーで構成されたXAデータソースの接続プール・サイズ

- アプリケーション・サーバーで構成された非XAデータソースの接続プール・サイズ

- xlconfig.xmlで構成されたダイレクト・データベース接続プール・サイズ

表24-2 構成パラメータのサンプル

パラメータ

Oracle Database 11gの推奨初期設定

db_block_size

8192

memory_target

Oracle Database 11gの自動メモリー管理機能を使用して、MEMORY_TARGETおよびMEMORY_MAX_TARGETパラメータでSGAとPGAを一緒に管理できます。

推奨値は3GBです。

MEMORY_TARGETをデータベース・メモリー・コンポーネントの管理用にする場合は、SGA_TARGETとPGA_AGGREGATE_TARGETは割り当てないでおく(0にする)ことができます。

db_keep_cache_size

800M

log_buffer

15 MB

cursor_sharing

FORCE

open_cursors

500

session_cached_cursors

500

query_rewrite_integrity

TRUSTED

query_rewrite_enabled

TRUE

db_file_multiblock_read_count

16

db_writer_processes

2

processes

接続プール設定に基づく

24.3 物理データの配置

Oracle Identity Managerの基本インストールでは、データベース・オブジェクトを格納するために2つの物理表領域(編成関連のLOBデータのための表領域oim_lobおよびその他すべてのための表領域oim)が使用されます。Oracle Identity Managerのデータベース・オブジェクトは、次のカテゴリのいずれかに属します。

- 物理表

- 索引

- ラージ・オブジェクト(LOBまたはCLOB)

ヒント:

使用ディスク領域を最小限にするために、次のようにすることをお薦めします。

デプロイメントの最初の起動フェーズでは、Oracle Identity Managerの表領域は、Oracle Identity Managerにリコンサイルされる10万ユーザーごとに20Gの割合で増加すると予測されます。同じユーザーに対して、LOB表領域はOracle Identity Managerの主要な表領域のサイズの約30%増加します。Oracle Identity Managerでの編成の使用はLOB表領域の増加に影響するため、広範囲に編成が使用されるというシナリオでは、これに応じて、LOB表領域は主要な表領域の60% - 100%の割合で増加する可能性があります。

ディスク領域を効率的に管理するために、データベース管理者は、実際のシステムで正確な増加率をモニタリングする必要があります。

パフォーマンスを向上させるため、ローカルで管理する複数の表領域を作成し、各カテゴリのデータベース・オブジェクトを専用の表領域に格納してください。ストレージを最適化することは、効率的なデータ・アクセスに役立ちます。次の項では、頻繁にアクセスが行われ増大する可能性がある表について説明します。これらの表を独自の専用表領域に配置することをお薦めします。

一般的なOracle Identity Managerデプロイメントでは、通常、次の項で説明されている表は増大し、頻繁にアクセスが行われます。また、パフォーマンス・メトリックを使用して、頻繁にアクセスする表(ホット表)を特定できます。I/O競合を削減するため、ホット表を専用の表領域に移動します。パフォーマンス・メトリックの詳細は、「データベース・パフォーマンスの監視」を参照してください。

注意:

Oracle Identity Managerでは、これらの表のほとんどでデータ増大を収容できるようにするためのアーカイブおよびパージのソリューションが提供されています。詳細は、第23章「アーカイブ・ユーティリティの使用」を参照してください。

24.3.1 タスクの表

Oracle Identity Managerでは、プロビジョニングおよび承認タスクの詳細が次の表に格納されます。これらは、時間の経過とともに増大する可能性が高い表です。これらを1つ以上の専用表領域にグループ化することをお薦めします。

- OSI

- OSH

- SCH

24.3.2 リコンシリエーション表

Oracle Identity Managerのリコンシリエーション・スキーマには、静的表と動的表の両方があります。静的表のリストを次に示します。動的表は、RECON_TABLES表のRECON_TABLE_NAME列を問い合せることで識別できます。

- RECON_ACCOUNT_OLDSTATE

- RECON_BATCHES

- RECON_CHILD_MATCH

- RECON_EVENTS

- RECON_EVENT_ASSIGNMENT

- RECON_EXCEPTIONS

- RECON_HISTORY

- RECON_JOBS

- RECON_TABLES

- RECON_UGP_OLDSTATE

- RECON_USER_OLDSTATE

- RECON_ACCOUNT_MATCH

- RECON_ORG_MATCH

- RECON_ROLE_HIERARCHY_MATCH

- RECON_ROLE_MATCH

- RECON_ROLE_MEMBER_MATCH

- RECON_USER_MATCH

- RA_LDAPUSER

- RA_MLS_LDAPUSER

- RA_LDAPROLE

- RA_MLS_LDAPROLE

- RA_LDAPROLEMEMBERSHIP

- RA_LDAPROLEHIERARCHY

使用する環境で大量のリコンシリエーション・データが生成される場合は、これらの表を1つ以上の専用表領域に移動してください。

24.3.3 監査表

Oracle Identity Managerでは、監査レベル設定に基づいてトランザクションが監査されます。ほとんどの監査レベルで、データが大幅に増大する可能性があります。監査表を独自の表領域に格納することをお薦めします。Oracle Identity Managerの監査表には、2つのカテゴリがあります。XML形式で監査データを格納する表を次に示します。このリストで、特にUPA表が増大することが予想されるため、これを専用の表領域に配置することが重要です。

- UPA

- GPA

ユーザー・プロファイル監査データは、次のフラット構造の表に格納されます。これらの表は、コンプライアンス・レポート作成のために、Oracle Identity Manager履歴レポートで使用されます。これらの表およびその索引を、専用の表領域に格納することをお薦めします。

- UPA_FIELDS

- UPA_GRP_MEMBERSHIP

- UPA_RESOURCE

- UPA_USR

- UPA_UD_FORMS

- UPA_UD_FORMFIELDS

24.3.4 REDOログ・ファイル

Oracle Identity Managerで構成されたリコンシリエーション・プロセスによっては、リコンシリエーション実行中のデータベース・トランザクションおよびコミットの量が多くなる場合があります。複数のREDOログ・ファイルを使用することをお薦めします。REOログ・ファイルに割り当てる総領域は、1 - 2GBにする必要があります。

それぞれの最小サイズが500MBの、REDOログ・メンバーを持つ3つ以上のREDOログ・グループを使用することをお薦めします。メンバーの多重化と正確な数および各メンバーのディスク領域は、障害に対する計画に従って検討できます。

24.3.5 プール保存の変更

Oracle Identity Managerのデフォルトでは、頻繁に参照される小さい表は、プール保存バッファを使用してデータベースにキャッシュされるように割り当てられます。表24-2のdb_keep_cache_sizeを参照してください。ユーザー・レコードを格納するUSR表も、デフォルトでキャッシュされます。インストール環境に含まれるユーザーが50,000より多い場合、USR表には、プール保存バッファではなくデフォルトのバッファを使用することをお薦めします。次のコマンドを使用して、USR表をデフォルトのバッファ・プールに配置できます。

ALTER TABLE USR STORAGE(buffer_pool default);

24.4 データベース・パフォーマンスの監視

Oracle Identity Managerデータベースのリアルタイム・パフォーマンス・メトリックを監視すると、パフォーマンス・ボトルネックを特定できます。

次のことを定期的に実行してください。

- Oracle Database 11gのOracle Enterprise Manager Fusion Middleware Controlや自動ワークロード・リポジトリ(AWR)などのパフォーマンス監視ツールを使用して、リアルタイムのパフォーマンスを監視します。

注意:

Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle Identity Managerを監視できます。これを行うには、次のようにします。

1. Identity Managementで、Oracle Identity Managerを選択して「ホーム」ページに進みます。「ホーム」ページで、Oracle Identity Managerを監視できます。

2. 「Oracle Identity Manager」メニューからパフォーマンスを選択して、パフォーマンス・メトリックを表示します。

- Oracle Database Enterprise Manager (EM)を使用してルーチン統計とレポートを収集します。これはOracle Database 11g(標準機能)で使用可能です。

- ルーチン統計の収集
ルーチン統計の収集は、自動メンテナンス・タスクによって行われます。これはOracle Database 11gの次のナビゲーション・パスで使用できます。

Oracle EM→「サーバー」タブ→「問合せオプティマイザ」→オプティマイザ統計の管理→自動メンテナンス・タスク・リンク

- Oracle Database 11g EMによる統計のレポート要件
現在収集されている統計の状態をレポートするために、EMには次のナビゲーション・パスにレポート・インタフェースが用意されています。

Oracle EM→「サーバー」タブ→「問合せオプティマイザ」→オプティマイザ統計の管理→「オブジェクト統計」リンク

このインタフェースを使用して、失効、欠落またはロック状態のオブジェクトやすでに分析済のオブジェクトまで、すべてのオブジェクトをレポートできます(スキーマのオブジェクトや選択肢のオブジェクトも含みます)。

- 完全なスキーマ統計をOracle Identity Manager実装で収集します。
スキーマ統計を定期的に更新すると、コストベース・オプティマイザ(CBO)で最新の統計にアクセスできます。ユーザーやアカウントの一括ロード、新規コネクタのインポート、新規ターゲットからの大規模なリコンシリエーションの実行、アーカイブ・リコンシリエーションやアーカイブ・ユーティリティの使用などの大量なデータ変更イベントでは、完全なスキーマまたは表統計を考慮してください。

これによりCBOは、データの現行の状態に基づく効果的な問合せ実行計画を決定できます。次に、定期的にデータベース統計を収集するSQLコマンドのサンプルを示します。

関連項目:

ルーチン統計の収集とレポートは、Oracle Database 11gで使用可能な自動メンテナンス・タスクによって実行できます。詳細は、『Oracle Database パフォーマンス・チューニング・ガイド』を参照してください。

DBMS_STATS.GATHER_SCHEMA_STATS(OWNNAME=> schema_owner,
ESTIMATE_PERCENT=>DBMS_STATS.AUTO_SAMPLE_SIZE,
DEGREE=>8,
OPTIONS=>'GATHER AUTO',
NO_INVALIDATE=>FALSE);

- 「自動データベース診断モニター(ADDM)」や「自動ワークロード・リポジトリ」レポートのアドバイザ・セクションにある関連推奨事項を参照し、推奨された設定に従ってインスタンス構成パラメータを調整します。これは特に、新しいコネクタをインポートして、新しいターゲット・システムからの一連のリコンシリエーションを完了した後で、一致ルールに応じた新しい索引の必要性を識別するために必要になります。

25 アプリケーション・サーバーのパフォーマンスのチューニング

この章では、Oracle Identity Manager用のOracle WebLogic Serverをチューニングしてパフォーマンスを向上させる方法について説明します。次の項で構成されています。

注意:

- この項では、すべてのチューニング・パラメータの推奨および値を参考のみの目的で示しています。必要性、アプリケーションの使用パターン、負荷およびハードウェア仕様に基づいて、値を変更してください。

- いずれかの設定を変更した場合、サーバーを再起動する必要があります。

- JVMメモリー設定

- JDBC接続プール

- メッセージ・ドリブンBeanの数

- ユーザー・インタフェース・スレッド

- アダプタおよびプラグイン構成の再ロードの無効化

- UNIX用のオープン・ファイル記述子数の変更(オプション)

- Solaris Sparc T3またはT4に対するJVMガベージ・コレクションのチューニング

関連項目:

Oracle Application Serverのチューニングの詳細は、『Oracle® WebLogic Serverパフォーマンスおよびチューニング』ドキュメントを参照してください。

25.1 JVMメモリー設定

JVMメモリー設定を変更するには:

1. DOMAIN_HOME/bin/setSOADomainEnv.shまたはsetSOADomainEnv.cmdファイルを開きます。

2. DEFAULT_MEM_ARGSおよびPORT_MEM_ARGSの値をデフォルト値から変更します。

3. setSOADomainEnv.shまたはsetSOADomainEnv.cmdファイルを保存します。

注意:

StringIndexOutOfBoundsExceptionエラーを回避するために、次のオプションを追加します。

-XX:-UseSSE42Intrinsics

このパラメータは、Sun JDKの場合のみ必要です。

25.2 JDBC接続プール

Oracle Identity Managerは、Oracle WebLogic ServerにデプロイされたoimOperationsDBおよびoimJMSStoreDSデータソースを使用します。最大接続は、デフォルトで50に設定されています。この値を必要に応じて増やす必要があります。JDBC接続プールの容量を増やすには、次の手順を実行します。

1. WebLogic Server管理コンソールを開きます。

2. JDBCデータソースxlXADSの場合:

1. 「サービス」→「JDBC」→「データ・ソース」→「oimOperationsDB」の順にクリックし、「接続プール」タブをクリックします。

2. 必要に応じて、初期容量と最大容量を調整します。

JDBCデータソースxlDSの場合:

1. 「サービス」→「JDBC」→「データ・ソース」→「oimJMSStoreDS」の順にクリックし、「接続プール」タブをクリックします。

2. 必要に応じて、初期容量と最大容量を調整します。

3. 変更を保存し、有効にします。

注意:

アプリケーション・サーバーの接続プールでの接続数の増加は、データベース構成の変更による補正が必要です。Oracle DatabaseのMAX SESSIONS設定を増やす必要がある場合があります。

25.3 メッセージドリブンBeanの数

Oracle Identity Managerでは、メッセージドリブンBean (MDB)を使用して、リコンシリエーション、監査、リクエストおよびアテステーションなどのすべてのオフライン・アクティビティの処理や、内部カーネル操作を行います。デフォルトでは、合計80 MDBインスタンスがリクエストを同時に処理します。ただし、これは、要件に基づいて、OIMMDBWorkManager構成を変更することで増加できます。これを行うには、次のようにします。

1. WebLogic管理コンソールにログインします。

2. 「環境」→「ワーク・マネージャ」→「MaxThreadsConstraint-1」に移動します。

3. 必要に応じてカウントを80からより大きい値に変更します。

25.4 ユーザー・インタフェース・スレッド

Oracle Identity Managerは、デフォルトでは20のフロントエンド・スレッド構成を提供します。これらのスレッドは、フロントエンド・リクエストを処理するために使用されます。フロントエンド・スレッド構成の数を変更するには、次のようにします。

1. WebLogic管理コンソールにログインします。

2. 「環境」→「ワーク・マネージャ」→「MaxThreadsConstraint-0」に移動します。

3. カウントの数を20から必要な数に変更します。

25.5 アダプタとプラグイン構成の再ロードの無効化

デフォルトでは、アダプタとログイン構成の再ロードは、開発を容易にするために有効化されています。これらは本番環境では無効化する必要があります。これを行うには、次のようにします。

1. 「構成ファイルのエクスポートとインポート」の説明に従って、MDSから/db/oim-config.xmlファイルをエクスポートします。

2. oim-config.xmlファイルで、次のコードを置換します。

<ADPClassLoaderConfig adapterReloadingEnabled="true" loadingStyle="ParentFirst" reloadInterval="15" reloadingEnabled="true">

置換後:

<ADPClassLoaderConfig adapterReloadingEnabled="false" loadingStyle="ParentFirst" reloadInterval="15" reloadingEnabled="false">

3. 次のコードを置換します。

<storeConfig reloadingEnabled="true" reloadingInterval="20"/>

置換後:

<storeConfig reloadingEnabled="false" reloadingInterval="20"/>

4. oim-config.xmlファイルを保存して、MDSにインポートして戻します。

25.6 UNIX用のオープン・ファイル記述子数の変更(オプション)

WebLogicでは、WEBLOGIC_HOME/common/bin/commEnv.shスクリプトでオープン・ファイル記述子の数が1024に制限されています。WebLogicでは同時ユーザー数が非常に多い場合は、「TOO MANY OPEN FILES」例外がスローされることがあります。このエラーが発生した場合は、スクリプトのこの制限値を1024より大きい数値に変更します。オペレーティング・システムが増加したオープン・ファイル数を処理できることを確認してください。

25.7 Solaris Sparc T3またはT4に対するJVMガベージ・コレクションのチューニング

Solaris Sparc T3またはT4でJVMガベージ・コレクションをチューニングするには、次の手順を実行します。

1. テキスト・エディタで、DOMAIN_HOME/bin/ディレクトリにあるsetSOADomainEnv.shまたはsetSOADomainEnv.cmdファイルを開きます。

2. USER_MEM_ARGSの値を次のように設定します。

注意:

USER_MEM_ARGSの値は例として示しています。この値は必要に応じて変更できます。

USER_MEM_ARGS="-Xms3048m -Xmx3048m -Xmn1648m -Xss256k -XX:PermSize=384m -XX:MaxPermSize=384m"

3. JAVA_OPTIONSの値を次のように設定します。

注意:

JAVA_OPTIONSの値は例として示しています。この値は必要に応じて変更できます。

JAVA_OPTIONS="-Xnoclassgc -XX:SurvivorRatio=8 -XX:TargetSurvivorRatio=90
-XX:PermSize=350m -XX:MaxPermSize=350m -XX:+AggressiveOpts
-XX:+UseParallelOldGC -XX:ParallelGCThreads=8 -XX:+PrintGCDetails
-XX:+PrintGCTimeStamps -XX:+PrintGCDateStamps  -XX:ReservedCodeCacheSize=64m
-XX:CICompilerCount=8 -XX:+AlwaysPreTouch -XX:+PrintReferenceGC
-XX:+ParallelRefProcEnabled -XX:-UseAdaptiveSizePolicy
-XX:+PrintAdaptiveSizePolicy -XX:+DisableExplicitGC"

4. ファイルを保存して閉じます。

26 アプリケーション・キャッシュのチューニングと管理

この章では、キャッシングとその管理方法について説明します。次の項で構成されています。

- キャッシングの概要

- Oracle Identity Managerキャッシュのチューニング

- キャッシュのパージ

26.1 キャッシングの概要

Oracle Identity Managerではメタデータのキャッシングが可能で、これによってDBアクティビティを減らすことができます。結果としてネットワーク負荷が軽減され、パフォーマンスが向上します。

開発環境でアプリケーション・サーバーを再起動しなくても構成の変更がすぐに反映されるように、デフォルトでは大多数の構成のキャッシングは無効です(falseに設定されています)。

26.2 Oracle Identity Managerキャッシュのチューニング

キャッシングは、MDSに置かれた構成ファイル/db/oim-config.xmlで構成されます。このファイルの変更方法については、第18章「Enterprise Managerを使用したOracle Identity Manager構成の管理」を参照してください。

本番環境でより高い最適なパフォーマンスが得られるように、次の設定をお薦めします。

- 次の2つのセクションを除くすべてのコンポーネントのキャッシングをtrueに設定します。
threadLocalCacheEnabled="false"

"StoredProcAPI" enabled="false"

- クラスタ化されていないインストールにはclustered="false"を設定し、クラスタ化されているインストールにはclustered="true"を設定します。

例26-1に、本番システム用のすべてのキャッシングを有効にした/db/oim-config.xmlファイルからのスニペットを示します。

例26-1 クラスタ化された本番環境のoim-config.xmlに推奨されるキャッシュ値

<cacheConfig clustered="true" enabled="true" expirationTime="144000"
provider="oracle.iam.platform.utils.cache.OSCacheProvider" threadLocalCacheEnabled="false">
<cacheCategoriesConfig>
<cacheCategoryConfig name="DataObjectEventHandlers" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ProcessDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="EmailDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="RuleDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="FormDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ColumnMap" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="UserDefinedColumns" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ObjectDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="StoredProcAPI" enabled="false" expirationTime="600"/>
<cacheCategoryConfig name="NoNeedToFlush" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="MetaData" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="User" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="AdapterInformation" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="OrgnizationName" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="Reconciliation" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="SystemProperties" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="LookupDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="UserGroups" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="LookupValues" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ITResourceKey" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="RecordExists" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ServerProperties" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="ColumnMetaData" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="API" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="CustomResourceBundle" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="CustomDefaultBundle" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="ConnectorResourceBundle" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="LinguisticSort" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="GenericConnector" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="GenericConnectorProviders" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="AccessPolicyDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="UserConfig" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="OESDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="RoleContainerToDescrMap" enabled="true" expirationTime="-1"/>
<cacheCategoryConfig name="PluginFramework" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="CallbackConfiguration" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="SchedulerTaskDefinition" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="UserStatus" enabled="true" expirationTime="14400"/>
<cacheCategoryConfig name="LocaleCodeLanguageMapping" enabled="true" expirationTime="14400"/>
</cacheCategoriesConfig>

26.3 キャッシュのパージ

キャッシュをパージするには、OIM_HOME/server/bin/ディレクトリでPurgeCacheユーティリティを使用します。このユーティリティはキャッシュ内のすべての要素をパージします。

注意:

- キャッシュのパージは、キャッシングが有効でシステム構成を変更した場合に行う必要があります。キャッシングが無効な場合には不要です。

- PurgeCacheユーティリティを実行する前に、OIM_HOME/server/bin/ディレクトリに移動します。

PurgeCacheユーティリティを実行する前に、DOMAIN_HOME/bin/setDomainEnv.shスクリプトを実行する必要があります。

PurgeCacheユーティリティを使用するには、Microsoft WindowsではPurgeCache.bat CATEGORY_NAME、UNIXではPurgeCache.sh CATEGORY_NAMEを実行します。CATEGORY_NAME引数は、パージする必要があるカテゴリの名前を表しています。たとえば、次のコマンドはすべてのFormDefinitionエントリをシステムとそのクラスタからパージします。

PurgeCache.bat FormDefinition
PurgeCache.sh FormDefinition

すべてのOracle Identity Managerカテゴリをパージするには、PurgeCacheユーティリティにAllの値を渡します。カテゴリはすべて消去することをお薦めします。

注意:

適切に実行するには、wlfullclient.jarファイルをPurgeCacheユーティリティのクラスパスに置く必要があります。

27 デプロイメントの保護

Oracle Identity Managerデプロイメントの保護は、認可と強化を利用して行います。認可は、様々なコンポーネントへのアクセスを制御します。強化は、潜在的なセキュリティ上の脅威からコンポーネントを保護します。

表27-1に、Oracle Identity Managerデプロイメントの保護に関する情報を参照できる様々なトピックを示します。

表27-1 デプロイメントの保護

トピック

トピックのタイプ

記載されている情報

「スケジュール済タスクの管理」

強化

スケジュール済タスクとスケジュール済ジョブ。必要なスケジュール済タスクのみが有効化されていることを確認してください。

「Oracle Identity Managerのシステム・プロパティ」

強化

システム動作に関連するシステム・プロパティ。パスワード・ポリシーおよびチャレンジ質問と回答が定義されていることを確認してください。

「コネクタのインストールのためのユーザー・アカウントの作成」

強化

コネクタをインストールするための固有の権限。

「セキュアなCookieの有効化」

強化

Oracle Identity ManagerのSSL経由での動作の有効化。

「Identity Virtualization Library(libOVD)とディレクトリ・サーバーの間でのSSLの有効化」

強化

Microsoft Active Directory、iPanet Directory ServerおよびOracle Internet Directory for Identity Virtualization Library(libOVD)固有の指示。

「LDAP同期が有効な場合のLDAP認証の構成」

強化

LDAP認証の有効化。

「Oracle Identity Managerに関連するURL変更」

強化

統合された依存アプリケーションでの変更に対応して、Oracle Identity ManagerおよびOracle WebLogicで構成変更を行う手順。

「Oracle Identity Managerに関連するパスワード変更」

強化

依存製品または統合された製品でパスワードが変更された場合に、Oracle Identity MangerおよびOracle WebLogic構成のパスワードを変更する手順。

「Oracle Identity ManagerのSSLの構成」

強化

SSLの構成によるOracle Identity Managerの保護。

「パスワード・ポリシーの管理」

強化

パスワード・ポリシーの構成。

「信頼関係の追加」

強化

リモート・マネージャSSLの構成。

「独自の証明書を使用したリモート・マネージャの構成」

強化

デフォルトのOracle Identity Manager証明書のかわりに独自の証明書を使用したリモート・マネージャ構成。

「OES統合」

認可

リコンシリエーション・イベントのアクセス。

「ロールの権限のチェック」

認可

ロールのインポートおよびエクスポートの際のロールの権限。データ・オブジェクトが欠落している場合は、データ・オブジェクト権限を設定する際のエラーを確認してください。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのユーザー管理の認可に関する説明

認可

ユーザー管理操作の認可。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのロール・メンバーシップの継承に関する説明

認可

メンバーシップによるロールの継承。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのロール権限の継承に関する説明

認可

権限によるロールの継承。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのデフォルト・ロールに関する説明

認可

Oracle Identity Manager内の事前定義済ロール。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのデータ・オブジェクト権限の更新に関する説明

認可

ロール・レベルでのデータ・オブジェクト権限。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドのロールの認可の管理に関する説明

認可

ロール管理操作の認可。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの管理ロールの管理に関する説明

認可

組織管理ロール。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの許可されたリソースの管理に関する説明

認可

選択した組織のユーザーに対する、許可されたリソースの割当てと更新の手順。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの組織管理の認可に関する説明

認可

組織管理操作の認可。

Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイドの認可ポリシーの管理に関する説明

認可

認可ポリシーを使用した、Oracle Identity Managerデプロイメントの保護。

関連項目:

Oracle Identity Managementソフトウェアの統合および関連セキュリティの詳細は、『Oracle Fusion Middleware Oracle Identity Managementインストレーション・ガイド』および『Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド』を参照してください。

索引

A  B  C  D  E  H  I  J  L  M  N  O  P  R  S  T  U  V  W

A

アクティブ・リコンシリエーション表, 23.1.1

アクティブ・タスク表, 23.2.1

アダプタ

コンパイル, 5.5.10

非定型リンク, 1.2.6.1 拡張検索

ジョブ, 2.4.2.2

通知テンプレート, 3.3

システム・プロパティ, 4.2.3.2

アプリケーション・サーバーのパフォーマンス

JDBC接続プール, 25.2

JVMメモリー設定, 25.1

MDB, 25.3

オープン・ファイル記述子, 25.6

アダプタの再ロード, 25.5

チューニング, 25

ユーザー・インタフェース・スレッド, 25.4

アーキテクチャ

構成管理, 13.6

アーカイブ・ユーティリティ, 23

リコンシリエーション・アーカイブ・ユーティリティ, 23.1

リクエスト・アーカイブ・ユーティリティ, 23.3

タスク・アーカイブ・ユーティリティ, 23.2

アーカイブ・リコンシリエーション表, 23.1.1 アーカイブ・タスク表, 23.2.1 非同期実行

非同期ルーティングと構成, 16.2

非同期サービス, 16.2

属性プロパティ, 13.1.2.1 非同期実行

非同期サービス, 16.1

構成パラメータ, 16.2.1

管理, 16

B

バッチサイズ・パラメータ, 1.1.1.2

BI Publisher, 11.7

バルク・リコンシリエーション, 1.1.1.5

C

キャッシュ構成

パージ, 26.3

カテゴリ構成, 13.1.5

作成

カテゴリ, 13.1.5.1

削除

カテゴリ, 13.1.5.3

属性の順序付けの指定, 13.1.5.4 リコンシリエーション・イベントのクローズ, 1.2.5 複雑なパスワード, 14.1.1 構成管理

アーキテクチャ, 13.6

構成

LDAP認証, 10.6

ログ・ハンドラ, 8.1.3

ロガー, 8.1.4

ノード・マネージャ, 7.1

ユーザー属性, 13

認可, 13.3

エンティティ構成操作, 13.1

検索構成操作, 13.2

ユーザー属性の構成

認可ポリシー, 13.3

プロキシ用の通知の構成, 3.7 作成

通知テンプレート, 3.2

パスワード・ポリシー, 14.1

リコンシリエーション・プロファイル, 1.3.1

スケジュール済ジョブ, 2.4.1

システム・プロパティ, 4.2.1

ユーザー属性, 13.1.2

作成

カスタムのスケジュール済タスク, 2.3.3

カスタム・ポリシー, 14.1.1 カスタムのスケジュール済タスク, 2.3.3

D

データベース・バックアップ, 5.5.13

デフォルト通知テンプレート, 3

デフォルト・システム・プロパティ, 4.1

イベント・メタデータの定義, 3.1

定義データ, 5.5.3

削除

ジョブ, 2.4.7

通知テンプレート, 3.5

システム・プロパティ, 4.2.5

ユーザー属性, 13.1.4

デプロイメント・マネージャ, 5

ベスト・プラクティス, 5.5

デプロイメントのエクスポート, 5.2

システム・オブジェクトのエクスポート, 5.5.1

機能, 5.1

デプロイメントのインポート, 5.3

制限 5.1

Design Console

管理フォルダ, 14

グループ・エンタイトルメント・フォーム, 15.4

組織デフォルト・フォーム, 15.2

パスワード・ポリシー・フォーム

使用状況タブ, 14.1.2

パスワード・ポリシー・フォーム, 14.1

ポリシー・ルール・タブ, 14.1.1

ポリシー履歴フォーム, 15.3 ユーザー管理フォルダ, 15.1 診断ダッシュボード, 16.4, 20

テストの実行, 20.5

インストール, 20.2.1

失敗した非同期タスクのパージ, 16.4.5

失敗した非同期タスクの再送信, 16.4.4

失敗した非同期タスクの再試行 16.4.3

テストの実行, 20.4

起動, 16.4.1, 20.3

失敗した非同期タスクの表示, 16.4.2

診断メッセージ・タイプ, 8.1.1 無効化

オフライン・プロビジョニング, 17.2

リコンシリエーション・イベントの詳細の表示, 1.2.2

E

有効化

オフライン・プロビジョニング, 17.2

セキュアなcookie, 9

システム・ロギング, 8

ジョブの有効化と無効化, 2.4.5 エンドユーザー管理者, 15.3 エンドユーザー, 15.3 Enterprise Manager, 18

構成ファイルのエクスポートとインポート, 18.2

Mbean, 18.1

エンティティ・アダプタ, 5.5.11 エンティティ属性

リスト, 13.1.1

イベント・メタデータ

定義, 3.1

エクスポートの説明, 5.5.6 データのエクスポート

依存性, 5.5.8

H

競合条件の処理, 1.1.3.2

水平表, 1.1.1.7, 1.1.3.1

ホストとポートの変更

BI Publisher, 12.1.4

OAM, 12.1.6

Oracle Identity Manager, 12.1.3

backOfficeURL, 12.1.3.2

OimFrontEndURL, 12.1.3.1

Oracle Identity Managerデータベース, 12.1.1 OVD, 12.1.2 SOA, 12.1.5

I

データのインポート, 5.5.14

継承, 4.1

インストール

診断ダッシュボード, 20.2.1

統合

BI Publisher, 11.7

OAAM, 11.2

OAM, 11.1

OIA, 11.3

OIN, 11.4

OVD, 11.5

SOA, 11.6

J

ジョブ, 2.4

作成, 2.4.1

表示, 2.4.3

ジョブ

拡張検索, 2.4.2.2

削除, 2.4.7

有効化と無効化, 2.4.5

変更, 2.4.4

単純検索, 2.4.2.1

起動と停止, 2.4.6

L

LDAP認証

構成, 10.6

LDAPスケジュール済タスク, 2.3.2 ライフサイクル管理, 12 孤立アカウントのリンク, 1.2.6.3 リコンシリエーション・イベントのリンク, 1.2.6 エンティティ属性のリスト表示, 13.1.1 ログ・ハンドラ

構成, 8.1.3

ログ・ハンドラとロガー, 8.1.2 ログ・レベル, 8.2.1 log4j, 8.2

ログ・レベル, 8.2.1

ロガー, 8.2.2

構成, 8.1.4

ロギング・サービス, 8

ODL, 8.1

logging.xml, 8.1.3.1

M

管理

通知, 3

リコンシリエーション・イベント, 1

管理

非同期実行, 16

リコンシリエーション・イベントの手動リンク, 1.2.6.2 MaxRetryCount, 1.1.1.2, 1.1.3.2 変更

ジョブ, 2.4.4

通知テンプレート, 3.4

システム・プロパティ, 4.2.4

ユーザー属性, 13.1.3

N

ネーミング規則, 5.5.4

ノード・マネージャ, 7.1

構成, 7.1

起動, 7.2

通知, 3

通知テンプレート, 3

通知サービス, 3 通知テンプレート, 3

作成, 3.2

通知テンプレート

ロケールの追加と削除, 3.6

デフォルト, 3

削除, 3.5

変更, 3.4

キャッシュのパージ, 4.2.2

検索, 3.3

O

OAAM, 11.2

OAM, 11.1

ODLログ出力, 8.1.5

オフライン・プロビジョニング

無効化, 17.2

有効化, 17.2

機能, 17.1

OIA, 11.3 oim-config.xml, 2.1 OIN, 11.4 操作データ, 5.5.3 Oracle Database

パフォーマンスの監視, 24.4

物理データの配置, 24.3

インスタンス構成のサンプル, 24.2

チューニング, 24

Oracle Identity Managerロガー, 8.1.4 Oracle Identity Manger

パスワード変更, 12.2

URL変更, 12.1

組織階層

エクスポート, 5.5.5

OVD, 11.5

P

パスワード変更

Oracle Identity Manager, 12.2.2

Oracle Identity Managerデータベース, 12.2.3

CSFにおけるOracle Identity Manager12.2.4

Oracle Identity Manger, 12.2

Oracle WebLogic管理者, 12.2.1

OVD, 12.2.5

パスワード・ポリシー

複雑なパスワード, 14.1.1

作成, 14.1

カスタム・ポリシー, 14.1.1

基準の設定, 14.2

物理データの配置

表領域, 24.3

事前定義済のスケジュール済タスク, 2.3.1 キャッシュのパージ, 4.2.2 パージ, 26.3

R

リコンシリエーション

非定型リンク, 1.1.2, 1.1.3.4

非同期, 1.1.3.3

自動再試行, 1.1.1.2, 1.1.3.2

バッチ, 1.1.1.4

バルク, 1.1.1.5

エラー・メッセージ, 1.4

イベント・アクション, 1.2.3

機能, 1.1

水平表, 1.1.1.7, 1.1.3.1

Javaエンジン, 1.1.1.6

パラメータ, 1.1.1.2

バッチサイズ, 1.1.1.2

MaxRetryCount, 1.1.1.2, 1.1.3.2

パフォーマンスの向上, 1.1.1 競合条件, 1.1.3.2 RECON_EXCEPTIONS表, 1.4 リコンシリエーション・アーカイブ・ユーティリティ, 23.1

アクティブ・リコンシリエーション表, 23.1.1

アーカイブ基準, 23.1.3

アーカイブ・リコンシリエーション表, 23.1.1

ログ・ファイル, 23.1.5

前提条件, 23.1.2

実行, 23.1.4

リコンシリエーション・イベント, 1

非定型リンク, 1.2.6.1

拡張検索, 1.2.1.2

クローズ, 1.2.5

詳細, 1.2.2

リンク, 1.2.6

孤立アカウントのリンク 1.2.6.3

手動リンク, 1.2.6.2

孤立アカウント, 1.2.6.3

再評価, 1.2.4

検索, 1.2.1

単純検索, 1.2.1.1

リコンシリエーション・プロファイル, 1.3

プロファイル・モードの変更, 1.3.3

変更プロパティ, 1.3.2

作成, 1.3.1

更新, 1.3

リコンシリエーション・イベントの再評価, 1.2.4 オブジェクトの関連グループ

エキスポート, 5.5.2

リモート・マネージャ, 21 レポート権限, 5.5.12 リクエスト・アーカイブ・ユーティリティ, 23.3

アーカイブ表, 23.3.1

入力パラメータ, 23.3.3

ログ・ファイル, 23.3.5

準備, 23.3.2

リクエスト・ステータス, 23.3.1

実行, 23.3.4

ロール権限, 5.5.12

S

スケジュール済ジョブ, 2.4

拡張検索, 2.4.2.2

単純検索, 2.4.2.1

スケジュール済タスク, 2.3, 5.5.10

LDAP, 2.3.2

パラメータ一致, 5.5.9

事前定義済, 2.3.1

スケジューラ, 2

子要素, 2.1

カスタムのスケジュール済タスクの作成, 2.3.3

ジョブ, 2, 2.4

ジョブ実行, 2

LDAPスケジュール済タスク, 2.3.2

oim-config.xml, 2.1

事前定義済のスケジュール済タスク, 2.3.1

スケジュール済タスク, 2

スケジュール済タスク, 2.3

起動と停止, 2.2

SDK表

更新, 5.5.15

検索

ジョブ, 2.4.2

通知テンプレート, 3.3

リコンシリエーション・イベント, 1.2.1

検索

システム・プロパティ, 4.2.3

ジョブの検索, 2.4.2 セキュアなcookie

cookie-secureフラグ, 9

有効化, 9

単純検索

ジョブ, 2.4.2.1

通知テンプレート, 3.3

システム・プロパティ, 4.2.3.1

SOA, 11.6 SSL, 9 起動と停止

ジョブ, 2.4.6

スケジューラの起動と停止, 2.2 起動と停止

WebLogic管理サーバー, 7.3

WebLogic管理対象サーバー, 7.4

サーバーの起動と停止, 7 UDFの同期化, 13.5 システム・ロギング

ログ・ハンドラの構成, 8.1.3

ロガーの構成, 8.1.4

診断メッセージ・タイプ, 8.1.1

有効化, 8

ログ・ハンドラとロガー, 8.1.2

ログ・レベル, 8.2.1

log4j, 8.2

ロガー, 8.2.2

logging.xml, 8.1.3.1

ODLログ出力, 8.1.5

Oracle Identity Managerロガー, 8.1.4

システム・オブジェクト

エクスポート, 5.5.1

システム・プロパティ, 4

拡張検索, 4.2.3.2

プロキシ用の通知の構成, 3.7

作成, 4.2.1

デフォルト, 4.1

削除, 4.2.5

変更, 4.2.4

検索, 4.2.3

単純検索, 4.2.3.1

T

タスク・アーカイブ・ユーティリティ, 23.2

アクティブ・タスク表, 23.2.1

アーカイブ・タスク表, 23.2.1

出力ファイル, 23.2.4

Oracle Databaseの準備, 23.2.2

実行, 23.2.3

チューニング

アプリケーション・サーバーのパフォーマンス, 25

Oracle Database, 24

Oracle Databaseのチューニング

ロール/権限の作成, 24.1

U

UDF

同期化, 13.5

更新

リコンシリエーション・プロファイル, 1.3

URL変更

Oracle Identity Manger, 12.1

ユーザー属性

カテゴリ構成, 13.1.5

作成, 13.1.5.1

削除, 13.1.5.3

属性の順序付けの指定, 13.1.5.4

構成

認可, 13.3

構成, 13

認可ポリシー, 13.3

作成, 13.1.2 削除, 13.1.4 エンティティ構成操作, 13.1 変更, 13.1.3 プロパティ, 13.1.2.1 検索構成操作, 13.2

V

ジョブの表示, 2.4.3

W

警告, 5.5.7

WebLogic管理サーバー

起動と停止, 7.3

WebLogic管理対象サーバー

起動と停止, 7.4

Copyright © 1991, 2011, Oracle and/or its affiliates. All rights reserved.