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

WebSphere SSL 证书安装实战:WAS 9.0.5 传统版与 Liberty 配置、排错和验证

websphere ssl证书安装 — WebSphere SSL 证书安装实战:WAS 9.0.5 传统版与 Liberty 配置、排错和验证
核心结论

WebSphere SSL 证书安装的核心是先把 CA 与服务器证书导入 NodeDefaultKeyStore 或 CellDefaultKeyStore,再用 wsadmin 或控制台把 SSL 配置的 sslProtocol 设为 TLSv1.2 或 TLSv1.3 并绑定到 9443 等端点;WAS 9.0.5.x 上 ikeycmd 导入通常 1-3 分钟完成,重启或动态刷新后生效。 WAS 9.0.5.x 推荐使用 2048 位 RSA、SHA256withRSA、TLSv1.2 起步;如启用 TLSv1.3 需确认 JDK 与对端兼容。 命令示例:ikeycmd -cert -receive -db ... -pw ... -file server.cer -format ascii;验证示例:openssl s_client -connect host:9443 -servername host -tls1_2 -showcerts 返回 Verify return code: 0 (ok)。 常见错误 CWPKI0022E 多为中间 CA 未导入,需把 rootCA 与 intermediateCA 一起加入 NodeDefaultTrustStore。 Liberty 用 server.xml 的 keyStore 与 ssl 元素;传统 WAS 用 SSL 配置;IHS 前置终结证书可减少 JVM 重启。

问题背景与根本原因:为什么 WebSphere 装完证书仍报 SSL 握手失败?

“证书已经拷到服务器上了,为什么 9443 还是握手失败?”这是 websphere ssl证书安装 里最高频的提问。根本原因在于:WAS 传统版(9.0.5.x)的 HTTPS 由三件事共同决定——JVM 内的 SSL 配置、KeyStore 中的私钥与证书链、以及端点对 SSL 配置的引用。9443 对应 WC_defaulthost_secure、9043 对应 WC_adminhost_secure,二者各自绑定一个 SSL 配置别名(默认 NodeDefaultSSLSocketFactory)。把 .cer 复制到 /opt/IBM/WebSphere/AppServer/etc 只是放了个文件,没有任何组件会去读它。

根因一:证书链不完整。据 RFC 5280 第 6 节,证书路径需要从终端实体证书经中间 CA 构建到受信任根。若只把 leaf 证书导入 .kdb/.p12,服务端握手时只发送一张证书,Java 客户端就会抛出:

javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

浏览器有时会靠 AIA 扩展自动补拉中间证书,JVM 不会——这正是“浏览器能打开、接口报 PKIX”的原因。用下面两条命令定位:

# 1) 看服务端实际发送了几张证书(链是否完整)
openssl s_client -connect was.example.com:9443 -servername was.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer

# 2) 检查 WAS 9.0.5 节点默认 KeyStore(8.5.5 起默认 PKCS12,默认密码 WebAS)
keytool -list -v -storetype PKCS12 -storepass WebAS 
  -keystore /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/cell01/nodes/node01/key.p12 
  | grep -E "Alias name|Certificate chain length"
# 期望 Certificate chain length 为 2 或 3,为 1 即链不完整

根因二:协议或密码套件不匹配。WAS 9.0.5 的部分默认 SSL 配置仍启用 TLSv1.0/1.1 与 RSA 密钥交换套件;而按 Mozilla Server Side TLS 的“Modern”兼容配置,客户端只发 TLSv1.2/1.3 + ECDHE 套件,双方无交集即报 SSL0227E。该错误码在 SystemOut.log 中的原文是 “SSL Handshake Failed, No ciphers in common”。

根因 典型报错 快速验证 修复方向
证书链不完整 PKIX path building failed openssl s_client -showcerts 数证书张数 把中间 CA 导入“签名者证书”/Signer Certificate
协议与套件不匹配 SSL0227E(No ciphers in common) openssl s_client -tls1_2 单独试 在 SSL 配置中禁用 TLSv1/1.1,勾选 ECDHE 套件
别名错位 CWPKI0033E / CWPKI0812E 比对 keytool 输出的 Alias name 与 -keyAlias 统一 CSR label、KeyStore keyAlias、SSL 配置 -keyAlias 三者

根因三:别名与配置错位。CSR 的 label、KeyStore 里的 keyAlias、SSL 配置中指定的 -keyAlias 必须是同一个字符串,大小写敏感;三者不一致时节点启动或握手直接报 CWPKI0033E / CWPKI0812E。据 IBM Knowledge Center 对 SSL 配置的说明,WebSphere 的入站与出站连接可分别引用不同 SSL 配置,因此排错第一步是确认报错发生在 9043 管理控制台、9443 业务端口,还是 JMS/SOAP 出站调用——三者可能用的是三套完全不同的 KeyStore。

工作量与成本参考:传统 WAS 单节点证书导入加绑定通常 10–30 分钟,集群同步加重启再叠加 5–15 分钟;证书方面 DV 约 0–300 元/年、OV 约 800–3000 元/年,Let’s Encrypt 按官方文档免费 90 天且需自动续期(WAS 传统版无内置 ACME 客户端,需外部脚本 + 管理控制台脚本化重载)。

完整实操步骤:从 CSR 到 WebSphere SSL 证书安装(以 WAS 9.0.5 传统版为例)

如果你只想要一条能直接跑通的最短路径,答案是:用 ikeycmd 在节点默认 keystore 里生成 CSR,把根 CA 与中间 CA 都导入同一个 .kdb,接收服务器证书后用 wsadmin 新建 SSL 配置并绑定到 server1 的 9443 端点,最后同步节点并重启。下面以 WAS 9.0.5.x 传统版(ND,profile 名 AppSrv01)为例逐步展开。之所以必须用 ikeycmd 而不是 OpenSSL:传统版的默认 keystore 是 IBM CMS 格式的 .kdb,据 IBM Knowledge Center 文档,它由 IBM Key Management 工具管理,keytool 与 openssl 无法直接读写。

