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

WebSphere 强制 HTTPS 怎么配置:传统版 9.0 与 Liberty 的实操步骤与排错

websphere 强制https — WebSphere 强制 HTTPS 怎么配置:传统版 9.0 与 Liberty 的实操步骤与排错
核心结论

WebSphere 强制 HTTPS 最直接的做法是:Traditional 在应用 web.xml 加 CONFIDENTIAL,或在 HTTP inbound channel 开 Redirect to HTTPS;Liberty 在 server.xml 的 设 redirectToHttps="true",默认把 9080 的请求 302 到 9443。 传统版 WAS 9.0.5 的默认端口是 9080/9443,管理控制台 9043;只更换 9443 证书不会关闭 9080,必须加跳转规则。 验证命令:curl -I http://was-host:9080/ 应返回 302 且 Location: https://was-host:9443/;openssl s_client -connect was-host:9443 -servername was-host 应显示 Verify return code: 0 (ok)。 常见报错 CWPKI0022E 是信任库缺少对端签发者,用 keytool -importcert 导入中间 CA;ERR_TOO_MANY_REDIRECTS 多因代理未传 X-Forwarded-Proto: https。

为什么 WebSphere 只开 9443 仍然会走 9080?

因为 WAS Traditional 9.0.5 在创建 profile 时,会同时生成两条 Web 容器传输链:WCInboundDefault(HTTP,默认 9080)和 WCInboundDefaultSecure(HTTPS,默认 9443)。导入证书、替换 9443 的 keystore,只会改变安全链上的握手行为;明文链仍然独立监听并返回 200。容器不会因为“已经有 HTTPS”就自动关闭 9080。先用两条命令复现扫描器的判定依据:

# 明文端口是否仍可达:返回 200 就是扫描器报告的"HTTP 明文可访问"
curl -sI http://was-host:9080/ | head -n 1
# HTTP/1.1 200 OK

# 加密端口是否正常(-k 跳过自签/内部 CA 校验)
curl -skI https://was-host:9443/ | head -n 1
# HTTP/1.1 200 OK

是否真的“强制”,由三层独立开关决定,任意一层都不能替代另一层(据 IBM WebSphere Application Server 9.0 文档,传输链在服务器启动时按 server.xml 静态生成,改证书不会重建链):

层级 配置位置 默认值 生效范围 只换 9443 证书是否影响
应用级 应用 web.xml 的 <transport-guarantee> NONE 仅该模块匹配的 url-pattern 否
容器级 WCInboundDefault 链上的 HTTP inbound channel → Redirect to HTTPS 未勾选 该 server 上所有应用 否
边缘级 IHS httpd.conf / Nginx 的 301 无规则 全站(含静态资源) 否

应用级最可靠,且随应用打包走,不依赖运维改控制台:

<!-- web.xml,Servlet 3.1 / 4.0 均适用;不写则等价于 NONE -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>Entire App</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <!-- 关键行:容器对 http:// 请求返回 302 到 https:// 同路径 -->
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

传统版容器级开关的路径是 Servers > Server Types > WebSphere application servers > server1 > Web Container Settings > Web container transport chains > WCInboundDefault,在链上的 HTTP inbound channel 启用 Redirect to HTTPS;改完需重启 server1,再用 curl -sI http://was-host:9080/ 确认首行变成 302 且 Location 指向 9443。注意该开关是“跳转”而非“关闭端口”,9080 仍在监听。

Liberty 没有传输链概念,端口写在 server.xml 的 <httpEndpoint> 上,两个端口默认就是 9080/9443;当它前面有 IHS 9.0.5 或 F5 时,必须让 Liberty 信任代理头,否则应用生成的绝对 URL 仍是 http://,与边缘 301 互相打架:

<!-- Liberty server.xml -->
<httpEndpoint id="defaultHttpEndpoint" host="*"
              httpPort="9080" httpsPort="9443" />

<!-- 关键行:默认 false,不开启则不解析 X-Forwarded-Proto,易触发重定向循环 -->
<httpDispatcher trustProxyHeaders="true" />

代理侧对应要显式传头(IHS 示例,需加载 mod_proxy_http 与 mod_headers):

# IHS httpd.conf
RequestHeader set X-Forwarded-Proto "https"
Redirect permanent / https://app.example.com/

