ヘッダーをスキップ
Oracle Identity Manager SAP User Management Connectorガイド
リリース9.0.3
E05128-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

2 コネクタのデプロイ

コネクタをデプロイするには次の手順を実行します。

SAP User Managementの複数のインストールに対してコネクタを構成する場合は、次の手順を実行します。

手順1: デプロイ要件の確認

次の表に、コネクタのデプロイ要件を示します。

項目 要件
Oracle Identity Manager Oracle Identity Managerリリース8.5.3以上。
ターゲット・システム ターゲット・システムは次のいずれかです。
  • SAP 4.6C

  • SAP 4.7

  • SAP BIW 3.1

  • SAP CRM 4.0

  • BIW3.1上のSEM BCS

  • mySAP ERP 2004 ECC 5.0

  • mySAP ERP 2005 ECC 6.0

外部コード 次のSAPカスタム・コード・ファイルです。
sapjco.jar

Microsoft Windowsの場合:

sapjcorfc.dll
librfc32.dll

バージョン: 2.0.10

SolarisおよびLinuxの場合:

libsapjcorfc.so
librfccm.so

バージョン: 2.0.10

ターゲット・システムのユーザー・アカウント ユーザー・アカウントを作成し、SAP_ALLグループに割り当てます。

「ITリソースの定義」の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。


手順2: コネクタ・ファイルおよび外部コードのコピー

次の表に、コピーするコネクタ・ファイルおよびそれらのコピー先のディレクトリを示します。


注意:

この表の最初の列に示すディレクトリ・パスは、インストール・メディアの次のディレクトリでのコネクタ・ファイルの場所に対応しています。
Enterprise Applications\SAP Enterprise Applications\SAP User Management

これらのファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。


インストール・メディア・ディレクトリのファイル コピー先ディレクトリ
BAPI\xlsapcar.sar
このファイルは、ターゲット・システムの任意の場所にコピーできます。次に例を示します。
C:\xlsapcar\

詳細は、「リクエスト・ファイルの抽出」を参照してください。

lib\SAPAdapter.jar

OIM_home\xellerate\SAP\lib
OIM_home\xellerate\JavaTasks
resourcesディレクトリのファイル
OIM_home\xellerate\connectorResources
troubleshootディレクトリにあるファイル
OIM_home\xellerate\SAP\troubleshoot
xmlディレクトリにあるファイル
OIM_home\xellerate\SAP\xml

外部コード・ファイルをダウンロードして必要な場所にコピーするには、次のようにします。

  1. 次のようにして、SAP Javaコネクタ・ファイルをSAPのWebサイトからダウンロードします。

    1. Webブラウザで次のページを開きます。

      https://websmp104.sap-ag.de/connectors

    2. 「Application Platform」「Connectivity」「Connectors」「SAP Java Connector」「Tools & Services」を順に選択し、「SAP JAVA Connector」ページを開きます。

    3. 「SAP JAVA Connector」ページの右側のペインに、ダウンロード可能なファイルのリンクが表示されます。ダウンロードするSAP JCOリリースのリンクをクリックします。

    4. 表示されるダイアログ・ボックスに、ファイルを保存するディレクトリ・パスを指定します。

  2. ダウンロードしたファイルの内容を抽出します。

  3. sapjco.jarファイルをOIM_home\Xellerate\JavaTasksディレクトリにコピーします。

  4. RFCファイルを必要なディレクトリにコピーし、このディレクトリへのパスが含まれるように適切な環境変数を変更します。

    • Microsoft Windowsの場合:

      librfccm.dllファイルとlibsapjcorfc.dllファイルをwinnt\system32ディレクトリにコピーします。あるいは、これらのファイルを任意のディレクトリにコピーし、そのディレクトリへのパスをPATH環境変数に追加することもできます。

    • SolarisおよびLinuxの場合:

      librfccm.soファイルとlibsapjcorfc.soファイルを/usr/local/jcoディレクトリにコピーし、このディレクトリへのパスをLD_LIBRARY_PATH環境変数に追加します。

  5. 環境変数への変更を有効にするために、サーバーを再起動します。


注意:

Oracle Identity Managerをクラスタ環境にインストールするときは、インストール・ディレクトリの内容をクラスタの各ノードにコピーします。同じく、connectorResourcesディレクトリとJARファイルも、クラスタの各ノードの対応するディレクトリにコピーする必要があります。

手順3: Oracle Identity Managerサーバーの構成

Oracle Identity Managerサーバーの構成には、次の手順があります。


注意:

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

