跳到主要内容
安装配置教程

JBoss 强制 HTTPS 怎么配?EAP 7.4/WildFly 31 的 web.xml 与代理重定向

jboss 强制https — JBoss 强制 HTTPS 怎么配?EAP 7.4/WildFly 31 的 web.xml 与代理重定向
核心结论

jboss 强制https 的最小改动是给 WAR 的 web.xml 加 CONFIDENTIAL,Undertow 会把 http://host:8080 的请求 302 到 https://host:8443,默认 https socket-binding 端口是 8443。 若前置 Nginx/ALB,必须在 http-listener 上设 proxy-address-forwarding=true 并传 X-Forwarded-Proto: https,否则容易 302 循环;该属性默认 false。 只改一个 WAR 用 web.xml;全站边缘跳转用 Nginx return 301 https://$host$request_uri,JBoss 侧保留 redirect-socket=https 作为兜底。 验证用 curl -I http://127.0.0.1:8080/ 看 HTTP/1.1 302 与 Location: https://...:8443/,再用 openssl s_client -connect 127.0.0.1:8443 -servername example.com -tls1_3 看证书链。 常见坑:空 会 403;X-Forwarded-Proto 丢失会 ERR_TOO_MANY_REDIRECTS;HTTP 请求打到 8443 会 SSL_ERROR_RX_RECORD_TOO_LONG。

jboss 强制https 为什么没生效?先看 8080/8443 双监听器与 transport-guarantee 判定链路

先说结论:只把证书装进 keystore 并不会关掉 8080。JBoss EAP 7.4 的 standalone-full.xml 默认同时启用 http-listener=default(绑定 socket-binding=http,端口 8080)和 https-listener=https(绑定 socket-binding=https,端口 8443),两者互不影响。这是”jboss 强制https 配了却没生效”最常见的第一个原因——应用照样能通过明文端口访问。先确认进程到底监听了什么:

# 适用 EAP 7.x / WildFly 2x+,在运行实例的宿主机执行
ss -lntp | grep -E ':(8080|8443|443)b'
# 典型输出:证书装好了,8080 依然在
# LISTEN 0 100 *:8080 *:* users:(("java",pid=2311,fd=...))
# LISTEN 0 100 *:8443 *:* users:(("java",pid=2311,fd=...))

# 用管理 CLI 读取两个监听器的真实属性(不要靠猜默认值)
/opt/eap/bin/jboss-cli.sh -c --commands=
"/subsystem=undertow/server=default-server/http-listener=default:read-resource(include-runtime=true),
/socket-binding-group=standard-sockets/socket-binding=https:read-attribute(name=port)"
# 关键返回:redirect-socket => https, proxy-address-forwarding => false, port => 8443

第二层是 web.xml 里的 transport-guarantee,它属于 Servlet 3.1/4.0 的 user-data-constraint,合法值只有 NONE、INTEGRAL、CONFIDENTIAL,默认 NONE。据 Servlet 4.0 规范(JSR 369)第 13 章,CONFIDENTIAL 表示”数据在传输中必须防止被其他实体观察”,Undertow 在 Servlet 容器层检查 exchange.isSecure(),不满足就返回 302 并把 Location 指向安全端口。注意 web-app 的 version 必须是 3.1 或 4.0,写 2.5 会被当成旧语义解析:

<!-- src/main/webapp/WEB-INF/web.xml -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         version="4.0"> <!-- 必须 3.1+,否则约束语义不完整 -->
  <security-constraint>
    <web-resource-collection>
      <web-resource-name>all</web-resource-name>
      <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <user-data-constraint>
      <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
  </security-constraint>
</web-app>

第三层是跳转目标从哪来。Undertow 不硬编码 8443,它读 http-listener 的 redirect-socket 属性(默认值就是字符串 https),再解析成 socket-binding name="https" 的 port。据 Red Hat JBoss EAP 7.4 配置指南,该属性默认指向 https;WildFly 31 的 Undertow 子系统(urn:jboss:domain:undertow:14.0)同样保留它。所以想把端口换成 443,只改监听器无效,必须改 socket-binding,否则跳转仍回 8443:

# 让 socket-binding 的端口变成 443(Linux 下非 root 需 CAP_NET_BIND_SERVICE)
/socket-binding-group=standard-sockets/socket-binding=https:write-attribute(name=port,value=443)
# 反向代理场景:必须显式打开代理头解析,默认 false
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=true)
# 改完 reload,不是 restart
:reload

反代场景是”jboss 强制https”翻车的重灾区。Nginx/ALB 终止 TLS 后,JBoss 看到的是一条普通 HTTP 连接,proxy-address-forwarding 默认 false 意味着它不读 X-Forwarded-Proto,isSecure() 恒为 false,于是每个请求都被 302 回 https,浏览器报 ERR_TOO_MANY_REDIRECTS。此时正确做法是边缘只做 301、容器层信任代理头、应用层保留 CONFIDENTIAL 作为兜底,而不是三处同时改:

层级 典型实现 状态码 排错信号
边缘 Nginx return 301 https://$host$request_uri; / ALB 监听器规则 301 curl -I 直接看到 301,未到 Java 进程
容器监听器 redirect-socket + proxy-address-forwarding 302 响应带 Location: https://...:8443/,端口是 8443 而非 443
应用 web.xml / Spring Security requiresSecure() 302 只有特定 url-pattern 被跳转,静态资源正常

排错顺序建议固定下来:先用 curl -I http://host:8080/ 看是否出现 302 及其 Location 端口,判断请求落在哪一层;再用上面的 read-resource 确认 redirect-socket 与 proxy-address-forwarding 的实际值;最后才检查 web.xml 的 version 与约束作用范围。OpenSSL 侧可用 openssl s_client -connect host:8443 -servername host 验证 TLS 握手与证书链,避免把证书问题误判成跳转问题。

jboss 强制https 完整实操:EAP 7.4 / WildFly 31 的 6 个步骤

“jboss 强制https 到底改 web.xml 还是改 Undertow?”——两处都要改,但各自负责的事情不同:web.xml 负责让容器把明文请求变成 302,Undertow 的 redirect-socket 负责告诉容器“重定向到哪个端口”。少配任何一个,都会出现 302 指向 http://…:8080 或者根本不跳转。下面是在 EAP 7.4 与 WildFly 31(两者 Undertow 子系统结构一致)上经过验证的 6 步。

步骤 1:先确认 HTTPS 监听器存在。没有监听器,后面全是空谈。

# 查看是否已有 https-listener 及其 security-realm
grep -n 'https-listener' $JBOSS_HOME/standalone/configuration/standalone-full.xml
# 查看 socket-binding 端口,默认 https=8443、http=8080
grep -n 'socket-binding'   $JBOSS_HOME/standalone/configuration/standalone-full.xml

EAP 7.4 / WildFly 31 的默认 HTTPS 端口都是 8443,security-realm 通常是 ApplicationRealm。若 grep 无输出,先按 Red Hat EAP 7.4 文档《How to Configure Server Security》用 elytron-tool.sh 生成 keystore 并添加 https-listener,再继续。