判断循环是否由丢头引起,看 curl 的最终报错即可:curl: (47) Maximum (50) redirects followed,浏览器侧则是 ERR_TOO_MANY_REDIRECTS。出现它基本可断定“应用以为自己是 http → 跳到 https → 边缘再跳回 → …”。定位手段是 curl -sIL http://was-host:9080/ 连续打印每一跳的 Location,看哪一跳把协议又改回 http。

传统版 WAS 9.0 强制 HTTPS 的完整操作步骤(编号 1-6)

先给结论:在 WAS 9.0.5.x 传统版里做 websphere 强制https,最省事且可回滚的路径是在 WCInboundDefault 传输链上打开 HTTP 重定向,而不是删掉 9080 端口或改 web.xml。删端口会让监控探针、健康检查和内部 EJB/IIOP 调用一起断,运维上得不偿失。以下 6 步按顺序执行,每步都给出可复制的完整命令。

步骤 1:备份配置(回滚的唯一保险)。Dmgr 与单机 profile 的配置全在 config 目录下,重点是 cells、nodes、servers 三层。

# 适用:WAS 9.0.x 传统版,默认 profile 路径 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01
mkdir -p /backup
tar -czf /backup/was-config-$(date +%F).tgz 
  -C /opt/IBM/WebSphere/AppServer/profiles/AppSrv01 
  config/cells config/nodes config/servers   # 只备这三层,体积小且覆盖所有变更点
# 回滚:先停服,再覆盖,最后同步
# ./stopServer.sh server1 -username admin -password '***'
# tar -xzf /backup/was-config-2025-01-01.tgz -C /opt/IBM/WebSphere/AppServer/profiles/AppSrv01
# ./syncNode.sh was-host 8879 -username admin -password '***'

步骤 2:登录控制台并确认版本与端口。地址是 https://was-host:9043/ibm/console(9043 是管理控制台安全端口,9080/9443 是应用端口)。在 Servers > Server Types > WebSphere application servers > server1 > Web Container Settings > Web container transport chains 中确认两条链的默认值,据 IBM Knowledge Center 对 9.0 的说明,出厂默认如下:

传输链 默认端口 SSL enabled 用途
WCInboundDefault 9080 false 明文 HTTP,强制 HTTPS 时保留但需重定向
WCInboundDefaultSecure 9443 true HTTPS 入口,重定向目标

步骤 3:打开 HTTP inbound channel 的 Redirect to HTTPS。进入 WCInboundDefault > HTTP inbound channel (HTTP_2),把 Redirect to HTTPS 设为 true(9.0.5.3 之后的某些 fix pack 里显示为一个复选框,勾选即可)。保存后同一页面通常会出现 Redirect port,填 9443。如果界面上根本没有这一项,不要删 9080 链,改用应用层方案:在 web.xml 里加 <transport-guarantee>CONFIDENTIAL</transport-guarantee>,容器会自动把 http 请求 302 到安全端口,这与 Servlet 规范及 RFC 9110 的重定向语义一致。批量修改可用 wsadmin(Jython):

# wsadmin.sh -lang jython -username admin -password '***'
AdminTask.modifyChain('[-chainName WCInboundDefault -modifyConfig -enableRedirect true]')
AdminConfig.save()   # 不 save 则配置不落盘

步骤 4:核对 WCInboundDefaultSecure 的 SSL 设置。确认 SSL enabled = true、端口 9443、证书别名指向 NodeDefaultKeyStore 中的域名证书(据 Let’s Encrypt 与 CA/Browser Forum 基线要求,证书 SAN 必须包含实际访问域名,否则浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID)。协议层面,WAS 9.0 的 SSL 配置默认 SSL_TLSv1.2,务必保持至少 TLSv1.2;JDK 8 SR6+ 或 JDK 11 环境下可在同一处追加 SSL_TLSv1.3,JDK 8 早期版本不支持 TLSv1.3,加了会导致启动失败。协议白名单推荐显式写:SSL_TLSv1.2,SSL_TLSv1.3。可用 OpenSSL 先验证握手与证书链:

openssl s_client -connect was-host:9443 -servername was-host -tls1_2 </dev/null 2>&1 | grep -E 'Protocol|Verify return code'
# 期望:Protocol : TLSv1.2   Verify return code: 0 (ok)