必要な入力ロケールへの変更

必要な入力ロケール(言語および国の設定)に変更するには、必要なフォントのインストールと必要な入力ロケールの設定を行います。

必要な入力ロケールを設定するには、次のようにします。


注意:

使用しているオペレーティング・システムによっては、この手順の実行方法が異なる場合があります。

  1. 「コントロール パネル」を開きます。

  2. 「地域のオプション」をダブルクリックします。

  3. 「地域のオプション」ダイアログ・ボックスの「入力ロケール」タブで、使用する入力ロケールを追加してから、その入力ロケールに切り替えます。

サーバー・キャッシュからのコネクタ・リソース・バンドル関連コンテンツの消去

OIM_home\xellerate\connectorResourcesディレクトリ内に新しいリソース・バンドルを追加するたび、または既存のリソース・バンドルで変更を行うたびに、コネクタ・リソース・バンドルに関連するコンテンツをサーバー・キャッシュから消去する必要があります。

サーバー・キャッシュからのコネクタ・リソース・バンドルに関連する内容を消去するには、次のようにします。

  1. コマンド・ウィンドウで、OIM_home\xellerate\binディレクトリに移動します。

  2. 次のコマンドのいずれかを入力します。


    注意:

    このステップを実行する前にステップ1を実行する必要があります。コマンドを次のように実行すると、例外がスローされます。
    OIM_home\xellerate\bin\batch_file_name
    

    • Microsoft Windowsの場合:

      PurgeCache.bat ConnectorResourceBundle
      
      
    • UNIXの場合:

      PurgeCache.sh ConnectorResourceBundle
      
      

    このコマンドのConnectorResourceBundleは、サーバー・キャッシュから削除できるコンテンツ・カテゴリの1つです。その他のコンテンツ・カテゴリの詳細は、次のファイルを参照してください。

    OIM_home\xellerate\config\xlConfig.xml
    
    

注意:

ステップ2の実行時にスローされる例外は無視できます。

ロギングの有効化

ロギングを有効化すると、Oracle Identity Managerはプロビジョニングおよびリコンシリエーション操作の過程で発生するイベントについての情報をログ・ファイルに自動的に格納します。ロギングを行うイベントのタイプを指定するには、ログ・レベルを次のいずれかに設定します。

  • ALL

    このレベルでは、すべてのイベントのロギングが有効化されます。

  • DEBUG

    このレベルでは、デバッグに役立つ詳細なイベントに関する情報のロギングが有効化されます。

  • INFO

    このレベルでは、アプリケーションの進行状況を粗密に選択した情報メッセージのロギングが有効化されます。

  • WARN

    このレベルでは、障害を引き起こす可能性のある状況に関する情報のロギングが有効化されます。

  • ERROR

    このレベルでは、アプリケーションを続行できる場合があるエラー・イベントに関する情報のロギングが有効化されます。

  • FATAL

    このレベルでは、アプリケーションの機能停止の原因となる可能性がある、非常に重大なエラー・イベントに関する情報のロギングが有効化されます。

  • OFF

    このレベルでは、すべてのイベントのロギングが無効化されます。

ログ・レベルおよびログ・ファイル・パスを設定するファイルは、使用するアプリケーション・サーバーによって異なります。

  • JBoss Application Serverの場合

    ロギングを有効にするには、次のようにします。

    1. JBoss_home\server\default\conf\log4j.xmlファイルで、次の行を検索します。

      <category name="XELLERATE">
         <priority value="log_level"/>
      </category>
      
      
    2. XMLコードの2行目で、log_levelを、設定するログ・レベルに置換します。次に例を示します。

      <category name="XELLERATE">
         <priority value="INFO"/>
      </category>
      
      

    ロギングを有効にすると、次のファイルにログ情報が書き込まれます。

    JBoss_home\server\default\log\server.log
    
    
  • IBM WebSphereの場合:

    ロギングを有効にするには、次のようにします。

    1. OIM_home\xellerate\config\log.propertiesファイルに次の行を追加します。

      log4j.logger.XELLERATE=log_level
      
      
    2. この行で、log_levelを、設定するログ・レベルに置換します。

      次に例を示します。

      log4j.logger.XELLERATE=INFO
      
      

    ロギングを有効にすると、次のファイルにログ情報が書き込まれます。

    WebSphere_home\AppServer\logs\server_name\startServer.log
    
    
  • BEA WebLogicの場合

    ロギングを有効にするには、次のようにします。

    1. OIM_home\xellerate\config\log.propertiesファイルに次の行を追加します。

      log4j.logger.XELLERATE=log_level
      
      
    2. この行で、log_levelを、設定するログ・レベルに置換します。

      次に例を示します。

      log4j.logger.XELLERATE=INFO
      
      

    ロギングを有効にすると、次のファイルにログ情報が書き込まれます。

    WebLogic_home\user_projects\domains\domain_name\server_name\server_name.log
    

