GlassFish 强制 HTTPS 实战:web.xml、asadmin 与 Nginx 三层配置(GF 4.1–7.0)
GlassFish 强制 HTTPS 最直接的做法是在应用 WEB-INF/web.xml 里写 CONFIDENTIAL 并覆盖 /*,容器会把 HTTP 请求 302 到安全监听器 http-listener-2(默认 8181),生产环境通常再前置 Nginx 做 80→443 的 301。 GlassFish 4.1.2 / 5.1.0 / 6.2.5 / 7.0 的默认端口是 HTTP 8080、HTTPS 8181、管理 4848;强制 HTTPS 后必须确认 8181 或 443 已在防火墙与云安全组放行,否则浏览器会停在跳转后的连接超时。 确认安全监听器状态用 asadmin get server-config.network-config.protocols.protocol.http-listener-2.security-enabled,返回 true 才说明 8181 走 TLS。 前置 Nginx 终止 TLS 时必须执行 asadmin set server-config.network-config.protocols.protocol.http-listener-1.scheme-mapping=X-Forwarded-Proto,否则 request.isSecure() 恒为 false,CONFIDENTIAL 反复跳转触发 ERR_TOO_MANY_REDIRECTS。 验证命令:curl -sI http://你的域名/ 应返回 HTTP/1.1 302 且 Location 指向 https,再用 openssl s_client -connect 域名:443 -servername 域名 检查证书链与 TLS 版本。
GlassFish 强制 HTTPS 为什么配了却不生效?先看这几个根本原因
为什么浏览器被 302 到 8181 后直接超时?因为 GlassFish 的监听器是三个独立端口,而不是一个“开关”。据 GlassFish 管理指南,默认 domain1 的网络监听器如下:
| 监听器 | 默认端口 | security-enabled | 典型问题 |
|---|---|---|---|
| http-listener-1 | 8080 | false | 明文入口,重定向的起点 |
| http-listener-2 | 8181 | true | 只在 127.0.0.1 绑定或安全组未放行时,重定向目标不可达 |
| admin-listener | 4848 | false | 管理控制台,需单独加固 |
# 查看实际监听地址与端口,确认 8181 不是绑定在 127.0.0.1
asadmin get 'server-config.network-config.network-listeners.network-listener.http-listener-2.*'
# 关键字段:address(默认 0.0.0.0)、port(默认 8181)、security-enabled(默认 true)
为什么 web.xml 写了 /* 还是漏掉一部分路径?<url-pattern>/*</url-pattern> 的作用域是当前 Web 应用上下文。同一 domain 下另外部署的 WAR、由另一个 virtual-server 提供的静态目录,都不会继承这条约束。多应用场景必须在每个 WAR 的 web.xml 或 glassfish-web.xml 中各写一次,这也是 glassfish 强制 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>
</security-constraint>
Nginx 终止 TLS 后为什么变成 ERR_TOO_MANY_REDIRECTS?CONFIDENTIAL 的判定依据是 request.isSecure()(见 Jakarta Servlet 规范 user-data-constraint 章节)。反向代理回源 8080 明文时 scheme 仍是 http,容器持续 302 形成死循环。解法是让 http protocol 的 scheme-mapping 读取代理头,该属性默认值为空:
# GlassFish 侧:把 X-Forwarded-Proto 映射回请求 scheme(4.1–7.0 通用)
asadmin set server-config.network-config.protocols.protocol.http-listener-1.scheme-mapping=X-Forwarded-Proto
# Nginx 侧:必须真的发出这个头,否则映射无效
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-For $proxy_add_x_forwarded_for;
}
老项目复制过来的 web.xml 为什么在 GF 7 部署就失败?描述符命名空间必须与容器的 Servlet 版本对齐:
| GlassFish | Servlet 规范 | 命名空间 | version |
|---|---|---|---|
| 4.1.2 | Servlet 3.1 | http://xmlns.jcp.org/xml/ns/javaee | 3.1 |
| 5.1.0 | Servlet 4.0 | http://xmlns.jcp.org/xml/ns/javaee | 4.0 |
| 6.2.5 | Jakarta Servlet 5.0 | https://jakarta.ee/xml/ns/jakartaee | 5.0 |
| 7.0 | Jakarta Servlet 6.0 | https://jakarta.ee/xml/ns/jakartaee | 6.0 |
典型报错:
org.xml.sax.SAXParseException ... cvc-elt.1.a: Cannot find the declaration of element 'web-app'.部署阶段即解析失败,约束自然不生效。
改完没反应,是缓存还是没重部署?GlassFish 在 deploy 时解析并缓存 web.xml,IDE 热部署常只替换 class。用 asadmin list-applications -long 看部署时间戳即可确认,强制重读描述符要 redeploy:
asadmin redeploy --name myapp /opt/apps/myapp.war # 重新解析 web.xml
asadmin list-applications -long # 核对 Location 与部署时间
GlassFish 强制 HTTPS 完整实操步骤(以 6.2.5 与 7.0 为例)
很多人问:在 GlassFish 里把 HTTP 强制跳 HTTPS,到底该改 web.xml 还是在 asadmin 里配?答案是两者都要,但职责不同——web.xml 负责”应用级拦截”,asadmin 负责”容器监听器与证书”,Nginx 负责”最外层 301″。下面按 6 个步骤走一遍,命令在 GlassFish 4.1.2 至 7.0.1 上通用。
步骤 1|确认版本与监听器。先确认你面对的是哪个版本,GF 4.x 与 7.x 的 asadmin 属性路径一致,但日志格式和默认 TLS 协议版本不同(7.0 默认已禁用 TLSv1/1.1)。
# 版本确认,输出形如 GlassFish Server Open Source Edition 7.0.1 (build 7.0.1)
asadmin version
# 应看到 http-listener-1 8080、http-listener-2 8181、admin-listener 4848
asadmin list-http-listeners
# 确认 8181 监听器已启用安全,默认值即为 true
asadmin get server-config.network-config.protocols.protocol.http-listener-2.security-enabled
步骤 2|准备证书链。Let’s Encrypt 文档明确要求服务端下发 fullchain.pem(叶子+中间),只给 cert.pem 会缺中间证书。先合成 PKCS12 再导入 GF 的 keystore.jks,默认口令 changeit,默认别名 s1as:
# 合成 PKCS12,-name 必须与目标别名一致
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem
-name s1as -out cert.p12 -passout pass:changeit
# 导入到域 keystore(会覆盖默认自签名的 s1as)
keytool -importkeystore -srckeystore cert.p12 -srcstoretype PKCS12
-srcstorepass changeit
-destkeystore $GF_HOME/glassfish/domains/domain1/config/keystore.jks
-deststorepass changeit -alias s1as
步骤 3|绑定别名并校验证书链。GF 只发送 keystore 中该别名下实际存在的链,链不全会导致浏览器报 NET::ERR_CERT_AUTHORITY_INVALID。
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=s1as
# 期望输出 Certificate chain length: 3(叶子+中间+根);若为 1,说明只导入了叶子
keytool -list -v -keystore $GF_HOME/glassfish/domains/domain1/config/keystore.jks -alias s1as
步骤 4|在应用内启用 transport-guarantee。这是 Servlet 规范(Jakarta Servlet 6.0 §13.8.4)定义的容器级约束,GF 4.1.2–7.0 行为一致:
<!-- WEB-INF/web.xml:注意不要同时写 auth-constraint,否则会先弹登录框 -->
<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>
步骤 5|重新部署并盯日志。用 --keepstate=true 保留会话,日志出现 WebModule[/yourapp] ... deployed 才算成功;若同一时间窗有 SEVERE 行,先修错误再验证跳转,否则你会误以为是跳转配置失效。
asadmin redeploy --name yourapp --keepstate=true /opt/app/yourapp.war
tail -f $GF_HOME/glassfish/domains/domain1/logs/server.log
步骤 6|(推荐)前置 Nginx 做 301,并让容器识别原始 scheme。据 Mozilla SSL Configuration Generator,最外层统一跳转比容器内跳转更易维护。关键是 scheme-mapping,否则 GF 仍认为请求是 http,会二次跳转甚至死循环:
# Nginx
server {
listen 80;
server_name example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme; # 关键行
}
}
# GlassFish:让容器从请求头读取原始 scheme
asadmin set server-config.network-config.protocols.protocol.http-listener-1.scheme-mapping=X-Forwarded-Proto
| 层 | 配置位置 | 触发结果 | 默认值 | 适用版本 |
|---|---|---|---|---|
| 应用层 | web.xml CONFIDENTIAL |
302 跳 https | 无(需显式声明) | GF 4.1.2–7.0 |
| 容器层 | security-enabled + 证书 |
8181 提供 TLS | http-listener-2 为 true | GF 4.1.2–7.0 |
| 边缘层 | Nginx return 301 |
301 永久跳转 | 无 | 与 GF 版本无关 |
顺带一提:GF 7.0 的 admin-listener 4848 默认仍走 HTTP,若要一并加固,需单独执行 asadmin set server-config.network-config.protocols.protocol.admin-listener.security-enabled=true,这与应用侧的 glassfish 强制https 是两条独立链路,别混在一起排查。
GlassFish 强制 HTTPS 的配置与命令示例:web.xml、domain.xml、asadmin、Nginx
在 GlassFish 上强制 HTTPS,最常被问到的第一个问题是:“只改 web.xml 就够了吗?”答案取决于你期望的拦截层级。web.xml 的 <transport-guarantee>CONFIDENTIAL 由 Servlet 容器执行,属于应用级;asadmin 和 domain.xml 控制的是监听器与协议栈,属于容器级;Nginx 则是网络入口级。三层叠加才最稳,但每层的写法在 GF 4.1 到 7.0 之间已经发生断裂性变化。
Java EE 时代(GF 4.1.2 / 5.1.0)的 web.xml 怎么写?关键在根元素命名空间与 version 必须匹配,否则 security-constraint 会被静默忽略。据 Jakarta EE 规范迁移指南,GF 5.1.0 应使用 version="4.0" 与 web-app_4_0.xsd:
<?xml version="1.0" encoding="UTF-8"?>
<!-- GF 4.1.2 用 version="3.1" + web-app_3_1.xsd;GF 5.1.0 改为 4.0 -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<security-constraint>
<web-resource-collection>
<web-resource-name>force-https</web-resource-name>
<url-pattern>/*</url-pattern> <!-- 只对 /admin/* 强制时改这里 -->
</web-resource-collection>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
</web-app>
GF 6.2.5 / 7.0 为什么部署后不生效?因为 Jakarta EE 9 起命名空间改为 https://jakarta.ee/xml/ns/jakartaee。GF 6.2.5 用 version="5.0",GF 7.0 用 version="6.0",security-constraint 的内容一字不改。继续沿用 http://java.sun.com/xml/ns/javaee 会导致 GF 7 无法识别描述符版本,约束被忽略或部署时抛解析异常。这是从 Java EE 迁移到 Jakarta EE 时最常见的坑之一。
容器级配置用哪些 asadmin 命令?以下序列适用于 GF 4.1–7.0,命令组路径一致:
# 1. 指定 SSL 证书别名,s1as 是默认自签证书
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=s1as
# 2. 显式关闭 SSLv3(POODLE 漏洞),默认值在 GF 5+ 已为 false,老版本需手动改
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.ssl3-enabled=false
# 3. 通过 JVM 选项禁用 TLS 1.0/1.1 与弱算法;重复执行会报 "already exists",先 delete-jvm-options
asadmin create-jvm-options "-Djdk.tls.disabledAlgorithms=TLSv1,TLSv1.1,RC4,3DES"
# 4. 重启域使配置生效
asadmin restart-domain domain1
对应 domain.xml 的实际结构(GF 6.2.5 实测):<network-listener port="8181" protocol="http-listener-2" name="http-listener-2" thread-pool="http-thread-pool" transport="tcp"/> 指向 <protocol name="http-listener-2" security-enabled="true" scheme="https">,其内嵌 <ssl cert-nickname="s1as" ssl3-enabled="false" tls-enabled="true" client-auth="false"/>。手工编辑前务必 asadmin backup-domain --domaindir /path/to/domains domain1,改完用 asadmin start-domain --verbose 观察启动日志中的 SSL 初始化报错。
Nginx 前置时要注意什么?1.24 及以上推荐 listen 443 ssl http2; 写法,80 端口做 301 跳转。由于 Nginx 终结 TLS,GlassFish 侧看到的是 http,务必透传 X-Forwarded-Proto,否则应用内 request.getScheme() 判断会失效。
server {
listen 80;
server_name example.com;
return 301 https://$host$request_uri; # 入口层强制跳转
}
server {
listen 443 ssl http2;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
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-For $proxy_add_x_forwarded_for;
}
}
据 Let’s Encrypt 文档,fullchain.pem 必须包含中间证书,否则部分安卓客户端会报链不完整。
| 方案 | 作用层 | 适用版本 | 局限 |
|---|---|---|---|
| web.xml CONFIDENTIAL | Servlet 容器 | GF 4.1–7.0(命名空间需对应) | 仅当存在 SSL 监听器时 302 跳转;无则返回 403 |
| asadmin / domain.xml | 协议栈与监听器 | GF 4.1–7.0 | 只管加密强度,不做 HTTP→HTTPS 跳转 |
| Nginx 301 | 网络入口 | Nginx 1.24+ | 需额外维护证书与反向代理头 |
| 代码级兜底 | 应用逻辑 | Servlet 3.0+ | 易漏配路径,维护成本高 |
只想对 /admin/* 强制 HTTPS 怎么办?用代码级兜底更灵活。Servlet 3.0+ 可标注 @ServletSecurity(value = @HttpConstraint(transportGuarantee = TransportGuarantee.CONFIDENTIAL));或在 Filter 中判断协议并重定向:if ("http".equals(request.getScheme())) response.sendRedirect("https://" + request.getServerName() + request.getRequestURI());。注意在 Nginx 后面时,需通过 asadmin set server-config.network-config.protocols.protocol.http-listener-1.scheme=https 或读取 X-Forwarded-Proto,否则会陷入无限重定向——这是 glassfish 强制https 排查中最典型的现象。
GlassFish 强制 HTTPS 四种方案怎么选?对比表与适用场景
在决定用哪种方式给 GlassFish 上 HTTPS 之前,先把一个容易混淆的点说清楚:“强制 HTTPS”在技术上分两类——应用层重定向(返回 3xx,浏览器再发起一次 TLS 请求)和端口收敛(HTTP 端口根本不再监听,客户端连明文 TCP 都建不起来)。两者的安全强度、运维成本和故障表现完全不同,下面四种方案的差异基本都源于此。
| 方案 | 配置位置 | 跳转状态码 | 生效范围 | 适用场景 |
|---|---|---|---|---|
| A:web.xml transport-guarantee | 应用 WAR 内的 WEB-INF/web.xml(Servlet 3.1+ 规范约束) |
302(临时重定向,Servlet 容器默认行为) | 仅该应用上下文,/* 或指定 url-pattern |
自有应用、能改代码的团队;零额外组件,成本最低,但无法覆盖同域其他应用 |
| B:Nginx/Apache 前置 301 | 反向代理层 server{} 块 |
301(永久重定向,浏览器会缓存) | 该域名全部流量,含静态资源与多后端 | 已用 Nginx 做负载均衡、多后端共存的既有环境;需额外维护 scheme 透传与代理头 |
| C:安全监听器统一收敛 | asadmin 修改 http-listener-2 端口为 443、http-listener-1 置 enabled=false |
无跳转(明文端口不监听) | 整个 GlassFish 域(domain) | 单机小站,GlassFish 能直接持有公网 IP 或做 443 端口映射;缺点是证书续期后需重启域 |
| D:应用代码 Filter / Spring Security | 应用代码(Filter 或 requiresChannel()) |
可自定义 301/302/307 | 应用内,可按路径精细控制 | 灰度迁移、需要路径白名单(如 /health 保留 HTTP 供探针使用);每个应用都要写一遍,漏写即失效 |
方案 C 的关键命令如下(适用于 GlassFish 4.1 至 7.0,asadmin 语法一致;默认 http-listener-1 端口 8080、http-listener-2 端口 8181):
# 1. 将安全监听器改为标准 443 端口(默认 8181,范围 1-65535)
asadmin set configs.config.server-config.network-config.network-listeners.
network-listener.http-listener-2.port=443
# 2. 关闭明文监听器(默认 enabled=true),实现"只开 HTTPS"
asadmin set configs.config.server-config.network-config.network-listeners.
network-listener.http-listener-1.enabled=false
# 3. 若前面没有 Nginx,需让 GF 感知原始协议,否则 redirectPort 会拼错 URL
asadmin set configs.config.server-config.network-config.protocols.
protocol.http-listener-2.scheme=https
# 4. 重启域使监听器变更生效(改端口/开关监听器必须重启,不能只 reload)
asadmin restart-domain domain1
注意第 2 步之后,任何指向 8080 的旧链接都会得到 Connection refused,而不是重定向——这正是它与 A、B 方案的本质区别。据 Servlet 规范(JSR 369,Servlet 3.1)对 transport-guarantee 的定义,容器在收到 CONFIDENTIAL 请求时若检测到非安全连接,应返回重定向;GlassFish 实现返回的是 302,这也解释了为什么 SEO 场景下运维更倾向在 Nginx 层给 301(301 会被浏览器长期缓存,且搜索引擎会传递权重)。
怎么选?面向运维的最小改动是“A + B 组合”:web.xml 在应用内做兜底(即使有人绕过 Nginx 直连后端也不会泄露明文),Nginx 层给 301 和 Strict-Transport-Security 头,两者职责不重叠。只有 1–2 个应用、且 GlassFish 能直接占用 443 时选 C,省掉一整层代理。对外提供 API、需要区分 /health 这类健康检查路径时选 D,用 Filter 做白名单比在 Nginx 里写一堆 location 例外更好维护。需要强调的是,glassfish 强制https 的四种做法并非互斥,生产环境常见的是代理层终止 TLS、应用层再做一次 glassfish 强制https 的二次校验,形成纵深防御。
GlassFish 强制 HTTPS 常见报错与排查清单
强制跳转类问题几乎都能用一条命令定性:先看 301 的 Location 指向哪里。下面是按“报错原文 → 首查命令 → 根因”整理的速查表,随后逐条展开。
| 报错/现象 | 首查命令 | 最常见根因 |
|---|---|---|
| ERR_TOO_MANY_REDIRECTS | asadmin get ...protocol.http-listener-1.scheme-mapping |
Nginx 终止 TLS,GF 不认 X-Forwarded-Proto |
| curl: (7) Connection refused | asadmin get ...http-listener-2.address |
监听器绑 127.0.0.1 或防火墙未放行 8181 |
| DeploymentException | asadmin deploy --force=true 看完整栈 |
web.xml 命名空间与 GF 大版本不匹配 |
| ERR_CERT_AUTHORITY_INVALID | keytool -list -v -keystore config/keystore.jks |
keystore 缺中间证书,链长只有 1 |
| no cipher suites in common | openssl s_client -connect host:443 -tls1_2 |
只开 TLS 1.3 或 jdk.tls.disabledAlgorithms 禁过头 |
| PKIX path building failed | keytool -list -keystore config/cacerts.jks |
GF 作为客户端调用后端时缺后端 CA |
Q1:http 跳 https 后又跳回 http,浏览器报 ERR_TOO_MANY_REDIRECTS?
90% 的情况是 Nginx 终止 TLS 后以 proxy_pass http://127.0.0.1:8080 转发,GlassFish 只看到明文 http,于是 transport-guarantee=CONFIDENTIAL 又发起一次跳转。先确认 scheme 映射是否为空,再补上并验证请求头确实到达:
# 返回空行 = 未配置映射,GF 不会信任任何代理头
asadmin --port 4848 get 'server-config.network-config.protocols.protocol.http-listener-1.scheme-mapping'
# 让 GF 读取 Nginx 传来的 X-Forwarded-Proto(GF 4.x/5.x/6.x/7.x 参数名一致)
asadmin set 'server-config.network-config.protocols.protocol.http-listener-1.scheme-mapping=X-Forwarded-Proto'
# 模拟代理请求,看 301 的 Location 是否还指向 http
curl -sI -H 'X-Forwarded-Proto: https' http://127.0.0.1:8080/ | grep -i location
Nginx 侧必须显式写 proxy_set_header X-Forwarded-Proto $scheme;——默认不会转发该头(它不是 RFC 7239 标准头,属事实标准)。改完 asadmin restart-domain 生效。
Q2:curl: (7) Failed to connect to example.com port 8181: Connection refused 怎么办?
说明跳转目标端口不可达,而非跳转逻辑错。默认 http-listener-2 端口就是 8181(GF 4.1 起一直未变),但 address 若被改成 127.0.0.1 则外部永远连不上:
asadmin get 'server-config.network-config.protocols.protocol.http-listener-2.address' # 期望 0.0.0.0
asadmin set 'server-config.network-config.protocols.protocol.http-listener-2.address=0.0.0.0'
firewall-cmd --list-ports # 需含 8181/tcp 或 443/tcp
firewall-cmd --permanent --add-port=443/tcp && firewall-cmd --reload
生产环境建议直接把 http-listener-2.port 改为 443(需 root 或 setcap cap_net_bind_service),避免在 URL 里暴露 8181,也顺带解决云安全组只放行 443 的问题。
Q3:部署时报 DeploymentException,提示解析 web.xml 失败?
描述符命名空间与 GlassFish 版本必须匹配,否则解析器直接拒绝。据 Jakarta EE 规范,GF 7.0 只认 Jakarta 命名空间,GF 4.1.2 只认 Java EE 7:
<!-- GF 7.0:Jakarta EE 10 / Servlet 6.0 -->
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
version="6.0">
<!-- GF 4.1.2:Java EE 7 / Servlet 3.1 -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="3.1">
改完必须 asadmin undeploy app && asadmin deploy --force=true app.war,热替换不会重新解析描述符。
Q4:浏览器报 NET::ERR_CERT_AUTHORITY_INVALID 或 ERR_CERT_COMMON_NAME_INVALID?
前者是链不完整(只装了站点证书、漏了中间证书),后者是 SAN 未覆盖当前域名。用 keytool 看链长度与 SAN:
keytool -list -v -keystore domains/domain1/config/keystore.jks -alias s1as -storepass changeit | grep -E 'Certificate[|Owner|DNSName'
若只输出 Certificate[1],说明缺中间证书,需用 keytool -importcert 或 openssl pkcs12 -export 重新导入完整链;域名不符则按 Let’s Encrypt 文档用 certbot -d example.com -d www.example.com --expand 重新签发。
Q5:javax.net.ssl.SSLHandshakeException: no cipher suites in common?
客户端与服务端无交集。逐版本探测能立刻定位是 TLS 版本问题还是套件问题:
openssl s_client -connect example.com:443 -tls1_2 </dev/null 2>&1 | grep -E 'Cipher|Protocol'
openssl s_client -connect example.com:443 -tls1_3 </dev/null 2>&1 | grep -E 'Cipher|Protocol'
若仅 -tls1_3 成功,说明老客户端被拒;若都失败,检查 $JAVA_HOME/conf/security/java.security 里的 jdk.tls.disabledAlgorithms(JDK 8u321+ 默认禁用 TLS 1.0/1.1 与 3DES)。可用 asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.tls-enabled=true 并对照 Mozilla SSL Configuration Generator 的 Intermediate 配置补齐套件。
Q6:sun.security.validator.ValidatorException: PKIX path building failed?
这是 GlassFish 作为客户端调用自签或私有 CA 后端时的典型报错,根因是域 truststore 里没有后端 CA。导入后重启域:
# cacerts.jks 默认口令 changeit(与 keystore.jks 相同)
keytool -importcert -noprompt -keystore domains/domain1/config/cacerts.jks
-alias backend -file backend.crt -storepass changeit
asadmin restart-domain # 修改 truststore 后必须重启,JVM 不会热加载
排查顺序建议固定为:跳转环 → 端口可达性 → 证书链 → 套件 → truststore。前两步能覆盖绝大多数 glassfish 强制https 场景下的线上故障,后三步多为部署期问题。
怎么验证 GlassFish 强制 HTTPS 已经生效?6 条可复现的检查命令
验证 GlassFish 强制 HTTPS 不能只看浏览器地址栏变绿——那只说明证书有效,不说明跳转生效。下面 6 条命令按”跳转 → 终态 → 证书 → 协议 → 套件 → 容器配置”的顺序逐层排除,每条都给期望输出与失败判据。命令在 GlassFish 4.1 / 5.1 / 6.2 / 7.0 上通用,本机端口按默认 8080(HTTP)与 8181(HTTPS)书写,生产环境替换为 80/443。
1. HTTP 是否真的跳转?
# -I 只取响应头,避免下载整个页面;-s 静默进度条
curl -sI http://127.0.0.1:8080/ | head -n 5
# 期望:
# HTTP/1.1 302 Found
# Location: https://example.com/
若首行是 HTTP/1.1 200,说明 <security-constraint> 未被加载,或 <url-pattern> 没覆盖你请求的路径。据 Servlet 规范(Jakarta Servlet 6.0 §13.8.1),CONFIDENTIAL 传输保证由容器实施重定向,因此 200 几乎总是配置问题而非容器缺陷。常见坑:url-pattern 写成 / 只匹配根路径,需用 /*。
2. 终态与 HSTS 头
curl -sI https://example.com/ | head -n 1
# 期望 HTTP/1.1 200
curl -sI https://example.com/ | grep -i strict-transport-security
# 期望 strict-transport-security: max-age=31536000; includeSubDomains
HSTS 头若缺失,说明它是由 Nginx 的 add_header 注入而非 GlassFish 自身(GF 的 security-constraint 不生成该头)。据 RFC 6797 §6.1,max-age 是必选参数;首次上线建议先设 300 秒灰度,确认全站 HTTPS 后再拉到 31536000。
3. 证书链与有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 期望 subject=CN = example.com(或 SAN 含该域名)
# notBefore / notAfter 区间合理
-servername 不可省,否则 SNI 未发送,可能拿到默认虚拟主机的证书。据 Let’s Encrypt 文档,其证书有效期固定 90 天,notAfter 距今天超过 90 天就说明你看的不是 LE 证书。
4. 协议版本
openssl s_client -connect example.com:443 -tls1 </dev/null # 期望 handshake failure
openssl s_client -connect example.com:443 -tls1_2 </dev/null # 期望 Verify return code: 0
openssl s_client -connect example.com:443 -tls1_3 </dev/null # GF 7.0 起可用
TLS 1.0 仍能握手,意味着 jdk.tls.disabledAlgorithms 未生效或域未重启。该属性由 JDK 的 java.security 控制,GF 通过 asadmin create-jvm-options 覆盖;改完必须 asadmin restart-domain,仅 stop/start-instance 不够。
5. 弱套件排查
nmap --script ssl-enum-ciphers -p 443 example.com
# 或用 testssl.sh 直接出评级
./testssl.sh --severity HIGH https://example.com
重点看是否仍列出 RC4、3DES、TLS_RSA_WITH_AES_128_CBC_SHA(无前向保密)。出现即需在 ssl-config 的 ssl-ciphers 中收窄,参考 Mozilla Server Side TLS 的 intermediate 配置。
6. 容器侧实际生效值
asadmin get "server-config.network-config.protocols.protocol.http-listener-2.ssl"
# 输出逐项含:cert-nickname、ssl3-enabled=false、tls-enabled=true、
# tls11-enabled=false、client-auth、classname 等
这条命令的价值在于”一次性看到全部键值”,管理控制台需要点进多层页面,容易漏掉 ssl3-enabled 之类的遗留开关。把它与预期清单逐项比对,比截图可靠。若 cert-nickname 指向 s1as(默认自签别名),说明你还在用安装时生成的证书,浏览器会告警。
| 检查项 | 命令 | 通过判据 | 失败含义 |
|---|---|---|---|
| 跳转 | curl -sI http://… |
301/302 + Location | security-constraint 未加载 |
| 终态 | curl -sI https://… |
200 | 后端或监听器故障 |
| HSTS | grep -i strict-transport |
含 max-age | Nginx 未加头 |
| 证书 | openssl s_client |
CN/SAN 匹配、未过期 | 别名或 SNI 错误 |
| 协议 | -tls1 / -tls1_2 |
前者失败后者成功 | JVM 选项未重启生效 |
| 套件 | nmap ssl-enum-ciphers |
无 RC4/3DES | ssl-ciphers 过宽 |
一个高频追问:为什么 curl 显示 302 但浏览器仍是 http?检查 Location 是否指向了内网主机名(如 https://localhost:8181/),这通常是因为 Nginx 的 proxy_set_header Host 没透传,导致 GF 按自身监听器拼出重定向地址。
GlassFish 强制 HTTPS 之后的加固:TLS 版本、密码套件与 HSTS
为什么加了 HTTPS 还不够?GlassFish 默认会跟随 JDK 的协议与算法集,但这不等于你已经把 TLS 1.0/1.1、RC4、3DES 关掉;而且强制跳转只覆盖 8080 业务端口,4848 管理端口往往仍是明文 HTTP。下面四件事做完,才算真正加固。
1. 禁用旧协议:改 JVM 参数还是改监听器?推荐 JVM 级(对所有实例生效),监听器级只作补充。
# 1) 先确认实际运行的 JDK(GF 6.2.5 / 7.0 官方推荐 JDK 11 或 17)
asadmin list-jvm-options | grep -i disabledAlgorithms
java -version
# JDK 8 的配置文件在 jre/lib/security/java.security;JDK 9+ 在 conf/security/java.security
grep -n "^jdk.tls.disabledAlgorithms" "$JAVA_HOME/conf/security/java.security"
# 2) 追加到 GlassFish(作用于 DAS 与所有实例的整个 JVM,而非单个 listener)
asadmin create-jvm-options "-Djdk.tls.disabledAlgorithms=TLSv1,TLSv1.1,RC4,3DES"
# 3) 顺手关掉 SSLv3(http-listener-2 为默认 HTTPS 监听器,端口 8181)
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.ssl3-enabled=false
asadmin restart-domain domain1
# 4) 验证:旧协议必须握手失败
openssl s_client -connect gf.example.com:8181 -tls1_1
# 预期输出:sslv3 alert handshake failure / no protocols available
openssl s_client -connect gf.example.com:8181 -tls1_2 -servername gf.example.com
注意:
create-jvm-options重复执行会报already exists,需先asadmin delete-jvm-options "-Djdk.tls.disabledAlgorithms=..."。据 OpenSSL 文档,握手被拒时客户端看到的是tlsv1 alert protocol version;若服务端日志出现javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate),说明算法确实被 JDK 屏蔽了——这正是预期行为。JDK 8u321 起jdk.tls.disabledAlgorithms默认已含TLSv1, TLSv1.1, RC4, 3DES_EDE_CBC,所以升级 JDK 比手写参数更省事。
| 参数 | 配置位置 | 默认值 | 建议值 / 取值范围 |
|---|---|---|---|
jdk.tls.disabledAlgorithms |
JVM 选项(全局) | 随 JDK 版本而定,8u321+ 已含 TLSv1/TLSv1.1 | 追加 RC4,3DES,DH keySize < 2048 |
ssl3-enabled |
protocol.http-listener-2.ssl |
false | 保持 false |
HSTS max-age |
响应头 / Nginx | 未设置 | 300 → 31536000(秒) |
admin-listener.address |
network-listeners |
0.0.0.0(4848 全网可达) | 127.0.0.1 |
| keystore 密码 / 别名 | domain.xml |
changeit / s1as |
与 asadmin 保持同步 |
2. HSTS 为什么必须灰度?因为浏览器一旦缓存了 max-age=31536000,你在一年内都回不到 HTTP,任何漏改的 http:// 资源都会直接白屏。首次上线先给 5 分钟:
# Nginx server 块;always 让 4xx/5xx 响应也带该头
add_header Strict-Transport-Security "max-age=300" always;
# 观察一周、DevTools 无 Mixed Content 告警后再换成:
# add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
据 hstspreload.org 说明,preload 只有在所有子域(含内网域名)都支持 HTTPS 后才能提交,且撤销需数月才能从各浏览器版本中移除,切勿随手加。
3. 证书续期怎么做到无人值守?Let’s Encrypt 证书有效期 90 天(据 Let’s Encrypt 官方文档),到期前 30 天续期。先用 --dry-run 把钩子跑通,再挂进 cron:
certbot renew --dry-run --deploy-hook "/opt/gf/reload-cert.sh"
#!/bin/bash
# /opt/gf/reload-cert.sh —— 把 PEM 转 PKCS12,再覆盖 GlassFish 的 keystore.jks
D=/opt/glassfish7/glassfish/domains/domain1/config
openssl pkcs12 -export -in /etc/letsencrypt/live/example.com/fullchain.pem
-inkey /etc/letsencrypt/live/example.com/privkey.pem
-name s1as -out /tmp/site.p12 -passout pass:changeit
keytool -importkeystore -srckeystore /tmp/site.p12 -srcstoretype PKCS12
-srcstorepass changeit -destkeystore $D/keystore.jks -deststoretype JKS
-deststorepass changeit -destkeypass changeit -srcalias s1as -destalias s1as -noprompt
/opt/glassfish7/bin/asadmin restart-domain domain1 # 或 restart-instance 减少中断
GlassFish 4.1 只认 JKS,5/6/7 才原生支持 PKCS12,采购证书前务必确认 CA 能提供含完整中间链的 fullchain。
| 类型 | 代表 CA | 参考价(元/年) | 适用场景 |
|---|---|---|---|
| 免费 DV | Let’s Encrypt、ZeroSSL | 0(90 天,需自动化续期) | 绝大多数公网站点 |
| 付费 DV | Sectigo、GeoTrust | 约 100–400 | 需要一年期、免运维 |
| OV | DigiCert、GlobalSign | 约 2000–6000 | 企业站点、需组织信息展示 |
| EV | 同上 | 更高 | 金融、政企合规要求 |
据 CA/Browser Forum Baseline Requirements(SC-081),公信证书有效期当前上限为 398 天,2026 年 3 月起缩短至 200 天、2027 年至 100 天、2029 年至 47 天——续期自动化不再是可选项。
4. 混合内容与管理口怎么收尾?Chrome DevTools Console 会逐条打印 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...',把图片、脚本、字体的 http:// 改成 // 或 https://;Servlet 应用可在过滤器中加 Content-Security-Policy: upgrade-insecure-requests 作过渡。管理面则必须隔离:
asadmin set server-config.network-config.network-listeners.network-listener.admin-listener.address=127.0.0.1
asadmin restart-domain domain1
# 之后通过 SSH 隧道访问:ssh -L 4848:127.0.0.1:4848 user@host
否则强制 HTTPS 只覆盖了业务端口,4848 仍是明文管理入口,这正是 GlassFish 强制 HTTPS 配置里最容易被漏掉的一环。
不是必须。可以在 Nginx 或 Apache 前置层用 return 301 https://$host$request_uri 统一跳转,GlassFish 只监听 127.0.0.1:8080;也可以直接把 http-listener-2 端口改成 443 并停用 http-listener-1。web.xml 的 transport-guarantee 好处是随应用走,换代理也不会漏。
两种做法:一是 asadmin set server-config.network-config.network-listeners.network-listener.http-listener-2.port=443 后重启域;二是保留 8181 只在本地监听,由 Nginx 对外提供 443 并设置 X-Forwarded-Proto,同时在 GlassFish 配置 scheme-mapping=X-Forwarded-Proto。
Tomcat 同样支持 web.xml 的 transport-guarantee,但需要 Connector 的 redirectPort 指向 8443;Spring Boot 内嵌 Tomcat 时更常用 server.ssl.enabled=true 配合 Spring Security 的 requiresChannel().requiresSecure()。GlassFish 作为完整 Java EE / Jakarta EE 容器,约束写在应用描述符里,由容器统一处理跳转。
先看跳转链:curl -sIL http://example.com/ 观察 Location 是否在 http 与 https 之间来回。最常见原因是代理层终止 TLS 但 GlassFish 未识别,补上 scheme-mapping=X-Forwarded-Proto 并确认 Nginx 发送了该头;其次是 web.xml 与 Nginx 同时做跳转且端口不一致。
GF 7.0 使用 Jakarta EE 10,web-app 根元素必须是 xmlns="https://jakarta.ee/xml/ns/jakartaee" version="6.0";GF 6.2.5 用 version="5.0"。如果项目仍是 javax.* 依赖,需要先迁移到 jakarta.* 或退回 GlassFish 5.1.0(Servlet 4.0)。
用 certbot renew –deploy-hook 挂一个脚本:把 fullchain.pem 与 privkey.pem 合成 PKCS12,keytool -importkeystore 覆盖 domain1/config/keystore.jks,再执行 asadmin restart-domain domain1。证书 90 天有效,建议在到期前 30 天续期并保留一次手工回滚的旧 keystore 备份。
不需要。把 admin-listener 绑定到 127.0.0.1,通过 SSH 端口转发访问 https://localhost:4848 更安全;如果必须远程管理,可启用 admin 的 secure-admin 并限制来源 IP,避免只给业务端口做了 HTTPS 而管理面仍是明文。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。