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,这两件事经常被混为一谈。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
怎么选?只改一个 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”。正确顺序是自外向内逐层撤:
- 撤掉 Nginx / ALB 的
301跳转规则,恢复 80 端口直通; - 关闭 Undertow 的代理头透传(默认值即
false,改回默认即可):
/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=proxy-address-forwarding,value=false) - 最后撤
web.xml里的<transport-guarantee>CONFIDENTIAL</transport-guarantee>,重新部署; - 确认业务恢复后,才评估是否需要保留
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。