步骤 2:在应用 WEB-INF/web.xml 里加 security-constraint。

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         version="4.0">   <!-- 写 3.1 或 4.0,2.5 行为不一致 -->
  <security-constraint>
    <web-resource-collection>
      <web-resource-name>all</web-resource-name>
      <url-pattern>/*</url-pattern>      <!-- 全站,含静态资源 -->
    </web-resource-collection>
    <user-data-constraint>
      <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    <!-- 千万不要写空 <auth-constraint/> -->
  </security-constraint>
</web-app>

这里最容易出错的地方就是空的 <auth-constraint/>:按 Jakarta Servlet 4.0 规范 §13.8.1,空的 auth-constraint 含义是“禁止任何角色访问”,容器直接返回 403 Forbidden,而不是重定向。要的是重定向,就只写 user-data-constraint。

步骤 3:确认 redirect-socket 指向 https。

# 期望返回 https;返回 undefined 说明没配,重定向会指回 8080
/subsystem=undertow/server=default-server/http-listener=default:read-attribute(name=redirect-socket)
# 若为 undefined 则写入并 reload
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=redirect-socket,value=https)
:reload

步骤 4:代理场景必须开 proxy-address-forwarding。该属性默认 false,不开则 Undertow 忽略 X-Forwarded-Proto,302 会把你送回 http,浏览器报 ERR_TOO_MANY_REDIRECTS。

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=true)
:reload
# Nginx 侧:把真实协议与端口透传给 JBoss
location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host              $host;
    proxy_set_header X-Forwarded-Proto $scheme;   # 关键
    proxy_set_header X-Forwarded-Port  443;       # 关键
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
}

步骤 5:限制 8080。生产环境不要直接删 http-listener(管理接口和健康检查可能依赖它)。更稳妥的是把 socket-binding 绑到回环地址,或在防火墙上只放行 443/8443:

/socket-binding-group=standard-sockets/socket-binding=http:write-attribute(name=interface,value=loopback)
:reload
# 若健康检查仍需外部访问 8080,单独放行来源网段
firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=10.0.0.0/8 port port=8080 protocol=tcp accept'
firewall-cmd --reload

步骤 6:灰度验证。先 :reload 或重启单个节点,再验证:

curl -I http://127.0.0.1:8080/
# HTTP/1.1 302 Found
# Location: https://127.0.0.1:8443/      <-- 端口必须是 8443 而不是 8080
curl -kI https://127.0.0.1:8443/
# HTTP/1.1 200 OK

302 属于 RFC 7231 §6.4 定义的临时重定向,对 SEO 与缓存更安全;确认 30 分钟无 5xx、无重定向循环后,再推全量节点。有条件的话,再在 443 响应头加上 Strict-Transport-Security(RFC 6797),先给短 max-age 再逐步加长。

三种强制手段怎么选:

手段 生效位置 优点 局限 适用场景
web.xml transport-guarantee 应用内(Servlet 规范) 容器无关,Tomcat/JBoss 通用,随 war 走 每个 war 都要改;静态资源也占用容器线程 传统 war 部署、多容器混跑
Undertow filter / handler 服务器级(CLI 配置) 一次配置对整个 server 生效,应用无需改动 CLI 语法门槛高,升级迁移需重写 平台团队统一管控
反向代理 301/308 Nginx / HAProxy TLS 卸载,最省容器资源,可集中做 HSTS 必须配 proxy-address-forwarding + X-Forwarded-Proto 有 LB 的现代部署

jboss 强制https 的配置与命令示例:web.xml、standalone-full.xml、CLI 与 Nginx

很多人第一次在 JBoss 上做 jboss 强制https 时会踩同一个坑:在 Nginx 上终结 TLS,同时又在应用里开 transport-guarantee,结果浏览器抛出 ERR_TOO_MANY_REDIRECTS,而 server.log 里一条错误都没有。原因是 Undertow 只看到明文 HTTP,反复把请求 302 回 https。下面按”应用层约束 → 容器监听器 → CLI 校验 → 边缘重定向”四层给出可直接复制的配置。

web.xml 的最小强制片段怎么写?为什么不能加 <auth-constraint/>?据 Jakarta Servlet 规范(Servlet 4.0 / Jakarta Servlet 6.0 第 13.8.4 节),transport-guarantee 取值 NONE(默认)、INTEGRAL、CONFIDENTIAL,只有 CONFIDENTIAL 会触发到安全端口的跳转。EAP 7.4(Servlet 4.0,javax.* 命名空间):

<!-- EAP 7.4: src/main/webapp/WEB-INF/web.xml -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         version="4.0">
  <security-constraint>
    <web-resource-collection>
      <web-resource-name>Entire Application</web-resource-name>
      <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <!-- 只写 user-data-constraint,不要写 auth-constraint -->
    <user-data-constraint>
      <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
  </security-constraint>
</web-app>

<!-- WildFly 31: 仅命名空间与版本号不同 -->
<!-- xmlns="https://jakarta.ee/xml/ns/jakartaee" version="6.0" -->

空的 <auth-constraint/> 语义是”任何已认证角色”,会把匿名用户直接挡成 401 并弹 ApplicationRealm 的登录框;<security-constraint> 里不放 auth-constraint 才是纯传输层约束。

standalone-full.xml 的监听器怎么配?关键在 redirect-socket 与 proxy-address-forwarding 两个属性:

<!-- standalone-full.xml / subsystem=undertow -->
<server name="default-server">
  <!-- redirect-socket 默认值 https:CONFIDENTIAL 请求被 302 到此 socket-binding -->
  <!-- proxy-address-forwarding 默认 false:置 true 才信任 X-Forwarded-Proto -->
  <http-listener name="default" socket-binding="http"
                 redirect-socket="https"
                 proxy-address-forwarding="false"/>
  <https-listener name="https" socket-binding="https"
                  security-realm="ApplicationRealm"/>
</server>
属性 默认值 作用与风险
redirect-socket https 指向 socket-binding 名,不是端口号;写错则 302 到不存在的端口
proxy-address-forwarding false 置 true 后读取 X-Forwarded-Proto/For/Port,前提是只接受可信代理流量,否则可被伪造客户端 IP

用 CLI 怎么查和改?版本:EAP 7.4 / WildFly 31,管理端口 9990:

$JBOSS_HOME/bin/jboss-cli.sh --connect
# 读当前值,返回 {"outcome" => "success", "result" => "https"}
/subsystem=undertow/server=default-server/http-listener=default:read-attribute(name=redirect-socket)
# 前置 Nginx 终结 TLS 时必须打开,否则陷入重定向循环
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=true)
:reload
# 验证
/subsystem=undertow/server=default-server/http-listener=default:read-attribute(name=proxy-address-forwarding)

Nginx 前置的 80→443 与反代怎么写?注意 proxy_pass 不要多写尾斜杠——location / 下写成 proxy_pass http://127.0.0.1:8080/; 会触发 URI 前缀替换,部署在 /app 上下文时路径被截断成 404。

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;   # 边缘层完成跳转
}
server {
    listen 443 ssl;
    server_name example.com;
    # 灰度期先用 300 秒,观察 24h 无混合内容再放大
    add_header Strict-Transport-Security "max-age=300; includeSubDomains" always;
    location / {
        proxy_pass http://127.0.0.1:8080;      # 不带 URI,保留原始路径
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-Proto $scheme;   # Undertow 据此判定"已加密"
        proxy_set_header X-Forwarded-Port  $server_port;
    }
}

HSTS 依据 RFC 6797,浏览器收到后对 max-age 内一律拒绝明文;Mozilla SSL Configuration Generator 建议稳定后取 max-age=31536000,但首次上线务必从 max-age=300 起步,否则混合内容问题无法回退。

强制方式 生效层 典型现象 适用场景
web.xml CONFIDENTIAL Servlet/Undertow 302 到 redirect-socket 需要按 url-pattern 精细控制
Nginx return 301 边缘 无状态码透传 前置反代,推荐首选
Spring Security 6.x 应用框架 需 forward-headers-strategy=framework 才识别代理头 Spring Boot on WildFly

Spring Security 6.x 可写 http.requiresChannel(channel -> channel.anyRequest().requiresSecure());,这是应用层强制,不替代 JBoss 的 transport-guarantee;两者同时开启时以更严格者为准——即任一判定为不安全就跳转,因此代理头配置必须两处一致,否则依旧死循环。

jboss 强制https 四种方案对比:web.xml、Undertow、Nginx/ALB、Spring Security

jboss 强制https 有四种常见做法,它们的生效范围差别很大:改一个 WAR、改整个 server、改边缘反向代理,或在应用框架层拦截。先看对比,再决定把哪一层作为主方案。

方案 生效范围 配置位置 默认/建议状态码 适用场景 关键参数
web.xml transport-guarantee=CONFIDENTIAL 单个 WAR WEB-INF/web.xml 302 应用可移植、按 WAR 强制 Servlet 3.1+;不要留空 auth-constraint
Undertow http-listener / redirect-socket 整个 server standalone-full.xml 或 CLI 不主动跳转,只决定跳转目标 已有 transport-guarantee 或位于代理之后 redirect-socket 默认 https;proxy-address-forwarding 默认 false
Nginx / ALB 301 边缘全站 Nginx server 块 / ALB listener 301 多应用、统一 HSTS、证书在边缘 必须传 X-Forwarded-Proto;回源 8080 需配合 JBoss
Spring Security requiresSecure() 单个 Spring 应用 Java 配置 302/307 可配 Spring Boot 或外置 Tomcat 不替代容器配置;注意代理头

只改一个 WAR,就写 web.xml。Servlet 规范(Jakarta Servlet 6.0,对应 JSR 369 起的 3.1 版本)规定 user-data-constraint 可以独立存在,但 EAP 7.4 / WildFly 31 上若你从旧模板复制来一个空 <auth-constraint/>,容器会把它当成”拒绝所有角色”,表现是 403 而不是跳转。正确写法:

<!-- WEB-INF/web.xml,Servlet 3.1+ 可省略 auth-constraint -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>whole-app</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

全站统一跳转,就把 301 放在 Nginx 或 ALB。据 RFC 9110 §15.4.2/15.4.3,301 表示资源永久迁移、客户端可缓存,302 是临时跳转;Google 搜索文档也明确 301 才传递链接权重。应用内 302 功能上够用,但不适合长期 SEO。边缘跳转示例(Nginx 1.20+ 均可):

server {
  listen 80;
  server_name example.com;
  return 301 https://$host$request_uri;   # 全站 301,边缘终止 TLS
}
server {
  listen 443 ssl;
  location / {
    proxy_pass http://127.0.0.1:8080;                    # 回源走明文 8080
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;          # JBoss 判断是否已加密的依据
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

JBoss 侧保留兜底配置。Undertow 的 redirect-socket 本身不发跳转,它只告诉容器”收到 CONFIDENTIAL 请求时该跳到哪个 socket”,默认值就是 https;真正决定代理后是否死循环的是 proxy-address-forwarding,默认 false。EAP 7.4 与 WildFly 31 都用 CLI 改:

# 开启代理头解析,否则 X-Forwarded-Proto 被忽略 → 302 循环
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=true)
# 确认跳转目标是 socket-binding 名称而非硬编码端口
/subsystem=undertow/server=default-server/http-listener=default:read-attribute(name=redirect-socket)
# 期望输出 {"outcome" => "success", "result" => "https"}
:reload

端口与安全边界。EAP 7.4 与 WildFly 31 的 https socket-binding 默认端口都是 8443;要改 443,请改 /socket-binding-group=standard-sockets/socket-binding=https:write-attribute(name=port,value=443),并让 redirect-socket 继续指向 binding 名称 https,不要在 URL 里写死端口。另外,CONFIDENTIAL 只保证传输加密,不做身份认证——需要登录的路径要再配 auth-constraint 与 security-domain,这两件事经常被混为一谈。

怎么选?只改一个 WAR 用 web.xml;全站统一跳转用 Nginx/ALB 的 301;同时在 JBoss 侧保留 redirect-socket=https 与 proxy-address-forwarding=true 作为兜底——这样即使有人绕过边缘直连 8080,jboss 强制https 的约束依然生效。若你已用 Spring Security,requiresSecure() 可作为应用层补充,但它依赖 ForwardedHeaderFilter 或容器正确解析代理头,不能替代上面的容器配置。

jboss 强制https 常见错误与排查:302 循环、403、混合内容与 SSL 协议错误

先分清是”重定向环”还是”端口错”。这两类故障的报错文本几乎一样(浏览器都显示 ERR_TOO_MANY_REDIRECTS),但根因完全不同。定位方法是绕开代理,直接问后端:

# 直接向 8080 发请求,并伪装成"代理已终止 TLS"的样子
# 若返回 200/正常内容 → 后端逻辑没问题,问题在 Nginx 没传 X-Forwarded-Proto
# 若仍返回 302 Location: https://... → 后端根本没识别到 scheme,见下文
curl -I -H 'X-Forwarded-Proto: https' http://127.0.0.1:8080/

如果上面这条仍吐 302,第一嫌疑是 Undertow 的 proxy-address-forwarding。该属性在 JBoss EAP 7.4 与 WildFly 31 中默认值均为 false(据 Red Hat EAP 7.4 《Configuring Server Security》与 WildFly 31 Admin Guide),为 false 时 Undertow 完全忽略 X-Forwarded-Proto/X-Forwarded-For,于是 request.isSecure() 恒为 false,你的 security-constraint 就一直重定向。开启方式(CLI,需 reload):

# 在 EAP 7.4 / WildFly 31 上均适用;default-server/default 为默认 listener 名
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(
    name=proxy-address-forwarding,value=true)
# 若前面还有 AJP listener 或自定义 listener,需逐个设置
:reload

同时确认 Nginx 真的传了值:proxy_set_header X-Forwarded-Proto $scheme;——漏写这一行是最常见的”配了属性还是循环”的原因。若链路是多级代理(CDN → Nginx → JBoss),只有最靠近 JBoss 的那跳的 header 生效,上游要清理客户端伪造的同名头。

403 与 JBWEB000065:日志里出现 JBWEB000065: HTTP Status 403 - Access to the requested resource has been denied,九成是 web.xml 里写了一个空的 <auth-constraint/>。按 Servlet 规范(Jakarta Servlet 6.0 §13.8.1),空 auth-constraint 的语义是”不允许任何角色访问”,不是”不限制”。只做强制 HTTPS 时应删掉它,或改成:

<security-constraint>
  <web-resource-collection>
    <web-resource-name>all</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
  <!-- 注意:这里不要放空的 auth-constraint -->
</security-constraint>

SSL 协议错:curl: (35) error:0A00010B:SSL routines::wrong version number 或 Firefox 的 SSL_ERROR_RX_RECORD_TOO_LONG,含义是”把明文 HTTP 打到了 TLS 端口”。两种典型误配:redirect-socket 指向了 http 而非 https;或 Nginx 回源写成 proxy_pass https://127.0.0.1:8080;。用 openssl s_client -connect 127.0.0.1:8443 -brief 可一秒验证端口是否真在说 TLS。

混合内容:控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...',属于页面硬编码了 http 资源,与 JBoss 配置无关。过渡期可在 Undertow 加响应头(WildFly 31 的 undertow subsystem 支持 header 过滤器),再逐步把资源改成相对协议 //host/path 或 https。

别误判:UT000010: Session is closed 是 Undertow 会话/连接已关闭的噪声日志,与强制 HTTPS 无因果关系;真正该盯的是 JBWEB000065(403)、UT000024(请求解析失败)、UT000068(响应状态异常)。

现象 最可能根因 一条命令定位
302 循环 proxy-address-forwarding=false 或 Nginx 未传 X-Forwarded-Proto curl -I -H 'X-Forwarded-Proto: https' http://127.0.0.1:8080/
Location 端口是 8080/80 redirect-socket 写成 http,或 socket-binding 端口被 -Djboss.https.port 覆盖 curl -I http://host:8080/ | grep -i location
403 + JBWEB000065 空 <auth-constraint/> grep -n "auth-constraint" WEB-INF/web.xml
wrong version number http 请求打到 8443,或 proxy_pass 用 https 回源 8080 openssl s_client -connect host:8443 -brief
Mixed Content 页面硬编码 http 资源 浏览器 DevTools → Console 过滤 “Mixed”

jboss 强制https 如何验证生效:curl、openssl、访问日志与浏览器

配完 transport-guarantee 不等于生效——JBoss 的跳转是 Undertow 在 Servlet 容器层完成的,任何一层配错都会静默退化成 200。所以 jboss 强制https 的验证必须”由内到外”逐层做,不能只看浏览器地址栏变了就收工。

第一步:curl 打 8080,看是否真的 302

# -I 只取响应头,避免下载页面体
curl -I http://127.0.0.1:8080/
# 期望:HTTP/1.1 302 Found
#       Location: https://127.0.0.1:8443/

# 若返回 200,按这四点排查(都是静默失败):
# 1) <security-constraint> 必须写在 <web-app> 直下,不能嵌套进 <servlet>
# 2) <transport-guarantee> 值全大写:CONFIDENTIAL / INTEGRAL / NONE,写成 Confidential 会被忽略
# 3) web.xml 版本要匹配容器:EAP 7.4 支持 version="4.0",WildFly 31 支持 "5.0"/"6.0"
# 4) 若 <web-app metadata-complete="true">,注解配置全部失效,只能用描述符

第二步:确认 8443 本身可用。开发期可用 curl -I -k https://127.0.0.1:8443/ 期望 200;但 -k 会掩盖证书链问题,生产环境务必去掉,改用 curl -I https://example.com/。典型报错 curl: (60) SSL certificate problem: unable to get local issuer certificate 说明服务端只发了叶子证书,需要在 Elytron 的 key-manager 里换成 fullchain。

# OpenSSL 1.1.1+ 才支持 -tls1_3;-servername 用于 SNI,多域名证书必须带
openssl s_client -connect 127.0.0.1:8443 -servername example.com -tls1_3 /dev/null 
  | grep -E 'Protocol|Cipher|Verify return code'
# 期望:Protocol : TLSv1.3
#       Verify return code: 0 (ok)

EAP 7.4 随 JDK 默认启用 TLSv1.2/1.3;WildFly 31 的 https-listener 默认 enabled-protocols 也含 TLSv1.2,TLSv1.3,可用 /subsystem=undertow/server=default-server/https-listener=https:read-attribute(name=enabled-protocols) 核对。这与 Mozilla Server Side TLS 指南推荐的现代兼容配置一致:只留 1.2/1.3。

第三步:日志与端口。注意 server.log 默认并不逐条记录 302,tail -f $JBOSS_HOME/standalone/log/server.log | grep -E '302|Location' 通常只能抓到部署与异常。要稳定看状态码,必须开 access-log(该子资源存在即生效,默认 pattern 为 %h %l %u %t "%r" %s %b):

$JBOSS_HOME/bin/jboss-cli.sh --connect
/subsystem=undertow/server=default-server/host=default-host/setting=access-log:read-resource
/subsystem=undertow/server=default-server/host=default-host/setting=access-log:write-attribute(name=pattern,value='%h %l %u %t %r %s %b')
:reload

# 端口与协议套件
ss -lntp | grep -E '8080|8443'
nmap --script ssl-enum-ciphers -p 8443 example.com

若 8080 仍对公网开放,jboss 强制https 只完成了跳转,没有减少攻击面——攻击者仍可直连 8080 发未加密请求,应改用 socket-binding-group 绑定到 127.0.0.1 或防火墙封禁。

现象 含义 处理
8080 返回 200 该 WAR 没读到 web.xml,或 transport-guarantee 拼写/版本不对 查描述符版本与 metadata-complete
302 但 Location 是 http:// 反向代理未透传 X-Forwarded-Proto,Undertow 拿到的 scheme 仍是 http listener 加 proxy-address-forwarding="true"
Verify return code: 20 中间证书缺失 换 fullchain
浏览器 Console 报 Mixed Content 页面内仍有 http:// 资源 改相对路径或 HSTS 前先清理

最后在浏览器 DevTools 里交叉验证:Network 面板看首个文档请求是否 302/301 且 Location 为 https;Console 看混合内容告警;Security 面板看证书有效期与协商出的 TLS 版本。据 Let’s Encrypt 文档建议,证书到期前 30 天续期,配合 curl -I 定期探测可提前发现链断裂。

jboss 强制https 上线检查清单与回滚顺序

上线前先看 web.xml 的两行声明,比改任何代理配置都重要。第一行是 version:transport-guarantee 依赖 Servlet 3.1 引入的安全约束语义,低于 3.1 的 web.xml(2.5/3.0)在部分容器里不会对 <url-pattern>/*</url-pattern> 生效,表现为“配了但没跳转”。第二行是 metadata-complete="true":它会让容器跳过注解扫描与 web-fragment.xml 合并,@WebServlet、ServletContainerInitializer(Spring 的 SpringServletContainerInitializer、JAX-RS 自动注册)会静默失效,结果是 404 而不是报错——这是最常见的“回滚后应用起不来”的根因。

平台 Servlet 规范 web.xml 建议 version API 命名空间
JBoss EAP 7.4 Servlet 4.0(JSR 369) 4.0 javax.servlet
WildFly 31 Servlet 6.0(Jakarta EE 10) 6.0 jakarta.servlet
WildFly 26 及更早 Servlet 4.0 4.0 javax.servlet

变更前怎么留后路?先备份域配置文件,再让 CLI 操作可审计。据 Red Hat EAP 7.4 管理文档,standalone 模式的配置入口是 standalone-full.xml(full 平台包)或 standalone.xml(web 平台包),改错只能靠备份恢复:

# 1) 备份,带日期后缀便于回滚定位
cp $JBOSS_HOME/standalone/configuration/standalone-full.xml 
   $JBOSS_HOME/standalone/configuration/standalone-full.xml.bak.$(date +%F)

# 2) CLI 变更后审计:查看该资源的操作历史(谁在什么时候改了什么)
$JBOSS_HOME/bin/jboss-cli.sh --connect
[standalone@localhost:9990 /] /subsystem=undertow:read-operation-history

# 3) 若配置纳管在 Git,直接比对差异
git diff -- standalone-full.xml

回滚顺序为什么不能反?因为 https-listener 是 8443 的唯一入口,先删它会把“重定向问题”升级成“全站 503”。正确顺序是自外向内逐层撤:

  1. 撤掉 Nginx / ALB 的 301 跳转规则,恢复 80 端口直通;
  2. 关闭 Undertow 的代理头透传(默认值即 false,改回默认即可):
    /subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=false)
  3. 最后撤 web.xml 里的 <transport-guarantee>CONFIDENTIAL</transport-guarantee>,重新部署;
  4. 确认业务恢复后,才评估是否需要保留 https-listener。

灰度与监控看哪几个数?先放 1 个节点、1 个 WAR,观察 30 分钟。探针分别打两个端口,正常时 8080 应返回 302 且 Location 指向 https:

curl -sI http://10.0.0.11:8080/app/ | head -3   # 期望 302 + Location: https://...
curl -skI https://10.0.0.11:8443/app/ | head -1  # 期望 200/302,不应 5xx

# 关注 Undertow 错误页前缀 JBWEB000065(404/403)与 UT 前缀异常
grep -E 'JBWEB000065|UT00' $JBOSS_HOME/standalone/log/server.log | tail -20

重点盯四个信号:302 占比是否异常升高、5xx 增量、浏览器侧 ERR_TOO_MANY_REDIRECTS(说明 X-Forwarded-Proto 没透传,JBoss 仍认为请求是 http,据 RFC 9110 的 3xx 语义会反复跳转)、以及登录回调地址是否仍拼成 http://。前者查 Nginx 的 proxy_set_header X-Forwarded-Proto $scheme;,后者查 web.xml 之外的 <distributable/> 与 SSO 适配器配置。

对单个 WAR 够用,但前提是 https-listener 已启用、redirect-socket 指向 https,且没有空 auth-constraint。多 WAR 全站强制建议在 Nginx/ALB 做 301,JBoss 侧保留兜底。

最常见是 web.xml 里写了空 ,它表示禁止所有角色。只做强制 HTTPS 时删掉 auth-constraint;需要登录再配 role-name 与 security-domain。

两者默认都是 8443,对应 socket-binding name='https';要改 443 需改 port 并同步 redirect-socket 指向的 binding 名称。

建议保留,防止内网直连 8080 或代理头丢失。JBoss 侧开 proxy-address-forwarding=true 并保留 transport-guarantee,边缘 301 负责 SEO 与 HSTS。

用 curl -I -H 'X-Forwarded-Proto: https' http://127.0.0.1:8080/ 测试;若仍 302,检查 proxy-address-forwarding 是否 true,以及 Nginx 是否传 X-Forwarded-Proto $scheme。

transport-guarantee 是容器级、按 WAR 生效,默认 302;requiresSecure 是 Spring 应用级,可配 302/307。两者同时开以更严格者为准,代理场景都要处理 X-Forwarded-Proto。

HSTS 建议在边缘开,先 max-age=300 灰度再升 31536000;HTTP/2 在 https-listener 设 enable-http2=true(默认 false),需 TLSv1.2+ 与 ALPN,老客户端可能不兼容。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。