手順4: ターゲット・システムの構成

この項では、ターゲット・システムの構成に関わる手順を説明します。これらの手順のいくつかは、実行にSAP Basis管理者の支援が必要になる場合があります。

ターゲット・システムの構成には次のタスクがあります。

必要な情報の収集

ターゲット・システムを構成するには、次の情報が必要です。


注意:

SAPのインストール時に、インストールが実行されているサーバーにシステム番号およびクライアント番号が割り当てられます。これらの番号は、次のリストに示されています。

  • リクエストのインポートに必要な権限を持つ管理ユーザーのログインの詳細

  • リクエストがインポートされるサーバーのクライアント番号

  • システム番号

  • サーバーのIPアドレス

  • サーバー名

  • SAPアプリケーション・サーバーへの接続に使用されるアカウントのユーザーID

  • SAPアプリケーション・サーバーへの接続に使用されるアカウントのパスワード

BAPIF4T表へのエントリの作成

「ユーザー・グループ」フィールドは、SAPユーザーのデータを保持するフィールドの1つです。F4値は、リストに表示され選択できるフィールドの値です。「ユーザー・グループ」フィールドのF4値を表示できるようにするには、BAPIF4T表にエントリを作成する必要があります。このエントリをBAPIF4T表に作成するには、次のようにします。

  1. SM30トランザクションをSAPシステムで実行します。

  2. 表名としてBAPIF4Tと入力し、「Maintain」をクリックします。表示される警告またはメッセージは無視します。

  3. 「New Entries」をクリックします。

  4. データ要素としてXUCLASS、ファンクション名としてZXL_PARTNER_BAPI_F4_AUTHORITYと入力します。


    注意:

    XUCLASSデータ要素に対してエントリがすでに存在する場合は、その値を変更しないでください。

  5. 作成したエントリを保存し、終了します。

リクエストのインポート

SAPシステムに次のカスタム・オブジェクトを作成するには、リクエストをインポートする必要があります。

オブジェクト・タイプ オブジェクト名
パッケージ ZBAPI
ファンクション・グループ ZXLGROUP

ZXLHELPVALUES

ZXLPROFILE

ZXLROLE

ZXLUSER

メッセージ・クラス ZXLBAPI
プログラム ZF4HLP_DATA_DEFINITIONS

ZMS01CTCO

ZMS01CTCO1

ZMS01CTP2

ZXLGROUP

ZXLHELPVALUES

ZXLPROFILE

ZXLROLE

ZXLUSER

ビジネス・オブジェクト・タイプ ZXLGROUP

ZXLHELP

ZXLPROFILE

ZXLROLE

ZXLUSER

ZXLBAPIMODE

ZXLBAPIMODM


xlsapcar.sarファイルには、これらのオブジェクトの定義が含まれます。xlsapcar.sarファイルの内容で表されるリクエストをインポートすると、これらのオブジェクトは自動的にSAPに作成されます。この手順により、既存のSAPの構成が変更されることはありません。

SAPへのリクエストのインポートには次の手順があります。

SAPCARユーティリティのダウンロード

リクエストを構成する2つのファイル、データファイルとCofileがxlsapcar.sarに圧縮されています。SAPCARユーティリティを使用してこれらのファイルを抽出できます。

SAPCARユーティリティをSAPヘルプのWebサイトからダウンロードするには、次のようにします。

  1. 次のURLからSAPのWebサイトにログオンします。

    https://service.sap.com/swdc

  2. 「OK」をクリックして、表示される証明書がSAPインストールに割り当てられた証明書であることを確認します。

  3. SAPユーザー名およびパスワードを入力してSAPサービス・マーケットプレイスに接続します。

  4. 「Downloads」「SAP Support Packages」「Entry by Application Group」「Additional Components」を順にクリックします。

  5. 「SAPCAR」「SAPCAR 6.20」を順に選択し、オペレーティング・システムを選択します。ダウンロード・オブジェクトが表示されます。

  6. 「Object」チェック・ボックスを選択し、「Add to Download Basket」をクリックします。

  7. SAPCARユーティリティをダウンロードするディレクトリを指定します。たとえば、C:\xlsapcarです。

リクエスト・ファイルの抽出