步骤 5:节点同步。单机(standalone)环境可跳过;有 Deployment Manager 的集群环境必须同步,否则节点上的 server.xml 仍是旧配置。

# 适用 WAS 9.0.x;8879 为 node agent 的 SOAP 端口,默认即 8879
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/syncNode.sh was-host 8879 -username admin -password '***'
# 输出结尾应出现 "Synching configuration completed" / "Syncronization complete"

步骤 6:滚动重启 server1 并看日志。集群按节点逐个重启,避免整体不可用。

cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
./stopServer.sh server1 -username admin -password '***'
./startServer.sh server1
# 启动后重点排查 SSL 握手类错误(CWPKI 前缀)
grep -E 'CWPKI[0-9]{4}[A-Z]' logs/server1/SystemOut.log | tail -20

常见真实报错是 CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN "CN=..." was sent from the target host...,含义是目标主机返回的证书签发者不在本地 truststore 里——处理办法是把根证书/中间证书导入 NodeDefaultTrustStore 的 Signer certificates,而不是关闭校验。启动日志干净后,用 curl -I http://was-host:9080/ 应返回 302 且 Location: https://was-host:9443/...,完整验证命令见第 6 节。

配置/命令示例:web.xml、Liberty server.xml 与 IHS 301

如果你在 WAS 传统版里想做到”只改应用、不动服务器配置”就完成 websphere 强制https,最省事的入口是 WEB-INF/web.xml 的 security-constraint。Servlet 3.1/4.0 规范要求容器对 CONFIDENTIAL 约束的资源只允许加密传输,WebSphere Application Server 9.0.5 的实现是:访问 http://host:9080/app/* 时返回 302 并带上 Location: https://host:9443/app/*(WC_defaulthost=9080、WC_defaulthost_secure=9443 为默认端口)。注意它是 302 而非 301,浏览器不会长期缓存,对 SEO 的权重传递弱于 301——这也是后面要用 IHS 做永久跳转的原因。

