GlassFish SSL 证书安装实战:keytool 导入、asadmin 配置与 7 类报错排查
GlassFish SSL 证书安装的核心是把 CA 签发的服务器证书与中间证书导入域使用的 PKCS12/JKS 密钥库,并在 http-listener-2 的 SSL 配置中指定 cert-nickname;默认端口 8181,生产常改为 443,改完重启后用 openssl s_client 验证。 默认域密钥库是 domains/domain1/config/keystore.jks,默认别名 s1as、默认口令 changeit;只替换文件不改 cert-nickname,握手仍会返回自签证书。 keytool 生成 CSR 时用 RSA 2048 或 ECDSA P-256,导入 fullchain 后 keytool -list -v 应显示 Certificate chain length: 3,否则浏览器常见 NET::ERR_CERT_AUTHORITY_INVALID。 GlassFish 7.0.x 配 JDK 17 可启用 tls13-enabled=true;GlassFish 4.1.2 配 JDK 8 通常只到 TLS 1.2,应关闭 ssl3-enabled、tls11-enabled。 Let's Encrypt 证书有效期 90 天,用 certbot renew --deploy-hook 转 PKCS12 并 asadmin restart-domain,单次重启约 10-30 秒;商业 OV 约 800-3000 元/年,EV 约 2000-8000 元/年。
为什么 GlassFish SSL 证书安装后浏览器仍报证书不受信任?5 个根因
答:GlassFish 4.x/5.x 里默认的 HTTPS 监听器叫 http-listener-2(端口 8181,HTTP 监听器 http-listener-1 是 8080,管理端口 4848)。它的 SSL 参数全部挂在 configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl 这个节点下,默认证书别名 s1as,密钥库 domains/domain1/config/keystore.jks,默认库口令 changeit。90% 的“证书装了但浏览器仍报不受信任”都落在下面 5 个根因里。
- 只换了 keystore.jks,没改 cert-nickname。GlassFish 不会自动挑“最新导入的那张证书”,它认死
cert-nickname。你把正式证书导进库、别名却叫glassfish,握手仍然返回库里的s1as自签证书——浏览器自然不认。这是 GlassFish SSL 证书安装里最隐蔽的一类。 - 只导入服务器证书,漏了中间证书。据 Let’s Encrypt 文档,要导入的是
fullchain.pem(服务器证书 + 中间证书),不是cert.pem。只发一张证书时 Chrome 报NET::ERR_CERT_AUTHORITY_INVALID,Java 客户端报PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。 - 证书与私钥不匹配。典型场景:CSR 在测试机生成、证书导入生产机。此时
keytool -list -v -alias glassfish打出的 SHA-256 指纹与 CA 后台记录对不上,服务端日志出现no cipher suites in common或certificate_unknown。 - security-enabled 被关掉。该属性为
false时 8181 端口实际跑明文 HTTP。GlassFish 4.1.2 出厂默认是true,但复制别人的domain.xml、或用asadmin create-protocol新建 listener 后经常被写成false。 - 协议与套件过旧。只开 TLS 1.0/1.1 会被 Chrome 120+、Firefox 120+ 直接拒绝。据 Mozilla Server Side TLS 指南与 RFC 8446,公网服务至少启用 TLS 1.2、优先 TLS 1.3,并禁用 SSLv3、RC4、3DES。
# ① 看监听器真实生效的别名与安全开关(GlassFish 4.1.2 / 5.1 / Payara 5 通用)
asadmin get "configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname"
asadmin get "configs.config.server-config.network-config.protocols.protocol.http-listener-2.security-enabled"
# 默认值分别为 s1as / true;若输出不是你的正式证书别名,就是根因 1
# ② 看服务端实际发出的证书链:只出现 depth=0 一张 = 漏中间证书(根因 2)
openssl s_client -connect shop.example.com:8181 -servername shop.example.com -showcerts /dev/null
| grep -E "^(depth|verify return code)"
# 期望:depth=1、depth=0 两级,且 verify return code: 0 (ok)
# ③ 比对指纹:SHA256 必须与 CA 后台记录完全一致(根因 3)
keytool -list -v -keystore domains/domain1/config/keystore.jks -alias glassfish -storepass changeit | grep "SHA256:"
| 根因 | 典型报错 / 现象 | 一条命令定位 | 修复动作 |
|---|---|---|---|
| 别名未改 | 证书链 subject 仍是 CN=s1as | openssl s_client ... | grep subject |
asadmin set ...ssl.cert-nickname=glassfish |
| 缺中间证书 | ERR_CERT_AUTHORITY_INVALID / PKIX path building failed | openssl s_client -showcerts 只 1 张 |
导入 fullchain,链序 服务器→中间→根 |
| 证书私钥不匹配 | no cipher suites in common / certificate_unknown | keytool -list -v 比对 SHA256 |
用同一台机器的 CSR 重签 |
| 安全开关关闭 | 8181 返回纯 HTTP、无 TLS 握手 | asadmin get ...security-enabled |
设为 true 后重启域 |
| 协议过旧 | ERR_SSL_VERSION_OR_CIPHER_MISMATCH | openssl s_client -tls1_2 失败 |
开 TLS 1.2/1.3,关 SSLv3 |
# 一次性修正别名、安全开关与协议版本(改完必须 restart-domain,动态重载不生效)
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=glassfish
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.security-enabled=true
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.ssl3-enabled=false
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.tls-enabled=false # 关 TLS 1.0
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.tls11-enabled=false
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.tls12-enabled=true
# Payara 5.2021+ / GlassFish 7 才有 tls13-enabled;GlassFish 4.1.2 无此属性,设了会报错
asadmin restart-domain
注意 ssl3-enabled 出厂即 false,tls-enabled(对应 TLS 1.0)在 GlassFish 4.1.2 里默认 true——这正是老实例被新浏览器判为不安全的原因。另外,改 domain.xml 后未重启、或改的是 DAS 配置而实例用的是 configs.config.<cluster>-config,也会让修改“看起来没生效”,排查时先用 asadmin get 确认读到的值与文件里写的一致。
GlassFish SSL 证书安装完整实操步骤:从备份到重启的 9 步
动手之前先回答一个高频问题:能不能不停域直接换证书?不能。GlassFish 在启动时把 keystore.jks(或 .p12)读进 JVM 内存并持有文件句柄,运行中覆盖会出现”证书已换、浏览器仍显示旧证书”的假象,所以 GlassFish SSL 证书安装的第一步永远是停域 + 备份。以下 9 步在 GlassFish 4.1.2(JDK 8)与 7.0.21(JDK 17)上均验证通过。
步骤 1–2:停域、备份、确认版本
# 1) 停域:避免热拷贝拿到半写状态的 keystore
asadmin stop-domain domain1
# 2) 备份域配置与默认信任库(-a 保留属主/权限/时间戳,便于回滚)
mkdir -p /backup
cp -a domains/domain1/config/keystore.jks /backup/keystore.jks.$(date +%F)
cp -a domains/domain1/config/cacerts.jks /backup/cacerts.jks.$(date +%F)
# 3) 记录版本:JDK 决定 keytool 的默认 storetype,别凭记忆
asadmin version
java -version
| GlassFish 版本 | 配套 JDK | keytool 默认 -storetype | 实操注意点 |
|---|---|---|---|
| 7.0.x | JDK 17(最低 11) | PKCS12 | 密钥库与私钥口令必须一致,否则报 Warning: Different store and key passwords not supported for PKCS12 |
| 6.2.x | JDK 11 | PKCS12 | 同上;cacerts.jks 可继续用 JKS 格式 |
| 4.1.2 | JDK 8 | JKS | JDK 8 起 keytool 生成新库已默认 PKCS12,务必显式写 -storetype |
| 3.1.x | JDK 7 | JKS | 不支持 ECDSA 证书,只能用 RSA |
据 Oracle《keytool》文档,JDK 9 起 -storetype 默认值由 JKS 改为 PKCS12,因此命令里一律显式声明,避免在 JDK 8/17 之间来回切换时踩坑。
步骤 3:生成私钥与 CSR
# 生成 2048 位 RSA 私钥并自建 PKCS12 库(-dname 中的 CN 必须等于证书要保护的主机名)
keytool -genkeypair -alias glassfish -keyalg RSA -keysize 2048
-sigalg SHA256withRSA -validity 365
-dname "CN=www.example.com,O=Example,C=CN"
-keystore glassfish.p12 -storetype PKCS12
-storepass StrongPass -keypass StrongPass
# 导出 CSR 交给 CA(Let's Encrypt / DigiCert / 企业内 CA 均可)
keytool -certreq -alias glassfish -keystore glassfish.p12
-storetype PKCS12 -storepass StrongPass -file glassfish.csr
步骤 4:先装根证书与中间证书
# 顺序很重要:先根、后中间,最后才是服务器证书,否则链不完整
keytool -importcert -alias root -file root.crt
-keystore glassfish.p12 -storetype PKCS12 -storepass StrongPass -noprompt
keytool -importcert -alias intermediate -file intermediate.crt
-keystore glassfish.p12 -storetype PKCS12 -storepass StrongPass -noprompt
别名 root、intermediate 绝不能与 glassfish 重名——同名导入会直接覆盖私钥条目,私钥丢失后只能重新签发。据 RFC 5280,服务器必须下发除根证书外的完整链,所以中间证书必须入链。
步骤 5:用 fullchain 替换服务器证书
# fullchain.crt = 服务器证书 + 中间证书(Let's Encrypt 的 fullchain.pem 即此结构)
keytool -importcert -alias glassfish -file fullchain.crt
-keystore glassfish.p12 -storetype PKCS12 -storepass StrongPass -noprompt
# 成功标志:Certificate reply was installed in keystore
keytool -list -v -alias glassfish -keystore glassfish.p12 -storetype PKCS12 -storepass StrongPass | grep "Certificate chain length"
输出应为 Certificate chain length: 3(服务器证书 + 中间证书 + 根)。若仍是 1,说明 fullchain 文件里只放了叶子证书。
步骤 6–7:部署到域配置并指定别名
cp glassfish.p12 domains/domain1/config/
随后在管理控制台依次进入 Configurations > server-config > HTTP Service > Http Listeners > http-listener-2 > SSL,设置 Certificate Nickname=glassfish、Key Store=config/glassfish.p12、Trust Store=config/cacerts.jks。习惯命令行的可用等价写法:
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=glassfish
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.key-store=config/glassfish.p12
asadmin restart-domain domain1
步骤 8–9:改端口、放行、重启验证
# 生产环境把默认 8181 改为 443
asadmin set configs.config.server-config.network-config.network-listeners.network-listener.http-listener-2.port=443
# Linux 非 root 用户绑定 1024 以下端口(JDK 升级后需重新执行)
sudo setcap 'cap_net_bind_service=+ep' $JAVA_HOME/bin/java
# 重启并确认监听与握手
asadmin restart-domain domain1
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts | head -n 5
tail -n 50 domains/domain1/logs/server.log
云环境记得在安全组放行 443/TCP,同时保留 8080 给内网健康检查使用——健康检查走 HTTP 端口可以避免证书链问题导致实例被误判下线。至此一次完整的 GlassFish SSL 证书安装结束;server.log 中出现 Grizzly SSL 相关异常时,优先回到步骤 5 检查链长度与别名拼写。
GlassFish SSL 证书安装的配置片段:domain.xml、asadmin 与 keytool 参数
domain.xml 里到底要改哪几行?GlassFish 的 HTTPS 由 network-listener 与同名 protocol 绑定,证书相关配置全部落在 <ssl> 子元素里。下面是最小可用片段(文件位置 domains/domain1/config/domain.xml):
<network-listener name="http-listener-2" port="8181"
protocol="http-listener-2" transport="tcp" />
<protocol name="http-listener-2" security-enabled="true">
<!-- ssl3/tls1.0/1.1 全部关闭;据 RFC 8996,TLS 1.0/1.1 已于 2021 年正式弃用 -->
<ssl cert-nickname="glassfish"
ssl3-enabled="false" tls-enabled="true"
tls11-enabled="false" tls12-enabled="true" tls13-enabled="true">
<!-- password 支持 ${ALIAS=别名} 引用 asadmin create-password-alias 生成的密文 -->
<classic-key-store file="${com.sun.aas.instanceRoot}/config/glassfish.p12"
type="PKCS12" password="${ALIAS=glassfishStorePass}" />
</ssl>
</protocol>
直接手改 domain.xml 需要重启,且容易写坏 XML;更稳妥的是用 asadmin 改,改完 asadmin restart-domain 即可。注意路径前缀随版本略有差异:
# 先确认当前实例里到底叫 classic-key-store 还是 key-store(4.x 早期/部分衍生版为后者)
asadmin get 'configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.*'
P=configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl
asadmin set "$P.cert-nickname=glassfish"
asadmin set "$P.classic-key-store.file=${com.sun.aas.instanceRoot}/config/glassfish.p12"
asadmin set "$P.classic-key-store.type=PKCS12"
asadmin set "$P.classic-key-store.password=${ALIAS=glassfishStorePass}"
asadmin set "$P.tls12-enabled=true"
asadmin set "$P.tls11-enabled=false"
asadmin set "$P.ssl3-enabled=false"
怎么确认证书本身没问题?用 keytool 反查,别只看文件大小:
keytool -list -v -keystore glassfish.p12 -storetype PKCS12
-storepass:env STOREPASS -alias glassfish
# 期望输出关键行:
# Alias name: glassfish
# Entry type: PrivateKeyEntry
# Certificate chain length: 3
# Subject Public Key Algorithm: 2048-bit RSA key
# Signature algorithm name: SHA256withRSA
# Valid from: ... until: ... ← 必须覆盖当前日期
老 JKS 或 Let’s Encrypt 的 PEM 怎么变成 PKCS12?两条路,任选其一:
# 1) JKS → PKCS12(成功会打印 Importing keystore old.jks to glassfish.p12...)
keytool -importkeystore -srckeystore old.jks -srcstoretype JKS
-destkeystore glassfish.p12 -deststoretype PKCS12
-deststorepass "$STOREPASS" -destkeypass "$STOREPASS" -noprompt
# 2) PEM → PKCS12;-name 必须等于 cert-nickname,据 OpenSSL 3.0 文档该参数写入 friendlyName
openssl pkcs12 -export -out glassfish.p12 -inkey privkey.pem
-in fullchain.pem -name glassfish -passout pass:"$STOREPASS"
openssl pkcs12 -info -in glassfish.p12 # 期望 MAC verified OK
Let’s Encrypt 文档强调要使用 fullchain.pem(含中间证书)而非 cert.pem,否则链长度只有 1,浏览器与 Java 客户端都会报 PKIX 错误。迁移完务必再跑一次 keytool -list -v 核对 Certificate chain length。
权限与密码怎么管?keystore 是 600 敏感文件,GlassFish 进程用户必须可读:
umask 077
chown glassfish:glassfish glassfish.p12
chmod 600 glassfish.p12
restorecon -Rv domains/domain1/config # 仅 RHEL/CentOS 且启用 SELinux
read -s -p "storepass: " STOREPASS; echo # 避免写进 shell history
| ssl.* 属性 | 默认值 | 建议值 | 说明 |
|---|---|---|---|
| cert-nickname | s1as | glassfish | 必须与 keytool/openssl 的 alias、-name 完全一致,大小写敏感 |
| classic-key-store.type | JKS | PKCS12 | JDK 9 起 PKCS12 为默认 keystore 类型 |
| tls11-enabled | 4.1 为 true,5.x 起 false | false | 保留旧值会触发 PCI DSS 扫描告警 |
| tls13-enabled | 4.1.1 为 false,5.x 起 true | true | 需 JDK 11+ 才真正生效,见 RFC 8446 |
| ssl3-enabled | false | false | POODLE 漏洞后一律禁用 |
密码填错时最典型的报错是 java.io.IOException: Keystore was tampered with, or password was incorrect;alias 拼错则是 java.security.KeyStoreException: Cannot get key for alias。改完配置重启后,可用 openssl s_client -connect host:8181 -servername host -tls1_2 验证协商到的协议版本与证书链,这与 Mozilla SSL Configuration Generator 推荐的验证方式一致,也是后续排查握手失败的第一手证据。
GlassFish SSL 证书安装方案对比:JKS、PKCS12、PEM 与 Let's Encrypt 怎么选
问:拿到证书后第一步该确认什么?先别改文件扩展名。GlassFish 4.1/5.1 新建域默认在 domains/domain1/config/keystore.jks 生成 JKS 密钥库,别名固定为 s1as,默认口令 changeit。用 keytool 确认实际类型(据 Oracle JDK keytool 文档,-list 会回显 Keystore type):
# 判断真实存储类型,扩展名不可信
keytool -list -v -keystore domains/domain1/config/keystore.jks -storepass changeit
# 典型输出:
# Keystore type: JKS
# Your keystore contains 1 entry
# s1as, 2024-03-11, PrivateKeyEntry,
# Certificate fingerprint (SHA-256): 3A:...
若输出为 JKS,把文件名改成 .p12 只会让后续 -storetype PKCS12 解析失败,报 keytool error: java.io.IOException: Invalid keystore format。老域升级必须先做一次转换:
# JKS → PKCS12;PKCS12 要求 storepass 与 keypass 完全一致,否则 keytool 只给 warning 并忽略 -destkeypass
keytool -importkeystore
-srckeystore domains/domain1/config/keystore.jks -srcstoretype JKS -srcstorepass changeit
-destkeystore domains/domain1/config/glassfish.p12 -deststoretype PKCS12
-deststorepass 'Str0ngPassw0rd!' -destkeypass 'Str0ngPassw0rd!'
-srcalias s1as -destalias s1as
# 校验
openssl pkcs12 -info -in domains/domain1/config/glassfish.p12 -noout
| 方案 | 适用版本 | 关键参数/命令 | 限制与成本 |
|---|---|---|---|
| JKS | GlassFish 4.1 / 5.1 默认 | -storetype JKS,别名 s1as |
私有格式;新版 keytool 默认已改为 PKCS12,跨 JDK 迁移易踩坑 |
| PKCS12 | 5.1 / 6.2 / 7.0 推荐 | -storetype PKCS12,-destkeypass 与 -deststorepass 必须相同 |
单文件可移植,被 OpenSSL/Nginx 共用;密码不一致时 keypass 被静默忽略 |
| PEM 转换 | 证书源自 Nginx / certbot | openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -name glassfish -out glassfish.p12 |
GlassFish 不直接读 PEM,必须先转 PKCS12/JKS,多一步导出 |
| Let’s Encrypt | 公网 DV | 90 天有效期,certbot renew --deploy-hook 自动续期并重载域 |
免费;需开放 80/443 做 HTTP-01 验证,续期链路必须可自动化 |
| 商业 OV/EV | 企业站点 | 1 年期,含组织核验 | DV 约 0–300 元/年,OV 约 800–3000 元/年,EV 约 2000–8000 元/年 |
问:EV 证书还值得买吗?不值得为“绿条”加预算——Chrome 桌面版自 77 起已移除 EV 的绿色公司名指示,Firefox 同理。内网测试用自签 365 天即可;公网 DV 选 Let’s Encrypt(90 天)或商业 DV;需要向审计方展示组织主体时才考虑 OV。PEM 转 PKCS12 的完整序列:
# certbot 产物:fullchain.pem 已含站点证书+中间证书
openssl pkcs12 -export -in /etc/letsencrypt/live/example.com/fullchain.pem
-inkey /etc/letsencrypt/live/example.com/privkey.pem
-name glassfish -out /opt/glassfish/domains/domain1/config/glassfish.p12
-passout pass:'Str0ngPassw0rd!'
# 指向新库并让 listener 使用该别名(asadmin 交互式执行)
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=glassfish
asadmin create-keystore? # 不存在此命令,密钥库路径由 JVM 参数指定,见下
GlassFish 读取密钥库依赖 JVM 参数 -Djavax.net.ssl.keyStore=.../glassfish.p12 与 -Djavax.net.ssl.keyStoreType=PKCS12,写在 domain.xml 的 <jvm-options> 中;仅改 cert-nickname 而不改这两个参数,启动会报 java.security.KeyStoreException: glassfish not found。监听器规划上,保留 http-listener-1 监听 8080 只做 301 跳转到 443,http-listener-2 独占 HTTPS——同一 listener 同时承载 HTTP/HTTPS 会导致 HSTS 预加载策略失效(参见 Mozilla SSL Configuration Generator 的 HSTS 建议)。
问:权限问题为什么总在重启后爆发?PKCS12 文件必须 chmod 600 且属主为运行 GlassFish 的用户;开启 SELinux 的 RHEL/CentOS 上,拷贝进来的证书会带错上下文,启动日志抛 java.nio.file.AccessDeniedException: /opt/glassfish/domains/domain1/config/glassfish.p12,修复命令:
chown glassfish:glassfish domains/domain1/config/glassfish.p12
chmod 600 domains/domain1/config/glassfish.p12
restorecon -Rv domains/domain1/config # SELinux 环境必做
密码策略上,PKCS12 的 storepass 与 keypass 必须一致且建议 ≥12 位;Let’s Encrypt 的自动续期可用 certbot renew --deploy-hook "openssl pkcs12 -export ... && asadmin restart-domain domain1" 串起来,据 Let’s Encrypt 文档,续期在到期前 30 天内触发,--deploy-hook 只在真正续期成功后执行,正好用来避免无谓重启。
GlassFish SSL 证书安装常见错误与排查:6 条真实报错信息
下面 6 条报错均取自 GlassFish 5.1 / 6 / 7 的 server.log 与浏览器控制台的原样输出。排查顺序建议“先入站、后出站”:先确认证书本身与密钥库密码,再查信任链,最后查端口与协议。凡涉及修改 domain.xml 的操作,改完都必须 asadmin restart-domain,因为 SSL 上下文在 domain 启动时一次性加载,asadmin set 之后不重启不会生效。
1. java.io.IOException: Keystore was tampered with, or password was incorrect 怎么修?
这是密码不一致的通用报错,不是文件损坏。两个原因:一是 storepass 与 GlassFish 中保存的密码不同;二是 JDK 9 起 keytool 默认生成 PKCS12(不再是 JKS),而 PKCS12 规范要求 keypass 必须等于 storepass,JKS 允许两者不同——所以“同一份证书从 JKS 转 PKCS12 后突然报错”几乎都是 keypass 没对齐。先验证密码本身:
# 密码正确时会列出条目;报 "password was incorrect" 说明 storepass 错
keytool -list -keystore glassfish.p12 -storetype PKCS12 -storepass 'StrongPass'
# 若 keypass 与 storepass 不同,就地重设(PKCS12 必须一致)
keytool -importkeystore -srckeystore glassfish.p12 -srcstoretype PKCS12
-srcstorepass 'OldPass' -destkeystore glassfish.p12 -deststoretype PKCS12
-deststorepass 'StrongPass' -destkeypass 'StrongPass'
asadmin restart-domain # 密码改动后必须重启 domain
2. java.security.KeyStoreException: keystore password was incorrect 为什么改了密码还是错?
典型场景是把测试域的 domain.xml 整段复制到生产域。GlassFish 用主密码(master password,默认 changeit,加密后存于 domains/domain1/config/domain-passwords)对 classic-key-store.password 做对称加密,换域后主密码不同,密文解不开,于是报 keystore password incorrect——此时你看到的 {AES256}... 并不是真实密码。先确认字段状态:
asadmin --user admin get 'server-config.network-config.protocols.protocol.http-listener-2.ssl.classic-key-store.password'
# 输出形如 {AES256}LxQ...= 表示已被主密码加密
# 方案 A:统一主密码后重新写入条目密码
asadmin change-master-password --savemasterpassword=true domain1
# 方案 B:直接在 admin 控制台 Configurations > server-config > HTTP Service > Http Listener 2
# 的 SSL 页重新输入 keystore 密码并保存(会以新主密码重新加密)
3. PKIX path building failed 是证书装错了吗?
不是。据 Oracle GlassFish 管理指南,该异常出现在 GlassFish 作为客户端访问上游 HTTPS(支付网关、OAuth、LDAP over TLS)时,属于出站信任链缺失,与你对外提供的 HTTPS 证书无关。把上游根 CA 导入 domain 的信任库(默认 config/cacerts.jks,默认密码 changeit):
keytool -importcert -alias upstream-ca -file ca.crt
-keystore domains/domain1/config/cacerts.jks -storepass changeit -noprompt
asadmin restart-domain
# 若自定义了信任库,确认 JVM 参数指向它:
# asadmin create-jvm-options "-Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot}/config/cacerts.jks"
4. 浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 是证书买错了吗?
多数是证书缺少 SAN(Subject Alternative Name)。Chrome 58 起只校验 SAN,不再回退比对 CN,这与 RFC 6125 弃用 CN 的方向一致。先查:
openssl x509 -in fullchain.crt -noout -text | grep -A1 'Subject Alternative Name'
# 期望输出:DNS:www.example.com, DNS:example.com
自签证书用 OpenSSL 重签(-addext 需 OpenSSL 1.1.1+);用 keytool 生成则写 -ext SAN=dns:www.example.com,dns:example.com:
openssl req -x509 -newkey rsa:2048 -nodes -days 825
-keyout privkey.pem -out fullchain.crt
-subj "/CN=www.example.com"
-addext "subjectAltName=DNS:www.example.com,DNS:example.com"
商业证书缺 SAN 只能让 CA 重签,客户端任何配置都无法绕过。
5. SSL_ERROR_NO_CYPHER_OVERLAP 或 no cipher suites in common 怎么排查?
- HTTPS配置 · SSL证书安装服务(各种服务器)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
协议版本或套件交集为空。先看服务端开了什么:
asadmin get 'server-config.network-config.protocols.protocol.http-listener-2.ssl.*'
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.tls12-enabled=true
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.tls11-enabled=false
asadmin set server-config.network-config.protocols.protocol.http-listener-2.ssl.ssl3-enabled=false
asadmin restart-domain
# 用指定协议版本握手,验证是否只剩 1.3 可用
openssl s_client -connect host:443 -tls1_2 -servername www.example.com
| ssl.* 属性(http-listener-2) | 默认值 | 建议 |
|---|---|---|
| tls-enabled | true | 保留 |
| tls12-enabled | true | 保留,兼容面最广 |
| tls11-enabled / ssl3-enabled | false / false | 保持关闭 |
| tls13-enabled | GlassFish 6/7 提供 | JDK 8 环境不要只开 1.3 |
Java 8 默认不启用 TLS 1.3,若服务端只留 TLS 1.3,老客户端必然报 no cipher suites in common;可参考 Mozilla SSL Configuration Generator 的 Intermediate 配置对齐套件。
6. Address already in use: bind 导致 domain 起不来怎么办?
443 被 Nginx / Apache 抢先绑定。先定位进程:
ss -lntp | grep ':443'
# 输出示例:LISTEN 0 511 0.0.0.0:443 users:(("nginx",pid=1123,fd=6))
两种取舍:停掉占用进程;或让 Nginx 终止 TLS,GlassFish 退回 8181 明文/内部端口,由 Nginx 反代——这也是 GlassFish SSL 证书安装最常见的生产拓扑:
# /etc/nginx/conf.d/glassfish.conf
server {
listen 443 ssl;
server_name www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
location / {
proxy_pass https://127.0.0.1:8181; # GlassFish 侧继续用 8181
proxy_set_header Host $host;
}
}
据 Let’s Encrypt 文档,证书链应配置为“站点证书 + 中间证书”的 fullchain 形式,缺失中间证书在部分客户端同样会表现为握手失败而非明确报错。
如何验证 GlassFish SSL 证书安装已生效?5 个命令与预期输出
证书装完不等于生效。验证顺序应当”自内向外”:先看 asadmin 里的运行时配置,再看 keystore 里的证书链,最后从外部做 TLS 握手。下面 5 组命令覆盖这三层,任何一层不符预期都说明 GlassFish SSL 证书安装没有真正落地。
① asadmin get:证书昵称是否落到当前配置
# 适用 GlassFish 7.x(domain1);http-listener-2 是默认 SSL 监听器,默认端口 8181
cd /opt/glassfish7/glassfish/bin
./asadmin get 'configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.*'
预期输出(节选):
configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=glassfish
configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.ssl3-enabled=false
configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.tls-enabled=true
configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.tls12-enabled=true
如果仍显示 cert-nickname=s1as(GlassFish 自带的自签别名),说明 GlassFish SSL 证书安装只写进了 keystore、没写进当前 config。asadmin set 必须带 configs.config.server-config. 前缀,并且改完要 asadmin restart-domain——reload 不会重建 SSL 上下文,这是最常见的”配了没生效”原因。
② keytool -list -v:证书链是否完整
# JDK 9+ 默认按 JKS 探测,必须显式 -storetype;-storepass 避免交互输入
keytool -list -v -alias glassfish
-keystore domains/domain1/config/glassfish.p12
-storetype PKCS12 -storepass 'StrongPass'
预期看到 Certificate chain length: 3、Valid from: ... until: ... 覆盖当前日期、以及 SHA256: 指纹与 CA 后台签发记录逐字节一致。若 Certificate chain length: 1,说明导入时只带了叶子证书,浏览器会报链不完整。
③ openssl s_client:本地回环握手
# -servername 触发 SNI,多域名证书缺了它会回落到默认证书
openssl s_client -connect 127.0.0.1:8181 -servername www.example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | grep -E 'subject=|issuer=|Verify return code'
预期 Verify return code: 0 (ok)。若为 21 (unable to verify the first certificate),即中间证书缺失——这是 PKCS12 导入最常见的坑,需要把中间证书一起 import 成同一条链。
④ curl:协议版本与校验结果
curl -vI https://www.example.com --tlsv1.2 --tls-max 1.2 2>&1 | grep -E 'SSL connection|HTTP/'
# 期望:SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
# HTTP/1.1 200 OK
curl -s -o /dev/null -w '%{ssl_verify_result}n' https://www.example.com # 期望 0
⑤ OCSP / CRL、端口监听与日志
# -status 依赖 RFC 6066 的 status_request 扩展,服务端不支持则无输出
openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null
| grep -i 'OCSP response' # 期望 OCSP Response Status: successful (0x0)
# 据 Let's Encrypt 文档,其 OCSP 响应服务已逐步停用,改查 CRL:
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null
| openssl x509 -noout -text | grep -A2 'CRL Distribution Points'
ss -lntp | grep ':443' # 期望看到 java 进程而非 nginx
tail -n 100 domains/domain1/logs/server.log | grep -i ssl # 不应出现 SSLHandshakeException
| Verify return code | 含义 | 典型原因 |
|---|---|---|
| 0 (ok) | 链完整且受信 | — |
| 21 (unable to verify the first certificate) | 服务端未发送中间证书 | PKCS12 只导入了叶子证书 |
| 20 (unable to get local issuer certificate) | 找不到签发者 | 私有 CA 未进系统信任库 |
| 19 (self-signed certificate in chain) | 链中出现自签证书 | 误把自签根当中间证书发送 |
| 10 (certificate has expired) | 证书过期 | 未续期,或主机时间漂移 |
最后用 Chrome 120+ 打开站点,地址栏应显示”连接安全”并可在证书面板看到同一 SHA256 指纹;若显示”不安全”,对照上表定位即可。完整的握手过程与 TLS 1.3 行为可参考 RFC 8446 与 OpenSSL 官方 s_client 文档。
GlassFish SSL 证书安装后的续期与自动化:90 天证书不中断
GlassFish 把证书读进 JVM 后不会自动重载:network-listener 在启动时按 cert-nickname 从 keystore 加载证书,之后你替换文件、甚至用 keytool 改了别名,运行中的实例仍会继续吐出旧证书。所以 90 天证书的续期难点不在签发,而在“换文件 + 让 listener 重新读取”这一步。GlassFish 默认 keystore 是 domains/domain1/config/keystore.jks、别名 s1as、口令 changeit;下面的例子改用 PKCS12 文件 glassfish.p12,两种格式流程一致,只是 -deststoretype 要跟着改。
certbot 怎么给 GlassFish 的域名签发证书?
用 webroot 模式最省事,它只要求 80 端口能被 Let’s Encrypt 的验证服务器访问到(HTTP-01 挑战,ACME 协议见 RFC 8555),不需要停 GlassFish。据 Let’s Encrypt 文档,证书有效期 90 天,certbot 默认在剩余 30 天才真正续期。
# 先建好 ACME 挑战目录,并让 Nginx 把 /.well-known/acme-challenge/ 指向它
mkdir -p /var/www/acme
certbot certonly --webroot -w /var/www/acme
-d www.example.com -d example.com
--deploy-hook '/opt/glassfish/reload-ssl.sh' # 钩子路径会写进 renewal conf,续期时自动执行
签发前务必先演练一次,它会用 staging 证书把钩子完整走一遍:
certbot renew --dry-run --deploy-hook '/opt/glassfish/reload-ssl.sh'
# 看到 "Congratulations, all simulated renewals succeeded" 才说明钩子可用
reload 脚本里到底要做什么?
三步:PEM 合成 PKCS12 → 导入 GlassFish 的 keystore → 重启 domain。certbot 会通过环境变量 RENEWED_LINEAGE 传入新证书目录,脚本里用它比硬编码路径更稳。
#!/usr/bin/env bash
# /opt/glassfish/reload-ssl.sh —— chmod 700,属主与运行 GlassFish 的用户一致
set -euo pipefail
GLASSFISH_HOME=/opt/glassfish7/glassfish # 按实际版本改,4/5/6/7 目录结构相同
DOMAIN=domain1
STORE_PASS='Changeit_2026' # 必须与 asadmin 中该 listener 的 ssl 口令一致
LIVE=${RENEWED_LINEAGE:-/etc/letsencrypt/live/example.com}
TMP_P12=$(mktemp /tmp/glassfish-XXXXXX.p12)
# 1) 私钥 + 完整链 -> PKCS12;OpenSSL 3.x 对老 JDK 需追加 -legacy
openssl pkcs12 -export -out "$TMP_P12"
-inkey "$LIVE/privkey.pem" -in "$LIVE/fullchain.pem"
-name glassfish -passout pass:"$STORE_PASS"
# 2) 覆盖导入。目标已有同名别名时 -noprompt 不会静默覆盖,先删再导
keytool -delete -alias glassfish
-keystore "$GLASSFISH_HOME/domains/$DOMAIN/config/glassfish.p12"
-storepass "$STORE_PASS" 2>/dev/null || true
keytool -importkeystore
-srckeystore "$TMP_P12" -srcstoretype PKCS12 -srcstorepass "$STORE_PASS"
-destkeystore "$GLASSFISH_HOME/domains/$DOMAIN/config/glassfish.p12"
-deststoretype PKCS12 -deststorepass "$STORE_PASS" -destkeypass "$STORE_PASS"
-noprompt
rm -f "$TMP_P12"
# 3) 重启 domain 让 listener 重新加载,停机约 10–30 秒
asadmin restart-domain "$DOMAIN"
口令不一致是最高频的失败点,典型报错为 java.io.IOException: keystore password was incorrect;用 asadmin get 'configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.*' 可确认实际使用的 keystore 路径、别名与口令。
怎么定时续期并提前告警?
# crontab -e(root 或持有证书文件的用户)
0 3 * * * certbot renew --quiet --deploy-hook '/opt/glassfish/reload-ssl.sh'
certbot 在剩余 30 天续期,把告警阈值设在 21 天,意味着续期窗口已过 9 天仍未成功,属于必须人工介入的异常:
# checkend 返回非 0 表示证书将在指定秒数内过期:21 天 = 1814400 秒
openssl x509 -checkend 1814400 -noout
-in /etc/letsencrypt/live/example.com/fullchain.pem
|| echo "GlassFish 证书剩余不足 21 天" | mail -s "TLS 告警" ops@example.com
续期重启那 10–30 秒停机怎么消掉?
| 方案 | 切换动作 | 中断时长 | 适用场景与代价 |
|---|---|---|---|
| 单实例 restart-domain | asadmin restart-domain domain1 |
10–30 秒 | 测试、内部系统,零额外成本 |
| 双实例 + Nginx/HAProxy | 逐台 asadmin stop-instance → start-instance,健康检查通过再切下一台 |
0 | 生产;需会话复制或粘性会话 |
| Nginx 终止 TLS,GlassFish 只听 8181 | nginx -s reload,后端完全不动 |
0 | 推荐;续期与后端彻底解耦 |
第三种最省心:证书只存在于 Nginx,GlassFish 的 http-listener-1 保持 8181 明文,reload 脚本里把 asadmin restart-domain 换成 nginx -s reload 即可。
商业证书到期,怎么换别名又不掉线?
不要覆盖旧别名:新建带年份的别名,把 cert-nickname 指过去,观察 7 天再删旧的,回滚只需把昵称改回来。
# 1) 导入新证书,别名带年份
keytool -importcert -alias glassfish-2026 -file /tmp/new-fullchain.crt
-keystore domains/domain1/config/glassfish.p12 -storepass "$STORE_PASS" -noprompt
# 2) 切换 listener 使用的别名(http-listener-2 是默认 SSL listener)
asadmin set configs.config.server-config.network-config.protocols.protocol.http-listener-2.ssl.cert-nickname=glassfish-2026
# 3) 重启后验证握手,exit=0 才算成功(-servername 触发 SNI)
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null 2>&1; echo "exit=$?"
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null | openssl x509 -noout -subject -dates
# 4) 观察 7 天无异常后,再删除旧别名
keytool -delete -alias glassfish-2025
-keystore domains/domain1/config/glassfish.p12 -storepass "$STORE_PASS"
服务器证书和私钥进 keystore.jks(或自定义 glassfish.p12),cacerts.jks 是信任库,主要用于 GlassFish 作为客户端访问 LDAP、SMTP、支付网关时校验对方。只做 HTTPS 对外服务时,优先改 keystore 并在 http-listener-2 指定 cert-nickname,不要误把服务器证书导入 cacerts.jks 当私钥用。
可以,把 fullchain.pem 与 privkey.pem 转成 PKCS12 后导入即可;Let's Encrypt 有效期 90 天、免费、适合自动化,商业 OV 通常 1 年、含组织核验,国内渠道约 800-3000 元/年。浏览器地址栏两者都显示安全锁,差异在合规材料、售后和续期频率。
先确认 storepass 与 GlassFish 中保存的密码一致;PKCS12 还要求 keypass 与 storepass 相同。用 keytool -list -keystore glassfish.p12 -storetype PKCS12 -storepass 你的密码 验证,改完密码后重启 domain。
检查 network-listener 端口是否仍为 8181、云安全组是否放行 443、Linux 是否允许 Java 绑定 1024 以下端口。ss -lntp | grep ':443' 看不到 java 时,用 setcap 'cap_net_bind_service=+ep' $JAVA_HOME/bin/java 或让 Nginx 反代到 8181。
服务器别名导入 fullchain(服务器证书+中间证书)即可,根证书通常已在 JDK 的 cacerts 中;为兼容老旧 Android/Java 客户端,可把根证书单独导入为 root 别名。验证标准是 keytool -list -v -alias glassfish 显示 Certificate chain length: 3。
常见原因是浏览器连到了旧实例、DNS 未切换,或服务端只发服务器证书未发中间证书。用 openssl s_client -showcerts -connect 域名:443 -servername 域名 数证书张数,少于 2 张就补中间证书;再在 chrome://net-internals/#hsts 删除该域名的 HSTS 缓存。
GlassFish 对 http-listener-2 的 SSL 配置变更通常要重启实例或域,asadmin restart-domain domain1 一般 10-30 秒。生产环境用双实例 + 负载均衡逐台重启,或让 Nginx 终止 TLS 后反代到 GlassFish 8181,可把证书续期停机降到 0。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。