手順2.1 インストール

1. インストールするパッケージをダウンロードします。

   Red Hat カスタマーポータルから希望の JBoss Enterprise SOA Platform パッケージバージョンをダウンロードします。
   (利用可能な各種バージョンについては 「ダウンロード」 を参照してください。)

2. zip ファイルの整合性を検証します。

   ダウンロードしたパッケージの zip ファイルに checksum 検証を実行します。ファイルが破損あるいは変更されていないよう確認するためです。方法は 付録C ダウンロードしたファイルの検証 を参照してください。

3. インストールディレクトリを展開します。

   ZIP ファイルには、installation directory と呼ばれるディレクトリが１つ含まれています。このディレクトリを ZIP ファイルからインストールしたい場所に展開します。
   (SOA Platform パッケージでは、これは jboss-soa-p-5 ディレクトリと呼ばれ、Standalone 版では jboss-soa-p-standalone-5 ディレクトリと呼ばれます)。
   このディレクトリにはアプリケーションサーバーファイルが含まれており、SOA Root ディレクトリとして参照されます。

   注記

   本書では、このディレクトリはプレースホルダー SOA_ROOT という名前で呼ばれます。

4. インストレーションが完了しました。

   JBoss Enterprise SOA Platform がインストールされ、次に設定をする必要があります。
   設定方法については 「設定」 を参照してください。
   サーバー起動方法については 3章操作 を参照してください。

手順2.5 サーバー上でのシリアル化署名の設定

1. $JBOSS_HOME ディレクトリを定義します。
2. $JBOSS_HOME ディレクトリに移動し、keytool コマンドを実行しプライベートキーストアを作成します。

   keytool -genkey -alias droolsKey -keyalg RSA -keystore MyDroolsPrivateKeyStore.keystore
   Enter keystore password:  
   Re-enter new password: 
   What is your first and last name?
     [Unknown]:  Test User
   What is the name of your organizational unit?
     [Unknown]:  HR
   What is the name of your organization?
     [Unknown]:  Test Org
   What is the name of your City or Locality?
     [Unknown]:  Brisbane
   What is the name of your State or Province?
     [Unknown]:  QLD
   What is the two-letter country code for this unit?
     [Unknown]:  AU
   Is CN=Test User, OU=DroolsHR, O=Test Org, L=Brisbane, ST=QLD, C=AU correct?
     [no]:  yes
   Enter key password for droolsKey
        (RETURN if same as keystore password):  
   Re-enter new password:
   

   すべての質問に答えたあと、MyDroolsPrivateKeyStore.keystore という名前のパスワード保護ファイルが作成されます。このキーストアファイルには、droolsのパスワードを持つ droolsKey と呼ばれるプライベートキーが含まれています。このファイルをお使いの環境内で安全な場所に置きます。これ以降、その場所を$keystoredirと参照することにします。

   重要

   上記のパスワードは例示を目的としており、実稼働環境で利用しないでください。
3. JBoss Rules シリアル化セキュリティ機能を利用するようにサーバーを設定するには、以下のように $JBOSS_HOME/server/$config/deploy/properties-service.xml ファイルを編集します。

     <mbean code="org.jboss.varia.property.SystemPropertiesService"  name="jboss:type=Service,name=SystemProperties">
       <attribute name="Properties">
         # Drools Security Serialization specific properties
         drools.serialization.sign=true
         drools.serialization.private.keyStoreURL=file://$keystoredir/MyDroolsPrivateKeyStore.keystore
         drools.serialization.private.keyStorePwd=drools
         drools.serialization.private.keyAlias=droolsKey
         drools.serialization.private.keyPwd=drools
       </attribute>
     </mbean>
   

