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

WebLogic SSL 证书安装实战:keytool 导入、WLST 启用 HTTPS 与 6 类报错排查(12c/14c)

weblogic ssl证书安装 — WebLogic SSL 证书安装实战:keytool 导入、WLST 启用 HTTPS 与 6 类报错排查(12c/14c)
核心结论

1)WebLogic SSL 证书安装的本质是把服务器证书和完整中间链导入 WebLogic 使用的 Java Keystore(JKS 或 PKCS12),在控制台为 AdminServer/Managed Server 启用 SSL 监听并重启,默认 HTTPS 端口 7002,执行 openssl s_client -connect 域名:7002 -servername 域名 返回 Verify return code: 0 (ok) 即表示链路可信。2)WebLogic 12.2.1.4 控制台 Custom Identity Keystore Type 默认 JKS,14.1.1.0 推荐 PKCS12;文件实际类型与配置不一致时启动日志常见 java.io.IOException: Invalid keystore format。3)证书链完整性用 keytool -list -v -alias weblogic 检查 Certificate chain length,正常为 2-3;只有 1 时客户端会报 PKIX path building failed。4)启用 SSL 监听不仅改 config.xml,还要在 WLST 中 cmo.setSSLListenPort(7002) 并 activate(),随后重启受管服务器,否则运行时端口不生效。5)Let's Encrypt 证书 90 天续期,商业证书通常 1 年;轮换时保留旧 identity.p12 与 config.xml 备份,单台停机窗口约 5-15 分钟。

为什么 WebLogic SSL 证书安装后浏览器仍提示不受信任?根因拆解

证书已经导入 identity.p12、控制台勾选了 Enable SSL、7002 端口也能访问,浏览器却仍然显示不安全警告——这是 WebLogic SSL 证书安装过程中最常见的现象。问题几乎从来不在“证书本身”,而是出在证书链、密钥库类型、域名匹配、信任关系、进程加载、时效性这六个环节中的某一个。下面按排查成本从低到高逐条分析。

根因一:只导入了服务器叶子证书,没有导入中间 CA。WebLogic 默认使用 Java Keystore,服务器证书条目必须形成完整链,否则客户端无法自行补齐到受信根的路径。先确认证书链长度:

keytool -list -v -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>' 
  | grep -E 'Alias name|Certificate chain length'
# 期望输出:Certificate chain length: 3
# 若为 1,说明只有叶子证书,必须重新用完整链导入

Certificate chain length 正常为 2–3;若为 1,就说明缺少中间证书。按 RFC 5246 §7.4.2 与 RFC 8446 §4.4.2 的要求,客户端需要从服务器证书出发构建到受信根的路径,缺少中间链就会直接报 unable to get local issuer certificate。

根因二:Keystore 类型与 WebLogic 配置不一致。WebLogic 12.2.1.4 控制台里 Custom Identity Keystore Type 默认是 JKS,14.1.1.0 起官方推荐 PKCS12。如果文件实际是 PKCS12,但 Type 填了 JKS,启动日志会出现 <BEA-090870> <The server failed to load the identity certificate>,底层原因是 java.io.IOException: Invalid keystore format。可先用 file 命令确认文件真实格式:

file identity.p12
# 输出含 "PKCS12"  → Type 填 PKCS12
# 输出含 "Java KeyStore" → Type 填 JKS

根因三:证书 SAN 与访问域名不匹配。WebLogic 默认启用主机名校验(Hostname Verification),访问 https://app.example.com:7002 时,证书 SAN 必须包含 app.example.com。如果只写 CN=internal-host,日志会出现 javax.net.ssl.SSLHandshakeException: No subject alternative names matching IP address。注意现代浏览器已完全不看 CN,只认 SAN(RFC 6125 与 CA/Browser Forum Baseline Requirements)。

openssl x509 -in server.crt -noout -text | grep -A1 'Subject Alternative Name'
# X509v3 Subject Alternative Name:
#     DNS:app.example.com, DNS:www.example.com

根因四:Trust Keystore 未包含签发根或中间证书。选择 Custom Identity and Java Standard Trust 时,默认信任库是 $JAVA_HOME/jre/lib/security/cacerts,口令 changeit;一旦改用自定义 trust.jks,就必须把根证书与中间证书都导入,否则出站 HTTPS 或集群间调用会报 PKIX path building failed:

keytool -importcert -alias rootca -file root.crt 
  -keystore trust.jks -storepass '<TrustPass>' -noprompt
keytool -list -keystore trust.jks -storepass '<TrustPass>'   # 验证条目已存在

根因五:只改了 config.xml,没有重启受管服务器。WLST 执行 activate() 后配置虽然写入了域,但受管服务器仍需重启才会重新创建 SSL 上下文。AdminServer 默认非 SSL 端口是 7001、SSL 端口是 7002;只重启 AdminServer 不会让受管实例生效。

grep -A5 '<ssl>' $DOMAIN_HOME/config/config.xml
# 必须同时看到 <enabled>true</enabled> 与 <listen-port>7002</listen-port>
$DOMAIN_HOME/bin/stopManagedWebLogic.sh ManagedServer_1
$DOMAIN_HOME/bin/startManagedWebLogic.sh ManagedServer_1 t3://AdminHost:7001

