手順

1. <business-application>.zip ファイルを展開して、<business-application>/<business-application>-service ディレクトリーに移動します。
2. テキストエディターで application.properties ファイルを開きます。

3. たとえば、以下のように REST エンドポイントのホスト、ポート、およびパスを設定します。

   server.address=localhost
   server.port=8090
   
   cxf.path=/rest

4. 以下のように、簡単に識別できるように KIE Server (kieserver) を設定します。

   kieserver.serverId=<business-application>-service
   kieserver.serverName=<business-application>-service
   kieserver.location=http://localhost:8090/rest/server
   kieserver.controllers=http://localhost:8080/decision-central/rest/controller

   以下の表で、ビジネスアプリケーションに設定可能な KIE Server のパラメーターを一覧で紹介します。

   表3.1 kieserver パラメーター

   パラメーター	値	説明
   kieserver.serverId	string	Decision Manager コントローラーに接続時にビジネスアプリケーションを識別するために使用する ID。
   kieserver.serverName	string	Decision Manager コントローラーへの接続時にビジネスアプリケーションを識別するのに使用する名前。kieserver.serverId パラメーターに使用した文字と同じものを使用できます。
   kieserver.location	URL	REST API を使用する他のコンポーネントがこのサーバーの場所を識別するために使用します。server.address および server.port で定義されている場所は使用しないでください。
   kieserver.controllers	URL	コントローラー URL のコンマ区切りリスト

5. ビジネスアプリケーションの作成時に Business Automation を選択した場合は、以下のコンポーネントの中から、ランタイムに起動するコンポーネントを指定します。

   表3.2 kieserver ケーパビリティーパラメーター

   パラメーター	値	説明
   kieserver.drools.enabled	true, false	Decision Manager コンポーネントを有効または無効にします。
   kieserver.dmn.enabled	true, false	DMN (Decision Model and Notation) コンポーネントを有効または無効にします。

手順

1. Red Hat シングルサインオン (SSO) をダウンロードし、インストールしている。Red Hat Single Sign-On スタートガイド を参照してください。

2. RH SSO を設定します。

   1. デフォルトのマスターレルムを使用するか、新しいレルムを作成します。
   2. springboot-app クライアントを作成して、パブリックに AccessType を追加します。

   3. 以下のように、ローカルの設定に合わせて有効なリダイレクト URI と Web オリジンを設定します。

      • 有効なリダイレクト URI: http://localhost:8090/*
      • Web オリジン: http://localhost:8090
   4. アプリケーションで使用するレルムロールを作成します。
   5. アプリケーションで使用するユーザーを作成してロールを割り当てます。

3. サービスプロジェクトの pom.xml ファイルに以下の依存関係を追加します。

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>org.keycloak.bom</groupId>
         <artifactId>keycloak-adapter-bom</artifactId>
         <version>${version.org.keycloak}</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>
   
     ....
   
   <dependency>
     <groupId>org.keycloak</groupId>
     <artifactId>keycloak-spring-boot-starter</artifactId>
   </dependency>

4. application.properties ファイルを更新します。

   # keycloak security setup
   keycloak.auth-server-url=http://localhost:8100/auth
   keycloak.realm=master
   keycloak.resource=springboot-app
   keycloak.public-client=true
   keycloak.principal-attribute=preferred_username
   keycloak.enable-basic-auth=true

5. DefaultWebSecurityConfig.java ファイルを変更して、RH SSO で Spring Security が正しく動作することを確認します。

   import org.keycloak.adapters.KeycloakConfigResolver;
   import org.keycloak.adapters.springboot.KeycloakSpringBootConfigResolver;
   import org.keycloak.adapters.springsecurity.authentication.KeycloakAuthenticationProvider;
   import org.keycloak.adapters.springsecurity.config.KeycloakWebSecurityConfigurerAdapter;
   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
   import org.springframework.security.config.annotation.web.builders.HttpSecurity;
   import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
   import org.springframework.security.core.authority.mapping.SimpleAuthorityMapper;
   import org.springframework.security.core.session.SessionRegistryImpl;
   import org.springframework.security.web.authentication.session.RegisterSessionAuthenticationStrategy;
   import org.springframework.security.web.authentication.session.SessionAuthenticationStrategy;
   
   @Configuration("kieServerSecurity")
   @EnableWebSecurity
   public class DefaultWebSecurityConfig extends KeycloakWebSecurityConfigurerAdapter {
   
       @Override
       protected void configure(HttpSecurity http) throws Exception {
           super.configure(http);
           http
           .csrf().disable()
           .authorizeRequests()
               .anyRequest().authenticated()
               .and()
           .httpBasic();
       }
   
       @Autowired
       public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception {
           KeycloakAuthenticationProvider keycloakAuthenticationProvider = keycloakAuthenticationProvider();
           SimpleAuthorityMapper mapper = new SimpleAuthorityMapper();
           mapper.setPrefix("");
           keycloakAuthenticationProvider.setGrantedAuthoritiesMapper(mapper);
           auth.authenticationProvider(keycloakAuthenticationProvider);
       }
   
       @Bean
       public KeycloakConfigResolver KeycloakConfigResolver() {
          return new KeycloakSpringBootConfigResolver();
       }
   
       @Override
       protected SessionAuthenticationStrategy sessionAuthenticationStrategy() {
           return new RegisterSessionAuthenticationStrategy(new SessionRegistryImpl());
       }
   }