步骤 1:确认版本、Java 与 keystore 路径。版本不符会直接影响后面的签名算法与 TLS 协议取值。

# 确认 WAS 版本与 JVM;WAS 9.0.5 传统版默认随附 Java 8
/opt/IBM/WebSphere/AppServer/bin/versionInfo.sh -maintenance
# 期望输出片段:
#   IBM WebSphere Application Server 9.0.5.7
#   Java Version : 1.8.0_xxx
ls -l /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/NodeDefaultKeyStore.kdb
# 默认节点 keystore:NodeDefaultKeyStore.kdb(CMS 类型),同目录下配套 .sth/.rdb 文件需一并备份

步骤 2:生成 CSR。私钥始终留在 .kdb 内,只有 CSR 交给 CA,这一步决定了私钥不会离开服务器。

/opt/IBM/WebSphere/AppServer/bin/ikeycmd -certreq -create 
  -db /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/NodeDefaultKeyStore.kdb 
  -pw 'StrongPass123' 
  -dn 'CN=was.example.com,O=Example,C=CN' 
  -size 2048 -sigalg SHA256withRSA 
  -file was.example.com.csr -label was_ssl
# -label 是别名,后续 -keyAlias 必须与它完全一致
参数 默认值 取值范围 / 说明
-size 2048 1024–4096;低于 2048 会被现代浏览器与 CA 拒绝
-sigalg SHA256withRSA Java 8 下可选 SHA384withRSA;SHA1withRSA 已被主流 CA 停发
-type CMS CMS / PKCS12 / JKS;传统版默认 CMS,与 .kdb 扩展名对应
-format ascii ascii(Base64 PEM)/ binary(DER)

步骤 3:先导入根 CA,再导入中间 CA。顺序不影响信任链构建,但两个都必须存在——据 Let’s Encrypt 文档,其服务器证书由中间证书(如 R10/R11)签发、再上溯到 ISRG Root X1,只导入根证书而缺少中间证书是握手失败最常见的原因。

# 根 CA
/opt/IBM/WebSphere/AppServer/bin/ikeycmd -cert -add 
  -db .../NodeDefaultKeyStore.kdb -pw 'StrongPass123' 
  -label rootCA -file rootCA.cer -format ascii -trust enable
# 中间 CA:仅 -label 不同
/opt/IBM/WebSphere/AppServer/bin/ikeycmd -cert -add 
  -db .../NodeDefaultKeyStore.kdb -pw 'StrongPass123' 
  -label intermediateCA -file intermediateCA.cer -format ascii -trust enable

步骤 4:接收服务器证书。若 CA 返回的是 PEM 链文件,顺序必须是服务器证书在前、中间 CA 在后;顺序颠倒时 -cert -receive 会报 CTGSK3027W The certificate chain is not valid 之类的链校验错误。

/opt/IBM/WebSphere/AppServer/bin/ikeycmd -cert -receive 
  -db .../NodeDefaultKeyStore.kdb -pw 'StrongPass123' 
  -file was.example.com.cer -format ascii
# 校验:确认 was_ssl 别名下已挂上完整链
/opt/IBM/WebSphere/AppServer/bin/ikeycmd -cert -list -db .../NodeDefaultKeyStore.kdb -pw 'StrongPass123'

步骤 5:创建 SSL 配置并绑定端点。这正是 websphere ssl证书安装 中最容易漏掉的一环——证书装进 keystore 并不等于生效,必须让某个 SSL 配置引用该别名。

/opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin/wsadmin.sh -lang jython -username wasadmin -password '***'
# 在 wsadmin 交互提示符下执行:
# 新建配置:引用 NodeDefaultKeyStore 中的 was_ssl,强制 TLSv1.2
AdminTask.createSSLConfig(['-alias','NodeDefaultSSLConfig_TLS12',
  '-keyStoreName','NodeDefaultKeyStore','-keyAlias','was_ssl',
  '-trustStoreName','NodeDefaultTrustStore','-sslProtocol','TLSv1.2'])
AdminConfig.save()
# 若提示 option 无效,先执行 AdminTask.createSSLConfig('?') 查看本版本支持的参数集

随后在控制台 Servers → Server Types → WebSphere application servers → server1 → Web container transport chains → WCInboundDefaultSecure → SSL settings 中把 SSL 配置切换为 NodeDefaultSSLConfig_TLS12,保存。注意 -sslProtocol 在 9.0.5 中默认值为 TLSv1.2,可选 TLSv1.3(需 Java 8 SR5 及以上);设为 SSL_TLS 会同时放行 TLS 1.0/1.1,多数合规扫描会直接判为高危。

步骤 6:同步与重启。在 Dmgr 中先同步,再停启受管节点上的 server,否则节点仍使用旧的 server.xml 配置。

# Dmgr:推送配置到活动节点
AdminNodeManagement.syncActiveNodes()
# AppSrv01:重启 server1(单节点约 1–3 分钟)
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
./stopServer.sh server1 -username wasadmin -password '***'
./startServer.sh server1
# 集群场景按节点滚动执行,整体 5–15 分钟

验证阶段用一条命令即可判断链是否完整:openssl s_client -connect was.example.com:9443 -servername was.example.com -showcerts,输出中应出现两级证书且 Verify return code: 0 (ok)。这也是把 websphere ssl证书安装 从”文件放对位置”推进到”链路真正可用”的关键判据,可继续延伸到 Liberty 的 server.xml 写法与证书轮换策略。

配置与命令示例:ikeycmd、wsadmin、Liberty server.xml 的具体参数

在 WAS 9.0.5 传统版里,证书落在哪里、由谁管,取决于你用哪条命令链:ikeycmd 负责“造库”(GSKit 层),wsadmin 负责“挂库”(WAS 配置层),两者之间靠 alias 对齐。搞混这两层,是 websphere ssl证书安装 最常见的返工原因。

