Red Hat Decision Manager のオンプレミスインストール

手順

1. ターミナルウインドウにおいて、インストーラー JAR ファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhdm-installer-7.0.0.GA.jar

   Copy to Clipboard
   注記

   Windows でインストーラーを実行する場合には、インストール時に管理者の認証情報を求められる場合があります。この要求を回避するには、インストールコマンドに izpack.mode=privileged オプションを追加します。

   java -Dizpack.mode=privileged -jar rhdm-installer-7.0.0.GA.jar

   Copy to Clipboard

   また、32 ビットの Java 仮想マシン上でインストーラーを実行している場合には、メモリー不足になる可能性があります。この問題を防ぐには、以下のコマンドを実行します。

   java -XX:MaxHeapSize=4g -jar rhdm-installer-7.0.0.GA.jar

   Copy to Clipboard
2. グラフィカルインストーラーにスプラッシュ画面と使用許諾契約書のページが表示されます。
3. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
4. Red Hat Decision Manager をインストールする Red Hat JBoss EAP 7.1 または Red Hat JBoss 3.1 Web Server with Tomcat 8 サーバーのホームを指定し、Next をクリックします。

5. インストールするコンポーネントを選択し、Next をクリックします。

   Decision Central を Red Hat JBoss 3.1 Web Server with Tomcat 8 上にインストールすることはできません。Decision Central をインストールできるのは Red Hat JBoss EAP だけです。ただし、Red Hat JBoss 3.1 Web Server with Tomcat 8 上に Decision Server コントローラーをインストールすることができます。コントローラーは、Decision Server を管理するために使用されます。複数の Decision Server インスタンスを管理する場合には、コントローラーをインストールしてください。

   注記

   Decision Central と Decision Server を同じサーバー上にインストールすることは可能です。ただし Red Hat では、実稼働環境では Decision Central と Decision Server を異なるサーバー上にインストールすることを推奨します。そのためには、インストーラーを 2 回実行します。

6. Decision Manager の admin ユーザーを作成し、Next をクリックします。

   注記

   必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を選択してください。たとえば、admin という名前のユーザーを作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

   ユーザー名とパスワードを書き留めておきます。Decision Central および Decision Server にアクセスする際に必要になります。

7. Component Installation ページで Next をクリックし、インストールを開始します。Component Installation ページに、インストールされるコンポーネントのリストが表示されます。
8. インストールが完了したら、Processing Finished ページで Next をクリックします。次のページに Installation has completed successfully というメッセージが表示されます。

9. 必要であれば、Generate Installation Script and Properties File をクリックしてインストールデータを XML ファイルに保存し、続いて Done をクリックします。このファイルを使用して、同じタイプのサーバー上に Red Hat Decision Manager を自動的にインストールすることができます。XML ファイルの installpath パラメーターを変更して、Red Hat Decision Manager をインストールする新しいサーバーのパスを指定しなければならない点に注意してください。XML ファイルを使用してインストールを実施するには、以下のコマンドを入力します。

   java -jar rhdm-installer-7.0.0.GA.jar <path-to-file>

   Copy to Clipboard

手順

1. ターミナルウインドウにおいて、インストーラーファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

   java -jar rhdm-installer-7.0.0.GA.jar -console

   Copy to Clipboard

   コマンドラインの対話プロセスが開始し、使用許諾契約書が表示されます。

   press 1 to continue, 2 to quit, 3 to redisplay.

   Copy to Clipboard

2. 使用許諾契約書を読んでから 1 を入力し、Enter キーを押して続行します。

   Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7.1 or Tomcat 8
   [/home/user/RHDM-7.0.0/jboss-eap-7.1]

   Copy to Clipboard

3. 既存の Red Hat JBoss EAP 7.1 または Red Hat JBoss Web Server 3.1 with Tomcat 8 システムの親ディレクトリーを入力します。

   インストーラーが、指定したインストール場所を確認します。1 を入力して確認し、続行します。

   注記

   Decision Manager と Decision Server を同じサーバー上にインストールすることは可能です。ただし Red Hat では、実稼働環境では Decision Central と Decision Server を異なるサーバー上にインストールすることを推奨します。

4. インストーラーの指示に従って、インストールを完了します。

   注記

   ユーザー名およびパスワードを作成する場合、指定したユーザー名が既存のロールタイトルまたはグループと競合しないようにしてください。たとえば、admin というロールがある場合、admin という名前のユーザーは作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字を使用することは できません。

   ユーザー名とパスワードを書き留めておきます。Decision Central および Decision Server にアクセスする際に必要になります。

5. インストールが完了すると、以下のメッセージが表示されます。

   Would you like to generate an automatic installation script and properties file?

   Copy to Clipboard