リクエストの構成要素であるデータファイルおよびCofileを抽出するには、次のようにします。

  1. SAPCARユーティリティをダウンロードしたディレクトリにxlsapcar.sarファイルをコピーします。

    xlsapcar.sarファイルは、インストール・メディア・ディレクトリ内のBAPIディレクトリにあります。

  2. コマンド・ウィンドウで、ディレクトリをSAPCARユーティリティおよびxlsapcar.sarファイルが格納されるディレクトリに変更します。

  3. 次のコマンドを入力して、リクエストの構成要素であるデータファイルおよびCofileを抽出します。

    sapcar -xvf xlsapcar.sar
    
    

    抽出されたファイルは、次のような形式です。

    K900208.I46(Cofile)

    R900208.I46(データファイル)

リクエスト・インポート操作の実行

リクエスト・インポート操作を実行するには、次のようにします。


注意:

次のステップを実行するには、SAP Basis管理者の支援が必要になります。

  1. データファイルおよびCofileをSAPサーバーの必要な場所にコピーします。

  2. リクエストをSAPにインポートします。

  3. ログ・ファイルを確認して、インポートが成功したかどうかを判断します。

    ログ・ファイルを表示するには、次のようにします。

    1. STMSトランザクションを実行します。

      トランスポート・リクエストのリストが表示されます。

    2. インポートしたリクエストに対応するトランスポート・リクエスト番号を選択します。

      トランスポート・リクエスト番号は、Cofileまたはデータファイルの名前の数値部分と同じです。前述の手順のステップ3におけるサンプルのCofile(K900208.I46)およびデータファイル(R900208.I46)の場合、トランスポート・リクエスト番号は900208です。

    3. ログ・ファイルのアイコンをクリックします。

      ログ・ファイルに表示されるリターン・コードが4の場合、インポートは終了していますが警告が発生したことを示します。これは、オブジェクトが上書きされたか、SAPシステムにすでに存在する場合に発生します。リターン・コードが8以上の場合、インポート時にエラーが発生したことを示します。

  4. SE80トランザクションを実行してABAPオブジェクトのZBAPIパッケージをチェックし、リクエストのインポートを確認します。

手順5: コネクタのXMLファイルのインポート

コネクタのXMLファイルをOracle Identity Managerにインポートするには、次のようにします。

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

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

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

  4. XMLファイルを検索して開きます。

    • ターゲット・システムがSAP R3の場合は、SAPR3ResourceObject.xmlファイルを検索します。

    • ターゲット・システムがBIWの場合は、SAPBIWResourceObject.xmlファイルを検索します。

    • ターゲット・システムがSAP CRMの場合は、SAPCRMResourceObject.xmlファイルを検索します。

    これらのファイルはOIM_home\Xellerate\SAP\xmlディレクトリにあります。選択したXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

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

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

  7. 「次へ」をクリックします。SAP R3 IT Resource ITリソースの「ITリソース・インスタンス・データの提供」ページが表示されます。

  8. SAP R3 IT Resource ITリソースのパラメータの値を指定します。指定する値の詳細は、「ITリソースの定義」の表を参照してください。

  9. 「次へ」をクリックします。SAP R3 IT Resource ITリソース・タイプの新しいインスタンスの「ITリソース・インスタンス・データの提供」ページが表示されます。

  10. その他のITリソースを定義しないことを指定するには、「スキップ」をクリックします。「確認」ページが表示されます。


    関連資料:

    その他のITリソースを定義する場合、手順は『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。

  11. 「選択内容の表示」をクリックします。

    XMLファイルの内容が「インポート」ページに表示されます。ノードの横に十字形のアイコンが表示されることがあります。各ノードを右クリックして「削除」を選択し、それらのノードを削除します。

  12. 「インポート」をクリックします。コネクタのXMLファイルがOracle Identity Managerにインポートされます。

コネクタのXMLファイルをインポートしたら、「手順7: アダプタのコンパイル」に進みます。

ITリソースの定義

SAP R3 ITリソース・パラメータには、次の表に示す値を指定してください。

パラメータ 説明 サンプル値
SAPClient SAPのクライアントID。 800
SAPHost SAPのホストIPアドレス。 172.20.70.204
SAPLanguage SAPの言語。 EN
SAPUser ターゲットSAPシステムのSAPユーザー。 xellerate
SAPPassword SAPユーザーのパスワード。 changethis
SAPsnc_lib cryptoライブラリが存在するパス。

このパラメータは、Secure Network Communication(SNC)が有効な場合にのみ必要です。