根因六:证书过期或 OCSP/CRL 检查失败。商业证书有效期通常为 1 年,Let’s Encrypt 为 90 天(据 Let’s Encrypt 官方文档)。内网隔离环境访问不到 OCSP 响应器时会超时,部分浏览器按软失败处理,这时需评估是否在前置负载均衡上部署 OCSP Stapling。

openssl x509 -in server.crt -noout -dates          # 查看 notBefore / notAfter
openssl ocsp -issuer intermediate.crt -cert server.crt 
  -url http://ocsp.example.com -resp_text          # 查看 OCSP 响应状态
现象(日志或浏览器) 对应根因 定位命令
unable to get local issuer certificate 证书链不完整(长度=1) keytool -list -v 看 Certificate chain length
BEA-090870 / Invalid keystore format Keystore Type 与文件格式不符 file identity.p12
No subject alternative names matching… SAN 缺访问域名 openssl x509 -text 看 SAN
PKIX path building failed Trust Keystore 缺根/中间证书 keytool -list -keystore trust.jks
配置已改但 7002 行为未变 受管服务器未重启 grep -A5 ‘<ssl>’ config.xml
NET::ERR_CERT_DATE_INVALID 证书过期或系统时钟偏差 openssl x509 -noout -dates

按这张表自上而下核对,绝大多数 WebLogic SSL 证书安装后的“不受信任”问题都能在一次排查内定位到具体环节,而不是反复重签证书。

WebLogic SSL 证书安装完整步骤:从 CSR 生成到启用 SSL 监听(12.2.1.4/14.1.1.0)

很多同学问:“WebLogic 装 SSL 证书是不是把 crt 丢进 keystore 就完事?”不是。WebLogic 的 weblogic ssl证书安装 分两层:密钥材料层(keystore 里私钥与证书链是否匹配)和监听层(域配置里 SSL 是否真正 enable 并绑定端口)。任何一层不对,控制台只会给你一个含糊的报错。下面按 6 步走完,每步都给可直接复制的命令。

步骤 1:先定 SAN 清单,再生成 CSR。把用户实际会敲的域名全列上(含 www、API 子域、负载均衡 VIP),单张证书控制在 5–10 个 SAN 内——SAN 越多,后续轮换和内部 CA 审批越麻烦。据 CA/Browser Forum 基线要求,公有 CA 签发的证书有效期上限已降到 398 天,别把有效期规划成“三年一换”。用 OpenSSL 1.1.1+ 生成(1.0.2 不支持 -addext,需改配置文件):

# OpenSSL 1.1.1+ 才有 -addext;-nodes 表示私钥不加口令,便于 WebLogic 读取
openssl req -new -newkey rsa:2048 -nodes 
  -keyout app.key -out app.csr 
  -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example/CN=app.example.com' 
  -addext 'subjectAltName=DNS:app.example.com,DNS:www.example.com'

# 校验 CSR 里的 SAN(RFC 5280 规定主机名匹配走 SAN,CN 已不再被浏览器采信)
openssl req -in app.csr -noout -text | grep -A1 'Subject Alternative Name'

若密钥必须留在 WebLogic 侧,就用 keytool 出 CSR;注意 SAN 是在生成密钥条目时写进去的,事后补不上:

# JDK 8 及以上;-ext SAN 必须与最终证书一致,否则 CA 回签的证书与你请求的不符
keytool -certreq -alias weblogic -keystore identity.p12 -storetype PKCS12 
  -storepass '<StrongPass>' -ext SAN=dns:app.example.com,dns:www.example.com 
  -file app.csr

步骤 2:建 keystore,并固定 alias。选型差异见下表(据 Oracle JDK 文档,JDK 9 起 keytool 默认格式已由 JKS 改为 PKCS12):

对比项 JKS PKCS12
JDK 8 keytool 默认 是 否(需 -storetype PKCS12)
JDK 9+ keytool 默认 否 是
WebLogic 12.2.1.4 可继续用 支持
WebLogic 14.1.1.0 兼容但不再推荐 推荐
口令强度校验 无 ≥6 字符
# 密钥长度 2048、签名算法 SHA256withRSA 是目前公有 CA 的最低通用配置
keytool -genkeypair -alias weblogic -keyalg RSA -keysize 2048 
  -sigalg SHA256withRSA -validity 365 
  -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>' 
  -dname 'CN=app.example.com,OU=IT,O=Example,L=Shanghai,ST=Shanghai,C=CN' 
  -ext SAN=dns:app.example.com,dns:www.example.com

# 生成后立刻备份:私钥丢了只能重签,alias 也务必保持 weblogic 不变
cp identity.p12 /backup/identity.p12.$(date +%F)

步骤 3:按根 → 中间 → 叶子的顺序导入。顺序反了或叶子进了新 alias,私钥与证书就对不上:

# 1) 根证书
keytool -importcert -alias rootca -file root.crt -keystore identity.p12 
  -storetype PKCS12 -storepass '<StrongPass>' -noprompt
# 2) 中间证书(缺这一步,导入叶子时会报 Failed to establish chain from reply)
keytool -importcert -alias intermediate -file intermediate.crt -keystore identity.p12 
  -storetype PKCS12 -storepass '<StrongPass>' -noprompt
# 3) 服务器证书回复,必须导回原 alias weblogic,覆盖的是证书链而非私钥
keytool -importcert -alias weblogic -file server.crt -keystore identity.p12 
  -storetype PKCS12 -storepass '<StrongPass>' -noprompt
# 确认链长度与顺序
keytool -list -v -alias weblogic -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>'