4. drools.serialization.sign property を true に設定します。

       drools.serialization.sign=true
       
   
   

   drools.serialization.private.keyStoreURL=lt&;URL> はプライベートキーストアの場所の URL です。
   上記の例では、$keystoredir と MyDroolsKeyStore.keystore をお使いのキーストアディレクトリと手順１で keytool を使い作成したキーストアの名前で置き換えてください。
   drools.serialization.private.keyStorePwd=<password> は、プライベートストアにアクセスするパスワードです。drools.serialization.private.keyAlias=<key> はプライベートキーのキーエイリアス (識別子) です。key.
   drools.serialization.private.keyPwd=<password> はプライベートキーのパスワードです。
5. サーバーインスタンスを再起動します。

   警告

   手順２のシステムプロパティが正しく設定されていない場合、パッケージをビルドする際に以下のようなエラーが発生します。

   An error occurred building the package.
   
   Error
   signing object store: Key store with private key not configured. Please
   configure it properly before using signed serialization
   

   注記

   設定をテストできる既存のルールあるいはパッケージがない場合、作成方法についてはJBoss Rules 5 リファレンスガイドを参照してください。

手順2.6 クライアント設定

1. 以前のプロセスの最初に作成したプライベートキーストアから公開鍵証明書を作成します。

   keytool -export -alias droolsKey -file droolsKey.crt -keystore MyDroolsPrivateKeyStore.keystore 
   Enter keystore password:  
   Certificate stored in file <droolsKey.crt>
   

2. 公開鍵証明書をパブリックキーストアにインポートします (これがクライアントアプリケーションが利用する場所です)。

   keytool -import -alias droolsKey -file droolsKey.crt -keystore MyPublicDroolsKeyStore.keystore
   Enter keystore password:  
   Re-enter new password: 
   Owner: CN=Test User, OU=Dev, O=XYZ Corporation, L=Brisbane, ST=QLD, C=AU
   Issuer: CN=Test User, OU=Dev, O=XYZ Corporation, L=Brisbane, ST=QLD, C=AU
   Serial number: 4ca0021b
   Valid from: Sun Sep 26 22:31:55 EDT 2010 until: Sat Dec 25 21:31:55 EST 2010
   Certificate fingerprints:
        MD5:  31:1D:1B:98:59:CC:0E:3C:3F:57:01:C2:FE:F2:6D:C9
        SHA1: 4C:26:52:CA:0A:92:CC:7A:86:04:50:53:80:94:2A:4F:82:6F:53:AD
        Signature algorithm name: SHA1withRSA
        Version: 3
   Trust this certificate? [no]:  yes
   Certificate was added to keystore
   

3. 以下のパブリックプロパティ２つをお使いのサーバーの$JBOSS_HOME/server/$config/deploy/properties-service.xml ファイルに追加します。$keystoredir および MyPublicDroolsKeyStore.keystore の部分は、手順２で作成したキーストアディレクトリ、そしてパブリックキーストア名で置き換えてください。

   # Drools Client Properties for Security Serialization
   drools.serialization.public.keyStoreURL=file://$keystoredir/MyPublicDroolsKeyStore.keystore
   drools.serialization.public.keyStorePwd=drools
   

4. サーバーインスタンスを再起動します。
5. Java クライアントアプリケーションについては、コードのシステムプロパティを以下のように設定します。

   // Set the client properties to de-serialise the signed packages
   URL clientKeyStoreURL = getClass().getResource( "MyPublicDroolsKeyStore.keystore" );
   System.setProperty( KeyStoreHelper.PROP_SIGN,
                               "true" );
   System.setProperty( KeyStoreHelper.PROP_PUB_KS_URL,
                               clientKeyStoreURL.toExternalForm() );
   System.setProperty( KeyStoreHelper.PROP_PUB_KS_PWD,
                               "drools" );
   ...
   

   注記

   他にもセキュリティプロパティを設定する方法があります。それは、$JBOSS_HOME/bin/run.sh スクリプトのJAVA_OPTS 部分に以下のプロパティを追加します。

   ...
   # Serialization Security Settings
   JAVA_OPTS="-Ddrools.serialization.sign=true $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.private.keyStoreURL=file://$keystoredir/MyDroolsKeyStore.keystore $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.private.keyStorePwd=drools $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.private.keyAlias=droolsKey $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.private.keyPwd=drools $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.public.keyStoreURL=file://$keystoredir/MyPublicDroolsKeyStore.keystore $JAVA_OPTS"
   JAVA_OPTS="-Ddrools.serialization.public.keyStorePwd=drools $JAVA_OPTS"
   ...
   

   上記の値をお使いの環境に固有のものに置き換え、サーバーインスタンスを再起動してください。