先建独立 KeyStore 还是复用 NodeDefaultKeyStore? 复用省事但升级/重装节点时易被覆盖;独立库便于单独备份与轮换。用 GSKit 建库(据 IBM GSKit ikeycmd 文档,-type 默认 cms,-expire 默认 365 天):

# 创建独立 CMS 格式密钥库;-stash 生成 .sth 隐式密码文件,供 WAS 免密读取
/opt/IBM/WebSphere/AppServer/bin/ikeycmd -keydb -create 
  -db /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/was_ssl.kdb 
  -pw 'StrongPass123' -type cms -stash -expire 3650

# 导入私钥证书与证书链(rootCA + intermediateCA 都要)
ikeycmd -cert -import -db /tmp/was_ssl.p12 -pw 'P12Pass' -type pkcs12 
  -target /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/was_ssl.kdb 
  -target_pw 'StrongPass123' -target_type cms
参数 常用值 默认值/取值范围 说明
-type cms cms(GSKit 默认)/ pkcs12 WAS 传统版原生支持 cms;Liberty 建议 pkcs12
-expire 3650 365,单位天 仅影响库内自签/内部证书
-size 2048 2048 起(RSA 生产下限) 低于 2048 会被现代客户端拒绝
-sigalg SHA256withRSA 对应 SHA-256 摘要 替代已弃用的 SHA1withRSA

wsadmin 里怎么把库挂成 SSL 配置? Jython 脚本(WAS 9.0.5 内置 Jython 2.7):

# ssl_config.py —— 用 wsadmin -lang jython -f ssl_config.py 执行
AdminTask.createSSLConfig('[-alias was_ssl_cfg -keyStoreName NodeDefaultKeyStore 
  -keyAlias was_ssl -sslProtocol TLSv1.2 
  -trustStoreName NodeDefaultTrustStore -trustAlias rootCA]')
# 已存在的配置改用 modifySSLConfig,务必保留原 -alias,否则入站连接会断
# AdminTask.modifySSLConfig('[-alias was_ssl_cfg -sslProtocol TLSv1.2]')
AdminConfig.save()
# 集群环境还需同步:AdminControl.invoke(AdminControl.completeObjectName('type=NodeSync,*'), 'sync')

怎么确认库里内容真的对? 列表必须同时出现个人证书与签发者证书,缺 intermediate 会触发典型报错 CWPKI0022E: SSL HANDSHAKE FAILURE ... The signer might need to be added to the local default trust store。

ikeycmd -cert -list -db /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/NodeDefaultKeyStore.kdb -pw 'StrongPass123'
# Personal Certificates
#   was_ssl
# Signer Certificates
#   rootCA
#   intermediateCA

Liberty 24.0.0.x 的写法与 WAS 完全不同——没有 ikeycmd,全在 server.xml;密码先用 securityUtility 编码为 {xor} 或 {aes}:

cd /opt/ibm/wlp/bin && ./securityUtility encode --encoding=xor 'StrongPass123'
# 输出形如 {xor}Kz0tLS0...
<!-- server.xml:type 默认 PKCS12,sslProtocol 默认 TLSv1.2(24.0.0.x) -->
<keyStore id="defaultKeyStore" location="${server.config.dir}/resources/security/was_ssl.p12"
          password="{xor}Kz0tLS0..." type="PKCS12"/>
<ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore" sslProtocol="TLSv1.2"
     enabledCiphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"/>

IHS 9.0.5 前置反向代理(基于 Apache,需 mod_ssl):

SSLEngine on
SSLCertificateFile      /opt/IBM/HTTPServer/ssl/was.example.com.crt
SSLCertificateKeyFile   /opt/IBM/HTTPServer/ssl/was.example.com.key
SSLCertificateChainFile /opt/IBM/HTTPServer/ssl/chain.crt
# 禁用已淘汰协议,仅保留 TLSv1.2/1.3
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1

改完怎么验证? 别只看日志“启动成功”,用 OpenSSL 直接看协商结果与链完整性:

openssl s_client -connect was.example.com:9443 -servername was.example.com 
  -tls1_2 -showcerts </dev/null 2>&1 | openssl x509 -noout -subject -issuer -dates
# 关注:Verify return code: 0 (ok),以及 issuer 是否为 intermediateCA

若采用 ECDSA P-256 证书,需确认 WAS 自带 JDK 8 SR5 及以上、且客户端支持相应曲线;生产变更前先在测试节点用上面的 s_client 跑通握手,再滚动到集群成员。按 Mozilla Server Side TLS 指南,TLSv1.2 下优先 ECDHE + AES-GCM 套件,这也正是 Liberty 示例里 enabledCiphers 只列两条的原因。

参数对比与方案选型表格:传统 WAS、Liberty、IHS 前置与云负载均衡怎么选?

选型的核心不是”哪种方案更强”,而是证书应该终结在哪一层。在决定 websphere ssl证书安装 落在哪一层之前,先看这张对比表:

方案 适用场景 证书格式 配置入口 轮换复杂度 生效代价
传统 WAS 9.0.5(内置 SSL) 管理控制台 9043、内部服务 9443、JMS/SOAP 双向 SSL CMS .kdb 或 PKCS12 管理控制台「安全性 > SSL 证书和密钥管理」+ 端点绑定 中 同步节点 + 重启 AppServer(分钟级)
WebSphere Liberty 24.0.0.x 容器、云原生、频繁发布环境 PKCS12 或 JKS server.xml 的 keyStore 与 ssl 元素 低 重启 server,10–60 秒
IHS 9.0.5 前置 多 JVM 共用 443、多应用共用域名 PEM(crt + key + chain) httpd.conf / ssl.conf 低 apachectl -k graceful,秒级重载
云负载均衡(ALB/NLB/SLB) 弹性伸缩、蓝绿发布、证书集中托管 PEM 或 PFX 控制台或 API 低 托管轮换,后端无需重启

