ヘッダーをスキップ
Oracle Identity Manager Oracle Application Server用インストレーション・ガイド
リリース9.0.3
E05330-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

7 Oracle Identity ManagerサーバーおよびOracle Application Serverのインストール後の構成

Oracle Identity Managerをインストールした後で、アプリケーションを使用する前にインストール後のタスクを実行する必要があります。さらに、アプリケーションを使用する前に、デプロイによって異なりますが、実行することを選択できるインストール後のオプション・タスクがいくつかあります。この章の内容は次のとおりです。

Oracle Application Serverのためのインストール後の必須タスク

Oracle Identity ManagerソフトウェアをOracle Application Serverにインストールした後で、Oracle Identity Managerが適切に作動するようにこの項のタスクを実行する必要があります。

Oracle Application Serverヒープ・サイズの増加

Oracle Identity ManagerをOracle Application Serverにインストールした後で、Oracle Identity Managerを使用する前にOracle Application Serverヒープ・サイズを増やす必要があります。次の手順を実行してOracle Application Serverヒープ・サイズを増やします。

  1. <ORACLE_HOME>\opmn\conf\opmn.xmlファイルをテキスト・エディタで開きます。

  2. 次の文字列を探します。

    -XX:MaxPermSize=128M
    
    

    この文字列を次のように変更します。

    -XX:MaxPermSize=512M
    
    
  3. <ORACLE_HOME>\opmn\conf\opmn.xmlファイルを保存して閉じます。

  4. ヒープ・サイズを増やした後で、Oracle Application Serverを再起動します。

インストール後のオプション・タスク

Oracle Identity Managerをインストールした後、アプリケーションを使用する前に、この項で説明するインストール後のオプション・タスクの実行について検討する必要があります。Oracle Identity Managerのデプロイによって異なりますが、タスクの一部は実行しないことも可能です。

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

Oracle Identity ManagerにはOracle Identity Managerサーバー用とデータベース用の2つのキーストアがあります。インストール時に両方のパスワードはxellerateに設定されます。すべての本番インストールでキーストア・パスワードを変更することをお薦めします。どちらのキーストアのキーストア・パスワードもkeytoolを使用して変更できます。

キーストア・パスワードを変更するには、次のようにします。

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

  2. <XL_HOME>\xellerate\configディレクトリにナビゲートします。

  3. 次のオプションを指定してkeytoolを実行します。

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

    表7-1に、このkeytoolの例で使用したオプションを示します。

    表7-1 keytoolのコマンド・オプション

    オプション 説明

    <JAVA_HOME>

    アプリケーション・サーバーに関連するJavaディレクトリの場所

    <new_password>

    キーストアの新しいパスワード

    -keystore <option>

    パスワードを変更するキーストア(Oracle Identity Managerサーバーでは.xlkeystore、データベースでは.xldatabasekey)

    -storetype <option>

    .xlkeystoreの場合はJKS、.xldatabasekeyの場合はJCEKS


  4. プレーン・テキスト・エディタを起動し、<XL_HOME>\xellerate\config\xlconfig.xmlファイルを開きます。

  5. <xl-configuration>.<Security>.<XLPKIProvider>.<KeyStore>セクションを編集して、キーストア・パスワードを指定します。


    注意:

    データベースのキーストア(.xldatabasekey)のパスワードを更新するには、構成ファイルの<XLSymmetricProvider>.<KeyStore>セクションを変更します。

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

    • (通常の文字で)パスワードを入力します。たとえば、次のブロックがあるとします。

      <Security>
      <XLPKIProvider>
      <KeyStore>
      <Location>.xlkeystore</Location>
      <Password encrypted="true">xYr5V2FfkRYHxKXHeT9dDg==</Password>
      <Type>JKS</Type>
      <Provider>sun.security.provider.Sun</Provider>
      </KeyStore>
      
      

      これを次のように変更します。

      <Security>
      <XLPKIProvider>
      <KeyStore>
      <Location>.xlkeystore</Location>
      <Password encrypted="false">newpassword</Password>
      <Type>JKS</Type>
      <Provider>sun.security.provider.Sun</Provider>
      </KeyStore>
      
      
  6. アプリケーション・サーバーを再起動します。

    アプリケーション・サーバーを停止して起動すると、構成ファイルのバックアップが作成されます。構成ファイル(新しいパスワードを含む)が読み込まれ、ファイル内でパスワードは暗号化されます。

  7. ここまでの手順がすべて正常に終了したら、バックアップ・ファイルを削除することができます。


    注意:

    また、UNIXまたはLinuxでは、次のコマンドを使用してシェルのコマンド履歴をクリアしてください。

    history -c


ログ・レベルの設定

Oracle Identity Managerでは、ロギングにlog4jが使用されます。ログ・レベルは、ロギング・プロパティ・ファイル<XL_HOME>/xellerate/config/log.propertiesで構成されます。デフォルトでは、Oracle Identity Managerは警告レベル(WARN)で出力するように構成されています。ただし、デバッグ・レベル(Debug)で出力するようにデフォルトで構成されているDDMを除きます。すべてのコンポーネントを一括して、または個別のコンポーネントごとにログ・レベルを変更できます。

たとえば、Oracle Identity Managerコンポーネントは、<XL_HOME>\xellerate\config\log.propertiesファイルのXELLERATEセクションに次のように指定されます。

