WildFly 25配置SSL证书报错：<security-realm>元素位置不被允许

我在WildFly 25中配置SSL证书时，修改了standalone.xml的以下内容：

<security-realms>
    <security-realm name="UndertowRealm">
         <server-identities>
             <ssl>
               <keystore path="certificate.jks" relative-to="/tools/wildfly/standalone/configuration" keystore-password="password" />
             </ssl>
         </server-identities>
     </security-realm>
</security-realms>

<server name="default-server">
    <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true"/>
    <https-listener name="https" security-realm="UndertowRealm"  socket-binding="https" ssl-context="applicationSSC" enable-http2="true"/>
    <host name="default-host" alias="localhost">
        <location name="/" handler="welcome-content"/>
        <http-invoker http-authentication-factory="application-http-authentication"/>
    </host>
</server>

启动时出现错误：

</security-realms>
 <security-realms>
 <security-realm name="UndertowRealm">
 ^^^^ 'security-realm' isn't an allowed element here

            Did you mean 'identity-realm'?

尝试将<security-realm>改为<identity-realm>后仍报同类错误，求解决。

问题根源 #

报错核心是配置节点位置错误：你要么重复创建了<security-realms>根节点，要么把<security-realm>放到了<security-realms>节点外部的非法位置。WildFly的XML配置有严格的层级要求，<security-realm>必须直接嵌套在已有的<security-realms>节点内部，不能独立存在或重复包裹。

修复步骤 #

1. 定位正确的节点位置：打开standalone.xml，找到文件中原本就存在的<security-realms>节点（通常包含ManagementRealm），不要自己新增一个。
2. 合并Realm配置：把你定义的<security-realm name="UndertowRealm">...</security-realm>直接插入到原有<security-realms>节点的内部，和其他security-realm同级。
3. 清理冲突属性：WildFly 25中，https-listener的security-realm和ssl-context属性二选一即可，同时设置会引发配置冲突，建议移除ssl-context="applicationSSC"。

修复后的配置片段示例：

<!-- 原有的security-realms节点，新增UndertowRealm -->
<security-realms>
    <!-- 保留原有ManagementRealm配置 -->
    <security-realm name="ManagementRealm">
        <authentication>
            <local default-user="$local" skip-group-loading="true"/>
            <properties path="mgmt-users.properties" relative-to="jboss.server.config.dir"/>
        </authentication>
        <authorization map-groups-to-roles="false">
            <properties path="mgmt-groups.properties" relative-to="jboss.server.config.dir"/>
        </authorization>
    </security-realm>
    <!-- 添加你的SSL Realm -->
    <security-realm name="UndertowRealm">
         <server-identities>
             <ssl>
               <!-- 用内置属性代替硬编码路径更可靠 -->
               <keystore path="certificate.jks" relative-to="jboss.server.config.dir" keystore-password="password" />
             </ssl>
         </server-identities>
     </security-realm>
</security-realms>

<!-- 修正后的https-listener配置 -->
<server name="default-server">
    <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true"/>
    <https-listener name="https" security-realm="UndertowRealm" socket-binding="https" enable-http2="true"/>
    <host name="default-host" alias="localhost">
        <location name="/" handler="welcome-content"/>
        <http-invoker http-authentication-factory="application-http-authentication"/>
    </host>
</server>

额外注意事项 #

• 推荐使用WildFly内置的jboss.server.config.dir属性，它自动指向standalone/configuration目录，避免硬编码路径带来的迁移问题。
• 确认certificate.jks文件已放置在standalone/configuration目录下，且配置的密码与密钥库密码完全一致。

内容的提问来源于stack exchange，提问作者Nirali Joshi