传统 WAS 9.0.5 内置 SSL 的取舍是什么?链路最短,不需要额外组件,管理控制台 9043 与内部服务 9443 直接受益;代价是证书与 JVM 绑定——据 IBM 文档,WAS 9.0 起默认密钥库类型已从 JKS 改为 PKCS12,CMS 默认密码为 WebAS,导入后必须”保存 → 同步节点 → 重启”三步走。用自带 keytool 导入根链:

# WAS 9.0.5 传统版:将 CA 链导入节点默认信任库(9.0 起默认 PKCS12,默认口令 WebAS)
/opt/IBM/WebSphere/AppServer/java/8.0/bin/keytool -importcert 
  -alias corp-root-ca 
  -file /opt/certs/ca-chain.pem 
  -keystore /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/Cell01/nodes/Node01/trust.p12 
  -storetype PKCS12 -storepass WebAS -noprompt
# 之后在控制台「SSL 配置」中把该密钥库绑定到 NodeDefaultSSLSettings,再同步节点并重启

Liberty 为什么更适合频繁轮换?因为证书是 server.xml 的声明式配置,改完 server stop/start 通常 10–60 秒,且可用变量避免明文口令(Liberty 24.0.0.x 支持 ${env.xxx} 语法):

<!-- Liberty 24.0.0.x server.xml:证书轮换只需替换 key.p12 并重启 server -->
<keyStore id="defaultKeyStore" location="${server.config.dir}/resources/security/key.p12"
          type="PKCS12" password="${env.SSL_PASSWORD}"/>
<ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore"
     sslProtocol="TLSv1.2"
     enabledCiphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"/>
<!-- 注意:显式写 sslProtocol="TLSv1.2" 会关闭 TLSv1.3;若客户端支持,留空让 JDK 默认协商更安全 -->

IHS 前置什么时候值得上?当一个域名下有多个 JVM 时。证书只在 IHS 终结,后端 WAS 用内部 CA 或自签证书,每台 JVM 的证书安装次数从 N 次降为 0 次。IHS 9.0.5 可选 OpenSSL 1.0.2 或 1.1.1 版本,只有 1.1.1 版本才支持 TLSv1.3:

# IHS 9.0.5 ssl.conf 片段(Apache 2.4 语法)
Listen 443
<VirtualHost *:443>
  SSLEngine on
  SSLProtocol -all +TLSv1.2 +TLSv1.3        # 1.0.2 版本请删掉 +TLSv1.3
  SSLCertificateFile      /opt/IBM/HTTPServer/ssl/app.crt
  SSLCertificateKeyFile   /opt/IBM/HTTPServer/ssl/app.key
  SSLCertificateChainFile /opt/IBM/HTTPServer/ssl/chain.pem
  RequestHeader set X-Forwarded-Proto "https"
</VirtualHost>
# 重载而非重启,连接不中断;plugin-cfg.xml 需由 WAS 重新生成并传播
/opt/IBM/HTTPServer/bin/apachectl -k graceful

云负载均衡的边界在哪?证书在 LB 托管,WAS 只需信任 LB 到后端的内部证书,适合流量弹性变化的场景。注意后端回调地址、X-Forwarded-Proto 与 cookie Secure 属性要一并调整,否则会出现”页面 HTTPS、跳转 HTTP”的混合内容问题。成本参考(随渠道浮动):DV 单域名约 0–300 元/年,OV 约 800–3000 元/年,EV 约 3000–10000 元/年;Let’s Encrypt 免费但有效期仅 90 天,据 Let’s Encrypt 官方文档建议用 ACME 客户端自动续期。

排错时先看报错归属哪一层,比盲改配置快得多:

  • 传统 WAS:CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN ... was sent from the target host, but no trust of this signer exists. → 缺中间证书或信任库未同步。
  • Liberty:java.security.cert.CertPathBuilderException: PKIX path building failed → 后端证书链不全,需在 keyStore 中补全 chain。
  • IHS:SSL0222E: SSL Handshake Failed, No ciphers available → 客户端与 SSLCipherSuite 无交集,常见于只允许 TLSv1.2 的老客户端。

一句话判断法:需要证书与 JVM 强绑定(9043 管理台、JMS 双向 SSL)就用传统 WAS 内置 SSL;需要频繁发布就用 Liberty;多应用共用 443 就上 IHS 前置;流量弹性大、证书想集中托管就用云负载均衡。这也决定了后续 websphere ssl证书安装 的步骤顺序——先定终结层,再谈导入命令。

常见错误与排查:CWPKI0022E、PKIX path building failed、SSL0227E 怎么处理?

CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN CN=… was sent 是什么原因?这是最典型的信任链断点:客户端只认识自己信任库里的签发者,而服务器在握手中送来的签发者(中间 CA 或根 CA)不在其中。注意报错里的 SubjectDN 通常是中间 CA 而非服务器证书本身,所以只导入服务器证书往往无效。处理方式是同时把 rootCA 与 intermediateCA 导入节点默认信任库,再重启节点。这也是 WebSphere SSL 证书安装环节最高频的坑,据 IBM 文档,默认信任库为 NodeDefaultTrustStore,传统版默认密码为 WebAS:

# WAS 9.0.5 传统版:导入中间 CA 与根 CA 到节点默认信任库
cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs
IKEY=/opt/IBM/WebSphere/AppServer/bin/ikeycmd
$IKEY -cert -add -db NodeDefaultTrustStore.kdb -pw WebAS 
      -label intermediateCA -file intermediate.cer -format ascii   # 默认即 ascii,DER 需先转换
$IKEY -cert -add -db NodeDefaultTrustStore.kdb -pw WebAS 
      -label rootCA -file root.cer -format ascii
$IKEY -cert -list -db NodeDefaultTrustStore.kdb -pw WebAS          # 确认两个 label 均在列
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/stopNode.sh -username wasadmin -password '***'
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startNode.sh