log4j.logger.XELLERATE=WARN
log4j.logger.XELLERATE.DDM=DEBUG
log4j.logger.XELLERATE.ACCOUNTMANAGEMENT=DEBUG
log4j.logger.XELLERATE.SERVER=DEBUG
log4j.logger.XELLERATE.RESOURCEMANAGEMENT=DEBUG
log4j.logger.XELLERATE.REQUESTS=DEBUG
log4j.logger.XELLERATE.WORKFLOW=DEBUG
log4j.logger.XELLERATE.WEBAPP=DEBUG
log4j.logger.XELLERATE.SCHEDULER=DEBUG
log4j.logger.XELLERATE.SCHEDULER.Task=DEBUG
log4j.logger.XELLERATE.ADAPTERS=DEBUG
log4j.logger.XELLERATE.JAVACLIENT=DEBUG
log4j.logger.XELLERATE.POLICIES=DEBUG
log4j.logger.XELLERATE.RULES=DEBUG
log4j.logger.XELLERATE.DATABASE=DEBUG
log4j.logger.XELLERATE.APIS=DEBUG
log4j.logger.XELLERATE.OBJECTMANAGEMENT=DEBUG
log4j.logger.XELLERATE.JMS=DEBUG
log4j.logger.XELLERATE.REMOTEMANAGER=DEBUG
log4j.logger.XELLERATE.CACHEMANAGEMENT=DEBUG
log4j.logger.XELLERATE.ATTESTATION=DEBUG
log4j.logger.XELLERATE.AUDITOR=DEBUG

Oracle Identity Managerのログ・レベルを設定するには、<XL_HOME>\xellerate\config\log.propertiesファイルのロギング・プロパティを次のように編集します。

  1. <XL_HOME>\xellerate\config\log.propertiesファイルをテキスト・エディタで開きます。このファイルには、Oracle Identity Managerの一般的な設定と、Oracle Identity Managerを構成するコンポーネントやモジュールの個別の設定が含まれます。

    デフォルトでは、Oracle Identity Managerは、次のように警告レベル(WARN)で出力するように構成されています。

    log4j.logger.XELLERATE=WARN

    これはOracle Identity Managerの一般的な設定の値です。個々のコンポーネントとモジュールの値は、プロパティ・ファイルの一般的な値の後に指定されます。個々のコンポーネントとモジュールは様々なログ・レベルに設定できます。特定のコンポーネントのログ・レベルが一般設定よりも優先されます。

  2. 一般設定の値を必要なログ・レベルに設定します。次に、サポートされるログ・レベルのリストを、ロギング情報の多い順に示します(DEBUGでは最も多くの情報がロギングされ、FATALでは最も少ない情報がロギングされます)。

    • DEBUG

    • INFO

    • WARN

    • ERROR

    • FATAL

  3. 他のコンポーネントのログ・レベルを必要に応じて設定します。個々のコンポーネントまたはモジュールには、様々なログ・レベルを指定できます。たとえば、次の値を指定すると、Account Managementモジュールのログ・レベルがINFO、サーバーはDEBUGレベル、その他のOracle Identity ManagerはWARNレベルに設定されます。

    log4j.logger.XELLERATE=WARNlog4j.logger.XELLERATE.ACCOUNTMANAGEMENT=INFOlog4j.logger.XELLERATE.SERVER=DEBUG

  4. 変更内容を保存します。

  5. アプリケーション・サーバーを起動して、変更を有効にします。

Oracle Identity Managerでのシングル・サインオン(SSO)の有効化

この後の手順では、ASCII文字ログインを使用してOracle Identity Managerでのシングル・サインオンを有効化する方法を説明します。非ASCII文字ログインでのシングル・サインオンを有効化するときも次の手順を使用しますが、手順4の構成設定を追加してください。


関連資料:

Oracle Access Managerを利用するOracle Identity Managerでのシングル・サインオンの構成の詳細は、『Oracle Identity Managerベスト・プラクティス・ガイド』を参照してください。


注意:

英字のみのヘッダー名しか認証されません。ヘッダー名には特殊な文字や数字を使用しないことをお薦めします。

Oracle Identity Managerのためにシングル・サインオンを有効化するには、次のようにします。

  1. アプリケーション・サーバーを正常に停止します。

  2. プレーン・テキスト・エディタを起動し、次のファイルを開きます。

    <XL_HOME>\xellerate\config\xlconfig.xml

  3. 次のようなシングル・サインオン構成を探します(この例はシングル・サインオンなしのデフォルト設定です)。

    <web-client>
    <Authentication>Default</Authentication>
    <AuthHeader>REMOTE_USER</AuthHeader>
    </web-client>
    
    
  4. シングル・サインオン構成を次のように編集し、<SSO_HEADER_NAME>を、シングル・サインオン・システムで構成されている適切なヘッダーで置き換えます。

    <web-client>
    <Authentication>SSO</Authentication>
    <AuthHeader><SSO_HEADER_NAME></AuthHeader>
    </web-client>
    
    

    非ASCII文字ログインでのシングル・サインオンを有効化するには、非ASCIIヘッダー値をデコードするためのデコード・クラス名を指定する必要があります。デコード・クラス名を追加し、シングル・サインオン構成を次のように編集します。

    <web-client>
    <Authentication>SSO</Authentication>
    <AuthHeader><SSO_HEADER_NAME></AuthHeader>
    <AuthHeaderDecoder>com.thortech.xl.security.auth.CoreIDSSOAuthHeaderDecoder</AuthHeaderDecoder>
    </web-client>
    
    

    <SSO_HEADER_NAME>を、シングル・サインオン・システムで構成されている適切なヘッダーで置き換えます。

  5. アプリケーション・サーバーおよびWebサーバーの構成を変更して、シングル・サインオンを有効にします。これには各ベンダーのドキュメントを参照してください。

  6. アプリケーション・サーバーを再起動します。