10 Oracle Identity Manager Remote Managerのインストールと構成

この章では、Oracle Identity Manager Remote Managerをインストールする方法について説明します。次の項が含まれます。

• Microsoft WindowsでのRemote Managerのインストール

• UNIXでのRemote Managerのインストール

• Remote Managerの構成

• Remote Managerの起動

• Remote Managerインストールの削除

10.1 Microsoft WindowsでのRemote Managerのインストール

次の手順を実行して、Microsoft WindowsホストにRemote Managerをインストールします。

注意: すべてのOracle Identity Managerコンポーネントは、異なるホーム・ディレクトリにインストールする必要があります。別のOracle Identity Managerコンポーネント（サーバーまたはDesign Console）のホスト・コンピュータにRemote Managerをインストールする場合は、使用されていないインストール・ディレクトリを指定します。

1. Oracle Identity ManagerインストールCDをCD-ROMドライブにセットします。

2. Microsoft Windowsエクスプローラを使用し、インストールCDのinstallServerディレクトリにナビゲートします。

3. setup_rm.exeファイルをダブルクリックします。

4. インストーラ・ページのリストから言語を選択します。「ようこそ」ページが表示されます。

5. 「ようこそ」ページで「次へ」をクリックします。

6. 「ターゲット・ディレクトリ」ページで、次の手順のいずれかを実行します。

   1. Oracle Identity Manager製品のデフォルト・ディレクトリはC:\oracleです。Remote Managerをこのディレクトリにインストールするには、「次へ」をクリックします。

   2. Remote Managerを別のディレクトリにインストールするには、「ディレクトリ」フィールドでディレクトリのパスを指定し、「次へ」をクリックします。

      
      

      注意: 指定したディレクトリ・パスが存在しない場合は、「ベース・ディレクトリの設定」フィールドが表示されます。「OK」をクリックします。ディレクトリが自動的に作成されます。Oracle Identity Managerのデフォルト・ディレクトリを作成するための書込み権限がない場合は、インストーラがディレクトリを作成できなかったことを知らせるメッセージが表示されます。「OK」をクリックしてメッセージを閉じた後、システム管理者に連絡して必要な権限を取得してください。

      
      

7. 既存のJREを選択します。その後、「次へ」をクリックします。「Remote Managerの構成」ページが表示されます。

   
   

   注意: アプリケーション・サーバーで使用中のJREを選択します。 Remote ManagerでサポートされているJREバージョンの詳細は、『Oracle Identity Manager Readme』を参照してください。

   
   

8. 「Remote Managerの構成」ページで、Remote Managerに関する情報を入力します。

   1. サービス名を入力します。デフォルト値は、RManagerです。

   2. Remote Managerのバインディング・ポートを入力します。デフォルト値は、12346です。

   3. Remote ManagerのSSL（Secure Sockets Layer）ポートを入力します。デフォルト値は、12345です。

   4. 「次へ」をクリックします。

9. 「ショートカット」ページで、必要に応じて、次のショートカット・オプションのチェック・ボックスを選択または選択解除します。

   1. デスクトップにRemote Managerのショートカットを作成します。

   2. 「スタート」メニューにRemote Managerのショートカットを作成します。

10. 「次へ」をクリックして次のページに進みます。

11. 「サマリー」ページで構成の詳細を確認し、「インストール」をクリックしてインストールを開始します。

12. インストールが完了したら、「完了」ページの「終了」をクリックして終了します。

10.2 UNIXでのRemote Managerのインストール

UNIXにRemote Managerをインストールするには、次のようにします。

注意: Remote Managerをインストールする前に、JREがRemote ManagerのインストーラによってJAVA_HOME変数に含まれるように、この変数を設定しておく必要があります。

1. Oracle Identity ManagerインストールCDをCD-ROMドライブにセットします。

2. ファイル・マネージャで、インストールCDのinstallServerディレクトリにアクセスします。

3. install_rm.shファイルを実行します。コマンドライン・インストーラが開始します。

4. 番号を入力してリストから言語を選択し、0を入力してその言語を適用します。「ようこそ」パネルが表示されます。

5. 「ようこそ」パネルで1を入力して、次のパネルに進みます。「ターゲット・ディレクトリ」パネルが表示されます。