步骤 4–5:控制台填身份库并开监听。路径 Environment > Servers > AdminServer > Configuration:

  • Keystores:选 Custom Identity and Java Standard Trust;Identity Keystore 填 /u01/keystore/identity.p12,Type 选 PKCS12,Passphrase 与 -storepass 完全一致;Trust 默认 $JAVA_HOME/jre/lib/security/cacerts,口令 changeit。内网 CA 则改 Custom Identity and Custom Trust,填 trust.jks。
  • General:勾选 SSL Listen Port,填 7002(WebLogic 默认 SSL 端口)。
  • SSL:勾选 Enabled,Identity and Trust Locations 选 Keystores;Hostname Verification 生产环境保留 BEA Hostname Verifier,仅联调可临时设 None(据 RFC 6125,跳过主机名校验等于放弃中间人防护)。
  • SSL > Advanced:14.1.1.0 + JDK 11 可勾 TLSv1.3;12.2.1.4 认证 JDK 8,协议上限 TLSv1.2。

脚本化改域可用 WLST 在线模式,改完必须激活:

# wlst.sh 连接 AdminServer 后执行
startEdit()
cd('/Servers/AdminServer/SSL/AdminServer')
cmo.setEnabled(true)
cmo.setListenPort(7002)
activate()
# 离线模式改的是 config.xml,需 updateDomain() + closeDomain() 后重启才生效

步骤 6:重启并验证监听层。顺序是先受管后管理:

$DOMAIN_HOME/bin/stopManagedWebLogic.sh ManagedServer1 t3://127.0.0.1:7001
$DOMAIN_HOME/bin/stopWebLogic.sh
$DOMAIN_HOME/bin/startWebLogic.sh &
grep -E 'BEA-090871|SSL listening' $DOMAIN_HOME/servers/AdminServer/logs/AdminServer.log

日志出现 <BEA-090871> <Enabled SSL for AdminServer> 与 <BEA-000000> <SSL listening on 7002>,说明 weblogic ssl证书安装 的监听层已加载;此时再用 openssl s_client -connect app.example.com:7002 -servername app.example.com -showcerts 确认返回的是完整链而非 “unable to get local issuer certificate”。

WebLogic SSL 证书安装的命令与配置示例:keytool、WLST、config.xml 关键参数

一次完整的 WebLogic SSL 证书安装,正确的顺序是“先验链、再导入、后启用”。如果顺序颠倒,最常见的结果是服务器能启动,但客户端访问时抛出 javax.net.ssl.SSLHandshakeException: PKIX path building failed——因为 WebLogic 只在启动时读取一次密钥库。据 Let’s Encrypt 文档,约 80% 的自签名链错误来自中间证书缺失或顺序错误,因此导入前请先做两件事:

# 1) 列出 fullchain.crt 里的证书顺序(应由 服务器证书 -> 中间证书 依次排列)
openssl crl2pkcs7 -nocrl -certfile fullchain.crt | openssl pkcs7 -print_certs -noout

# 2) 用根证书 + 中间证书做离线校验,必须先返回 OK
openssl verify -CAfile root.crt -untrusted intermediate.crt server.crt
# 期望输出:server.crt: OK
# 若输出 unable to get local issuer certificate -> 中间链缺失或顺序错误,先修链再导入

校验通过后,用 keytool 把证书写入 PKCS12 密钥库。注意 -trustcacerts 只对中间证书有意义,服务器证书的私钥必须事先通过 -importkeystore 导入,或使用 CA 交付的 .p12:

# 导入中间证书(建立信任链),-noprompt 避免交互
keytool -importcert -trustcacerts -alias intermediate -file intermediate.crt 
  -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>' -noprompt

# 导入服务器证书,别名必须与后续 config.xml / 控制台中的 alias 一致
keytool -importcert -alias weblogic -file server.crt 
  -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>'

# 核对结果:重点看 Alias name: weblogic 的 Entry type 是否为 PrivateKeyEntry
keytool -list -v -keystore identity.p12 -storetype PKCS12 -storepass '<StrongPass>' 
  | grep -E 'Alias name|Certificate chain length|Valid from'

如果输出中 weblogic 显示为 trustedCertEntry 而非 PrivateKeyEntry,说明私钥没有导入,WebLogic 启动时会报 No private key found for alias weblogic。另外,-storepass 明文会出现在 ps 与 shell history 中,JDK 9+ 可用 -storepass:file 修饰符规避。检查无误后,用 WLST 离线修改域配置(脚本位于 $MW_HOME/oracle_common/common/bin/wlst.sh,12.2.1.4 与 14.1.1.0 均自带):

# 执行前务必备份:cp config.xml config.xml.bak.$(date +%F)
readDomain('/u01/domains/base_domain')
cd('/Servers/AdminServer')
cmo.setListenPort(7001)
cmo.setSSLListenPort(7002)
cmo.setSSLEnabled(true)
updateDomain()      # 写入 config.xml
closeDomain()
# 执行后必须重启 AdminServer 与受管服务器,热改 config.xml 不会生效

对应的 config.xml 片段如下,其中 hostname-verification 建议保持 true,与 JVM 参数保持一致:

<server>
  <name>AdminServer</name>
  <listen-port>7001</listen-port>
  <ssl>
    <name>AdminServer</name>
    <enabled>true</enabled>
    <listen-port>7002</listen-port>
    <hostname-verification>true</hostname-verification>
    <keystore>
      <type>PKCS12</type>
      <file>/u01/keystore/identity.p12</file>
    </keystore>
  </ssl>