6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するよう求められます。
7. パスを入力するか、Enter キーを押して提案されたパスを了承します。

手順

1. rhdm-7.0.0.GA-decision-central-eap7-deployable.zip ファイルを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR としています。

2. TEMP_DIR/rhdm-7.0.0.GA-decision-central-eap7-deployable/jboss-eap-7.1 ディレクトリーの内容を EAP_HOME にコピーします。ファイルの上書きまたはディレクトリーのマージを確認されたら、はい を選択します。

   警告

   コピーする Red Hat Decision Manager デプロイメントの名前が Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

手順

1. ターミナルアプリケーションで EAP_HOME/bin ディレクトリーに移動します。

2. Decision Central および Decision Server へのログインに使用するユーザーを作成します。以下のコマンドの <username> および <password> を、ご自分で考えたユーザー名およびパスワードに置き換えます。

   $ ./add-user.sh -a --user <USERNAME>  --password <PASSWORD> --role kie-server,admin

   Copy to Clipboard
   注記

   必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、admin という名前のユーザーを作成しないでください。

   パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

3. ユーザー名とパスワードを書き留めておきます。

手順

1. Decision Central の EAP_HOME/standalone/configuration/standalone.xml ファイルにおいて、<system-properties> セクションの以下のプロパティーのコメントを解除し、<USERNAME> および <USER_PWD> を kie-server ロールを持つユーザーの認証情報に置き換えます。

      <property name="org.kie.server.user" value="<USERNAME>"/>
      <property name="org.kie.server.pwd" value="<USER_PWD>"/>

   Copy to Clipboard

2. Decision Server の EAP_HOME/standalone/configuration/standalone.xml ファイルにおいて、<system-properties> セクションの以下のプロパティーのコメントを解除します。

     <property name="org.kie.server.controller.user" value="<CONTROLLER_USER>"/>
     <property name="org.kie.server.controller.pwd" value="<CONTROLLER_PWD>"/>
     <property name="org.kie.server.id" value="<KIE_SERVER_ID>"/>
     <property name="org.kie.server.location" value="http://<HOST>:<PORT>/kie-server/services/rest/server"/>
     <property name="org.kie.server.controller" value="<CONTROLLER_URL>"/>

   Copy to Clipboard

3. このファイルで、以下の値を置き換えます。

   • <CONTROLLER_USER> および <CONTROLLER_PWD> を rest-all ロールを持つユーザーの認証情報に置き換える。
   • <KIE_SERVER_ID> を Decision Server システムの ID または名前に置き換える (例: rhdm700-decision-server-1)。
   • <HOST> を Decision Server ホストの ID または名前に置き換える (例: localhost または 192.7.8.9)。

   • <PORT> を Decision Server ホストのポートに置き換える (例: 8080)。

     注記

     org.kie.server.location プロパティーで Decision Server の場所を指定します。

   • <CONTROLLER_URL> を Decision Central に埋め込まれたコントローラーの URL に置き換える。Decision Server は、起動時にこの URL に接続されます。

     • インストーラーまたは Red Hat JBoss EAP zip ファイルを使用して Decision Central をインストールした場合、<CONTROLLER_URL> は以下のフォーマットになります。

       http://<HOST>:<PORT>/decision-central/rest/controller

     • standalone.jar ファイルを使用して Decision Central を実行している場合、<CONTROLLER_URL> は以下のフォーマットになります。

       http://<HOST>:<PORT>/rest/controller

手順

1. ターミナルアプリケーションで EAP_HOME/bin に移動します。

2. スタンドアロン設定を実行します。

   • Linux または UNIX ベースのシステムの場合:

     $ ./standalone.sh

     Copy to Clipboard

   • Windows の場合:

     standalone.bat

     Copy to Clipboard
     注記

     Red Hat JBoss EAP 上に Decision Central をデプロイせず Decision Server だけをデプロイした場合は、以下のコマンドのいずれかを使用して Red Hat JBoss EAP をスタンドアロン Full Profile で起動する必要があります。

     Linux または UNIX ベースのシステムの場合:

     $ /standalone.sh -c standalone-full.xml

     Copy to Clipboard

     Windows の場合:

     standalone.bat -c standalone-full.xml

     Copy to Clipboard
3. Web ブラウザーで URL localhost:8080/decision-central にアクセスします。
4. ユーザー名 rhdmAdmin およびパスワード password@1 を使用してログインします。

手順

1. Red Hat カスタマーポータル の「Software Downloads」ページで Red Hat Decision Manager 7.0.0 Add-On's の横の Download をクリックし、rhdm-7.0-controller-ee7.zip ファイルをダウンロードします。
2. rhdm-7.0.0.GA-add-ons.zip ファイルを展開します。rhdm-7.0-controller-ee7.zip ファイルは、展開したディレクトリーにあります。
3. rhdm-7.0-controller-ee7 アーカイブを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR としています。