手順2.7 シリアル化署名の無効化

1. 署名を無効にし以前のセキュリティレベルの低い動作をリストアするには、/WEB-INF/classes/preferences.properties ファイルか、 $JBOSS_HOME/server/$config/deploy/properties-service.xml ファイルから drools.serialization.sign プロパティの定義を削除します。

   注記

   他の署名を無効にする方法は、$JBOSS_HOME/bin/run.sh に以下を設定します。

   JAVA_OPTS="-Ddrools.serialization.sign=false $JAVA_OPTS"
   

2. サーバーインスタンスを再起動します。

   注記

   Java クライアントアプリケーションの署名を無効にするには、drools.serialization.sign プロパティを削除するか、以下のスニペットを各アプリケーションのコードに追加します。

   System.setProperty( KeyStoreHelper.PROP_SIGN,
                               "false" );
   

1. コネクター設定をserver.xml ファイル ($config/deploy/jbossweb-tomcat5x.sar アーカイブの中にあります。) に追加します。

         <!-- SSL/TLS Connector with encrypted keystore password configuration  -->
         <Connector port="9943" address="${jboss.bind.address}"
              maxThreads="100" minSpareThreads="5" maxSpareThreads="15"
              scheme="https" secure="true" clientAuth="true"
            sslProtocol = "TLS" 
            securityDomain="java:/jaas/encrypt-keystore-password"
            SSLImplementation="org.jboss.net.ssl.JBossImplementation" ></Connector>
   
   

   注記

   Connector port を違う値に変えてみましょう。
2. deploy/security-service.xml ファイルの JaasSecurityDomain に定義を渡します。

      <mbean code="org.jboss.security.plugins.JaasSecurityDomain"
         name="jboss.security:service=PBESecurityDomain">
         <constructor>
            <arg type="java.lang.String" value="encrypt-keystore-password"></arg>
         </constructor>
         <attribute name="KeyStoreURL">resource:localhost.keystore</attribute>
         <attribute name="KeyStorePass">{CLASS}org.jboss.security.plugins.FilePassword:${jboss.server.home.dir}/conf/keystore.password</attribute>
         <attribute name="Salt">redhatjboss</attribute>
         <attribute name="IterationCount">16</attribute>
      </mbean>
   
   

   注記

   salt と iteration count 変数を使い、暗号化パスワードの強度を定義します。これらの変数を使い暗号化パスワードを生成します。値の変更も可能ですが、salt の長さは 8 文字以上にしてください。

   注記

   キーストアは conf/localhost.keystore に保存されています。keystore.password は、conf ディレクトリに置かれている暗号化パスワードで、次のステップで生成されます。
3. $config/conf に移動し次のコマンドを実行します。 java -cp ../lib/jbosssx.jar org.jboss.security.plugins.FilePassword redhatjboss 16 unit-tests-server keystore.password

   注記

   redhatjboss が salt で 16 が iteration count とします。unit-tests-server は、お使いのキーストアのパスワードです。また、keystore.password は暗号化パスワードが保存されているファイルです。
4. JaasSecurityDomain MBean を使うには Tomcat Service MBean を設定します。これは Tomcat Connector は jboss.security:service=PBESecurityDomain のあとに起動する必要があるためです。
5. 以下のタグを deploy/jbossweb-tomcat5x.sar/META-INF/jboss-service.xml ファイルのあとに追加します。

   ...
         <depends>jboss.security:service=PBESecurityDomain</depends>
      </mbean>
   </server>