8.3. HTTPS/SSL の設定

手順

1. キーストアを使用し、HTTPS を有効にするには、standalone.xml ファイル、standalone-ha.xml ファイル、または host.xml ファイルを編集する必要があります。

2. キーストアファイルをデプロイメントの configuration/ ディレクトリーに移動するか、選択した場所のファイルに移動して、そのファイルへの絶対パスを指定することができます。

   絶対パスを使用している場合は、設定から任意の relative-to パラメーターを削除します (操作モード を参照してください)。

3. CLI を使用して新しい security-realm 要素を追加します。

   $ /core-service=management/security-realm=UndertowRealm:add()
   
   $ /core-service=management/security-realm=UndertowRealm/server-identity=ssl:add(keystore-path=keycloak.jks, keystore-relative-to=jboss.server.config.dir, keystore-password=secret)

   Copy to Clipboard Toggle word wrap

   ドメインモードを使用する場合、コマンドは /host=<host_name>/ 接頭辞を使用するすべてのホストで実行する必要があります (すべてのホストで security-realm を作成するため)。これは、ホストごとに繰り返す例です。

   $ /host=<host_name>/core-service=management/security-realm=UndertowRealm/server-identity=ssl:add(keystore-path=keycloak.jks, keystore-relative-to=jboss.server.config.dir, keystore-password=secret)

   Copy to Clipboard Toggle word wrap

   スタンドアロンまたはホスト設定ファイルでは、security-realms 要素は以下のようになります。

   <security-realm name="UndertowRealm">
       <server-identities>
           <ssl>
               <keystore path="keycloak.jks" relative-to="jboss.server.config.dir" keystore-password="secret" />
           </ssl>
       </server-identities>
   </security-realm>

   Copy to Clipboard Toggle word wrap
4. スタンドアロンまたは各ドメイン設定ファイルで security-realm のインスタンスを検索します。

5. 作成したレルムを使用するように https-listener を変更します。

   $ /subsystem=undertow/server=default-server/https-listener=https:write-attribute(name=security-realm, value=UndertowRealm)

   Copy to Clipboard Toggle word wrap

   ドメインモードを使用している場合は、コマンドの前に /profile=<profile_name>/ で使用されている使用されるプロファイルを付けます。

   生成される要素である server name="default-server" (subsystem xmlns="urn:jboss:domain:undertow:12.0" の子要素) には以下のスタンザを含める必要があります。

   <subsystem xmlns="urn:jboss:domain:undertow:12.0">
      <buffer-cache name="default"/>
      <server name="default-server">
         <https-listener name="https" socket-binding="https" security-realm="UndertowRealm"/>
      ...
   </subsystem>

   Copy to Clipboard Toggle word wrap