4. TEMP_DIR/rhdm-7.0-controller-ee7/controller.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

   警告

   コピーするスタンドアロン Decision Server Controller デプロイメントの名前が Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

5. TEMP_DIR/rhdm-7.0-controller-ee7/SecurityPolicy/ ディレクトリーの内容を EAP_HOME/bin にコピーします。ファイルの上書きを確認されたら、はい を選択します。
6. EAP_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとスタンドアロン Decision Server Controller が自動的にデプロイされます。

手順

1. rhdm-7.0-controller-jws.zip アーカイブを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR としています。

2. TEMP_DIR/rhdm-7.0-controller-jws.zip/controller.war ディレクトリーを JWS_HOME/tomcat8/webapps ディレクトリーにコピーします。

   警告

   コピーする Red Hat Decision Manager デプロイメントの名前が Red Hat JBoss Web Server インスタンスの既存デプロイメントと競合しないことを確認します。

3. controller.war フォルダーから .war 拡張子を削除します。
4. TEMP_DIR/rhdm-7.0-controller-jws/SecurityPolicy/ ディレクトリーの内容を JWS_HOME/bin にコピーします。ファイルの上書きを確認されたら、はい を選択します。
5. JWS_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとスタンドアロン Decision Server Controller が自動的にデプロイされます。

6. JWS_HOME/tomcat8/conf/tomcat-users.xml ファイルに kie-server ロールおよびユーザーを追加します。以下の例で、<USERNAME> と <PASSWORD> はご自分で考えたユーザーとパスワードの組み合わせです。

   <role rolename="kie-server"/>
   <user username="<USER_NAME>" password="<PASSWORD>" roles="kie-server"/>

   Copy to Clipboard

7. Decision Server を実行しているインスタンスの JWS_HOME/tomcat8/bin ディレクトリーに、以下の内容で読み取り可能な setenv.sh ファイルを作成します。

   CATALINA_OPTS="-Xmx1024m -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true -Dorg.kie.server.controller.user=<CONTROLLER_USER> -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD> -Dorg.kie.server.id=<KIE_SERVER_ID> -Dorg.kie.server.location=http://<HOST>:<PORT>/kie-server/services/rest/server -Dorg.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller"

8. スタンドアロン Decision Server Controller を実行しているインスタンスの JWS_HOME/tomcat8/bin ディレクトリーに、以下の内容で読み取り可能な setenv.sh ファイルを作成します。

   CATALINA_OPTS="-Dorg.kie.server.user=<USERNAME> -Dorg.kie.server.pwd=<USER_PWD>"

9. スタンドアロン Decision Server Controller を起動するには、JWS_HOME/tomcat8/bin ディレクトリーからターミナルを開いて以下のコマンドのいずれかを入力します。

   • Linux または UNIX ベースのシステムの場合:

     $ ./startup.sh

     Copy to Clipboard

   • Windows の場合:

     startup.bat

     Copy to Clipboard
10. 数分後に JWS_HOME/tomcat8/logs ディレクトリーを確認し、エラーが発生していたら修正します。

11. Controller が Red Hat JBoss Web Server 上で動作していることを確認するには、以下のコマンドを入力します。このコマンドで、<CONTROLLER> および <CONTROLLER_PWD> を tomcat-users.xml ファイル内の値に置き換えます。このコマンドにより、Decision Server インスタンスに関する情報が出力されます。

    curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'

    Copy to Clipboard

手順

1. Maven プロジェクトを生成します。pom.xml ファイルは、Maven プロジェクトの作成時に自動的に生成されます。

2. pom.xml を編集して、追加の依存関係および新たなリポジトリーを追加します。

   プロジェクトのコンパイルおよびパッケージング時に、Maven がすべての JAR ファイルおよび依存関係にある JAR ファイル を Maven リポジトリーからダウンロードします。

手順

1. pom.xml で BOM を宣言します。以下に例を示します。

   例3.1 Red Hat Decision Manager 7.0.0 用の BOM

   <dependencyManagement>
    <dependencies>
     <dependency>
      <groupId>org.jboss.bom.rhdm</groupId>
      <artifactId>rhdm-platform-bom</artifactId>
      <version>7.0.0.Final-redhat-4</version>
      <type>pom</type>
      <scope>import</scope>
     </dependency>
    </dependencies>
   </dependencyManagement>
   <dependencies>
   <!-- Your dependencies -->
   </dependencies>

   Copy to Clipboard