c:\\usr\\sap\\sapcrypto.dll
SAPsnc_mode SAPサーバーでSNCが有効な場合は、このフィールドを1に設定します。それ以外の場合は、0(ゼロ)に設定します。

注意: SNCを有効化して、ターゲット・システムとの通信を保護することをお薦めします。

0
SAPsnc_myname SNCのシステム名。

このパラメータは、SNCが有効な場合のみ必要です。

p:CN=TST,OU=SAP, O=ORA,c=IN
SAPsnc_partnername SAPサーバーのドメイン名。

このパラメータは、SNCが有効な場合のみ必要です。

p:CN=I47,OU=SAP, O=ORA, c=IN
SAPsnc_qop データが送信される保護レベル(保護の質(QOP))を指定します。

デフォルト値は3です。値は次のいずれかです。

  • 1: 認証のみを保護

  • 2: データ整合性保護

  • 3: データ・プライバシ保護

  • 8: パラメータの値を使用

  • 9: 使用可能な最大値を使用

このパラメータは、SNCが有効な場合のみ必要です。

3
SAPSystemNo SAPシステム番号。 00
SAPType SAPシステムのタイプ。

R3BIWCRMなどです。

このパラメータは任意です。

R3
TimeStamp 最初のリコンシリエーションの実行では、タイムスタンプ値は設定されていません。後続のリコンシリエーション処理では、前のリコンシリエーション処理が完了した時刻がこのパラメータに保存されます。 サンプルのタイムスタンプ値は次のとおりです。

英語: Jun 01, 2006 at 10:00:00 GMT+05:30

フランス語: juin. 01, 2006 at 10:00:00 GMT+05:30

日本語: 6 01, 2006 at 10:00:00 GMT+05:30


これらのITリソース・パラメータの値を指定したら、この手順のステップ9に進んで、コネクタのXMLファイルをインポートします。

手順6: リコンシリエーションの構成

リコンシリエーションを構成するには、次の手順を実行します。

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


注意:

この手順のこのステップは、信頼できるソース・リコンシリエーションを構成する場合にのみ実行します。信頼できるソース・リコンシリエーションに構成できるのは、1つのコネクタのみです。別の信頼できるソースを構成している状態で次のファイルのいずれかをインポートした場合、2つのコネクタのリコンシリエーションはいずれも機能しなくなります。
  • SAPR3XLResourceObject.xml

  • SAPBIWXLResourceObject.xml

  • SAPCRMXLResourceObject.xml

リコンシリエーションの構成の概念の詳細は、『Oracle Identity Manager Connectorフレームワーク・ガイド』を参照してください。


信頼できるソース・リコンシリエーションを構成するには、まず次のようにして、信頼できるソース・リコンシリエーションのXMLファイルをインポートする必要があります。

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

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

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

  4. SAPR3XLResourceObject.xmlSAPBIWXLResourceObject.xmlまたはSAPCRMXLResourceObject.xmlファイルを検索して開きます。これらのファイルはOIM_home\Xellerate\sap\xmlディレクトリにあります。選択したXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

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

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

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

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

次に、次の項で説明する手順の実行中に、リコンシリエーションのスケジュール済タスク属性IsTrustedの値をTrueに設定します。

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

参照フィールドおよびユーザー・リコンシリエーションにスケジュール済タスクを作成するには、次のようにします。

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

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

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

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

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

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

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

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

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

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

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

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


    関連資料:

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

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

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

両方のスケジュール済タスクを作成したら、「手順7: アダプタのコンパイル」に進みます。

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

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

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

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


注意:

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

属性 説明 サンプル値
Password Xellerateユーザーの作成時に割り当てられるデフォルト・パスワード Dummy
Organization 新しいユーザーに割り当てられるデフォルトの組織 Xellerate Users
Role 新しいユーザーに割り当てられるデフォルトのロール Consultant
Xellerate Type 新しいユーザーに割り当てられるデフォルトのタイプ End-User Administrator
ITResource SAP User Managementサーバーへの接続を設定するためのITリソースの名前 SAP R3 IT Resource
ResourceObject ユーザーをリコンサイルする必要があるリソース・オブジェクトの名前

この属性値が、Lookup.SAP.R3.FieldNames参照定義のResourceObjectNameコード・キーのデコード値と同じであることを確認する必要があります。

関連資料: 参照定義の変更については、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

SAP R3 Resource Object
Server SAPサーバーのタイプ

値はR3BIWまたはCRMです。

R3

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

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

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


注意:

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