</server>
启动参数 / 配置项 默认值 作用与取值
-Dweblogic.security.SSL.trustedCAKeyStore 未设置,沿用 JDK 的 cacerts 指定自定义信任库(如 /u01/keystore/trust.jks),用于出站 HTTPS 与双向认证
-Dweblogic.security.SSL.ignoreHostnameVerification false 设为 true 会关闭主机名校验,仅限测试;生产环境应配合 SAN 证书
-Djava.net.preferIPv4Stack false 设为 true 可规避双栈环境下握手阶段的 Connection reset 异常
TLS 协议版本 12.2.1.4 默认 TLSv1.2 TLS 1.3 需 WebLogic 14.1.1.0 + JDK 11,并在控制台 SSL > Advanced 勾选 TLSv1.3

上述命令覆盖了 WebLogic SSL 证书安装的全部关键落点;据 Oracle Fusion Middleware 官方文档,updateDomain() 只是把变更写入域目录,activate() 才会同步到运行中的服务器,而 config.xml 的手工编辑在任何版本中都不会被热加载——重启是唯一可靠的生效方式。

WebLogic SSL 证书安装方案选型:JKS、PKCS12、PEM 与证书类型对比

控制台里 Custom Identity Keystore 那一栏,到底该填 .jks、.p12 还是 .pem?答案是:WebLogic 只认 Java KeyStore 容器(JKS 或 PKCS12),PEM 不是合法选项。据 Oracle WebLogic Server 12.2.1.4 官方文档 “Configuring SSL”,Custom Identity Keystore Type 的可选值为 JKS 与 PKCS12,默认 JKS;14.1.1.0 起 Oracle 推荐 PKCS12,因为它单文件承载完整证书链且跨平台。把 Let’s Encrypt 或商业 CA 下发的 PEM 转成 PKCS12,是 weblogic ssl证书安装 最常见的第一步:

# 将 fullchain.pem(叶子+中间)与私钥合并为 WebLogic 可用的 PKCS12
# 适用:WebLogic 14.1.1.0(JDK 11)及 12.2.1.4(需把 Keystore Type 显式改为 PKCS12)
openssl pkcs12 -export 
  -in fullchain.pem 
  -inkey privkey.pem 
  -name weblogic_identity       # 别名,后续 WLST/控制台选证书时用这个名字
  -out identity.p12 
  -passout pass:ChangeIt123

# 校验:确认别名、链长度与有效期,避免装完才发现链不完整
keytool -list -v -storetype PKCS12 -keystore identity.p12 -storepass ChangeIt123 
  | grep -E "Alias name|Certificate chain length|Valid from"
# 期望输出 Certificate chain length: 2(叶子 + 中间证书)

一个高频坑:JDK 8 的 keytool 新建 keystore 时默认仍是 JKS,JDK 9+ 才默认 PKCS12。WebLogic 12.2.1.4 自带 JDK 8,所以新建时务必显式写 -storetype PKCS12,否则控制台里类型与文件实际格式不一致,启动即报 keytool error: java.io.IOException: keystore password was incorrect(实际往往是格式误判而非密码错)。

Keystore 格式 WebLogic 兼容性 密码模型 适用场景
JKS 12.2.1.4 默认,14.1.1.0 仍可读 storepass 与 keypass 可不同 存量 12c 域、已有 keytool 流程
PKCS12 14.1.1.0 推荐;12.2.1.4 需显式选类型 单一密码,storepass 即 keypass 新建域、跨平台交付
PEM 不能直接作为 Custom Identity Keystore 无 Nginx/Apache/F5,需先转 PKCS12

信任模式怎么选?只对接公共 CA 时保持默认 CustomIdentityAndJavaStandardTrust,信任库就是 $JAVA_HOME/jre/lib/security/cacerts(默认口令 changeit),无需维护 trust.jks;内网 CA 或双向 TLS 必须切到 CustomIdentityAndCustomTrust 并导入根证书后重启;容器化临时环境可用 CustomIdentityAndCommandLineTrust,通过 -Dweblogic.security.TrustKeyStore=CustomTrust -Dweblogic.security.CustomTrustKeyStoreFileName=... 指定,漏写参数就会在握手时报 <BEA-090477> <Certificate chain received from ... was not trusted.>,或底层抛出 CertPathValidatorException: Path does not chain with any of the trust anchors(RFC 5280 链验证语义)。

监听器方案 端口 优点 代价
AdminServer 直接开 SSL 7002(默认 SSL 端口) 配置最少 管理流量与业务混用
Managed Server 各自开 SSL 7002 或自定义 适合集群横向扩展 需逐台重启
前置 Nginx/F5 卸载 SSL 回源 HTTP 7001 证书统一管理 需配 X-Forwarded-Proto 与回源白名单
证书类型 价格区间 签发周期 适用与续期
DV 单域名 0–300 元/年 1–10 分钟 测试与内部系统;手动或 ACME 续期
OV 单域名 800–3000 元/年 组织验证 1–3 天 生产环境;手动替换,停机 5–15 分钟
EV 1500–8000 元/年 扩展验证 3–7 天 按合规要求选择,浏览器 UI 已不再特殊显示
Let’s Encrypt 0 元 / 90 天 秒级 需具备 ACME 自动化;certbot 续期后重新导出 identity.p12 并重启