6. 「ターゲット・ディレクトリ」パネルで、Oracle Identity Manager Remote Managerをインストールするディレクトリのパスを入力します。デフォルト・ディレクトリは/opt/oracleです。

   • 1を入力して次のパネルに進みます。

   • ディレクトリが存在しない場合は、ディレクトリの作成を求められます。yを入力してディレクトリを作成します。

   
   

   注意: すべてのOracle Identity Managerコンポーネントは、異なるホーム・ディレクトリにインストールする必要があります。Oracle Identity Managerサーバーのホスト・コンピュータにRemote Managerをインストールする場合は、一意のインストール・ディレクトリを指定する必要があります。

   
   

7. Remote Managerで使用するJREの場所を指定します。

   1を入力して次のパネルに進みます。

   
   

   関連項目: Remote ManagerでサポートされているJREバージョンの詳細は、『Oracle Identity Manager Readme』を参照してください。

   
   

8. 「Remote Managerの構成」パネルで、Remote Managerの構成情報を入力します。

   1. サービス名を入力するか、[Enter]を押してデフォルト値を使用します。

   2. Remote Managerのバインディング・ポートを入力するか、[Enter]を押してデフォルト値を使用します。

   3. Remote ManagerのSSLポートを入力するか、[Enter]を押してデフォルト値を使用します。

   4. 1を入力して次のパネルに進みます。

      Remote Managerインストールのサマリー・パネルが表示されます。

9. 情報を確認します。

   • 2を入力し、戻って変更します。

   • 1を入力し、インストールを開始します。

     Oracle Remote Managerがインストールされ、インストール後のサマリー・パネルが表示されます。

10. 3を入力し、インストールを終了します。

10.3 Remote Managerの構成

Remote ManagerとOracle Identity ManagerはSSLを使用して通信します。Remote Managerを使用する場合は、Oracle Identity ManagerとRemote Managerの間の信頼関係を有効にする必要があります。つまり、サーバーにRemote Managerの証明書を信頼させる必要があります。

クライアント側認証（Remote Managerがサーバーの証明書をチェックする認証）を有効にすることもできます。Remote Managerの証明書は、Oracle Identity Managerのキーストアにインポートし、信頼済にしてください。クライアント側認証を有効にする場合は、Oracle Identity Managerの証明書をRemote Managerのキーストアにインポートし、その証明書を信頼済にします。また、サーバーに関連する構成ファイルを手動で編集する必要があります。Remote Mangerのインストール時に選択したオプションによっては、Remote Managerの構成ファイルも編集する必要があります。

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

• Remote Managerのキーストア・パスワードの変更

• Remote Manager証明書の信頼

• Remote Managerでのクライアント側認証の有効化

10.3.1 Remote Managerのキーストア・パスワードの変更

インストール時に、Remote Managerのキーストアのパスワードはxellerateに設定されます。すべての本番インストールでキーストア・パスワードを変更することをお薦めします。

キーストアのパスワードを変更するには、.xlkeystoreのストアパスと.xlkeystoreのxellエントリのキーパスを変更する必要があります。これら2つの値は同一である必要があります。keytoolユーティリティを使用して、次のようにキーストアのパスワードを変更します。

1. Oracle Identity Managerのホスト・コンピュータでコマンド・ウィンドウを開きます。

2. OIM_RM_HOME\xellerate\configディレクトリに移動します。

3. 次のオプションを使用してkeytoolユーティリティを実行し、ストアパスを変更します。

   JAVA_HOME\jre\bin\keytool -storepasswd -new new_password -storepass xellerate
   -keystore .xlkeystore -storetype JKS
   

4. 次のオプションを使用してkeytoolユーティリティを実行し、.xlkeystoreのxellエントリのキーパスを変更します。

   JAVA_HOME\jre\bin\keytool -keypasswd -alias xell -keypass xellerate -new new_password
   -keystore .xlkeystore -storepass xellerate
   

   JAVA_HOMEは、Remote Managerインストールに関連するJavaインストールの場所です。

5. テキスト・エディタでOIM_RM_HOME\xlremote\config\xlconfig.xmlファイルを開きます。