<!-- WEB-INF/web.xml,适用于 Servlet 3.1/4.0、WAS 9.0.5;无需重启服务器,重装应用即生效 -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>HTTPS Only</web-resource-name>
    <url-pattern>/*</url-pattern>          <!-- 覆盖全部路径,可按需缩小 -->
  </web-resource-collection>
  <user-data-constraint>
    <!-- CONFIDENTIAL:仅允许 HTTPS;NONE 为默认值,表示不限制传输层 -->
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

Open Liberty 的做法不同:不必改应用,直接在 server.xml 打开端点级重定向。redirectToHttps 默认是 false,改成 true 后 9080 上的请求会被回 302 到 httpsPort(默认 9443)。别忘了 defaultKeyStore 的密码必须配置,否则 ssl 元素启动即失败。

<!-- Open Liberty 24.0.0.6 server.xml -->
<httpEndpoint id="defaultHttpEndpoint" host="*"
              httpPort="9080" httpsPort="9443"
              redirectToHttps="true" />   <!-- 默认 false -->

<!-- sslProtocol 默认在 24.0.0.x 已包含 TLSv1.2/TLSv1.3,显式写出便于审计 -->
<ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore"
     sslProtocol="TLSv1.2,TLSv1.3" />

<!-- 密码可用 securityUtility encode 生成 {xor} 或 {aes} 加密串 -->
<keyStore id="defaultKeyStore" location="defaultKeyStore.p12"
          type="PKCS12" password="{xor}KzozbTQ+LTY=" />

面向公网时更推荐在 IHS 9.0.5 上做 301,因为重定向发生在 Web 层,后端 WAS 完全不必暴露 9080。据 RFC 6797,HSTS 头必须通过 HTTPS 响应下发才生效,所以下面的 Header 要写在 <VirtualHost *:443> 里,80 端口那段只负责跳转。

# IHS 9.0.5 conf/httpd.conf
LoadModule rewrite_module modules/mod_rewrite.so   # 默认未加载,不加载会报 Invalid command 'RewriteEngine'
LoadModule headers_module modules/mod_headers.so

<VirtualHost *:80>
    ServerName www.example.com
    RewriteEngine On
    RewriteCond %{HTTPS} off                        # 仅对明文请求跳转,避免环回
    RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]
</VirtualHost>

<VirtualHost *:443>
    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
</VirtualHost>

证书链是排错高发区。WAS 传统版节点级密钥库默认名为 NodeDefaultKeyStore,用 keytool 一眼看清别名、Owner 与 SAN:

# 查看别名、持有者、SAN 与链长度;storepass 按实际修改
keytool -list -v -keystore NodeDefaultKeyStore.p12 -storetype PKCS12 
        -storepass changeit | grep -E "Alias name|Owner|SubjectAlternativeName|Certificate chain length"

若输出里 Certificate chain length: 1,说明只导入了叶子证书。据 Let’s Encrypt 文档,服务端必须一并下发中间证书,否则部分客户端(尤其是 Java 8u 早期与 Android 旧版本)会报 unable to get local issuer certificate 或 PKIX path building failed。链长度 2–3 张(叶子 + 中间 CA,必要时带根)才是常态。

最后是协议版本。WAS 9.0.5 的 SSL 配置里 SSLv3 已默认禁用,但 TLSv1.0/1.1 仍可能开启,需在”安全性 → SSL 证书和密钥管理 → SSL 配置”中把协议勾选改为仅 TLSv1.2、TLSv1.3。据 Mozilla Server Side TLS 指南,面向公众站点应 TLS 1.2 起步。三种强制 HTTPS 方式的差异如下:

方式 生效位置 状态码 生效范围 是否需重启
web.xml CONFIDENTIAL 应用容器 302 单应用 重装应用即可
Liberty redirectToHttps httpEndpoint 302 整个 server 需重启 server
IHS mod_rewrite Web 服务器 301 整个 VirtualHost graceful 重载

web.xml、通道重定向、Liberty、IHS 怎么选?参数对比表

四种强制 HTTPS 的做法,到底该改哪一层?先看对比表,再决定配置位置——选错的代价通常是“应用跳转了,但 IIOP 客户端连不上”或“健康检查全红”。

方案 适用版本 配置位置 默认跳转 优点 注意
web.xml CONFIDENTIAL WAS 8.5.5 / 9.0.5、Liberty 应用 WEB-INF/web.xml 9080 → 9443 随应用发布,迁移方便 需重新打包;非 HTTP 客户端不受控
HTTP inbound channel 勾选 Redirect to HTTPS WAS Traditional 8.5.5 / 9.0.5 管理控制台传输链 9080 → 9443 服务端统一,无需改应用 不同 fix pack 界面有差异
Liberty redirectToHttps Open Liberty / WebSphere Liberty 24.0.0.6 server.xml 的 httpEndpoint 9080 → 9443 一行属性,适合容器化 仅 Liberty;需配 trustedProxy
IHS mod_rewrite 301 IHS 9.0.5 + WAS 插件 httpd.conf VirtualHost 80 → 443 集中管理,可加 HSTS 需在 IHS 配证书与插件

表里的端口对是默认值:WAS Traditional 默认 HTTP 9080、HTTPS 9443,管理控制台 9043,SOAP 连接器 8880;Liberty 默认 httpPort=9080、httpsPort=9443。任何方案都不要去动 9043 和 8880,否则控制台与 wsadmin 的 SOAP 连接会直接失联。

应用层:web.xml 怎么写?适合“应用必须兼容非 HTTP 客户端(IIOP、JMS、SOAP over HTTP)”的场景,因为它只约束匹配到的 Web 资源。

<!-- WEB-INF/web.xml,WAS 9.0.5 与 Liberty 通用;随应用打包,换服务器不用改配置 -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>all-https</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <!-- 取值 NONE | INTEGRAL | CONFIDENTIAL;CONFIDENTIAL 触发到 9443 的 302 -->
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

据 Jakarta Servlet 规范对 transport-guarantee 的定义,CONFIDENTIAL 要求容器用 TLS 保护该 URL 模式,WAS 与 Liberty 都实现为重定向到安全端口;它不会拦截 EJB 调用与消息驱动 Bean,所以不会误伤管理端口 9043。

服务端:传输链 Redirect to HTTPS 在哪改?控制台路径为“服务器 > 服务器类型 > WebSphere 应用服务器 > server1 > Web 容器传输链 > WCInboundDefault > HTTP_2”,勾选 Redirect to HTTPS 并把重定向端口填 9443。集群里每个 server 都要改,改完必须同步节点:

cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
./syncNode.sh dmgr.example.com 8879 -username wasadmin -password '******'
# 输出 "Synchronization complete" 才生效;漏同步会导致重启后配置回滚

Liberty 一行属性怎么写?注意 trustedProxy 默认是空字符串,即只信任本机转发头,Ingress/nginx 网段不写进去,跳转逻辑会判断错协议。

<!-- server.xml:WebSphere Liberty 24.0.0.6;redirectToHttps 默认 false -->
<httpEndpoint id="defaultHttpEndpoint" host="*"
              httpPort="9080" httpsPort="9443"
              redirectToHttps="true"
              trustedProxy="10.0.0.0/8"> <!-- 默认空串=仅信任本机 -->
</httpEndpoint>

IHS 前置 301 怎么写?集中管理、还能顺手下发 HSTS(RFC 6797),证书可用 Let’s Encrypt 签发后经 ikeyman 导入 kdb。

# IHS 9.0.5(基于 Apache httpd 2.4)conf/httpd.conf 的 80 端口 VirtualHost 内
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule headers_module  modules/mod_headers.so
<VirtualHost *:80>
  ServerName app.example.com
  RewriteEngine On
  # 仅对未走 TLS 的原始请求跳转,避免插件回源时二次跳转
  RewriteCond %{HTTP:X-Forwarded-Proto} !https
  RewriteRule ^/(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
</VirtualHost>
# 443 虚拟主机内下发 HSTS,先小 max-age 灰度再放大
Header always set Strict-Transport-Security "max-age=300; includeSubDomains"

为什么不能直接删掉 WCInboundDefault 传输链?IHS 插件健康检查、Kubernetes readinessProbe 和不少监控默认探 9080,链路一删,探针返回 503,SystemOut.log 里刷 SRVE0255E: A WebGroup/Virtual Host to handle /health has not been defined。要“强制”而不是“断链”,用重定向。

容器里为什么出现 ERR_TOO_MANY_REDIRECTS?Ingress 已终止 TLS 并把 http 转发到 9080,Liberty 再 302 回 https,浏览器就循环。此时关掉 redirectToHttps,改用 Ingress 注解 nginx.ingress.kubernetes.io/ssl-redirect: "true" 并透传 X-Forwarded-Proto。集群环境则优先选 web.xml 或 IHS 前置 301:前者随应用版本走,后者只需改 IHS 一处。

常见错误与排查:从 CWPKI0022E 到 ERR_TOO_MANY_REDIRECTS

Q:日志里出现 CWPKI0022E: SSL HANDSHAKE FAILURE: A signer with SubjectDN "CN=backend" was not found,是协议版本不匹配吗?

不是。据 IBM 文档,该消息的含义是握手时对端送来的证书链中找不到本端信任库已有的签发者,即信任锚缺失,与 TLS 版本、密码套件无关。传统 WAS 9.0 默认使用 NodeDefaultTrustStore,Liberty 则取 server.xml 中 <ssl> 元素的 defaultTrustStore 或 truststore.p12。把对端证书(或签发它的 CA)导入:

# -alias 必须唯一,重复导入会报 "Certificate not imported, alias <backend> already exists",先 -delete 再导入
keytool -importcert -alias backend -file backend.crt 
  -keystore trust.p12 -storetype PKCS12 
  -storepass changeit -noprompt
# WAS 9.0 与 Liberty 的默认 storepass 均为 changeit,生产环境必须修改
# 导入后重启:WAS 用 stopNode.sh / startNode.sh,Liberty 用 server stop / server start

Q:信任库导入了,为什么还报 java.security.cert.CertificateException: No subject alternative names present?

这是主机名校验失败,而非信任问题。RFC 6125 规定主机名匹配优先取 SAN 扩展,仅当 SAN 缺失才回退 CN;JDK 8u181 之后回退行为更严格。先确认证书内容:

openssl x509 -in server.crt -noout -text | grep -A1 'Subject Alternative Name'
# 正常输出:X509v3 Subject Alternative Name:
#               DNS:app.example.com, DNS:app
# 无输出说明只写了 CN,必须重签(Let's Encrypt 已不签发仅含 CN 的证书)

Q:浏览器报 ERR_TOO_MANY_REDIRECTS,到底是哪一层在循环跳?

常见于三层各跳一次:IHS 在 80 端口已 301 到 443,WAS 的 WCInboundDefaultSecure 因 security-constraint 的 CONFIDENTIAL 再 302 到 9443,而插件回源仍走 9080 明文端口,WAS 认为“仍是 http”于是继续跳。这也是 websphere 强制 https 最常见的翻车点:只在传输层加跳转,没告诉后端“前端已是 https”。

# IHS httpd.conf:确认 mod_headers 已加载,且该头只写在 443 的 VirtualHost 内
LoadModule headers_module modules/mod_headers.so
RequestHeader set X-Forwarded-Proto "https"
<!-- Liberty server.xml:trustedProxy 自 21.0.0.10 起支持,填 IHS 实际 IP,不要写 * -->
<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="9080" httpsPort="9443"
              trustedProxy="10.20.30.41"/>

传统 WAS 还要检查 plugin-cfg.xml 的 <VirtualHostGroup> 是否含 *:443、*:9443,以及应用绑定的虚拟主机别名是否覆盖对外域名。

Q:跳转到 9443 之后变成 404 Not Found?

多半是虚拟主机别名缺失或插件配置过期。先在控制台确认 WCInboundDefaultSecure 的 Host Aliases 含访问域名;WAS 9.0.5 上重新生成插件并重启 IHS:

/opt/IBM/WebSphere/AppServer/bin/GenPluginCfg.sh -profileName AppSrv01
# 输出默认位于 profiles/AppSrv01/config/cells/<cell>/nodes/<node>/servers/webserver1/plugin-cfg.xml
apachectl -k restart

Q:SRVE0255E: A WebGroup/Virtual Host to handle /app has not been defined 怎么处理?

含义是 URI 没有匹配到任何绑定在该虚拟主机与端口上的 Web 模块。进入 Environments > Virtual hosts > default_host > Host Aliases,添加 *:9443(以及 app.example.com:443),保存后 Synchronize nodes 并重启应用服务器。

Q:启动时报 SSL0227E: Fail to read the certificate?

属密钥库层读取失败,常见三因:storepass 与 ssl.client.props 不一致、别名不存在、文件对启动用户不可读。先验证文件本身:

keytool -list -v -storetype PKCS12 
  -keystore /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/<cell>/NodeDefaultKeyStore.p12 
  -storepass <password>
# 能列出别名即文件与密码正常;提示 password was incorrect 则密码错误
ls -l NodeDefaultKeyStore.p12   # 属主须为启动 WAS 的用户,建议权限 600
报错 定位层次 首查对象与关键动作
CWPKI0022E 信任链 信任库是否含对端 CA,keytool -importcert 后重启
No subject alternative names 证书内容 openssl x509 -text 看 SAN,缺失即重签
ERR_TOO_MANY_REDIRECTS 代理回源协议 X-Forwarded-Proto / trustedProxy / 插件虚拟主机
404(9443 上) 虚拟主机别名 WCInboundDefaultSecure + GenPluginCfg.sh
SRVE0255E 虚拟主机绑定 default_host 增加 *:9443 并同步节点
SSL0227E 密钥库文件 密码一致性、别名、文件属主与权限

快速分层验证:curl -vk https://app.example.com:9443/ 直连后端能通,说明问题在代理层(头信息与插件配置);直连也失败则停留在密钥库与虚拟主机层。

怎么确认 WebSphere 强制 HTTPS 已生效?

先看最直接的判据:明文端口应该回 302,而不是 200。WebSphere 的“强制 HTTPS”本质是 Web 容器在收到明文请求、且该资源被标记为 CONFIDENTIAL 传输保障(Servlet 规范 <transport-guarantee>)时,返回 302 并把 Location 指向加密端口。所以验证只需一条命令:

# Traditional 默认明文端口 WC_defaulthost=9080,加密端口 WC_defaulthost_secure=9443
curl -I http://was-host:9080/
# 期望:HTTP/1.1 302 Found
#       Location: https://was-host:9443/
# 若返回 HTTP/1.1 200 OK,说明重定向未加载或应用未重新部署(改了 web.xml 必须整包重装)

再跟一次重定向链,确认没有跳转死循环或多跳:

curl -I -L http://was-host:9080/
# 期望最终 HTTP/1.1 200 OK,且中间只有一次 302
# 出现多次 301/302:多为前置 IHS/httpd 与应用各跳一次,需按代理与 X-Forwarded-Proto 排查

证书与协议版本怎么一次验完?据 OpenSSL 文档,-tls1_2 会把握手限制在 TLS 1.2,握手失败即说明该通道未启用此协议(Liberty 可在 ssl 元素用 enabledTlsProtocols 显式声明):

# 1) 看握手与证书链,输出须含 Verify return code: 0 (ok)
openssl s_client -connect was-host:9443 -servername was-host -tls1_2 < /dev/null

# 2) 看有效期与 SAN 是否匹配主机名(Let's Encrypt 证书有效期 90 天,易过期)
openssl s_client -connect was-host:9443 -servername was-host < /dev/null 
  | openssl x509 -noout -dates -subject -issuer -ext subjectAltName

# 3) 确认协商到 TLSv1.2
curl -vI https://was-host:9443/ --tlsv1.2 2>&1 | grep -i "SSL connection"
# 期望:SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384

端口还在监听算不算没生效?算正常。9080 仍在监听但只回 302,说明重定向在容器层生效;若 ss 里 9080 直接消失,往往是传输链(transport chain)被误删:

# Linux
ss -lntp | grep -E '9080|9443'
# Windows
netstat -ano | findstr "9080 9443"

日志该搜什么关键字?配置生效后日志不应新增握手错误;Traditional 的 SystemOut.log/SystemErr.log 搜 CWPKI(SSL/证书,如 CWPKI0022E: SSL HANDSHAKE FAILURE)与 SRVE(Web 容器),Liberty 的 messages.log 搜 CWWKS(SSL 配置)与 CWWKO(端点,如 CWWKO0801E: Unable to initialize SSL)。

检查项 Traditional 9.0 WebSphere Liberty
默认端口 9080 / 9443(WC_defaulthost / WC_defaulthost_secure) 9080 / 9443(defaultHttpEndpoint)
强制跳转落点 应用 web.xml 的 CONFIDENTIAL + 虚拟主机别名 同样依赖 CONFIDENTIAL,端口在 server.xml 的 <httpEndpoint> 定义
日志文件 profiles/<app>/logs/<server>/SystemOut.log wlp/usr/servers/<server>/logs/messages.log
关键字 CWPKI、SRVE CWWKS、CWWKO

最后补一项安全基线常查的头:WebSphere 默认不发送 HSTS,Strict-Transport-Security 通常由前置 IHS/httpd 或应用过滤器补上,用 curl -sI https://was-host:9443/ | grep -i strict-transport-security 确认。三件事同时成立——明文回 302、加密端口 Verify return code: 0 (ok)、日志无新增 CWPKI/CWWKS 报错——才可判定 websphere 强制https 真正生效。

和 Tomcat、Nginx 比,WebSphere 强制 HTTPS 要注意什么?

为什么同样的“强制 HTTPS”,在 WebSphere 上要绕一圈?因为 Tomcat 和 Nginx 把跳转写进了连接器或 server 块,而 WebSphere Traditional 9.0 没有等价的“单行 return”:它的 HTTP 与 HTTPS 是两条独立的传输通道(WCInboundDefault 与 WCInboundDefaultSecure),跳转只能从“应用 web.xml 的 CONFIDENTIAL”“通道链配置”“前置 IHS”三选一。这就是 WebSphere 强制 HTTPS 复杂度的主要来源。

对比项 Tomcat 9 Nginx WAS Traditional 9.0 WebSphere Liberty 24.0.0.6
跳转实现 Connector redirectPort + web.xml CONFIDENTIAL return 301 一行 web.xml / 通道链 / IHS 三选一 httpEndpoint redirectToHttps="true"
默认安全端口 redirectPort 默认 8443 443 9443(WCInboundDefaultSecure) 9443,但必须显式写 httpsPort
证书链来源 JSSE keystore fullchain.pem JSSE truststore(NodeDefaultTrustStore) defaultKeyStore
生效方式 重启 reload 重启 server 并 sync 节点 server.xml 热加载

Tomcat 9 的写法最省事,注意 redirectPort 只是“告知端口”,真正触发跳转的是 CONFIDENTIAL:

<!-- conf/server.xml:redirectPort 指向 HTTPS Connector 端口,默认 8443 -->
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

<!-- conf/web.xml:CONFIDENTIAL 使容器返回 302 到 redirectPort -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>all</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

Nginx 侧只有一行,注意用 $request_uri 保留原始路径与查询串:

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;   # 单行完成跳转,无需 location 块
}

WebSphere Traditional 上先别急着写 8443。据 IBM 文档,传统版的默认安全端口来自传输通道 WCInboundDefaultSecure,默认值就是 9443,写错端口是 websphere 强制https 最常见的“跳过去打不开”原因:

# 传统版 9.0:确认 WCInboundDefaultSecure 的真实端口(默认 9443)
grep -A2 'WCInboundDefaultSecure' 
  $WAS_HOME/profiles/AppSrv01/config/cells/*/nodes/*/serverindex.xml

证书链为什么在 WebSphere 上更容易翻车?据 Let’s Encrypt 文档,服务端若只发送叶证书而不带中间证书,浏览器会直接报 NET::ERR_CERT_AUTHORITY_INVALID;WebSphere 传统版把信任锚放在 JSSE truststore(NodeDefaultTrustStore)里,比 Nginx 的 fullchain 文件更容易漏掉中间证书。上线前用一条命令自检:

# 应看到 2 条及以上 s:/i: 记录(叶证书 + 中间证书)
openssl s_client -connect example.com:9443 -showcerts -servername example.com </dev/null 2>/dev/null | grep -E ' [si]:'

Kubernetes 里为什么会出现重定向循环?Ingress 终止 TLS 后转发给后端的是明文 80/9080,如果 WAS 内再按 CONFIDENTIAL 或 redirectToHttps 跳一次,浏览器就会在 301 之间来回,报 ERR_TOO_MANY_REDIRECTS。正确做法是让 Ingress 做 ssl-redirect,后端只监听 9080,并把客户端协议透传下去:

# Ingress(ingress-nginx):跳转交给入口层,后端不再跳
metadata:
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true"        # 80 -> 443
    nginx.ingress.kubernetes.io/force-ssl-redirect: "true"  # 即使 Ingress 本身是 TLS 也强制
<!-- Liberty server.xml:信任代理传来的 X-Forwarded-Proto -->
<httpDispatcher trustedProxy="10.0.0.0/8" />

迁移到 Liberty 会轻多少?轻很多——redirectToHttps 一个属性就替代了传统版的通道链,但据 IBM 文档,24.0.0.6 的 httpEndpoint 仍需同时给出 httpsPort 与 defaultKeyStore,只写 httpPort 不会自动生成 9443,跳转目标为空,请求会挂起而非跳转:

<!-- features: transportSecurity-1.0 -->
<httpEndpoint id="defaultHttpEndpoint"
              host="*"
              httpPort="9080"
              httpsPort="9443"            <!-- 缺失则 redirectToHttps 无效 -->
              redirectToHttps="true" />   <!-- 等价于 Nginx 的 return 301 -->

<keyStore id="defaultKeyStore" password="{xor}..." />

建议保留但只做 302 跳转。直接删除传输链会让 IHS 插件健康检查、Kubernetes readinessProbe、监控探针返回 503;若合规要求关闭明文,可在防火墙只允许内网探针访问 9080。

不同 fix pack 界面有差异。优先在应用 web.xml 加 CONFIDENTIAL,或在 IHS 9.0.5 做 301;不要用删除 9080 传输链的方式,否则容易影响插件与健康检查。

说明信任库缺少对端签发者。用 keytool -importcert 导入中间 CA 或根 CA,确认别名与 SAN,重启 server1;再用 openssl s_client 验证证书链是否完整。

通道级重定向先发生,web.xml 在容器层再校验。同时开启通常不会循环,但代理未传 X-Forwarded-Proto 时可能循环;容器化场景只保留一层重定向。

WebSphere 有传输链、虚拟主机、插件三层。Tomcat 只需 redirectPort,Nginx 一条 return 301;WebSphere 要同时确认 9443 通道、虚拟主机别名和证书别名。

在 IHS/负载均衡设置 RequestHeader set X-Forwarded-Proto https,Liberty 配 trustedProxy,应用尽量用相对路径;WAS Traditional 检查插件是否保留 Host 与协议头。

可在 IHS 加 Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"。先确保所有子域 HTTPS,否则按 RFC 6797 浏览器会强制 HTTPS 一年。


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

内容审核

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