コネクタの構成後タスクの実行

4 コネクタの構成後タスクの実行

ここでは、Oracle Identity Governanceでアプリケーションを作成した後に実行できるタスクについて説明します。

4.1 Oracle Identity Governanceの構成

アプリケーションの作成時に、デフォルトのフォームを作成するように選択しなかった場合は、コネクタを使用して作成したアプリケーションのUIフォームを作成する必要があります。

注意:

この項の手順は、アプリケーションの作成時にデフォルトのフォームを作成するように選択しなかった場合にのみ実行します。

次の各トピックでは、Oracle Identity Governanceを構成する手順を示します。

4.1.1 サンドボックスの作成およびアクティブ化

カスタマイズおよびフォーム管理機能の使用を開始するには、サンドボックスを作成してアクティブにする必要があります。次に、サンドボックスを公開してそのカスタマイズを他のユーザーが使用できるようにします。

『Oracle Fusion Middleware Oracle Identity Governanceのためのアプリケーションの開発とカスタマイズ』のサンドボックスの作成およびサンドボックスのアクティブ化に関する項を参照してください。

4.1.2 UIフォームの新規作成

Oracle Identity System Administrationのフォーム・デザイナを使用して、アプリケーション・インスタンス・フォームを作成および管理できます。

『Oracle Fusion Middleware Oracle Identity Governanceの管理』のフォーム・デザイナを使用したフォームの作成に関する項を参照してください。

UIフォームを作成するときは、必ずそのフォームを関連付ける新しく作成されたアプリケーションに対応するリソース・オブジェクトを選択します。また、「権限フォームの生成」チェック・ボックスを選択します。

4.1.3 サンドボックスの公開

サンドボックスを公開する前に、ベスト・プラクティスとして次の手順を実行し、このステージまでに行われたすべてのサンドボックスの変更を検証してください(サンドボックスを公開した後に変更を元に戻すことは難しいため)。

アイデンティティ・システム管理で、サンドボックスを非アクティブ化します。
アイデンティティ・システム管理をログアウトします。
xelsysadmユーザー資格証明を使用してIdentity Self Serviceにログインし、ステップ1で非アクティブ化したサンドボックスをアクティブ化します。
カタログで、リソースのアプリケーション・インスタンス・フォームが正しいフィールドとともに表示されていることを確認します。
サンドボックスを公開します。『Oracle Fusion Middleware Oracle Identity Governanceのためのアプリケーションの開発とカスタマイズ』のサンドボックスの公開に関する項を参照してください。

4.1.4 新規フォームによる既存アプリケーション・インスタンスの更新

Identity Self Serviceでアプリケーションのスキーマに行うすべての変更に対して、新しいUIフォームを作成し、アプリケーション・インスタンスでその変更を更新する必要があります。

新規フォームにより既存のアプリケーション・インスタンスを更新するには:

サンドボックスを作成してアクティブ化します。
リソースの新しいUIフォームを作成します。
既存のアプリケーション・インスタンスを開きます。
「フォーム」フィールドで、作成した新しいUIフォームを選択します。
アプリケーション・インスタンスを保存します。
サンドボックスを公開します。

4.2 権限および同期カタログの収集

子プロセス・フォーム表から権限割当てスキーマを移入し、ロール、アプリケーション・インスタンスおよび権限をカタログに収集できます。カタログ・メタデータをロードすることもできます。

権限の収集とカタログ同期化を行うには、次の手順を実行します。

「リコンシリエーション・ジョブ」にリストされている参照フィールド同期のスケジュール済ジョブを実行します。
権限リスト・スケジュール済ジョブを実行して、子プロセス・フォーム表から権限割当てスキーマを移入します。
カタログ同期化ジョブ・スケジュール済ジョブを実行します。

4.3 コネクタのロギングの管理

Oracle Identity Governanceでは、Oracle Diagnostic Logging (ODL)ロギング・サービスを使用して、コネクタに関連するすべてのタイプのイベントを記録します。

次の項では、ロギングに関する詳細情報を提供します。

4.3.1 ログ・レベルの理解

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

ODLはOracle Identity Governanceにより原則的に使用されるロギング・サービスで、java.util.loggerに基づいています。ロギングを行うイベントのタイプを指定するには、ログ・レベルを次のいずれかに設定します。

SEVERE.intValue()+100

このレベルでは、致命的エラーに関する情報のロギングが有効化されます。
SEVERE

このレベルでは、Oracle Identity Governanceの実行を続行できる可能性があるエラーに関する情報のロギングが有効化されます。
WARNING

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

このレベルでは、アプリケーションの進行状況を示すメッセージのロギングが有効化されます。
CONFIG

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

これらのレベルでは、詳細なイベントに関する情報のロギングが有効化されます。FINESTではすべてのイベントに関する情報がログに記録されます。