据 Let’s Encrypt 官方文档,其证书有效期 90 天、支持 ACME 协议自动续期,因此 weblogic ssl证书安装 若选它,必须把“续期 → 重新导出 PKCS12 → 重启受管服务器”写成脚本,并保留旧 identity.p12 用于回滚。最后用 WLST 一次性写入,注意 12.2.1.4 的类型默认值必须显式覆盖:

# WLST 在线配置,适用 WebLogic 12.2.1.4 / 14.1.1.0
connect('weblogic','Welcome1','t3://127.0.0.1:7001')
cd('/Servers/AdminServer')
cmo.setCustomIdentityKeyStoreFileName('/u01/security/identity.p12')
cmo.setCustomIdentityKeyStoreType('PKCS12')   # 12.2.1.4 默认 JKS,必须改
cmo.setCustomIdentityKeyStorePassPhrase('ChangeIt123')  # 生产环境用 encrypt() 加密
cmo.setKeyStores('CustomIdentityAndJavaStandardTrust')
save(); activate(block='true')

WebLogic SSL 证书安装常见报错与排查:PKIX path building failed 等真实日志

问:为什么同样的 identity.p12,在 keytool 里能读,WebLogic 启动却报 java.io.IOException: Keystore was tampered with, or password was incorrect?

答:这条日志几乎只对应两件事——控制台里填的 Custom Identity Keystore Passphrase 与 keytool -storepass 实际密码不一致,或 Custom Identity Keystore Type 填错(把 PKCS12 文件标成 JKS,或反之)。先用 keytool 独立验证密码,再回头看控制台:

# 验证 storepass 是否正确(能列出条目即密码正确)
keytool -list -keystore /u01/oracle/keystores/identity.p12 
  -storetype PKCS12 -storepass '<StrongPass>'
# 若报 "password was incorrect",说明控制台 Passphrase 填错
# 注意 JDK 9+ 的 keytool 默认 -storetype 已是 PKCS12,JDK 8 默认仍是 JKS

控制台里 Keystore Passphrase 与 Key Passphrase 是两个字段:PKCS12 通常二者相同(keytool 在 JDK 8u301+ 对 PKCS12 独立 keypass 会告警),JKS 则可能不同,填反同样触发该报错。

对比项 JKS PKCS12
keytool 默认 storetype JDK 8 及更早 JDK 9+
Key Passphrase 可否独立 可以,常见不同 通常与 storepass 相同
WebLogic 控制台 Type 取值 JKS PKCS12
私钥条目类型 PrivateKeyEntry PrivateKeyEntry

问:启动日志出现 <BEA-090870> <The server failed to load the identity certificate> 怎么定位?

答:按 Oracle WebLogic 文档,该错误表示指定 alias 无法作为身份条目加载,三个高频原因:alias 指向的是 TrustedCertEntry、证书链不完整、keystore 文件属主/权限不对(WebLogic 以 oracle 用户运行却无权读取)。逐条确认:

# 1) 确认 alias 是私钥条目且链完整(链长应为 3)
keytool -list -v -alias weblogic -keystore identity.p12 
  -storetype PKCS12 -storepass '<StrongPass>' 
  | grep -E 'Entry type|Certificate chain length'
# 期望:Entry type: PrivateKeyEntry  /  Certificate chain length: 3
# 2) 修正权限后重启受管服务器
chown oracle:oinstall /u01/oracle/keystores/identity.p12
chmod 640 /u01/oracle/keystores/identity.p12

若输出 Certificate chain length: 1,说明只有服务器证书、缺中间证书,必须先补齐再谈权限。

问:客户端连 WebLogic 报 javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed,是服务端证书错了吗?

答:不一定。这条报错发生在信任方——调用方 JVM 的 trust store 里找不到签发链的根证书或中间证书。Java 默认信任库是 $JAVA_HOME/jre/lib/security/cacerts(JDK 9+ 为 $JAVA_HOME/lib/security/cacerts,默认口令 changeit),私有 CA 签发的证书不会在里面。导入后必须重启受管服务器才会重新加载:

keytool -importcert -alias rootca -file root.crt 
  -keystore /u01/oracle/keystores/trust.jks 
  -storepass '<TrustPass>' -noprompt
# 再把该文件配置为 Server 的 Custom Trust Keystore,重启受管服务器

问:<BEA-000362> <Server failed. Reason: [Security:090398]Invalid certificate chain> 为什么证书“看起来没问题”还是起不来?

答:多半是 PEM 拼接顺序或换行符问题。据 RFC 5280 的路径构建规则,链必须从 leaf 到 root 逐级签发;顺序错了,WebLogic 的链校验直接失败。用 OpenSSL 先本地验证,返回 OK 再导入:

# 顺序必须是 leaf -> intermediate -> root
cat server.crt intermediate.crt root.crt > fullchain.crt
openssl verify -CAfile root.crt -untrusted intermediate.crt server.crt
# 期望输出:server.crt: OK

不要用 Windows 记事本拼接,CRLF 与 BOM 会破坏 PEM 头尾标记,请用 cat 或 openssl pkcs12 -export 处理。

问:SSLHandshakeException: No subject alternative names matching IP address 只能重签证书吗?