属性 説明 サンプル値
Password Xellerateユーザーの作成時に割り当てられるデフォルト・パスワード Dummy
Organization 新しいユーザーに割り当てられるデフォルトの組織 Xellerate Users
Role 新しいユーザーに割り当てられるデフォルトのロール Consultant
Xellerate Type 新しいユーザーに割り当てられるデフォルトのタイプ End-User Administrator
ITResource SAP User Managementサーバーへの接続を設定するためのITリソースの名前 SAP R3 IT Resource
ResourceObject ユーザーをリコンサイルする必要があるリソース・オブジェクトの名前

この属性値が、Lookup.SAP.R3.FieldNames参照定義のResourceObjectNameコード・キーのデコード値と同じであることを確認する必要があります。

関連資料: 参照定義の変更については、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

SAP R3 Resource Object
IsTrusted 信頼できる/信頼できないターゲットに対する構成

Trueに設定する場合は、ターゲットは信頼できるターゲットです。Falseに設定する場合は、ターゲットは信頼できないターゲットです。デフォルト値はFalseです。

False
FirstTimeReconRecords リコンシリエーション・スケジュール済タスクがタイムアウトした場合の、最初のリコンシリエーション時にフェッチされるレコード数

最初に、Oracle Identity Managerは、すべてのレコードをフェッチしようとします。プロセスがタイムアウトすると、Oracle Identity Managerはこのパラメータに指定されたレコード数をフェッチしようとします。このレコード数がフェッチされる前にタスクがタイムアウトすると、Oracle Identity Managerはターゲット・システムからすべてのレコードがフェッチされるまで、繰り返しこの数を2で割ってレコードをフェッチしようとします。

5000
Server SAPサーバーのタイプ

値はR3BIWまたはCRMです。

R3

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

手順7: アダプタのコンパイル

コネクタのXMLファイルのインポート時に、次のアダプタがOracle Identity Managerにインポートされます。

これらのアダプタを使用してターゲット・システムにアカウントをプロビジョニングするには、これらをコンパイルする必要があります。

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

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

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

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


    注意:

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

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

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

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

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

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

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


注意:

一度に1つのアダプタをコンパイルするには、「アダプタ・ファクトリ」フォームを使用します。「アダプタ・ファクトリ」フォームおよび「アダプタ・マネージャ」フォームの使用方法の詳細は、『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。

手順8: SAP Password Change機能の構成

Change Password機能を構成して、ターゲット・システムのユーザー・プロファイルがロックされたり、有効期限が切れたりした場合のパスワードの動作を変更できます。このような場合、ロックされたり有効期限が切れたユーザー・プロファイルのパスワードを管理者がリセットできないようにシステムを構成できます。これより、Oracle Identity Managerとターゲット・システムのデータ間に矛盾が発生しないようにすることができます。

Change Password機能を構成するには、次のようにします。


関連資料:

『Oracle Identity Managerデザイン・コンソール・ガイド』

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

  2. 「Process Management」フォルダを開きます。

  3. 「Process Definition」フォームを開きます。

  4. SAP R3 Processプロセス定義を選択します。

  5. 「Password Updated」タスクをダブルクリックします。

  6. 「Integration」タブで、次のパラメータの値を指定します。

    • validityChange: 値trueまたはfalseを割り当てることができるフラグです。

      • true: ユーザーの有効期限が切れた場合、validityDateパラメータに指定された日付まで延長されます。

      • false: ユーザーの有効期限が切れた場合、有効期限は延長されず、ユーザーのパスワードは変更できません。

    • lockChange: 値trueまたはfalseを割り当てることができるフラグです。

      • true: ユーザーが(管理者以外によって)ロックされた場合、そのユーザーはパスワードが変更される前にロック解除されます。ユーザーが管理者によってロックされた場合、パスワードは変更できません。

      • false: ユーザーがロックされた場合、パスワードは変更できません。

    • validityDate: ユーザーの有効期限の延長日です。日付書式は次のとおりです。

      Dec 28, 2005 at 11:25:00 GMT+05:30
      
      

      このフィールドが空の場合、ユーザーの有効期間は無期限になります。

    • userGroupCheck: 次の形式の文字列リテラルです。

      user_group_to_check, flag(1|0), user_group_to_be_updated_after_reset_password
      
      

      このパラメータは、パスワードのリセット時にチェックするグループがない場合、空の文字列となります。

      パスワードを変更し、ユーザーがそのグループに属する場合、このフラグの値は1です。パスワードを変更せず、ユーザーがそのグループに属する場合、このフラグの値は0です。

      複数のユーザーをチェックするには、各ユーザーのレコードをこの文字列に追加します。区切り文字としてセミコロン(;)を使用します。次に例を示します。

      user_group_to_check, flag(1|0), user_group_to_be_updated_after_reset_password;
      user_group_to_check, flag(1|0), user_group_to_be_updated_after_reset_password
      
      

      たとえば、パスワードの変更時にチェックされるInactiveというユーザー・グループがあり、ユーザーがそのグループに割り当てられている場合、このユーザーをパスワードの変更後にActiveグループに移動する必要があります。

      この場合、userGroupCheckパラメータの設定は次のとおりです。

      INACTIVE,1,ACTIVE;
      
      

      パスワードの変更時にチェックされるTerminatedというグループがあり、ユーザーがそのグループに割り当てられている場合、パスワードの変更を許可しない必要があります。この場合、userGroupCheckパラメータの設定は次のとおりです。

      TERMINATED,0,;
      
      

      userGroupCheck構成パラメータには、次の2種類のユーザー・グループ・レコードしかありません。

      • パスワードの変更がユーザー・グループの更新とともに実行されるユーザー・グループ

        INACTIVE,1,ACTIVE;
        
        
      • パスワードの変更が実行されないユーザー・グループ

        TERMINATED,0,;
        
        

      ユーザーがuserGroupCheckパラメータに指定されていないグループに割り当てられている場合、パスワードは変更されます。パスワードの変更は、構成パラメータの値に指定されていないユーザー・グループすべてに対して許可されます。


    注意:

    指定する値は、大/小文字が区別されるため、SAPシステムでの大/小文字と一致する必要があります。