これらのメッセージ・タイプは、表4-1に示すようなODLメッセージ・タイプとレベルの組合せにマップされます。

表4-1 ログ・レベルおよびODLメッセージ・タイプ: レベルの組合せ

Javaのレベル	ODLのメッセージ・タイプ:レベル
SEVERE.intValue()+100	INCIDENT_ERROR:1
SEVERE	ERROR:1
WARNING	WARNING:1
INFO	NOTIFICATION:1
CONFIG	NOTIFICATION:16
FINE	TRACE:1
FINER	TRACE:16
FINEST	TRACE:32

OJDLの構成ファイルはlogging.xmlであり、次のパスにあります。

DOMAIN_HOME/config/fmwconfig/servers/OIM_SERVER/logging.xml

ここで、DOMAIN_HOMEとOIM_SERVERは、それぞれOracle Identity Governanceのインストール時に指定されたドメイン名とサーバー名です。

4.3.2 ロギングの有効化

次の手順を実行して、Oracle WebLogic Serverでロギングを有効化します。

Oracle WebLogic Serverでロギングを有効にするには:

次のようにしてlogging.xmlファイルを編集します。

ファイル内に次のブロックを追加します。

<log_handler name='S4HANA-handler'
          level='[LOG_LEVEL]'class='oracle.core.ojdl.logging.ODLHandlerFactory'>
             <property name='logreader:' value='off'/>      <property name='path'
            value='[FILE_NAME]'/>      
             <property name='format' value='ODL-Text'/>     <property name='useThreadName' value='true'/>
             <property name='locale' value='en'/>
             <property name='maxFileSize' value='5242880'/>
             <property name='maxLogSize'
          value='52428800'/>   <property name='encoding'
          value='UTF-8'/></log_handler> Copy<logger name="
        ORG.IDENTITYCONNECTORS.S4HANA" level="[LOG_LEVEL]"
          useParentHandlers="false">   <handler
          name="S4HANA-handler"/>   <handler
          name="console-handler"/> </logger>

2箇所の[LOG_LEVEL]を、必要なODLのメッセージ・タイプとレベルの組合せで置き換えます。表4-1に、サポートされているメッセージ・タイプとレベルの組合せを示します。同様に、[FILE_NAME]は、ログ・メッセージを記録するログ・ファイルのフルパスおよび名前で置き換えます。次のブロックは、[LOG_LEVEL]および[FILE_NAME]のサンプル値を示しています。

<log_handler name= ‘S4HANA -handler’
          level='NOTIFICATION:1'class='oracle.core.ojdl.logging.ODLHandlerFactory'>
             <property name='logreader:' value='off'/>      <property name='path'
            value='F:\MyMachine\middleware\user_projects\domains\base_domain1\servers\oim_server1\logs\oim_server1-diagnostic-1.log'/>   <property name='format' value='ODL-Text'/>
                <property name='useThreadName' value='true'/>
             <property name='locale' value='en'/>
             <property name='maxFileSize' value='5242880'/>
             <property name='maxLogSize' value='52428800'/>
             <property name='encoding'
          value='UTF-8'/></log_handler>   <logger name="
        ORG.IDENTITYCONNECTORS.S4HANA" level="NOTIFICATION:1"
          useParentHandlers="false">   <handler name="S4HANA-handler"/>
             <handler
          name="console-handler"/>
    </logger>

これらのサンプル値を設定してOracle Identity Governanceを使用すると、このコネクタについて生成される、ログ・レベルがNOTIFICATION:1レベル以上のすべてのメッセージが指定のファイルに記録されます。

ファイルを保存して閉じます。
サーバー・ログをファイルにリダイレクトするには、次の環境変数を設定します。
- Microsoft Windowsの場合: set WLS_REDIRECT_LOG=FILENAME
- UNIXの場合: export WLS_REDIRECT_LOG=FILENAME
FILENAMEを、出力のリダイレクト先ファイルの場所と名前に置き換えます。
アプリケーション・サーバーを再起動します。

4.4 コネクタ・サーバーのITリソースの構成

コネクタ・サーバーを使用した場合は、コネクタ・サーバーITリソースのパラメータの値を構成する必要があります。

ターゲット・システムのアプリケーションを作成した後に、『Oracle Fusion Middleware Oracle Identity Governanceの管理』のITリソースの作成に関する項の説明に従ってコネクタ・サーバーのITリソースを作成する必要があります。ITリソースを作成するときは、必ず「ITリソース・タイプ」リストから「コネクタ・サーバー」を選択します。

表4-2 コネクタ・サーバーのITリソースのパラメータ