2. プロジェクトに必要な依存関係を <dependencies> タグで宣言します。

   • 標準的な Red Hat ビジネス自動化プロジェクトでは、以下の依存関係を宣言します。

     埋め込まれた jBPM エンジン依存関係

     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <!-- Dependency needed for default WorkItemHandler implementations. -->
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-workitems-core</artifactId>
     </dependency>
     
     <!-- Logging dependency. You can use any logging framework compatible with slf4j. -->
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
       <version>${logback.version}</version>
     </dependency>
     
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>

     Copy to Clipboard

   • CDI を使用する Red Hat ビジネス自動化プロジェクトでは、以下の依存関係を宣言します。

     CDI 対応 jBPM エンジン依存関係

     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-kie-services</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.jbpm</groupId>
       <artifactId>jbpm-services-cdi</artifactId>
     </dependency>

     Copy to Clipboard

   • 標準的な Red Hat Decision Manager プロジェクトでは、以下の依存関係を宣言します。

     埋め込まれた Drools エンジン依存関係

     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
     </dependency>
     
     <!-- Dependency for persistence support. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-persistence-jpa</artifactId>
     </dependency>
     
     <!-- Dependencies for decision tables, templates, and scorecards.
     For other assets, declare org.drools:drools-workbench-models-* dependencies. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-decisiontables</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-templates</artifactId>
     </dependency>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-scorecards</artifactId>
     </dependency>
     
     <!-- Dependency for loading KJARs from a Maven repository using KieScanner. -->
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-ci</artifactId>
     </dependency>

     Copy to Clipboard

   • Decision Server を使用するには、以下の依存関係を宣言します。

     クライアントアプリケーション Decision Server 依存関係

     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>
     <dependency>
         <groupId>org.kie.server</groupId>
         <artifactId>kie-server-api</artifactId>
     </dependency>
     
     <!-- Dependency for Red Hat JBoss BRMS functionality. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-core</artifactId>
     </dependency>
     
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
     </dependency>

     Copy to Clipboard

   • Red Hat ビジネス自動化または Red Hat Decision Manager のリモートクライアントを作成するには、以下の依存関係を宣言します。

     クライアント依存関係

     <dependency>
       <groupId>org.uberfire</groupId>
       <artifactId>uberfire-rest-client</artifactId>
     </dependency>

     Copy to Clipboard

   • KJAR パッケージのアセットを使用するには、kie-maven-plugin を含める方法を推奨します。

     Kie Maven プラグイン

     <packaging>kjar</packaging>
     <build>
      <plugins>
       <plugin>
        <groupId>org.kie</groupId>
        <artifactId>kie-maven-plugin</artifactId>
        <version>7.0.0.Final-redhat-4</version>
        <extensions>true</extensions>
       </plugin>
      </plugins>
     </build>

     Copy to Clipboard

手順

1. Red Hat JBoss Developer Studio を起動します。
2. Help → Install New Software をクリックします。
3. Add をクリックして Add Repository メニューに入ります。
4. Name フィールドの横で名前を指定し、Location フィールドに https://devstudio.jboss.com/11/stable/updates/integration-stack/ の URL を追加します。
5. OK をクリックします。
6. 利用可能なオプションから JBoss Business Process and Rule Development 機能を選択して Next をクリックし、もう一度 Next をクリックします。
7. ライセンス内容を確認して、適切なラジオボタンを押してライセンス内容に同意し、Finish をクリックします。
8. インストールプロセスが終了したら、Red Hat JBoss Developer Studio を再起動します。

手順

1. Red Hat JBoss Developer Studio を起動します。
2. Drools ビューを開くには、Window → Open Perspective → Other の順にクリックし、Drools を選択し、特定のビューを選択して OK をクリックします。
3. Window → Show View → Other…​ の順にクリックし、Server → Servers を選択してサーバービューを追加します。
4. Servers パネルを右クリックし、New → Server を選択してサーバーメニューを開きます。
5. JBoss Enterprise Middleware → JBoss Enterprise Application Platform 7.1+ をクリックし、Next をクリックしてサーバーを定義します。

6. Browse ボタンをクリックしてホームディレクトリーを設定します。Red Hat Decision Manager をインストールした Red Hat JBoss EAP ディレクトリーに移動します。

   Red Hat Decision Manager サーバーを設定するには、Red Hat Decision Manager をインストールした Red Hat JBoss EAP ディレクトリーを選択します。

7. Name フィールドにサーバーの名前を指定して、設定ファイルが設定されていることを確認し、Finish をクリックします。

手順

1. Red Hat JBoss Developer Studio の Server タブからサーバーを選択し、Start アイコンをクリックして選択したサーバーを起動します。

2. セキュアシェルサーバーがまだ実行されていなければ、ターミナルに以下のコマンドを入力してサーバーを起動します。

   /sbin/service sshd start

   Copy to Clipboard
   注記

   このコマンドは、Linux および Apple Macintosh 固有のものです。これらのプラットフォームで sshd がすでに起動していると、このコマンドに失敗しますが、その場合はこのステップを無視しても問題ありません。