手順9: Oracle Identity Managerとターゲット・システムとの間の通信を保護するためのSNCの構成

Oracle Identity ManagerはJavaアプリケーション・サーバーを使用します。SAPシステム・アプリケーション・サーバーに接続するために、このJavaアプリケーション・サーバーではJavaコネクタ(sapjco.jar)およびRFC(librfccmファイルとlibsapjcorfcファイル)を使用します。必要な場合には、Secure Network Communication(SNC)を使用してこのような接続を保護できます。


注意:

Oracle Identity Managerで使用されるJavaアプリケーション・サーバーには、IBM WebSphere、BEA WebLogic、JBoss Application Serverがあります。

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

SNCを使用するためのコネクタの構成の前提条件

SNCを使用するためにコネクタを構成する前提条件は、次のとおりです。

  • SNCは、SAPアプリケーション・サーバーでアクティブである必要があります。

  • SNCインフラストラクチャに精通している必要があります。また、アプリケーション・サーバーでSNCに使用するPersonal Security Environment(PSE)を把握しておく必要があります。

セキュリティ・パッケージのインストール

Oracle Identity Managerで使用されるJavaアプリケーション・サーバーでセキュリティ・パッケージをインストールするには、次のようにします。

  1. SAP Cryptographic Libraryインストール・パッケージの内容を抽出します。

    SAP Cryptographic Libraryインストール・パッケージは、次のSAPサービス・マーケットプレイスのWebサイトで認可された顧客に提供されています。

    http://service.sap.com/download

    このパッケージには次のファイルが含まれます。

    • SAP Cryptographic Library(Microsoft Windowsの場合はsapcrypto.dll、UNIXの場合はlibsapcrypto.ext

    • 対応するライセンス・チケット(ticket

    • 構成ツールsapgenpse.exe

  2. ライブラリおよびsapgenpse.exeファイルをローカル・ディレクトリにコピーします。たとえば、C:\usr\sapです。

  3. ファイル権限を確認します。Javaアプリケーション・サーバーを実行しているユーザーが、ライブラリおよびsapgenpse.exeファイルをコピーするディレクトリでライブラリ機能を実行できることを確認します。

  4. secディレクトリをライブラリおよびsapgenpse.exeファイルをコピーするディレクトリ内に作成します。


    注意:

    作成するディレクトリには任意の名前を使用できます。しかし、SAPでは、C:\usr\sap\sec(または/usr/sap/sec)ディレクトリの作成を推奨しています。

  5. ticketファイルをsecディレクトリにコピーします。このディレクトリは、Personal Security Environment(PSE)およびJavaアプリケーション・サーバーの資格証明が生成されるディレクトリでもあります。


    関連項目:

    「SNCの構成」

  6. Javaアプリケーション・サーバーのユーザーのSECUDIR環境変数をsecディレクトリに設定します。


    注意:

    これ以降、「SECUDIRディレクトリ」という用語は、SECUDIR環境変数に定義されているパスのディレクトリを表す場合に使用します。

  7. Javaアプリケーション・サーバーのユーザーのSNC_LIB環境変数を、secディレクトリの親ディレクトリである暗号ライブラリ・ディレクトリに設定します。

SNCの構成

SNCを構成するには次のようにします。

  1. PSEを作成するか、SAPアプリケーション・サーバーのSNC PSEをSECUDIRディレクトリにコピーします。Javaアプリケーション・サーバーのSNC PSEを作成するには、次のようにsapgenpse.exeコマンドライン・ツールを使用します。

    1. SECUDIRディレクトリの場所を特定するには、コマンド・オプションを指定せずにsapgenpseコマンドを実行します。SECUDIRディレクトリのライブラリ・バージョンや場所などの情報が表示されます。

    2. 次のようなコマンドを入力してPSEを作成します。

      sapgenpse get_pse -p PSE_Name -x PIN Distinguished_Name
      
      

      サンプルの識別名を次に示します。

      CN=SAPJ2EE, O=MyCompany, C=US
      
      

      sapgenpseコマンドにより、PSEがSECUDIRディレクトリに作成されます。

  2. Javaアプリケーション・サーバーの資格証明を作成します。

    Javaアプリケーション・サーバーには、PSEにアクセスするために実行時にアクティブな資格証明が必要です。この条件を満たしているかどうかを確認するには、次のコマンドをSECUDIRディレクトリの親ディレクトリに入力します。

    seclogin
    
    

    次に、次のコマンドを入力してサーバーのPSEを開き、credentials.sapgenpseファイルを作成します。

    seclogin -p PSE_Name -x PIN -O [NT_Domain\]user_ID
    
    

    指定するuser_IDには、管理者権限が必要です。PSE_NAMEは、PSEファイルの名前です。

    -Oオプションで指定されたユーザーの資格証明ファイルcred_v2SECUDIRディレクトリに作成されます。

  3. 次のようにして、2つのサーバーの公開鍵証明書を交換します。


    注意:

    SAPサーバーの証明書ごとに個別のPSEを使用する場合は、SAPサーバーの証明書ごとにこの手順を1回実行する必要があります。つまり、この手順を実行する回数はPSEの数と同じです。

    1. 次のコマンドを入力してOracle Identity Managerの証明書をエクスポートします。

      sapgenpse export_own_cert -o filename.crt -p PSE_Name -x PIN
      
      
    2. Oracle Identity Managerの証明書をSAPアプリケーション・サーバーにインポートします。このステップの実行には、SAP管理者の支援が必要になる場合があります。

    3. SAPアプリケーション・サーバーの証明書をエクスポートします。このステップの実行には、SAP管理者の支援が必要になる場合があります。

    4. 次のコマンドを入力してSAPアプリケーション・サーバーの証明書をOracle Identity Managerにインポートします。

      sapgenpse maintain_pk -a serverCertificatefile.crt -p PSE_Name -x PIN
      
      
  4. SAP R3 IT Resource ITリソース・オブジェクトの次のパラメータを構成します。

    • SAPsnc_lib

    • SAPsnc_mode

    • SAPsnc_myname

    • SAPsnc_partnername

    • SAPsnc_qop

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


注意:

この手順は、SAP User Managementの複数のインストールに対してコネクタを構成する場合にのみ実行します。この手順の各ステップ実行の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

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

  1. 各ターゲット・システムのインストールに、リソース・オブジェクトを1つ作成および構成します。

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

  2. 各リソース・オブジェクトに、ITリソースを1つ作成および構成します。

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

  3. プロセス定義ごとに1つずつプロセス・フォームを設計します。

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

    • UD_SAPR3(SAP R3)

    • UD_SAPR3ROL(SAP R3ロール・フォーム)

    • UD_SAPR3PRO(SAP R3プロファイル・フォーム)

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

  4. 各リソース・オブジェクトに、プロセス定義を1つ作成および構成します。

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

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

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

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

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

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

    • ITResource

    • ResourceObject

    • IsTrusted

    信頼できるソースとして指定するSAP User ManagementインストールのIsTrusted属性をTrueに設定します。SAP User Managementの単一インストールと複数インストールのいずれも信頼できるソースとして指定できます。残りのSAP User Managementインストールについては、この属性をFalseに設定します。

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

管理およびユーザー・コンソールを使用してプロビジョニングを実行する場合、ユーザーのプロビジョニング先のSAP User Managementインストールに対応するITリソースを指定できます。