答:本质是访问地址不在 SAN 扩展里(RFC 6125 已弃用仅凭 CN 匹配的做法)。用 keytool -list -v 查看 SubjectAlternativeName 是否包含实际访问的 DNS 名与 IP。测试环境可临时把控制台 Hostname Verification 设为 None,生产不建议——Oracle WebLogic 文档明确指出关闭主机名验证会削弱对中间人攻击的防护。

问:WLST 执行 activate 时抛 WLSTException: Error occurred while performing activate: java.lang.SecurityException: Invalid keystore format?

答:WLST 侧写的 type 与文件真实格式不符,或 config.xml 里残留 JKS 而文件已是 PKCS12。先确认文件格式,再用 WLST 显式改写类型:

file /u01/oracle/keystores/identity.p12
# 期望:... identity.p12: PKCS12 (p12 file)

# WLST 片段(weblogic 12c/14c 通用)
connect('weblogic','<Password>','t3://localhost:7001')
edit()
startEdit()
cd('/Servers/AdminServer/SSL/AdminServer')
cmo.setCustomIdentityKeyStoreType('PKCS12')
activate()

完成 WebLogic SSL 证书安装后,建议固定用 keytool -list -v + openssl verify 两条命令做上线前自检,能覆盖上述六类报错中的五类。

如何验证 WebLogic SSL 证书安装生效:openssl、WLST、浏览器与 OCSP 四层检查

为什么”证书装完了”不等于”生效了”?因为 WebLogic 的 SSL 生效链路有三段:keystore 文件 → 域配置(config.xml 里的 <ssl> 元素)→ 服务器运行时。任何一段断裂,端口可能照样 listen,但握手、链或 OCSP 会失败。下面六层检查按”从外到内”的顺序排列,每层都有明确的通过标准。WebLogic 12.2.1.x 与 14.1.1.0.0 的默认 SSL 监听端口都是 7002,命令与路径通用;差异在于 14.1.1.0.0 在 JDK 11 上支持 TLSv1.3,而 12.2.1.x 默认上限为 TLSv1.2。

第一层:端口通、握手成、链完整

# 一次拿到端口连通性、协议版本与证书链完整性
# -servername 触发 SNI 扩展:同一 IP 挂多张证书时必须带,否则可能拿到默认证书
openssl s_client -connect app.example.com:7002 
  -servername app.example.com -showcerts </dev/null

# 通过标准(三行关键输出):
#   Verify return code: 0 (ok)                 → 链完整且被本机信任库认可
#   Protocol  : TLSv1.2  或  TLSv1.3           → 符合你的 TLS 基线
#   Cipher    : ECDHE-RSA-AES256-GCM-SHA384    → 非 NULL/EXPORT 套件

# 典型失败输出与含义:
#   verify error:num=20:unable to get local issuer certificate  → 缺中间 CA,weblogic ssl证书安装尚未完成
#   verify error:num=21:unable to verify the first certificate   → 只导了叶子证书,链断
#   verify error:num=10:certificate has expired                  → notAfter 已过
#   no peer certificate available                                → 端口通但未启用 SSL(连到了 HTTP 端口)

据 OpenSSL 官方文档,-servername 就是向服务端发送 SNI(RFC 6066)扩展;漏掉它时,多域名环境下你验证的可能根本不是目标证书。

第二层:证书字段对不对——握手成功不代表证书内容正确,必须逐字段核对域名与有效期:

echo | openssl s_client -connect app.example.com:7002 
  -servername app.example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 通过标准:
#   issuer = 中间 CA(例:C=US, O=DigiCert Inc, CN=DigiCert TLS RSA SHA256 2020 CA1)
#            不能是自签、也不能是根 CA——根证书不应出现在服务端返回的链里
#   notBefore / notAfter 覆盖当前时间,剩余有效期建议 > 30 天
#   X509v3 Subject Alternative Name: DNS:app.example.com, DNS:*.example.com
#            SAN 必须含用户实际访问的域名;只写 CN 在 Chrome 58+ 已不被接受

Let’s Encrypt 文档明确建议服务端下发”叶子 + 中间”两级,根证书由客户端本地信任库提供——这正是 -showcerts 输出里应该看到 2 张、浏览器证书路径显示 3 层的原因。

第三层:WLST 看运行时是否真的加载了配置——配置文件改了但未重启或未激活,控制台看着是 HTTPS,运行时却还是旧值:

# 在 $DOMAIN_HOME/bin/setDomainEnv.sh 之后执行;12.2.1.x / 14.1.1.0.0 命令一致
java weblogic.WLST

connect('weblogic','<Password>','t3://admin.example.com:7001')
domainRuntime()
cd('/ServerRuntimes/AdminServer')
print cmo.getSSLListenPort()        # 期望 7002;返回 -1 说明运行时未加载 SSL 配置
print cmo.isSSLEnabled()            # 期望 true;返回 false 说明配置未生效
print cmo.getSSLProtocolVersion()   # 期望 TLSv1.2 或 TLSv1.3
disconnect()

若此处返回 -1/false,先去控制台 Environment → Servers → AdminServer → Configuration → SSL 确认 “SSL Listen Port Enabled” 已勾选并 Activate Changes + 重启,而不是继续排查证书。

第四层:浏览器与 HTTP 头——浏览器是最终裁判,curl 是可自动化的替身:

# --resolve 绕过 DNS,直连指定 IP,用于验证"证书与访问域名是否匹配"
curl -Iv https://app.example.com:7002/console 
  --resolve app.example.com:7002:10.0.0.10