パラメータ	説明
ホスト	コネクタ・サーバーのホスト・コンピュータのホスト名またはIPアドレスを入力します。サンプル値: `HostName`
キー	コネクタ・サーバーのキーを入力します。
ポート	コネクタ・サーバーがリスニングしているポートの番号を入力します。サンプル値: `8763`
タイムアウト	コネクタ・サーバーとOracle Identity Governanceの間の接続がタイムアウトになるまでの時間(ミリ秒)を指定する整数値を入力します。値が0の場合、または値を指定しない場合、タイムアウトは無制限です。サンプル値: `0` (推奨値)
UseSSL	Oracle Identity Governanceとコネクタ・サーバーとの間にSSLを構成するよう指定する場合は、`true`を入力します。それ以外の場合は、`false`を入力します。デフォルト値: `false` ノート: SSLを構成してコネクタ・サーバーとの通信を保護することをお薦めします。SSLを構成するには、『Oracle Fusion Middleware Oracle Identity Governanceのためのアプリケーションの開発とカスタマイズ』のJavaコネクタ・サーバーのSSLの構成に関する項を参照してください。

4.5 UIフォームにおけるフィールド・ラベルのローカライズ

使用する言語に対応するリソース・バンドルを使用して、UIフォーム・フィールド・ラベルをローカライズできます。リソース・バンドルはコネクタ・インストール・メディアに用意されています。

UIフォームに追加されるフィールド・ラベルをローカライズするには、次のようにします。

Oracle Enterprise Managerにログインします。
左側のペインで、「アプリケーションのデプロイ」を開き、oracle.iam.console.identity.sysadmin.earを選択します。
右側のペインで、「アプリケーションのデプロイ」リストから、「MDS構成」を選択します。
「MDS構成」ページで、「エクスポート」をクリックして、ローカル・コンピュータにアーカイブ(oracle.iam.console.identity.sysadmin.ear_V2.0_metadata.zip)を保存します。
アーカイブの内容を解凍して、テキスト・エディタで次のファイルを開きます。
```
SAVED_LOCATION\xliffBundles\oracle\iam\ui\runtime\BizEditorBundle.xlf
```
注意:
ターゲット・システムに対するアプリケーションの作成を完了するか、UDFの作成などのカスタマイズを実行しないかぎり、BizEditorBundle.xlfファイルは表示されません。

次のように、BizEditorBundle.xlfファイルを編集します:

次のテキストを検索します。

<file source-language="en"
          original="/xliffBundles/oracle/iam/ui/runtime/BizEditorBundle.xlf"
          datatype="x-oracle-adf">

次のテキストで置き換えます。

<file source-language="en" target-language="LANG_CODE"
          original="/xliffBundles/oracle/iam/ui/runtime/BizEditorBundle.xlf"
          datatype="x-oracle-adf">

このテキストのLANG_CODEを、フォーム・フィールド・ラベルをローカライズする言語のコードに置き換えます。フォーム・フィールド・ラベルを日本語でローカライズする場合の値の例を次に示します。

 <file source-language="en" target-language="ja"
          original="/xliffBundles/oracle/iam/ui/runtime/BizEditorBundle.xlf"
          datatype="x-oracle-adf">

アプリケーション・インスタンスのコードを検索します。この手順は、S4HANAアプリケーション・インスタンスのサンプル編集を示しています。元のコードは次のとおりです。

 <trans-unit
          id="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_USER_NAME__c_description']}"><source>Username</source><target/></trans-unit><trans-unitid="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_S4HANAApp_USER_NAME__c_description']}"><source>UserName</source><target/></trans-unit><trans-unitid="sessiondef.oracle.iam.ui.runtime.form.model.S4HANAApp.entity.S4HANAAppEO.UD_S4HANAApp_USER_NAME__c_LABEL"><source>UserName</source><target/></trans-unit>Open the resource file from the connector package, for       example
            S4HANA_ja.properties, and get the value of the attribute from the       file, for
            example,Copyglobal.udf.UD_S4HANA_USER_NAME=\u30E6\u30FC\u30B6\u30FC\u540DReplace the original code shown in Step 6.c with the
          following:Copy<trans-unit
          id="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_USER_NAME__c_description']}"><source>Username</source><trans-unitid="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_S4HANAApp_USER_NAME__c_description']}"><source>UserName</source>
          <target>\u30E6\u30FC\u30B6\u30FC\u540D</target></trans-unit><trans-unitid="sessiondef.oracle.iam.ui.runtime.form.model.S4HANAApp.entity.S4HANAAppEO.UD_S4HANAApp_USER_NAME__c_LABEL"><source>User
    
    Name</source> <target>\u30E6\u30FC\u30B6\u30FC\u540D</target> </trans-unit>

コネクタ・パッケージに入っているリソース・ファイル(たとえば、S4HANA_ja.properties)を開き、そのファイルの属性の値を取得します。例:
```
global.udf.UD_S4HANA_USER_NAME=\u30E6\u30FC\u30B6\u30FC\u540D
```

ステップ6.cに示されている元のコードを、次のものに置き換えます。