3. Red Hat JBoss Developer Studio で File → Import…​ を選択し、Git フォルダーに移動します。Git フォルダーを開き、Projects from Git を選択して Next をクリックします。
4. リポジトリーのソースに Clone URI を選択し、Next をクリックします。
5. 次のウィンドウで Git リポジトリーの詳細を入力して、次へ をクリックします。
6. 次のウインドウでインポートするブランチを選択し、Next をクリックします。
7. このプロジェクトのローカルストレージを定義するために、空ではないディレクトリーを入力 (または選択) して設定を変更し、Next をクリックします。
8. 次のウィンドウでプロジェクトを一般プロジェクトとしてインポートし、Next をクリックします。
9. このプロジェクトに名前を付け、Finish をクリックします。

手順

1. Server タブからサーバーを選択し、Start アイコンをクリックしてサーバーを起動します。
2. Red Hat JBoss Developer Studio で File → Import…​ を選択し、Git フォルダーに移動します。Git フォルダーを開き、Projects from Git を選択して Next をクリックします。
3. リポジトリーのソースに Existing local repository を選択し、Next をクリックします。
4. 使用可能なリポジトリーの一覧から設定するリポジトリーを選択し、Next をクリックします。
5. 表示されたダイアログウィンドウで、Wizard for project import グループから Import as general project ラジオボタンを選択し、Next をクリックします。
6. このプロジェクトに名前を付け、Finish をクリックします。

手順

1. Red Hat カスタマーポータルの「Software Downloads」セクションから RH-SSO をダウンロードします。

2. 基本的な RH-SSO のスタンドアロンサーバーをインストールして設定します。インストールおよび設定は、『Red Hat Single Sign On Getting Started Guide』の「Install and Boot」の章に記載された手順に従ってください。実稼働環境の設定については、Red Hat Single Sign On の『Server Administration Guide』を参照してください。

   注記

   同じシステム上で RH-SSO と Red Hat Decision Manager サーバーの両方を実行する場合には、以下の手段のいずれかによりポートの競合を避けてください。

   • 以下のように、RHSSO_HOME/standalone/configuration/standalone.xml ファイルを更新して、ポートのオフセットを 100 に設定する。

     <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:100}">

     Copy to Clipboard

   • 環境変数を使用してサーバーを実行する。

     bin/standalone.sh -Djboss.socket.binding.port-offset=100

     Copy to Clipboard

3. RH-SSO サーバーを起動し、RHSSO_HOME/bin から RH-SSO を設定します。

   ./standalone.sh

   Copy to Clipboard

   RH-SSO サーバーが起動したら、Web ブラウザーで http://localhost:8180/auth/admin にアクセスし、RH-SSO のインストール時に作成した管理者の認証情報を使用してログインします。初回のログイン時に、新規ユーザー登録フォームで初期ユーザーを設定することができます。

4. RH-SSO 管理コンソールで、Realm Settings メニューアイテムをクリックします。

5. Realm Settings ページで Add Realm をクリックします。

   Add realm ページが表示されます。

6. Add realm ページで、レルムの名前を指定して Create をクリックします。

7. Clients メニューアイテムをクリックし、Create をクリックします。

   Add Client ページが表示されます。

8. Add Client ページで、以下のようにレルム用の新規クライアント作成に必要な情報を指定します。

   • Client ID: kie
   • Client protocol: openid-connect
   • Root URL: http://localhost:8080/decision-central

9. Save をクリックして変更を保存します。

   作成した新規クライアントの Access Type は、デフォルトでは public に設定されています。この設定を confidential に変更します。

   この時点で、RH-SSO サーバーに Red Hat Decision Manager アプリケーションのレルムおよびクライアントが設定され、localhost:8180 で HTTP 接続をリッスンした状態で実行されます。このレルムは Red Hat Decision Manager アプリケーションに異なるユーザー、ロール、セッションを提供します。

手順

1. Install Red Hat JBoss EAP 7.1.

   See chapter Installing Red Hat JBoss EAP in the Red Hat JBoss Enterprise Application Platform Installation Guide.

2. 新規にインストールした Red Hat JBoss EAP ホームに Red Hat Decision Manager をインストールします。

   standalone.xml ファイルに変更を加えて RH-SSO アダプターを設定してから Red Hat Decision Manager を展開すると、RH-SSO アダプターの設定が上書きされて失われる可能性があります。

3. Red Hat カスタマーポータル から Red Hat JBoss EAP アダプターをダウンロードします。
4. アダプターを展開してインストールします。インストールの説明は、『Red Hat Single Sign On Securing Applications and Services Guide』の「JBoss EAP Adapter」セクションを参照してください。
5. Go to EAP_HOME/standalone/configuration and open the standalone.xml and standalone-full.xml files. Delete the <single-sign-on/> element from both of the files.