# 通过标准:
#   *  SSL certificate verify ok.
#   *  TLSv1.2 (或 1.3), cipher ...
#   <  Strict-Transport-Security: max-age=31536000   ← 仅在配置 HSTS 后期望出现(RFC 6797)

浏览器里点锁图标 → 证书 → “证书路径”应为 3 层(叶子 → 中间 → 根);若显示”证书无效”但 openssl 返回 0,多半是本机信任库或系统时间偏差。

第五层:吊销状态(OCSP/CRL)——链对、域名对,证书仍可能已被吊销:

# 直接向 CA 的 OCSP 响应器查询(RFC 6960)
openssl ocsp -issuer intermediate.crt -cert server.crt 
  -url http://ocsp.digicert.com -resp_text -no_nonce

# 通过标准:
#   Response verify OK
#   server.crt: good

内网无法出网访问 OCSP 时,浏览器通常”软失败”放行,但这会带来数秒握手延迟与合规风险。此时可评估 OCSP Stapling,或改用不强制 OCSP 的 CA(如 Let’s Encrypt 已停止提供 OCSP,改以 CRL 为主)。

第六层:日志与文件权限——把”看起来生效”变成”有据可查”:

# 1) 启动期是否真正启用并监听 SSL
grep -E "BEA-090871|SSL listening on" 
  $DOMAIN_HOME/servers/AdminServer/logs/AdminServer.log
# 期望看到:<BEA-090871> <SSL enabled> / <BEA-000000> <SSL listening on 7002>

# 2) 加密口令文件权限:属主必须是启动 WebLogic 的 OS 用户,权限不超过 640
ls -l $DOMAIN_HOME/servers/AdminServer/security/SerializedSystemIni.dat
# 期望:-rw-r----- 1 weblogic weblogic ...

# 3) 权限错误或文件被覆盖时的真实报错(keystore 密码无法解密)
# java.io.IOException: Keystore was tampered with, or password was incorrect

权限异常(如属主被改成 root 后又被 weblogic 用户启动)会让服务在启动阶段无法解密 keystore 口令,表现为”端口不监听”而非证书错误——这是 weblogic ssl证书安装排查中最容易被误判为”证书没导对”的一类问题。

层级 检查对象 关键命令/位置 通过标准
1 端口与握手 TCP + TLS + 链完整性 openssl s_client -showcerts Verify return code: 0 (ok)
2 证书字段 SAN / 有效期 / issuer openssl x509 -noout -dates -ext subjectAltName SAN 含访问域名,issuer 为中间 CA
3 WLST 运行时 配置是否加载 cmo.isSSLEnabled() true / 7002 / TLSv1.2+
4 浏览器与头 最终用户视角 curl -Iv --resolve verify ok,链 3 层
5 OCSP/CRL 吊销状态 openssl ocsp -resp_text Response verify OK / good
6 日志与权限 启动期证据 AdminServer.log、SerializedSystemIni.dat BEA-090871 + 640 weblogic

建议把第 1、2、4 层写成一条 cron 监控脚本(openssl 返回码 + curl 退出码),在证书到期前 30 天和第 7 天各告警一次;第 3、6 层则纳入变更后检查清单,因为它们是”配置已改、运行时未生效”这类问题的唯一证据来源。

WebLogic SSL 证书安装后的续期与轮换:90 天 Let's Encrypt 与 1 年商业证书操作差异

90 天的 Let’s Encrypt 证书到期了,WebLogic 能自动续吗?

certbot 只负责签发与续期,把 PEM 转成 WebLogic 可读的 PKCS12、并让受管服务器重新加载,必须自己挂钩子。certbot ≥0.30 提供 --deploy-hook(certbot 2.x 仍然有效),仅在成功续期后触发一次;据 Let’s Encrypt 文档,官方建议每天跑两次 renew,续期窗口默认为到期前 30 天(可用 --days 调整,但不建议低于 30)。

#!/bin/bash
# /usr/local/bin/wl-deploy-hook.sh   适用 certbot 1.x/2.x,以 root 执行
set -e
LE=/etc/letsencrypt/live/app.example.com
KS=/u01/keystore
cp -p $KS/identity.p12 $KS/identity.p12.$(date +%F).bak      # 保留旧 keystore 用于回滚
openssl pkcs12 -export -out $KS/identity.p12 
  -inkey $LE/privkey.pem -in $LE/fullchain.pem 
  -name weblogic -passout pass:'<StrongPass>'                 # -name 即 alias,轮换时保持不变
chown oracle:oinstall $KS/identity.p12 && chmod 640 $KS/identity.p12
su - oracle -c '/u01/oracle/domains/base_domain/bin/stopManagedWebLogic.sh ManagedServer1'
su - oracle -c '/u01/oracle/domains/base_domain/bin/startManagedWebLogic.sh ManagedServer1'

注册方式:certbot renew --deploy-hook /usr/local/bin/wl-deploy-hook.sh 写入 cron。注意 fullchain.pem 已含中间证书,无需再加 -certfile;PKCS12 默认 key password 与 store password 相同,所以 WebLogic 控制台里 Custom Identity Keystore Passphrase 与 Key Passphrase 填同一个值即可。续期失败时 Let’s Encrypt 会向 ACME 账户邮箱发信,因此必须保证账户邮箱可达,并把 certbot renew --dry-run 的退出码接入监控。