javax.net.ssl.SSLHandshakeException: PKIX path building failed: unable to find valid certification path to requested target 怎么查?与上一条同源但发生在 JSSE 层:Java 信任库缺根 CA 或中间 CA,或证书已过期。先看服务器是否真的发完整链,输出中应出现 s:(服务器证书)与 i:(签发者)交替的多段:

openssl s_client -connect app.example.com:443 -servername app.example.com -showcerts </dev/null 2>/dev/null | grep -E "s:|i:"
openssl s_client -connect app.example.com:443 -servername app.example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject

SSL0227E: SSL Handshake Failed, no cipher suites in common 怎么办?协议版本或套件集合无交集。WAS 9.0.5 的 SSL 配置默认 Protocol 为 SSL_TLSv2(TLS 1.0/1.1/1.2 协商),若对端只发 TLS 1.3 或仅支持旧 RSA 套件就会撞上此错。在管理控制台 Security > SSL certificate and key management > SSL configurations > NodeDefaultSSLSettings > Quality of protection 中把 Protocol 设为 TLSv1.2,并启用 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 等 ECDHE 套件后同步节点。

错误码 故障层面 第一步验证动作
CWPKI0022E 信任库缺签发者 ikeycmd -cert -list 查 NodeDefaultTrustStore
PKIX path building failed JSSE 信任链不完整/过期 openssl s_client -showcerts 看链
SSL0227E 协议或套件不匹配 比对两端 Protocol 与 enabledCiphers
CWPKI0820A 密钥库路径/权限 ls -l .../certs/NodeDefaultKeyStore.kdb

CWPKI0820A: The keystore … does not exist 与 CWPKI0033E/CWPKI0812E 怎么处理?前者几乎都是路径大小写、profile 名写错(AppSrv01 与 Dmgr01 混用)或 .kdb/.sth 权限不足,确保 wasadmin 可读,且 -pw 与建库时一致;后者是 keyAlias 与 CSR 的 label 不一致或链缺失:

ls -l /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/etc/ssl/certs/NodeDefaultKeyStore.kdb
$IKEY -cert -list all -db NodeDefaultKeyStore.kdb -pw WebAS
$IKEY -cert -details -label was_ssl -db NodeDefaultKeyStore.kdb -pw WebAS  # 核对 SubjectDN 与有效期

SECJ0209E: SSL configuration alias was_ssl_cfg not found 怎么修?多为配置未保存、未同步或端点仍引用旧 alias。在 wsadmin(Jython)中确认后保存并同步:

print AdminTask.listSSLConfigs()   # 确认 alias 是否真实存在
AdminConfig.save()
AdminControl.invoke(AdminControl.queryNames('type=NodeSync,*'), 'sync')

排查顺序建议:先用 ikeycmd -cert -list 定位信任链,再用 openssl s_client 确认对端链路完整性,最后才动协议与套件——顺序反了会把信任问题误判成协议问题,浪费大量重启时间。

效果验证方法:如何确认 WebSphere SSL 证书安装已生效?

为什么“浏览器能打开控制台”不足以证明证书装对了?浏览器会缓存、会自动补链,而 WAS 传统版的 9443 与 Liberty 的 9443 走的是不同信任库:前者用 NodeDefaultKeyStore.kdb(CMS 格式),后者用 key.jks/key.p12。一次完整的验证必须同时覆盖四层:TLS 握手(协议+套件+链)、密钥库内容、SSL 配置对象与端点绑定、HTTP 层可达性。据 OpenSSL 官方文档,s_client 的 Verify return code 为 0 才表示对端发送的整条链在本地信任库中校验通过,非 0(如 20 = unable to get local issuer certificate、21 = unable to verify the first certificate)几乎都指向中间 CA 缺失。

第一步:用 OpenSSL 直连业务端口,看协议、套件和链(适用 OpenSSL 1.1.1 及以上;1.0.2 的输出格式略有差异):

# -servername 触发 SNI,多域名证书必须带;-tls1_2 强制只用 TLS1.2,便于判断是否还能降级
openssl s_client -connect was.example.com:9443 
  -servername was.example.com -tls1_2 -showcerts </dev/null
# 期望输出(节选):
#   depth=1 C = US, O = Let's Encrypt, CN = R3
#   Verify return code: 0 (ok)
#   New, TLSv1.2, Cipher is ECDHE-RSA-AES128-GCM-SHA256
#   Protocol  : TLSv1.2
# 只看到期时间(证书到期前 30 天设告警,可用 Zabbix/Prometheus 抓这行)
echo | openssl s_client -connect was.example.com:9443 -servername was.example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

第二步:确认证书真的进了正确的 KeyStore。WAS 9.0.5 传统版自带 ikeycmd(IKEYMAN 命令行,路径 $WAS_HOME/bin/ikeycmd),CMS 库默认是 NodeDefaultKeyStore,密码为创建时的 defaultKeyStore 密码:

export KS=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/Cell01/nodes/Node01/NodeDefaultKeyStore.kdb
# 列出个人证书,期望看到别名 was_ssl 且状态为 Valid
ikeycmd -cert -list personal_certificate -db $KS -pw 'StrongPass123'
# 核对 CN、有效期、签发者与 SAN,和线上证书逐字比对
ikeycmd -cert -details -label was_ssl -db $KS -pw 'StrongPass123'

若 -cert -list 里只有 root/default 而没有 was_ssl,说明证书被导进了 CellDefaultTrustStore 或另一节点的 KeyStore——这是最常见的一类“装了但没生效”。

第三步:核对 SSL 配置对象与 9443 端点绑定。WAS 9.0.5 新建 SSL 配置的 sslProtocol 默认为 TLSv1.2,但从 8.5.5 升级上来的 was_ssl_cfg 常残留 TLSv1;sslType 应为 JSSE(另一取值 SSLLight 已不推荐):

