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

GlassFish 强制 HTTPS 实战:web.xml、asadmin 与 Nginx 三层配置(GF 4.1–7.0)

glassfish 强制https — 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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