手順

1. UserGroupCallback の別の実装を提供するには、以下のコードを、アプリケーションクラスに追加するか、@Configuration のアノテーションが付いた別のクラスに追加します。

   @Bean(name = "userGroupCallback")
   public UserGroupCallback userGroupCallback(IdentityProvider identityProvider) throws IOException {
       return new MyCustomUserGroupCallback(identityProvider);
   }

2. UserInfo の別の実装を提供するには、以下のコードを、アプリケーションクラスに追加するか、@Configuration のアノテーションが付いた別のクラスに追加します。

   @Bean(name = "userInfo")
   public UserInfo userInfo() throws IOException {
       return new MyCustomUserInfo();
   }

手順

1. <business-application>.zip ファイルを展開して、<business-application>/<business-application>-service ディレクトリーに移動します。
2. テキストエディターでサービスプロジェクト pom.xml ファイルを開きます。

3. サービスプロジェクトの pom.xml ファイルに以下の依存関係を追加して、このファイルを保存します。

   <dependency>
     <groupId>org.apache.cxf</groupId>
     <artifactId>cxf-rt-rs-service-description-swagger</artifactId>
     <version>3.2.6</version>
   </dependency>
   <dependency>
     <groupId>io.swagger</groupId>
     <artifactId>swagger-jaxrs</artifactId>
     <version>1.5.15</version>
     <exclusions>
       <exclusion>
         <groupId>javax.ws.rs</groupId>
         <artifactId>jsr311-api</artifactId>
       </exclusion>
     </exclusions>
   </dependency>

4. Swagger UI を有効にするには (任意)、以下の依存関係を pom.xml ファイルに追加して、このファイルを保存します。

   <dependency>
     <groupId>org.webjars</groupId>
     <artifactId>swagger-ui</artifactId>
     <version>2.2.10</version>
   </dependency>

5. テキストエディターで <business-application>/<business-application>-service/src/main/resources/application.properties ファイルを開きます。

6. Swagger サポートを有効にするには、以下の行を application.properties ファイルに追加します。

   kieserver.swagger.enabled=true

手順

1. <business-application>/<business-application>-service ディレクトリーに移動します。

2. 以下のコマンドの 1 つを実行します。

   表4.1 スタンドアロンの起動オプション

   コマンド	説明
   ./launch.sh clean install	(Linux または UNIX) スタンドアロンモードで起動します。
   ./launch.bat clean install	(Windows) スタンドアロンモードで起動します。
   ./launch.sh clean install -Pmysql	(Linux または UNIX ) MySQL データベースでアプリケーションを設定した場合に、スタンドアロンモードで起動します。
   ./launch.bat clean install -Pmysql	(Windows) MySQL データベースでアプリケーションを設定した場合に、スタンドアロンモードで起動します。
   ./launch.sh clean install -Ppostgres	(Linux または UNIX ) PostgreSQL データベースでアプリケーションを設定した場合に、スタンドアロンモードで起動します。
   ./launch.bat clean install -Ppostgres	(Windows) PostgreSQL データベースでアプリケーションを設定した場合に、スタンドアロンモードで起動します。

   clean install の引数で、Maven に、新規インストールをするように指示を出します。プロジェクトは、以下の順番に構築されます。

   • データモデル
   • ビジネスアセット

   • サービス

     スクリプトの初回実行時には、プロジェクトの依存関係がすべてダウンロードされるため、プロジェクトのビルドに時間がかかる場合があります。ビルドの最後に、アプリケーションが起動します。

3. 以下のコマンドを入力して、ビジネスアプリケーションにアクセスします。

   http://localhost:8090/

4. 認証情報 user/user または kieserver/kieserver1! を入力します。

手順

1. <business-application>/<business-application>-service ディレクトリーに移動します。

2. 以下のコマンドの 1 つを実行します。

   表4.2 管理起動オプション

   コマンド	説明
   ./launch-dev.sh clean install	(Linux または UNIX) 開発モードで起動します。
   ./launch-dev.bat clean install	(Windows) 開発モードで起動します。
   ./launch-dev.sh clean install -Pmysql	(Linux または UNIX ) MySQL データベースでアプリケーションを設定した場合に、開発モードで起動します。
   ./launch-dev.bat clean install -Pmysql	(Windows) MySQL データベースでアプリケーションを設定した場合に、開発モードで起動します。
   ./launch-dev.sh clean install -Ppostgres	(Linux または UNIX) postgreSQL データベースでアプリケーションを設定した場合に、開発モードで起動します。
   ./launch-dev.bat clean install -Ppostgres	(Windows) postgreSQL データベースでアプリケーションを設定した場合に、開発モードで起動します。

   clean install の引数で、Maven に、新規インストールをするように指示を出します。プロジェクトは、以下の順番に構築されます。

   • データモデル
   • ビジネスアセット

   • サービス

     スクリプトの初回実行時には、プロジェクトの依存関係がすべてダウンロードされるため、プロジェクトのビルドに時間がかかる場合があります。ビルドの最後に、アプリケーションが起動します。

3. 以下のコマンドを入力して、ビジネスアプリケーションにアクセスします。

   http://localhost:8090/

4. 認証情報 user/user または kieserver/kieserver1! を入力します。ビジネスアプリケーションを起動した後に、Decision Manager コントローラーと接続すると、Business Central の Menu → Deploy → Execution Servers に表示されます。