# 列出全部 SSL 配置别名
/opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -lang jython -c "print AdminTask.listSSLConfigs()"
# 逐个打印 sslProtocol / sslType / keyStoreName,确认 was_ssl_cfg 指向 NodeDefaultKeyStore
/opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -lang jython -c "
print AdminConfig.showAttribute(AdminConfig.getid('/SSLConfig:was_ssl_cfg/'), 'sslProtocol')
print AdminConfig.showAttribute(AdminConfig.getid('/SSLConfig:was_ssl_cfg/'), 'keyStoreName')"
# 改完务必同步并重启,否则节点用旧配置
# AdminConfig.modify(AdminConfig.getid('/SSLConfig:was_ssl_cfg/'), [['sslProtocol','TLSv1.2']]); AdminConfig.save()
# AdminNodeManagement.syncActiveNodes()

第四步:HTTP 层与协议面双向确认。用 curl 看应用层是否真的走 TLS(curl 7.52+ 输出 SSL certificate verify ok.),再用扫描器确认没有 TLSv1.0/1.1 残留、TLSv1.2 只协商 AEAD 套件(GCM/CHACHA20),这与 Mozilla 服务器端 TLS 推荐配置一致:

curl -vk https://was.example.com:9443/ibm/console 2>&1 | grep -Ei 'SSL certificate verify|TLS|subject:'
# 选项一:nmap(需 NSE ssl-enum-ciphers 脚本)
nmap --script ssl-enum-ciphers -p 9443 was.example.com
# 选项二:testssl.sh,只看 1.2 且不触发全量扫描
./testssl.sh --tls1_2 --quiet https://was.example.com:9443
验证面 命令 通过标准 失败通常意味着
握手与证书链 openssl s_client -showcerts Verify return code: 0 (ok) 缺中间 CA,或信任库未更新
协议版本 nmap --script ssl-enum-ciphers 仅 TLSv1.2(可选 TLSv1.3) sslProtocol 仍为 TLSv1
密钥库 ikeycmd -cert -list 出现 was_ssl 且 Valid 导入到错误 KeyStore
端点绑定 AdminTask.listSSLConfigs() 9443 引用 was_ssl_cfg 改配置后未 sync/未重启

Liberty 上怎么确认?Liberty 的 <ssl> 元素默认 sslProtocol 即 TLSv1.2,无需照抄传统版的 JSSE 配置;在 server.xml 中显式声明更利于审计:

<!-- server.xml:Liberty 19.0.0.9+ 支持 sslProtocol="TLSv1.3" -->
<ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore" sslProtocol="TLSv1.2" />

重启后在 messages.log 中确认 CWWKO0219I: TCP Channel defaultHttpEndpoint-ssl has been started and is now listening for requests on host * port 9443.,该消息出现即表示 SSL 端口已绑定证书启动;若改为 CWWKO0221E 则多半是 keystore 密码或别名不匹配。建议把 openssl x509 -enddate 的输出接入监控,在到期前 30 天告警——Let’s Encrypt 证书有效期仅 90 天,WAS 不会主动提醒你续期。

证书轮换与自动化:Let's Encrypt 90 天证书续期后 WebSphere 要重启吗?

会问这个问题,通常是因为 certbot 已经把新证书写入 /etc/letsencrypt/live/,但业务仍在提供旧证书。结论可以概括为:Liberty 必须重启 server(10–60 秒),传统 WAS 默认也要重启 AppServer,除非你确认该版本开启了动态 SSL 配置刷新;生产上更推荐滚动重启,而不是依赖热加载。据 Let’s Encrypt 官方文档,证书有效期 90 天,官方建议在到期前 30 天左右续期,certbot 默认在剩余 30 天内才实际续签,这也正好对应下文两级告警中的第一级。

对比项 传统 WAS 9.0.5.x(Base/ND) WebSphere Liberty
证书存储 CMS 密钥库 NodeDefaultKeyStore.kdb + .sth(密码 stash) server.xml 中 keyStore 指向 JKS/PKCS12/SAF
替换手段 ikeycmd -cert -delete / -cert -receive 替换文件 + 修改 server.xml 或变量
生效方式 默认重启 AppServer(JVM 级);9.0.5.x 部分环境支持动态刷新 重启 server 进程
典型中断 单节点 1–3 分钟;集群每节点间隔 5–10 分钟观察 10–60 秒

传统 WAS 的坑几乎都出在“别名”上:同一别名重复导入会直接抛 CWPKI0033E: The certificate with alias "was_ssl" already exists in the keystore.。所以顺序必须是先备份、再删除、最后导入完整链。注意 .kdb 与 .sth 必须成对备份,只备份 kdb 会导致 stash 密码对不上而无法打开库。

#!/bin/bash
# /opt/was/scripts/reload-was-ssl.sh  —— certbot deploy-hook,仅在证书真正续期时被触发
set -euo pipefail
DOMAIN=was.example.com
LE_DIR=/etc/letsencrypt/live/$DOMAIN
WAS_HOME=/opt/IBM/WebSphere/AppServer
KS_DIR=$WAS_HOME/profiles/AppSrv01/config/cells/DefaultCell01/nodes/DefaultNode01
LOG=/var/log/was-ssl-rotate.log; TS=$(date -Is)

# 0) 成对备份 kdb 与 sth,回滚时一起还原
cp -a $KS_DIR/NodeDefaultKeyStore.kdb $KS_DIR/NodeDefaultKeyStore.kdb.bak.$TS
cp -a $KS_DIR/NodeDefaultKeyStore.sth $KS_DIR/NodeDefaultKeyStore.sth.bak.$TS

# 1) 删除旧别名(首次执行不存在,忽略报错)
$WAS_HOME/bin/ikeycmd -cert -delete -db $KS_DIR/NodeDefaultKeyStore.kdb 
  -pw "$(cat /etc/was/kdb.pw)" -stash $KS_DIR/NodeDefaultKeyStore.sth 
  -label was_ssl || echo "$TS delete skipped" >> $LOG