手順

1. Red Hat JBoss EAP システムの EAP_HOME/standalone/configuration ディレクトリーに移動し、standalone.xml ファイルを編集して RH-SSO サブシステム設定を追加します。以下に例を示します。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
    <secure-deployment name="decision-central.war">
      <realm>demo</realm>
      <realm-public-key>MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQAB</realm-public-key>
      <auth-server-url>http://localhost:8180/auth</auth-server-url>
      <ssl-required>external</ssl-required>
      <enable-basic-auth>true</enable-basic-auth>
      <resource>kie</resource>
      <credential name="secret">759514d0-dbb1-46ba-b7e7-ff76e63c6891</credential>
      <principal-attribute>preferred_username</principal-attribute>
    </secure-deployment>
   </subsystem>

   Copy to Clipboard

   この例で、

   • secure-deployment name は、アプリケーションの WAR ファイルの名前です。
   • realm は、使用するアプリケーション用に作成したレルムの名前です。
   • realm-public-key は、作成したレルムの公開鍵です。この鍵は、RH-SSO 管理コンソールで作成したレルムの Realm settings ページの Keys タブで確認することができます。realm-public-key の値を指定しない場合は、サーバーが自動的に取得します。
   • auth-server-url は、RH-SSO 認証サーバーの URL です。
   • enable-basic-auth は、クライアントがトークンベースと基本認証アプローチの両方を使用して要求を実行できるように、基本認証メカニズムを有効にする設定です。
   • resource は、作成したクライアントの名前です。
   • credential name は、作成したクライアントの秘密鍵です。この鍵は、RH-SSO 管理コンソールの Clients ページの Credentials タブで確認することができます。

   • principal-attribute は、ユーザーのログイン名です。この値を指定しないと、ユーザー名ではなくユーザー ID がアプリケーションに表示されます。

     注記

     RH-SSO サーバーは、ユーザー名を小文字に変換します。そのため、RH-SSO と統合した後には、Red Hat Decision Manager ではユーザー名が小文字で表示されます。ビジネスプロセスでユーザー名が大文字でハードコード化されている場合には、アプリケーションが大文字のユーザー名を識別できない場合があります。

2. EAP_HOME/bin/ に移動し、以下のコマンドを入力して Red Hat JBoss EAP サーバーを起動します。

   ./standalone.sh

   Copy to Clipboard

1. RH-SSO 管理コンソールにログインして、ユーザーを追加するレルムを開きます。

2. Manage セクションで Users メニューアイテムをクリックします。

   Users という名前の空のユーザー一覧のページが表示されます。

3. 空のユーザー一覧で Add User ボタンをクリックして、新規ユーザーの作成を開始します。

   Add user ページが表示されます。

4. Add user ページでユーザー情報を指定して、Save をクリックします。
5. Credentials タブで新規パスワードを設定します。

6. admin または analyst ロールなど、Red Hat Decision Manager へのアクセスが許可されるロールの 1 つを新規ユーザーに割り当てます。

   Roles セクションの Realm Roles タブで、このロールをレルムロールとして定義します。

7. Users ページの Role Mappings タブをクリックしてロールを割り当てます。

手順