6. <RMSecurity>.<KeyStore>セクションを編集して、キーストア・パスワードを次のように指定します。

   • パスワード・タグをencrypted="false"に変更します。

   • パスワードを次のように入力します。

     <RMSecurity>
     <KeyStore>
     <Location>.xlkeystore</Location>
     <Password encrypted="false">new_password</Password>
     <Type>JKS</Type>
     <Provider>sun.security.provider.Sun</Provider>
     </KeyStore>
     

   
   

   注意: Remote Managerにクライアント側認証を使用している場合は、OIM_RM_HOME/xlremote\config\xlconfig.xmlファイルの<RMSecurity>.<TrustStore>セクションにOracle Identity Managerのキーストア・パスワードを次のように入力します。 <TrustStore> <Location>.xlkeystore</Location> <Password encrypted="false">OIM_Server_keystore_password</Password> <Type>JKS</Type> <Provider>sun.security.provider.Sun</Provider> </TrustStore>

   
   

7. xlconfig.xmlファイルを保存して閉じます。

8. Remote Managerを再起動します。

9. テキスト・エディタでOIM_HOME\xellerate\config\xlconfig.xmlファイルを開きます。

10. <RMSecurity>.<TrustStore>セクションを次のように編集し、Remote Managerの新しいキーストア・パスワードを指定します。

    • パスワード・タグをencrypted="false"に変更します。

    • （通常の文字で）パスワードを入力します。次に例を示します。

      <TrustStore>
      <Location>.xlkeystore</Location>
      <Password encrypted="false">new_password</Password>
      <Type>JKS</Type>
      <Provider>sun.security.provider.Sun</Provider>
      </TrustStore>
      

11. xlconfig.xmlファイルを保存して閉じ、Oracle Identity Managerを再起動します。

10.3.2 Remote Manager証明書の信頼

Oracle Identity ManagerとRemote Managerとの間に信頼関係を確立するには、次の手順を実行します。

1. Remote Manager証明書をサーバー・コンピュータにコピーします。Remote ManagerのコンピュータにあるOIM_RM_HOME\xlremote\config \xlserver.certファイルを、サーバーのコンピュータにコピーします。

   
   

   注意: OIM_HOMEディレクトリのサーバー保証書も、xlserver.certと名前が付けられます。この証明書を上書きしないように注意してください。

   
   

2. サーバー・コンピュータでコマンド・プロンプトを開きます。

3. keytoolユーティリティを使用して証明書をインポートするには、次のコマンドを実行します。

   JAVA_HOME\jre\bin\keytool -import -alias rm_trusted_cert -file RM_cert_location\xlserver.cert -trustcacerts 
   -keystore OIM_HOME\xellerate\config\.xlkeystore -storepass xellerate
   

   JAVA_HOMEはアプリケーション・サーバーのJavaディレクトリの場所、エイリアスの値はストアの証明書に対する任意の名前、RM_cert_locationは証明書をコピーした場所です。

   
   

   注意: キーストアのパスワードを変更した場合は、その値をxellerateのかわりに使用してください（xellerateはstorepass変数のデフォルト値です）。

   
   

4. プロンプトでYを入力して、証明書を信頼するようにします。

5. テキスト・エディタでOIM_HOME\xellerate\config\xlconfig.xmlファイルを開きます。

6. <RMIOverSSL>プロパティを探し、次のように値がtrueに設定されていることを確認します。

   <RMIOverSSL>true</RMIOverSSL>
   

7. <KeyManagerFactory>プロパティを探します。IBM JREを使用する場合は値をIBMX509に設定します。次に例を示します。

   <KeyManagerFactory>IBMX509</KeyManagerFactory>
   

   その他のすべてのJREの場合は値をSUNX509に設定します。次に例を示します。

   <KeyManagerFactory>SUNX509</KeyManagerFactory>
   

8. ファイルを保存します。

9. Oracle Identity Managerを再起動します。

10.3.2.1 独自の証明書の使用

Remote Managerシステムで独自の証明書を使用してRemote Managerを構成するには、次のようにします。

1. カスタム・キーを.xlkeystore以外の新しいキーストア（new_keystore_name）にインポートします。新しいキーストアに使用したパスワード（new_keystore_pwd）を忘れないようにしてください。

2. この新しいキーストアをOIM_RM_HOME\xlremote\config\ディレクトリにコピーします。