<trans-unit
          id="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_USER_NAME__c_description']}"><source>Username</source><trans-unitid="${adfBundle['oracle.adf.businesseditor.model.util.BaseRuntimeResourceBundle']['persdef.sessiondef.oracle.iam.ui.runtime.form.model.user.entity.userEO.UD_S4HANAApp_USER_NAME__c_description']}"><source>UserName</source>
          <target>\u30E6\u30FC\u30B6\u30FC\u540D</target></trans-unit><trans-unitid="sessiondef.oracle.iam.ui.runtime.form.model.S4HANAApp.entity.S4HANAAppEO.UD_S4HANAApp_USER_NAME__c_LABEL"><source>UserName</source> <target>\u30E6\u30FC\u30B6\u30FC\u540D</target>

</trans-unit>

プロセス・フォームのすべての属性に対し、ステップ6.aから6.dを繰り返します。
ファイルをBizEditorBundle_LANG_CODE.xlfとして保存します。このファイル名で、LANG_CODEを、ローカライズする言語のコードに置き換えます。サンプル・ファイル名: BizEditorBundle_ja.xlf.

ZIPファイルを再パッケージしてMDSにインポートします。

関連項目:

メタデータ・ファイルのエクスポートおよびインポートの詳細は、『Oracle Fusion Middleware Oracle Identity Governanceのためのアプリケーションの開発とカスタマイズ』のカスタマイズのデプロイおよびアンデプロイに関する項を参照してください
Oracle Identity Governanceからログアウトしてから、ログインします。

4.6 SSLの構成

Oracle Identity GovernanceとZoomターゲット・システムの間のデータ通信を保護するためにSSLを構成します。

注意:

このコネクタをコネクタ・サーバーとともに使用している場合、SSLを構成する必要はありません。この項はスキップできます。

SSLを構成するには:

SAP S/4HANA CloudおよびSAP IASのSSL公開キー証明書を取得します。
これらの証明書を取得するには、次のいずれかの方法を使用します: (推奨される方法はaとbです):
1. opensslユーティリティの使用: ほとんどの Unix OSでは、このユーティリティがデフォルトでインストールされています。ない場合は、インストールするか、他の実行可能な方法に従ってください。
2. 次のコマンドを実行して、証明書を取得します。ホストIP/DNS、ポートおよび証明書名を置き換え、必要な証明書をすべて取得するまでこのコマンドを再実行します。
```
Syntax: echo | openssl s_client -connect <host IP/ DNS>:<port number> -showcerts >> [path where you want to save your cert]/<file name (use crt, cert, pem, der etc . extension based on your keystore)>example: echo | openssl s_client -connect oracle.com:443 -showcerts >> oracle.cert
```
3. 証明書のダウンロードと共有を証明書管理チームに依頼してください
ブラウザの使用中に、次のステップに従います:
- 1. SAP IASインスタンスにログインします。
  2. 「Lock」アイコン→「Secure Connection」/「Connection is secure」をクリックします。
    注意:
    - ブラウザのタイプに応じて、次の各ステップは変わります。次のステップはFirefoxブラウザに適用可能です。
    - すべてのタイプのブラウザで「Download Application Certificate」を使用します(ルートCAまたは発行元ではない)。
  3. 「More information」→「Security」→「View certificate」を選択します。
  4. オプション「Miscellaneous」までスクロールし、証明書をダウンロードします。
SAP S/4HANA CloudおよびSAP IASの公開キー証明書を、Oracle Identity Governanceをホストしているコンピュータにコピーします。
次のkeytoolコマンドを実行して、公開キー証明書をOracle Identity Governanceのアイデンティティ・キー・ストアにインポートします。
keytool -import -alias ALIAS -trustcacerts -file CERT_FILE_NAME -keystore KEYSTORE_NAME -storepass PASSWORD
このコマンドでは:
- ALIASは公開キー証明書の別名です
- ERT_FILE_NAMEは、ストアに追加される証明書のフルパスと名前で、KEYSTORE_NAMEはキーストアの名前です。
- CPASSWORDはキーストアのパスワードです。
次に、このコマンドのサンプル値を示します:

keytool -import -keystore <WL_HOME>/server/lib/DemoTrust.jks -file <fully qualified S4/HANA Cloud certificate name -storepass DemoTrustKeyStorePassPhrase -alias s4hana_cloud

keytool -import -keystore <WL_HOME>/server/lib/DemoTrust.jks -file <fully qualified SAP IAS certificate name> -storepass DemoTrustKeyStorePassPhrase -alias SAP_IAS
注意:
- keytoolコマンドに渡すパラメータ値は、個別の要件に応じて変更してください。keytoolの引数には改行が含まれないようにしてください
- SSL通信中のエラーを回避するために、Oracle Identity Governanceのシステム日付がSSL証明書の有効日と同期していることを確認します。