1. アプリケーションデプロイメント記述子ファイル (WEB-INF/web.xml) を開き、以下の変更を加えます。

   • 以下の行を削除して、org.uberfire.ext.security.server.BasicAuthSecurityFilter クラスのサーブレットフィルターとマッピングを削除します。

     <filter>
       <filter-name>HTTP Basic Auth Filter</filter-name>
       <filter-class>org.uberfire.ext.security.server.BasicAuthSecurityFilter</filter-class>
       <init-param>
         <param-name>realmName</param-name>
         <param-value>KIE Workbench Realm</param-value>
       </init-param>
     </filter>
     
     <filter-mapping>
       <filter-name>HTTP Basic Auth Filter</filter-name>
       <url-pattern>/rest/*</url-pattern>
       <url-pattern>/maven2/*</url-pattern>
       <url-pattern>/ws/*</url-pattern>
     </filter-mapping>

     Copy to Clipboard

   • 以下の行を追加して、フィルターマッピングから削除した url-patterns の security-constraint を追加します。

     <security-constraint>
       <web-resource-collection>
         <web-resource-name>remote-services</web-resource-name>
         <url-pattern>/rest/*</url-pattern>
         <url-pattern>/maven2/*</url-pattern>
         <url-pattern>/ws/*</url-pattern>
       </web-resource-collection>
       <auth-constraint>
         <role-name>rest-all</role-name>
         <role-name>rest-project</role-name>
         <role-name>rest-deployment</role-name>
         <role-name>rest-process</role-name>
         <role-name>rest-process-read-only</role-name>
         <role-name>rest-task</role-name>
         <role-name>rest-task-read-only</role-name>
         <role-name>rest-query</role-name>
         <role-name>rest-client</role-name>
       </auth-constraint>
     </security-constraint>

     Copy to Clipboard
2. 変更を保存します。

手順

1. http://localhost:8080/auth/admin から RH-SSO 管理コンソール に移動します。
2. Clients をクリックします。

3. 以下の設定で新規クライアントを作成します。

   • Client ID は kie-git に設定します。
   • Access Type は confidential に設定します。
   • Standard Flow Enabled オプションを無効化します。
   • Direct Access Grants Enabled オプションを有効化します。
   
4. Save をクリックします。
5. クライアント設定画面上部にある Installation タブをクリックして、Format Option に Keycloak OIDC JSON を選択します。
6. Download をクリックします。

7. ダウンロードした JSON ファイルを、サーバーのファイルシステム内でアクセス可能なディレクトリーに移動するか、アプリケーションクラスパスに追加します。

   詳しい情報は、Keycloak の『Securing Applications and Services Guide』の「JAAS plugin」の章を参照してください。

手順

1. 以下のライブラリーが WEB-INF/lib ディレクトリーにあることを確認します。

   uberfire-security-management-api-<latest_artifact_version>.jar
   uberfire-security-management-backend-<latest_artifact_version>.jar
   uberfire-security-management-keycloak-<latest_artifact_version>.jar
   keycloak-core-<latest_artifact_version>.jar
   keycloak-common-<latest_artifact_version>.jar

   Copy to Clipboard

2. サードパーティーセキュリティー JAR ファイルを削除します。以下に例を示します。

   uberfire-security-management-wildfly-<latest_artifact_version>.jar
   uberfire-security-management-tomcat-<latest_artifact_version>.jar

   Copy to Clipboard

3. WEB-INF/classes/security-management.properties ファイルの内容全体を、以下の内容に置き換えます。

   org.uberfire.ext.security.management.api.userManagementServices=KCCredentialsUserManagementService
   org.uberfire.ext.security.management.keycloak.authServer=http://localhost:8081/auth
   org.uberfire.ext.security.management.keycloak.realm=demo
   org.uberfire.ext.security.management.keycloak.user=admin
   org.uberfire.ext.security.management.keycloak.password=admin
   org.uberfire.ext.security.management.keycloak.clientId=kie
   org.uberfire.ext.security.management.keycloak.clientSecret=759514d0-dbb1-46ba-b7e7-ff76e63c6891

   Copy to Clipboard
   注記

   WEB-INF/classes/security-management.properties ファイルが存在しない場合は、そのファイルを作成します。

4. /META-INF/jboss-deployment-structure.xml ファイルにおいて、以下の依存関係および除外を編集します。

   <dependencies>
       <module name="org.jboss.resteasy.resteasy-jackson-provider" services="import"/>
   </dependencies>
   <exclusions>
       <module name="org.jboss.resteasy.resteasy-jackson2-provider"/>
   </exclusions>

   Copy to Clipboard

手順

1. RH-SSO 管理コンソールで作成したセキュリティーレルムを開きます。

2. Clients メニューアイテムをクリックし、Create をクリックします。

   Add Client ページが表示されます。

3. Add Client ページで、以下のようにレルム用の新規クライアント作成に必要な情報を指定します。

   • Client ID: kie-execution-server
   • Root URL: http://localhost:8080/kie-server
   • Client protocol: openid-connect

4. Save をクリックして変更を保存します。

   新規クライアントの Access Type は、デフォルトでは public に設定されています。この設定を confidential に変更して、もう一度 Save をクリックします。

5. Credentials タブに移動して秘密鍵をコピーします。秘密鍵は、次のセクションで kie-execution-server クライアントを設定するのに必要です。

手順

1. Red Hat JBoss EAP システムの EAP_HOME/standalone/configuration に移動し、standalone.xml ファイルを編集して RH-SSO サブシステム設定を追加します。以下に例を示します。

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
     <secure-deployment name="kie-execution-server.war">
        <realm>demo</realm>
        <realm-public-key>MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQAB</realm-public-key>
        <auth-server-url>http://localhost:8180/auth</auth-server-url>
        <ssl-required>external</ssl-required>
        <resource>kie-execution-server</resource>
        <enable-basic-auth>true</enable-basic-auth>
        <credential name="secret">03c2b267-7f64-4647-8566-572be673f5fa</credential>
        <principal-attribute>preferred_username</principal-attribute>
     </secure-deployment>
   </subsystem>
   
   <system-properties>
     <property name="org.kie.server.sync.deploy" value="false"/>
   </system-properties>

   Copy to Clipboard

   この例で、

   • secure-deployment name は、アプリケーションの WAR ファイルの名前です。
   • realm は、使用するアプリケーション用に作成したレルムの名前です。
   • realm-public-key は、作成したレルムの公開鍵です。この鍵は、RH-SSO 管理コンソールで作成したレルムの Realm settings ページの Keys タブで確認することができます。この公開鍵の値を指定しない場合は、サーバーが自動的に取得します。
   • auth-server-url は、RH-SSO 認証サーバーの URL です。
   • resource は、作成したサーバークライアントの名前です。
   • enable-basic-auth は、クライアントがトークンベースと基本認証アプローチの両方を使用して要求を実行できるように、基本認証メカニズムを有効にする設定です。
   • credential name は、作成したサーバークライアントの秘密鍵です。この鍵は、RH-SSO 管理コンソールの Clients ページの Credentials タブで確認することができます。
   • principal-attribute は、ユーザーのログイン名です。この値を指定しないと、ユーザー名ではなくユーザー ID がアプリケーションに表示されます。
2. standalone.xml ファイルに加えた設定変更を保存します。

3. 以下のコマンドを使用し、Red Hat JBoss EAP サーバーを再起動して Decision Server を実行します。

   EXEC_SERVER_HOME/bin/standalone.sh -Dorg.kie.server.id=<ID> -Dorg.kie.server.user=<USER> -Dorg.kie.server.pwd=<PWD> -Dorg.kie.server.location=<LOCATION_URL> -Dorg.kie.server.controller=<CONTROLLER_URL> -Dorg.kie.server.controller.user=<CONTROLLER_USER> -Dorg.kie.server.controller.pwd=<CONTOLLER_PASSWORD>

   Copy to Clipboard

   以下に例を示します。

   EXEC_SERVER_HOME/bin/standalone.sh -Dorg.kie.server.id=kieserver1 -Dorg.kie.server.user=kieserver -Dorg.kie.server.pwd=password -Dorg.kie.server.location=http://localhost:8080/kie-execution-server/services/rest/server -Dorg.kie.server.controller=http://localhost:8080/decision-central/rest/controller -Dorg.kie.server.controller.user=kiecontroller -Dorg.kie.server.controller.pwd=password

   Copy to Clipboard

4. Decision Server を実行したら、サーバーの状態を確認することができます。以下のコマンドの kieserver は kie-server ロールのユーザー名で、パスワードは password です。

   curl http://kieserver:password@localhost:8080/kie-execution-server/services/rest/server/

   Copy to Clipboard

手順

1. トークンを使用して Decision Server を管理するように Red Hat Decision Manager を設定するには、org.kie.server.token プロパティーを設定します。
2. org.kie.server.user および org.kie.server.pwd プロパティーは設定しないでください。これで、Red Hat Decision Manager は Authorization: Bearer $TOKEN 認証方法を使用します。

手順

1. トークンベースの認証を用いて REST API を使用する場合は、org.kie.server.controller.token プロパティーを設定します。
2. org.kie.server.controller.user および org.kie.server.controller.pwd プロパティーは設定しないでください。

手順

1. RH-SSO 管理コンソールで Clients メニューアイテムをクリックし、Create をクリックして新規クライアントを作成します。

   Add Client ページが表示されます。

2. Add Client ページで、以下のようにレルム用の新規クライアント作成に必要な情報を指定します。

   • Client ID: kie-remote
   • Client protocol: openid-connect
3. Save をクリックして変更を保存します。

4. Realm Settings でトークンの設定を変更します。

   1. RH-SSO 管理コンソールで、Realm Settings メニューアイテムをクリックします。
   2. Tokens タブをクリックします。

   3. Access Token Lifespan の値を 15 分に変更します。

      このように設定することで、トークンを取得してから失効するまでに十分な余裕をもってサービスを呼び出すことができます。

   4. Save をクリックして変更を保存します。

5. リモートクライアントの公開クライアントを作成したら、以下のコマンドを使用して、RH-SSO サーバーのトークンエンドポイントに対して HTTP 要求を行いトークンを取得することができます。

   RESULT=`curl --data "grant_type=password&client_id=kie-remote&username=admin&password=password" http://localhost:8180/auth/realms/demo/protocol/openid-connect/token`

   Copy to Clipboard

   上記のコマンドは、RH-SSO ユーザーで実行してください。詳しい情報は「新規ユーザーの追加」を参照してください。

6. RH-SSO サーバーから取得したトークンを表示するには、以下のコマンドを使用します。

   TOKEN=`echo $RESULT | sed 's/.*access_token":"//g' | sed 's/".*//g'`

   Copy to Clipboard