# 2) fullchain.pem 含叶子+中间证书,ikeycmd 建议转 PKCS#7 后整链导入
openssl crl2pkcs7 -nocrl -certfile $LE_DIR/fullchain.pem 
  | openssl pkcs7 -print_certs -out /tmp/was-chain.pem

# 3) 以原别名重新导入,避免应用侧 sslConfig 引用失效
$WAS_HOME/bin/ikeycmd -cert -receive -file /tmp/was-chain.pem 
  -db $KS_DIR/NodeDefaultKeyStore.kdb -pw "$(cat /etc/was/kdb.pw)" 
  -stash $KS_DIR/NodeDefaultKeyStore.sth -format ascii -label was_ssl

echo "$TS imported, $(openssl x509 -in $LE_DIR/cert.pem -noout -enddate)" >> $LOG

挂到续期流程上,先用 --dry-run 验证钩子不会静默失败,再落地:

# 适用 certbot ≥1.0;--deploy-hook 仅在证书实际续期成功后执行
certbot renew --deploy-hook /opt/was/scripts/reload-was-ssl.sh --dry-run
certbot renew --deploy-hook /opt/was/scripts/reload-was-ssl.sh --quiet

# 传统 WAS:滚动重启,单节点间隔 5-10 分钟
$WAS_HOME/bin/stopServer.sh server1 -username wsadmin -password '***'
$WAS_HOME/bin/startServer.sh server1

Liberty 侧更简单,但不要把密码写死在 XML 里。用 ${env.SSL_PASSWORD} 引用环境变量,轮换时只替换密钥库文件并重启 server 即可;若采用 dropins/ 下的独立配置片段,还能让证书配置与应用配置解耦,便于同一份 server.xml 在测试与生产复用。

<!-- Liberty server.xml:密码来自环境变量,轮换只换文件+重启 -->
<keyStore id="defaultKeyStore" location="${server.config.dir}/resources/was.p12"
           type="PKCS12" password="${env.SSL_PASSWORD}"/>
<ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore" sslProtocol="TLSv1.2"/>

验证与监控不要只看本地文件,要探测真实端口。据 Mozilla SSL Configuration Generator 与 OpenSSL 文档,-servername 对 SNI 站点是必需的,否则会取到默认证书:

# 查看本地证书有效期(notBefore / notAfter)
openssl x509 -in /etc/letsencrypt/live/was.example.com/cert.pem -noout -dates

# 探测 9443 实际下发的证书,输出剩余天数,供脚本/探针调用
echo | openssl s_client -connect was.example.com:9443 -servername was.example.com 2>/dev/null 
  | openssl x509 -noout -enddate 
  | cut -d= -f2 | xargs -I{} date -d "{}" +%s 
  | awk -v n=$(date +%s) '{print int(($1-n)/86400)" days left"}'

Zabbix 可用“Web certificate”监控项直接取 ssl_expiry;Prometheus 则用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry,告警表达式写成 probe_ssl_earliest_cert_expiry - time() < 86400*30 作预警、< 86400*7 作严重级,正好覆盖 Let’s Encrypt 的 30 天续期窗口与失败兜底。

安全加固与兼容性:TLS 1.2/1.3、密码套件与证书链检查

Q:websphere ssl证书安装 完成、9443 也通了,怎么确认握手真的达标?

端口通只代表监听成功。合规体检看三件事:协商出的协议版本、密码套件、服务器是否把中间 CA 一并发送。先抓现场(OpenSSL 3.x 输出,1.1.1 字段名略有差异):

# -tls1_2 强制只谈 TLS 1.2;-verify_return_error 让链校验失败时返回非零退出码,便于脚本判断
openssl s_client -connect was.example.com:9443 -servername was.example.com 
  -tls1_2 -showcerts -verify_return_error </dev/null | 
  grep -E "Protocol|Cipher|Verify return code|i:"

合格输出应包含 Protocol : TLSv1.2、Cipher : TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、Verify return code: 0 (ok)。若出现 Protocol : TLSv1 或 Verify return code: 21 (unable to verify the first certificate),就得回到配置层修,而不是在应用侧打补丁。

Q:WAS 9.0.5 传统版怎么把协议钉死在 TLS 1.2,TLS 1.3 要不要开?

传统版的 sslProtocol 默认值是 SSL_TLSv2,它会随底层 IBM JDK 的版本放开 TLS 1.1、TLS 1.2 乃至 TLS 1.3,等于把协议下限交给 JDK 决定。显式改成 TLSv1.2 才能锁死基线(SSLv3、TLSv1.0 随之被排除)。据 RFC 8446,TLS 1.3 的握手与密钥派生完全重写,建议单独建一个 SSL 配置做灰度,确认对端(数据库、LDAP、MQ、第三方支付网关)都支持后再切,不要与生产配置共用。

# 文件 harden_ssl.py,执行:$WAS_HOME/bin/wsadmin.sh -lang jython -f harden_ssl.py
# 1) 列出全部 SSL 配置别名与 scopeName,改之前先抄下来
print AdminTask.listSSLConfigs()

