8.3. 设置 HTTPS/SSL

流程

1. 编辑 standalone.xml、standalone-ha.xml 或 host.xml 文件，以使用密钥存储并启用 HTTPS。

2. 将密钥存储文件移到部署的 配置/ 目录中，或者您选择的位置或提供该文件的绝对路径。

   如果您使用绝对路径，请从您的配置中删除可选的 relative-to 参数(See 操作模式)。

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)

   如果使用域模式，应在每个主机中使用 /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)

   在独立或主机配置文件中，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>

4. 在独立或每个域配置文件中，搜索任何 安全域 实例。

5. 修改 https-listener 以使用创建的域：

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

   如果使用域模式，为命令添加与以下内容一起使用的配置集： /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>