商业证书 1 年轮换和 Let’s Encrypt 有什么操作差异?

维度 Let’s Encrypt(90 天) 商业证书(约 1 年)
触发 certbot 定时任务 + deploy-hook 全自动 到期前 30–45 天人工生成新 CSR
私钥 沿用账户目录下 privkey.pem 建议新建私钥,不复用旧私钥
停机 重启受管服务器,单台约 1–3 分钟 维护窗口内 5–15 分钟
主要风险 自动化静默失败,靠邮件与监控兜底 人为排期漏做,直接过期中断
回滚 换回 identity.p12.YYYY-MM-DD.bak 还原旧 keystore 与 config.xml,5 分钟内切回
# 商业证书轮换:新建私钥与 CSR(不复用旧私钥)
openssl req -new -newkey rsa:2048 -nodes -keyout /u01/keystore/app-new.key 
  -out /u01/keystore/app-new.csr -subj "/CN=app.example.com" 
  -addext "subjectAltName=DNS:app.example.com"

10 台受管服务器怎么批量换而不中断服务?

把 identity.p12 收敛到共享存储 /u01/keystore/identity.p12,权限 640、属主 oracle:oinstall,用 scp -p 分发;集群规模 10 台时按 2 批滚动,每批间隔 5 分钟观察健康检查,绝不可同时重启。若已部署 Node Manager,可用 WLST 精确控制启停(Oracle 官方 WLST 文档的 nmKill/nmStart 命令):

# wlst.sh 中执行:需 Node Manager 已监听 5556
connect('weblogic','<AdminPass>','t3s://adminserver:7002')
nmConnect('oracle','<NmPass>','adminserver','5556','/u01/oracle/domains/base_domain','base_domain','ssl')
nmKill('ManagedServer1'); nmStart('ManagedServer1')

怎么在用户投诉之前发现证书要过期?

echo | openssl s_client -connect app.example.com:7002 -servername app.example.com 2>/dev/null 
  | openssl x509 -noout -enddate          # 输出示例:notAfter=Mar 18 12:00:00 2026 GMT
nc -zv app.example.com 7002               # 输出含 succeeded! 才说明监听器存活

把 notAfter 解析为剩余天数接入 Zabbix/Prometheus,阈值 30 天告警;同时用 nc 探测 7002 端口,避免”证书有效但监听器已宕”的假阴性。每次 weblogic ssl证书安装 或轮换后,保持 alias 固定为 weblogic,可以把配置改动降到最低,也让上述脚本在多套环境间直接复用。

Nginx 直接读取 PEM 格式的 fullchain.pem 与 privkey.pem,改完 nginx -s reload 即可;WebLogic SSL 证书安装必须把证书和私钥导入 Java Keystore(JKS 或 PKCS12),再在控制台或 WLST 中绑定 SSL 监听并重启受管服务器。WebLogic 默认 HTTPS 端口 7002,Nginx 常见 443;WebLogic 还需关注 Hostname Verification 与 Custom Identity and Java Standard Trust 信任模式。

先确认服务器证书条目是否带完整中间链:keytool -list -v -alias weblogic 查看 Certificate chain length 是否为 2-3。若链长只有 1,导入 intermediate.crt 与 root.crt 后重新导入 server.crt;若链完整,则把根证书导入信任库 trust.jks 或 $JAVA_HOME/jre/lib/security/cacerts,再重启受管服务器。最后用 openssl verify -CAfile root.crt -untrusted intermediate.crt server.crt 验证返回 OK。

修改 AdminServer 的 SSL 监听通常需要重启 AdminServer;修改 Managed Server 的 SSL 配置后,该受管服务器必须重启才能加载新的 SSL 上下文,不需要重启整个域的所有节点。生产环境建议逐台滚动重启,先停一台、验证 7002 握手成功后再停下一台,避免集群整体不可用。

WebLogic 12.2.1.4 控制台默认兼容 JKS,存量域可继续用 JKS;WebLogic 14.1.1.0 推荐 PKCS12,单文件包含证书链且跨平台兼容性更好。关键是控制台 Custom Identity Keystore Type 必须与文件真实类型一致,PKCS12 文件填 JKS 会报 java.io.IOException: Invalid keystore format。新建域建议直接用 PKCS12 并在 keytool 命令中显式加 -storetype PKCS12。

先检查 config.xml 中 下 true 与 7002 是否同时存在,再确认 AdminServer.log 出现 。若日志没有监听记录,用 WLST 执行 cmo.setSSLListenPort(7002) 与 cmo.setSSLEnabled(true) 后 activate() 并重启。还要检查操作系统防火墙与云安全组是否放行 7002,命令 nc -zv app.example.com 7002 返回 succeeded 才说明端口可达。

可以。Let's Encrypt 证书有效期 90 天,需要 certbot 或 acme.sh 自动续期,并在 deploy-hook 中把 fullchain.pem 与 privkey.pem 导出为 identity.p12,再重启 WebLogic 受管服务器。注意 WebLogic 不直接读取 PEM,必须转换为 PKCS12 或 JKS;续期脚本要保留旧 keystore 备份,并用 openssl s_client 验证新证书链。

用 keytool -list -v -alias weblogic -keystore identity.p12 -storetype PKCS12 -storepass '' 查看 Certificate chain length,正常为 2-3。再用 openssl s_client -connect app.example.com:7002 -servername app.example.com -showcerts


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

内容审核

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