3. テキスト・エディタでOIM_RM_HOME\xlremote\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. Remote Managerサーバーを再起動し、xlconfig.xmlファイルを開いて、新しいキーストアのパスワードが暗号化されたことを確認します。

Oracle Identity Managerサーバーで独自の証明書を使用してRemote Managerを構成するには、次のようにします。

1. Remote Managerシステムで使用したのと同じ証明書鍵を、.xlkeystore以外のキーストア（new_svrkeystore_name）にインポートします。新しいキーストアに使用したパスワード（new_svrkeystor_pwd）を忘れないようにしてください。

2. この新しいキーストアをOIM_HOME\xellerate\configディレクトリにコピーします。

3. テキスト・エディタでOIM_HOME\xellerate\config\xlconfig.xmlファイルを開きます。

4. <RMSecurity>タグを探し、<Location>タグと<Password>タグの値を次のように変更します。

   <TrustStore>
      <Location>new_svrkeystore_name</Location>
      <Password encrypted="false">new_svrkeystor_pwd</Password>
      <Type>JKS</Type>
      <Provider>sun.security.provider.Sun</Provider></TrustStore>
   

5. Oracle Identity Managerを再起動し、xlconfig.xmlファイルを開いて新しいキーストアのパスワードが暗号化されていることを確認します。

10.3.3 Remote Managerでのクライアント側認証の有効化

クライアント側認証を有効にするには、次のようにします。

1. テキスト・エディタで、Remote Managerのホスト・コンピュータにあるOIM_RM_HOME\xlremote\config\xlconfig.xmlファイルを開きます。

2. <ClientAuth>プロパティをtrueに設定します。次に例を示します。

   <ClientAuth>true</ClientAuth>
   

3. <RMIOverSSL>プロパティをtrueに設定します。次に例を示します。

   <RMIOverSSL>true</RMIOverSSL>
   

4. <KeyManagerFactory>プロパティを探します。

   IBM JREを使用する場合は値をIBMX509に設定します。次に例を示します。

   <KeyManagerFactory>IBMX509</KeyManagerFactory>
   

   その他のすべてのJREの場合は値をSUNX509に設定します。次に例を示します。

   <KeyManagerFactory>SUNX509</KeyManagerFactory>
   

5. ファイルを保存します。

6. サーバーの証明書をRemote Managerのコンピュータにコピーします。サーバーのコンピュータにあるOIM_HOME\xellerate\config\xlserver.certファイルを、Remote Managerのコンピュータにコピーします。

   
   

   注意: Remote Managerの証明書の名前もxlserver.certであるため、上書きしないように注意してください。

   
   

7. Remote Managerのコンピュータでコマンド・プロンプトを開きます。

8. 次のkeytoolコマンドを使用して証明書をインポートします。

   JAVA_HOME\jre\bin\keytool -import -alias trusted_server_cert -file 
   server_cert_location\xlserver.cert -trustcacerts 
   -keystore XL_RM_HOME\xlremote\config\.xlkeystore -storepass xellerate
   

   JAVA_HOMEはRemote ManagerのJavaディレクトリの場所、エイリアスの値はストアの証明書に対する任意の名前、OIM_RM_HOMEはRemote Managerのホーム・ディレクトリ、server_cert_locationはサーバーの証明書をコピーした場所です。

   
   

   注意: キーストアのパスワードを変更した場合は、その値をxellerateのかわりに使用してください（xellerateはstorepass変数のデフォルト値です）。

   
   

9. プロンプトでYを入力して、証明書を信頼するようにします。

10. Remote Managerを再起動します。

10.4 Remote Managerの起動

Remote Managerを起動するには、次のスクリプトを使用します。

• Microsoft Windowsの場合:

  OIM_RM_HOME\xlremote\remotemanager.bat
  

• UNIXの場合:

  OIM_RM_HOME/xlremote/remotemanager.sh
  

10.5 Remote Managerインストールの削除

Remote Managerインストールを削除するには、次のようにします。

1. Oracle Identity ManagerとRemote Managerが実行している場合は停止します。

2. すべてのOracle Identity Managerプロセスを停止します。

3. Remote ManagerをインストールしたOIM_RM_HOMEディレクトリを削除します。