# 2) 协议基线钉死 TLSv1.2;scopeName 换成上一步打印出的真实值
AdminTask.modifySSLConfig('[-alias NodeDefaultSSLSettings 
  -scopeName (cells/DefaultCell01|security.xml#SSLConfig_1) 
  -sslProtocol TLSv1.2]')

# 3) 保存并同步到节点,否则重启后回到旧值
AdminConfig.save()
AdminNodeManagement.syncActiveNodes()

Liberty 侧等价写法在 server.xml,sslProtocol 默认已是 TLSv1.2,支持逗号分隔多协议,且 tlsAllowRenegotiation 默认 true,生产应关掉:

<!-- 灰度 TLS 1.3 时写 sslProtocol="TLSv1.2,TLSv1.3";Liberty 20.0.0.11 起支持 TLS 1.3 -->
<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
     tlsAllowRenegotiation="false"
     enabledCiphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256"/>
加固项 传统版(full profile)位置 Liberty 位置 验证手段
协议基线 SSL 配置属性 sslProtocol=TLSv1.2 sslProtocol=”TLSv1.2″ openssl s_client -tls1_1 应报 unsupported protocol
密码套件 控制台 SSL 配置 → Cipher suites 勾选 enabledCiphers 属性 s_client 输出的 Cipher 行
证书链 NodeDefaultKeyStore 需含 leaf+intermediate defaultKeyStore 指向的 PKCS12 Verify return code: 0
吊销检查 JVM 属性启用 CRL/OCSP 无内建 stapling,前置 IHS/LB openssl s_client -status

Q:密码套件怎么选,为什么必须避开 CBC 和 RSA 密钥交换?

优先级只有两个:TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 与 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384(ECDSA 证书换成对应的 TLS_ECDHE_ECDSA_*)。ECDHE 提供前向保密,GCM 规避 CBC 的填充预言攻击(Lucky13/BEAST 一类)。RSA 证书密钥至少 2048 位,ECDSA 用 P-256 即可。要排除的是 TLS_RSA_WITH_AES_*(无前向保密)和一切 *_CBC_*。Mozilla SSL Configuration Generator 给出的 intermediate 档位可直接作为套件基线参考。传统版改完套件后,用 -Djavax.net.debug=ssl:handshake 在 SystemOut.log 里能看到实际协商结果,比猜更快。

Q:证书链报 PKIX 错误,怎么定位是缺中间 CA 还是信任库问题?

据 RFC 5280,校验方会检查 Basic Constraints(CA:TRUE)、Key Usage(keyCertSign)、Extended Key Usage(含 serverAuth)。生产上最常见的是 服务器只发了 leaf 证书,客户端拿不到中间 CA 就断链,典型报错就是 num=21:unable to verify the first certificate;若中间 CA 已发但客户端信任库没根证书,则是 num=20:unable to get local issuer certificate。修复顺序:先把中间 CA 导入服务器密钥库(leaf 与 intermediate 一起发送),根证书只放客户端信任库。

# 1) 服务器侧:把中间 CA 并入 PKCS12 密钥库(-alias 必须与现有条目不同名)
keytool -importcert -noprompt -alias intermediate-ca -file intermediate.pem 
  -keystore $CONFIG_ROOT/cells/DefaultCell01/NodeDefaultKeyStore.p12 
  -storetype PKCS12 -storepass changeit

# 2) 客户端侧:确认链上条目顺序(leaf 在最前,中间 CA 随后)
openssl s_client -connect was.example.com:9443 -showcerts /dev/null | 
  openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout

Q:OCSP stapling 和 HSTS 该在哪一层做?

WAS 传统版与 Liberty 对 OCSP stapling 的内建支持都有限,硬要在 JVM 层实现会牺牲性能与可控性。需要 stapling 时,把 TLS 终结前移到 IHS 或云负载均衡,用 openssl s_client -connect www.example.com:443 -status 检查响应里是否出现 OCSP Response Status: successful;做不到 stapling,至少配置 CRL 检查或改用 90 天以内的短期证书(Let’s Encrypt 默认有效期即 90 天),把吊销窗口压小。

HSTS 必须等全站 HTTPS 验证通过后再上,否则回滚成本极高。先在测试域名用 max-age=300 观察一周,再放大到一年:

# IHS 9(基于 httpd 2.4),需加载 mod_headers.so;灰度期用 300 秒便于回退
Header always set Strict-Transport-Security "max-age=300; includeSubDomains"
# 验证:curl -sI https://was.example.com/ | grep -i strict-transport-security

这一步与前面的 websphere ssl证书安装 是配套的:证书装对只解决”能加密”,协议、套件、链、吊销、HSTS 一起达标才算”加密得安全”。

传统 WAS 修改 NodeDefaultKeyStore 或 SSL 配置后,建议同步节点并重启 AppServer,单节点约 1-3 分钟;Liberty 修改 server.xml 后重启 server 通常 10-60 秒。部分 WAS 9.0.5.x 环境可动态刷新 SSL 配置,但生产变更仍建议按窗口重启并保留回滚。

传统 WAS 通过 ikeycmd 管理 .kdb 或 PKCS12 KeyStore,再用 wsadmin 或控制台创建 SSL 配置并绑定端点;Liberty 直接在 server.xml 配 keyStore 与 ssl 元素。前者适合既有企业应用,后者更适合容器和云原生部署。

先查服务器是否发送完整证书链,以及客户端信任库是否包含 rootCA 和 intermediateCA。把中间 CA 导入 NodeDefaultTrustStore 后重启,再用 openssl s_client -showcerts 确认链完整;若仍报错,检查证书 SubjectDN 与主机名是否匹配。

可以,但传统 WAS 更常用 CMS .kdb;PFX 可先转换为 PKCS12,再用 ikeycmd -keydb -import 或控制台导入,注意私钥密码与 KeyStore 密码分离。导入后仍要创建 SSL 配置并把 keyAlias 指向正确别名。

支持,但自动续期后要把新证书导入 KeyStore 并让 WAS 重新加载;传统 WAS 通常需同步节点和重启,Liberty 重启更快。建议 certbot deploy-hook 调用 ikeycmd 导入并记录日志,监控剩余 30 天告警。

用 openssl s_client -connect was.example.com:9443 -servername was.example.com -showcerts,检查输出是否包含 leaf 与 intermediate,并用 openssl verify -CAfile rootCA.pem -untrusted intermediate.pem leaf.pem 返回 OK。WAS 侧用 ikeycmd -cert -list 确认 Signer Certificates 有中间 CA。

不一定,取决于它们引用的 SSL 配置;如果 9043 与 9443 都绑定同一个 was_ssl_cfg,则一张证书即可覆盖。若管理控制台与业务域名不同,建议分别创建 SSL 配置和证书,避免主机名不匹配。


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

内容审核

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