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