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

WebLogic 强制 HTTPS 怎么配?12.2.1/14.1.1 三种方案、WLST 命令与报错实录

weblogic 强制https — WebLogic 强制 HTTPS 怎么配?12.2.1/14.1.1 三种方案、WLST 命令与报错实录
核心结论

WebLogic 强制 HTTPS 的标准做法是两步:先启用 Server 的 SSL 监听端口 7002 并配好 identity keystore,再在应用 web.xml 里声明 transport-guarantee=CONFIDENTIAL;要彻底禁掉明文,则用 WLST 执行 cmo.setListenPortEnabled(false) 关掉 7001,改完重启该 Server 生效,单实例耗时 2–5 分钟。 关明文端口的关键命令:connect 后在 /Servers/Managed1 下执行 cmo.setListenPortEnabled(false),重启后 ss -lntp | grep 7001 应无输出,只剩 7002 在监听。 反向代理终结 TLS 时必须在 WebLogic 侧设 Frontend Host / Frontend HTTPS Port(443),或开启 WebLogicPluginEnabled 并让代理发送 WL-Proxy-SSL: true,否则必现 ERR_TOO_MANY_REDIRECTS。 只跳转不收紧协议等于没加固:12.2.1.x 默认启用 TLSv1/1.1/1.2,需在控制台 SSL > Advanced 的 Enabled SSL Protocols 中只勾 TLSv1.2,JDK 11 环境可再加 TLSv1.3。 三条验证命令即可确认生效:curl -I 看 302 与 Location 端口、openssl s_client -tls1 必须握手失败、nmap --script ssl-enum-ciphers -p 7002 不应出现 TLSv1.0。

一、为什么 http://域名:7001 不会自动跳到 HTTPS?先看这三个根因

直接回答:WebLogic 里没有“全局强制 HTTPS”这个开关。它默认只开一个明文监听端口,SSL 端口是关着的,重定向能力则来自 Servlet 规范而非容器配置。所以 http://域名:7001 不会自动跳转,是设计使然,不是配置漏了。

根因 1:SSL 监听端口默认是关闭的。新建域时 ListenPort=7001、ListenPortEnabled=true,而 SSL MBean 的 enabled 默认是 false(Oracle 官方文档《Understanding WebLogic Server Security》中明确该属性默认值为 false)。此时访问 https://host:7002 直接得到 ERR_CONNECTION_REFUSED——端口根本没监听,连“重定向的机会”都不存在。先确认现状:

# 适用 WebLogic 12.2.1.x / 14.1.1.0,$DOMAIN_HOME/bin/setDomainEnv.sh 后执行
wlst.sh
connect('weblogic','Welcome1','t3://127.0.0.1:7001')
cd('Servers/AdminServer')
print('ListenPort        =', get('ListenPort'))        # 默认 7001
print('ListenPortEnabled =', get('ListenPortEnabled')) # 默认 true
print('SSL/ListenPort    =', get('SSL/ListenPort'))    # 默认 7002
print('SSL/enabled       =', get('SSL/enabled'))       # 默认 false,必须改 true

对应的 config.xml 长这样,<enabled>false</enabled> 就是那个“坑”:

<server>
  <name>AdminServer</name>
  <listen-port>7001</listen-port>
  <listen-port-enabled>true</listen-port-enabled>
  <ssl>
    <name>AdminServer</name>
    <listen-port>7002</listen-port>
    <enabled>false</enabled>   <!-- 关键:默认 false,端口未监听 -->
  </ssl>
</server>

根因 2:真正干活的是 transport-guarantee。据 Servlet 3.1 规范(JSR 340)第 13.8.4 节,只有当 web.xml 里声明了 security-constraint + user-data-constraint,且请求命中 url-pattern 时,容器才返回 302,Location 由请求的 Host 头加上本机 SSL 监听端口拼成。没声明时,HTTP 与 HTTPS 各自独立服务,互不干涉:

<security-constraint>
  <web-resource-collection>
    <web-resource-name>ForceHTTPS</web-resource-name>
    <url-pattern>/*</url-pattern>   <!-- 命中范围,按需收窄 -->
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

根因 3:代理终结 TLS 是循环重定向高发区。因为 Location 是 WebLogic 自己拼的(Host 头 + 7002),在 Nginx 对外 443、回源 7001 的拓扑下,浏览器收到 https://host:7002/xxx,代理再还原成 http 回源,最终 ERR_TOO_MANY_REDIRECTS。这也是为什么“在 Nginx 上配 rewrite”往往比在 WebLogic 内配 transport-guarantee 更稳。

现象 最可能根因 一条验证命令
ERR_CONNECTION_REFUSED(7002) SSL MBean enabled=false netstat -an | grep 7002
http 正常、不跳转 web.xml 缺 security-constraint grep -c transport-guarantee WEB-INF/web.xml
ERR_TOO_MANY_REDIRECTS Location 端口与代理端口不一致 curl -I http://host:7001/ 看 Location
403 且页面含 Transport guarantee constraint could not be satisfied keystore 路径/别名/口令错误,SSL 端口起不来 查 AdminServer.log 中 SSLKeyStoresException

最后提醒两点常被混淆的事。其一,“强制 HTTPS”不等于“安全”:WebLogic 12.2.1.x 的 SSL 默认启用 TLSv1、TLSv1.1、TLSv1.2;据 Oracle JDK 8u331 的 java.security 默认值,jdk.tls.disabledAlgorithms 已包含 TLSv1、TLSv1.1,但跑在 8u202 这类老 JDK 上时,扫描器仍会报 TLS 1.0 可用。其二,keystore 配错会把 302 直接变成 403——identity keystore 的路径、类型(JKS/PKCS12)、别名、私钥口令任一不匹配,SSL 端口就起不来,强制策略退化为 403 报错页。所以任何 weblogic 强制https 方案的第一步,都是先让 7002 端口真正监听成功,再谈跳转。

二、WebLogic 强制 HTTPS 的完整实操步骤(12.2.1.4 与 14.1.1 通用)

步骤 1|先备份再动手,把“回滚路径”准备好

WebLogic 的 SSL 配置全部落在 $DOMAIN/config/config.xml 里,改错一个 <ssl> 子节点就可能导致服务器起不来,所以任何 weblogic 强制https 操作之前先做两件事:备份配置目录、记录当前 SSL 节点原文。

export DOMAIN=/u01/domains/base_domain

# -a 保留属主/权限/时间戳,否则重启后可能因 config.xml 权限变化报 BEA-090402
cp -a $DOMAIN/config $DOMAIN/config.bak.$(date +%F)

# 记录当前 SSL 节点,回滚时直接 diff 这份快照
grep -A6 '<ssl>' $DOMAIN/config/config.xml
# 典型输出(说明当前 SSL 已开但协议未收紧):
#   <ssl>
#     <name>Managed1</name>
#     <enabled>true</enabled>
#     <listen-port>7002</listen-port>
#   </ssl>

# 确认 JDK 与 WL_HOME,避免拿 14.1.1 的文档去配 12.2.1.4 的域
$JAVA_HOME/bin/java -version
grep -E 'WL_HOME=|JAVA_HOME=|JAVA_VENDOR=' $DOMAIN/bin/setDomainEnv.sh | head -5
对比项 WebLogic 12.2.1.4 WebLogic 14.1.1
官方支持 JDK JDK 8(8u 系列为主) JDK 8 或 JDK 11
默认启用协议 TLSv1、TLSv1.1、TLSv1.2(SSLv3 自 12.2.1 起默认关闭) 同上;JDK 11 运行时才可启用 TLSv1.3
keystore 默认类型 JKS JDK 11 下 keytool 默认已改为 PKCS12,需显式 -storetype JKS

Mozilla 的 Server Side TLS 指南把 TLS 1.2 定为 intermediate 配置的基线,RFC 8446 定义的 TLS 1.3 则需要 JDK 11 及以上运行时支持——这就是 14.1.1 值得升级 JDK 的实际理由。

步骤 2|生成密钥与 CSR(显式指定 JKS)

export KEYSTORE=$DOMAIN/security/identity.jks

# 生成 2048 位 RSA + 自签占位证书,别名 weblogic_ssl 后续必须与正式证书一致
keytool -genkeypair -alias weblogic_ssl -keyalg RSA -keysize 2048 
  -sigalg SHA256withRSA 
  -dname "CN=app.example.com,OU=Ops,O=Example,L=Shanghai,ST=Shanghai,C=CN" 
  -keystore $KEYSTORE -storetype JKS 
  -storepass 'St0rePass!' -keypass 'KeyPass!' -validity 365

# 导出 CSR 交给 CA
keytool -certreq -alias weblogic_ssl -keystore $KEYSTORE 
  -storetype JKS -storepass 'St0rePass!' -file $DOMAIN/security/app.csr

据 Let’s Encrypt 文档,DV 证书通过 ACME 自动化签发通常在分钟级完成,而 OV/EV 证书因需人工核验主体,普遍要 1–3 个工作日,排期时要预留这段窗口。

步骤 3|导入完整证书链(顺序不能错)

# 先根 CA、再中间 CA、最后用同一别名 weblogic_ssl 覆盖自签证书
keytool -importcert -alias root_ca -file root.crt -keystore $KEYSTORE -storepass 'St0rePass!' -noprompt
keytool -importcert -alias intermediate_ca -file intermediate.crt -keystore $KEYSTORE -storepass 'St0rePass!' -noprompt
keytool -importcert -alias weblogic_ssl -file fullchain.crt -keystore $KEYSTORE -storepass 'St0rePass!' -noprompt

# 关键校验:链长应为 3;若显示 1 说明只导了叶子证书,浏览器会报"证书链不完整"
keytool -list -v -alias weblogic_ssl -keystore $KEYSTORE -storepass 'St0rePass!' 
  | grep -E "Certificate chain length|Signature algorithm"

步骤 4|配置 Keystore(控制台路径与写入结果)

路径:Environment > Servers > 目标服务器 > Configuration > Keystore。KeyStores 选 CustomIdentityAndJavaStandardTrust;Identity 填文件名 identity.jks、类型 JKS、库口令、别名 weblogic_ssl、私钥口令;Trust 沿用 JDK 自带 cacerts(默认口令 changeit)。保存后口令不会以明文出现,而是被加密成 {AES}... 写入 config.xml 的 <credential-encrypted> 节点——这也是为什么不能直接复制别人的 config.xml 片段。

步骤 5|启用 SSL 端口并收紧协议

General 页勾选 SSL Listen Port Enabled,端口填 7002(对外由 NAT/负载均衡映射到 443);再到 SSL > Advanced 的 Enabled SSL Protocols 只勾 TLSv1.2(JDK 11 环境可加 TLSv1.3),取消 TLSv1 与 TLSv1.1。命令行等价写法:

connect('weblogic','welcome1','t3://admin.example.com:7001')
cd('/Servers/Managed1/SSL/Managed1')
cmo.setEnabled(True)
cmo.setListenPort(7002)
cmo.setEnabledProtocols(['TLSv1.2'])          # JDK 11 环境可写 ['TLSv1.2','TLSv1.3']
cd('/Servers/Managed1')
cmo.setListenPortEnabled(false)               # 彻底关闭明文端口,仅在全部应用已走 HTTPS 时执行
save()
activate()

步骤 6|施加强制策略并滚动重启

强制方式 落地位置 生效范围 注意事项
transport-guarantee 应用 WEB-INF/web.xml 单个应用 需重新部署,CONFIDENTIAL 即全站 HTTPS
关闭明文 Listen Port 服务器配置 整台服务器 健康检查与监控探针要同步改端口
Frontend Host / Frontend HTTPS Port 服务器配置 反向代理拓扑 代理需透传 X-Forwarded-Proto
<!-- WEB-INF/web.xml -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>EntireApp</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>
cd $DOMAIN/bin
# 先起 AdminServer,再逐个起 Managed Server;7001 先保留,验证通过再关
nohup ./startManagedWebLogic.sh Managed1 t3://admin.example.com:7001 > /tmp/managed1.out 2>&1 &

# 验证证书链与协议版本(应只看到 TLSv1.2)
openssl s_client -connect app.example.com:7002 -servername app.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -dates

回滚只需 cp -a $DOMAIN/config.bak.$(date +%F)/* $DOMAIN/config/ 并重启;若 ssl_client 握手报 sslv3 alert handshake failure,八成是客户端仍只支持 TLSv1,而不是配置没生效。

三、配置片段与命令:web.xml、WLST、keytool、Nginx 各来一份

先说最容易踩坑的 web.xml。Servlet 3.1(Java EE 7)及以上,把下面这段放进应用 WEB-INF/web.xml 的 <web-app> 内即可,无需改任何 WebLogic 私有描述符:

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
  <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>
  <!-- 千万不要在这里写空的 <auth-constraint/>:
       按 Servlet 规范它表示"不允许任何角色",结果是整站 403 而不是 302 跳转 -->
</web-app>

CONFIDENTIAL 的语义由 Servlet 规范定义:容器必须保证数据在传输中不可被窃听,WebLogic 的实现是向同主机的 SSL 端口发 302。所以它依赖下面的 SSL 端口真的开着。

关明文端口用 WLST 最稳,12.2.1 与 14.1.1 命令完全一致,必须在 edit 会话里执行:

connect('weblogic','Welcome1','t3://admin.example.com:7001')
edit()
startEdit()                                        # 获取编辑锁
cd('/Servers/Managed1')
cmo.setListenPortEnabled(false)                    # 默认 true,关掉 7001 明文监听
cd('/Servers/Managed1/SSL/Managed1')
cmo.setEnabled(true)                               # 默认 true
cmo.setListenPort(7002)                            # SSL 端口默认 7002
cmo.setHostnameVerificationIgnored(false)          # 默认 false,改 true 等于放弃证书校验
cmo.setTwoWaySSLEnabled(false)                     # 单向 TLS,默认 false
activate()                                         # 写回 config.xml
# 之后必须重启 Managed1:监听端口的增删不支持动态生效
MBean 属性 默认值 说明
ListenPortEnabled true 置 false 后该 Server 不再监听明文端口
SSL/ListenPort 7002 被 CONFIDENTIAL 重定向的目标端口
HostnameVerificationIgnored false 置 true 会跳过 CN/SAN 校验,仅限排障
FrontendHTTPSPort 0(未设) 0 表示沿用请求端口,代理场景必须显式设 443

代理拓扑下,后端仍走明文 7001,但要让 WebLogic 认代理发来的 WL-Proxy-SSL: true 头,否则它会用 7001 拼绝对 URL,跳转后端口错乱:

cd('/Servers/Managed1/WebServer/Managed1')
cmo.setFrontendHost('app.example.com')
cmo.setFrontendHTTPSPort(443)
cmo.setWebLogicPluginEnabled(true)   # 默认 false;为 true 时 WL-Proxy-SSL 才被采信
activate()

Nginx 侧把 80 全部 301,443 加 HSTS。据 Mozilla SSL Configuration Generator,HSTS 建议 max-age 至少 31536000 秒且带 always,避免只对 2xx 生效:

server {
    listen 80;
    server_name app.example.com;
    return 301 https://$host$request_uri;          # 明文只做跳转
}
server {
    listen 443 ssl;
    http2 on;                                       # nginx 1.25.1+ 写法;旧版写 listen 443 ssl http2;
    server_name app.example.com;
    ssl_certificate     /etc/nginx/certs/fullchain.pem;
    ssl_certificate_key /etc/nginx/certs/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;                  # 与 WebLogic 14.1.1 默认协议集对齐
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    location / {
        proxy_set_header Host              $host;
        proxy_set_header WL-Proxy-SSL      true;    # WebLogic 专用,必须带
        proxy_set_header X-Forwarded-Proto https;
        proxy_pass http://10.0.0.11:7001;           # 后端仍是明文 7001
    }
}

证书进 JKS 时注意 JDK 的一个细节:keytool -importcert 只读取文件中的第一张证书,所以链文件要先拆开,或者干脆走 PKCS12:

keytool -importcert -trustcacerts -alias root -file root.crt 
        -keystore identity.jks -storepass 'ChangeIt123'          # 先导根 CA
keytool -importcert -alias weblogic_ssl -file fullchain.crt 
        -keystore identity.jks -storepass 'ChangeIt123'          # 再导服务器证书
keytool -list -keystore identity.jks -storepass 'ChangeIt123'
# 期望看到 weblogic_ssl 与两个 CA 条目,类型均为 trustedCertEntry
# 若需要带私钥的 PrivateKeyEntry(WebLogic 身份证书要求),改走:
# openssl pkcs12 -export -in fullchain.crt -inkey privkey.pem -out id.p12 -name weblogic_ssl
# keytool -importkeystore -srckeystore id.p12 -srcstoretype PKCS12 -destkeystore identity.jks

改完后 config.xml 的落地形态应包含 <listen-port-enabled>false</listen-port-enabled> 和 <ssl><name>Managed1</name><enabled>true</enabled><listen-port>7002</listen-port></ssl>。建议只通过控制台或 WLST 让管理端写入——直接手改 config.xml 需要停机,且下次 activate() 时以内存编辑树为准,改动可能被静默覆盖。

四、三种强制 HTTPS 方案怎么选?参数对比与选型建议

选型时不要先看”哪个最简单”,而是先量化五个维度:改动落在哪一层(应用包 / Server 实例 / 代理)、是否必须重启、明文端口是否仍在监听、能否顺带下发 HSTS、对健康检查与内部调用的影响。这五项基本决定了绝大多数生产环境的答案。

维度 方案 A:web.xml transport-guarantee 方案 B:关闭 ListenPortEnabled 方案 C:前置 Nginx / OHS
改动层级 应用包内 WEB-INF/web.xml Server 实例配置(config.xml / WLST) 代理层,应用零改动
生效方式 重新部署,通常 10–60 秒 必须重启该 Server,单实例 2–5 分钟 nginx -s reload,秒级
7001 是否仍监听 是,命中规则的请求返回 302 否,连接直接被拒 是(回源端口),但外部不可达
HSTS 需另配 Strict-Transport-Security 响应头过滤器 同样需另配 代理层一行 add_header 统一覆盖
健康检查 / 内部调用 探针仍可走 7001,影响最小 探针必须改 https 并信任内部 CA 探针打代理,需放行 /health 免 301

方案 A适合单应用、没有统一入口、还要把 7001 留给内部探针的场景;代价是每个应用都得改一遍,而且 302 属于临时重定向(RFC 7231 定义),部分扫描器会提示”未使用 301″。配置片段如下,12.2.1 与 14.1.1 通用:

<!-- WEB-INF/web.xml:命中 /* 的请求若为 http,WebLogic 返回 302 到 SSL 端口 -->
<security-constraint>
  <web-resource-collection>
    <web-resource-name>HTTPSOnly</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>  <!-- 关键行 -->
  </user-data-constraint>
</security-constraint>

方案 B最彻底:端口不再监听,任何 http 请求都拿不到 302,直接失败——用 curl 验证会看到 curl: (7) Failed to connect to app.example.com port 7001: Connection refused。代价是管理控制台与所有健康检查都得切到 https。

# WLST 在线修改单个 Server,适用于 12.2.1 / 14.1.1
connect('weblogic','Welcome1','t3s://admin.example.com:9002')
cd('/Servers/Managed1')
cmo.setListenPortEnabled(false)          # 默认 true,强制 HTTPS 场景设 false
cd('/Servers/Managed1/SSL/Managed1')
cmo.setListenPort(7002)                  # 默认 7002,可映射到 443
cmo.setEnabled(false)                    # 如需临时关 SSL 再改回 true
activate()                               # 需重启 Managed1 生效

方案 C是已有统一入口时的首选:证书、HSTS、OCSP stapling 集中管理,据 Mozilla SSL Configuration Generator 的 modern 配置档,可同时开启 ssl_stapling on 与 ssl_session_cache shared:SSL:10m。关键坑在于 Host 与 WL-Proxy-SSL 头:漏掉后者,WebLogic 认为请求仍是 http,会再次 302,浏览器报 ERR_TOO_MANY_REDIRECTS。

server {
  listen 80;
  server_name app.example.com;
  return 301 https://$host$request_uri;   # 301 而非 302,便于搜索引擎与扫描器识别
}
server {
  listen 443 ssl http2;
  ssl_certificate     /etc/nginx/certs/app.pem;
  ssl_certificate_key /etc/nginx/certs/app.key;
  ssl_protocols       TLSv1.2 TLSv1.3;    # WebLogic 默认仍含 TLSv1/1.1,此处收紧
  ssl_stapling on;
  ssl_stapling_verify on;
  ssl_session_cache shared:SSL:10m;
  add_header Strict-Transport-Security "max-age=300" always;  # 灰度期先用 300 秒,验证后调至 31536000
  location / {
    proxy_pass http://10.0.0.11:7001;
    proxy_set_header Host $host;
    proxy_set_header WL-Proxy-SSL true;            # 关键行:告知 WebLogic 已是 HTTPS
    proxy_set_header X-Forwarded-Proto https;
  }
}

关键参数默认值与建议值对照(依据 Oracle WebLogic Server 12.2.1/14.1.1 的 Administration Console Online Help 与 Securing Oracle WebLogic Server 文档):

参数 默认值 强制 HTTPS 建议值 备注
SSL Listen Port 7002 7002 或映射 443 管理端口与业务端口分开
ListenPortEnabled true false(方案 B) 改动需重启 Server
Frontend HTTPS Port 0(未设置) 443(代理场景) 影响重定向生成的 URL
Administration Port 9002,且 AdministrationPortEnabled=false 保持关闭 除非需要管理流量隔离
Enabled protocols 含 TLSv1、TLSv1.1 仅 TLSv1.2(JDK 11 可加 TLSv1.3) 旧协议已不被 PCI DSS 接受

一句话判断路径:有统一入口走 C,纯内网直连且能接受重启走 B,单应用又想保留明文端口给探针就走 A。HSTS 的语义与 max-age 生效规则见 RFC 6797,Let’s Encrypt 文档也明确建议首次上线用短 max-age 灰度,避免证书链问题被浏览器长期锁定。

五、踩坑实录:WebLogic 强制 HTTPS 的 6 个真实报错与处理

下面 6 个报错按现场出现频率排序,每条都给出一条能直接定位问题的命令。先说结论:WebLogic 强制 HTTPS 的故障,八成不在 web.xml 的 transport-guarantee 上,而在 SSL 端口状态、证书链完整性和代理层与 WebLogic 之间的“谁负责跳转”这三处。

Q1|报 HTTP 403 – Transport guarantee constraint could not be satisfied 怎么查?

A:这个 403 说明 web.xml 已声明 CONFIDENTIAL,但目标 Server 的 SSL 端口没启用,或 identity keystore 不完整(别名对不上、私钥缺失)。

<!-- web.xml:一旦声明,该 URL 只能走 HTTPS,否则容器直接返回 403 -->
<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>

到控制台 Environment → Servers → 目标 Server → Configuration → General,确认 SSL Listen Port Enabled 已勾选(端口默认 7002,取值范围 1–65535);再到 Keystore 页签核对 Custom Identity Keystore 路径、别名与私钥口令。注意:改的是 Server 级配置,必须重启该 Server,仅重新部署应用无效。

Q2|浏览器报 ERR_TOO_MANY_REDIRECTS 无限跳转?

A:典型场景是代理终结 TLS 后,WebLogic 仍按自身监听地址 302 到 https://host:7002,浏览器再被代理拦回,形成循环。两种改法:设置 Frontend Host / Frontend HTTPS Port,或勾选 WebLogicPluginEnabled 并让代理发送请求头 WL-Proxy-SSL: true。若代理侧已做 301 跳转,就应移除应用里的 transport-guarantee——跳转只能保留一层,两层必然死循环。

Q3|javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure?

A:客户端只支持 TLSv1/1.1,服务端只开 TLSv1.2 及以上,或双方加密套件无交集。据 OpenSSL 文档,用 -tls1_2 可强制单一协议版本握手,配合 nmap 枚举服务端套件即可定位缺口。

# 强制 TLS 1.2 握手,看服务端是否接受
openssl s_client -connect app.example.com:7002 -tls1_2 -servername app.example.com </dev/null

# 枚举服务端支持的协议与加密套件(需 nmap ssl-enum-ciphers 脚本)
nmap --script ssl-enum-ciphers -p 7002 app.example.com

协议勾选在控制台 Server → Configuration → SSL → Advanced → SSL Protocols;Oracle 从 12.2.1 起默认关闭 SSLv3(POODLE),14.1.1 在 JDK 11 及以上可勾选 TLSv1.3。老旧设备只能单独放行旧协议或用前置网关代理,不建议为它整体降级。

Q4|java.security.KeyStoreException: Cannot find the key for alias 'weblogic_ssl' 或 Keystore was tampered with, or password was incorrect?

A:别名拼写不一致、私钥口令与库口令不同,或从其他环境拷贝了 identity.jks 却没同步口令。先用 keytool 验证,别急着改配置。

# -v 会打印别名、证书链长度、是否含私钥入口(Entry type: PrivateKeyEntry)
keytool -list -v -keystore $DOMAIN_HOME/security/identity.jks -alias weblogic_ssl -storepass <库口令>

12.2.1 起控制台会把口令加密后写入 config.xml(依赖 SerializedSystemIni.dat),手改 config.xml 时直接填明文口令不会被识别,必须回到控制台重新录入。

Q5|sun.security.validator.ValidatorException: PKIX path building failed?

A:服务端只下发了叶子证书,缺中间 CA。据 Let's Encrypt 文档,证书文件应使用 fullchain(叶子 + 中间),而非单独的 cert。先数一下链长度:

# 统计服务端实际下发的证书张数,结果为 1 即缺中间证书
openssl s_client -connect app.example.com:7002 -showcerts -servername app.example.com </dev/null 2>/dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 导入中间 CA(先 delete 同名别名,再导入;根证书多数客户端已内置,可选)
keytool -importcert -noprompt -trustcacerts -alias intermediate_ca 
  -file intermediate.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit

服务端侧则用 fullchain 覆盖别名 weblogic_ssl(顺序为叶子 → 中间),覆盖前需 keytool -delete -alias weblogic_ssl。

Q6|启用 Administration Port(9002)后 http://host:7001/console 打不开或返回 403?

A:管理端口只接受管理流量且强制 SSL,普通应用请求走 7001 也会被拒。正确入口是 https://host:9002/console。确需回退时用 WLST:

# WLST 在线模式;AdministrationPortEnabled 默认 false,设 true 即强制管理端口 SSL
connect('weblogic', '<口令>', 't3://admin.example.com:7001')
edit()
startEdit()
cd('/Servers/AdminServer')
cmo.setAdministrationPortEnabled(false)
activate()
disconnect()
# 之后重启 AdminServer 生效:$DOMAIN_HOME/bin/stopWebLogic.sh && startWebLogic.sh

报错关键字 根因 一步定位
Transport guarantee constraint could not be satisfied web.xml 要 CONFIDENTIAL,但 SSL 端口未启用 General 页签查 SSL Listen Port Enabled
ERR_TOO_MANY_REDIRECTS 代理终结 TLS,WebLogic 302 回 7002 看响应头 Location 是否指向 7002
handshake_failure 协议/套件无交集 openssl s_client -tls1_2
Cannot find the key for alias 别名或口令不匹配 keytool -list -v -alias ...
PKIX path building failed 缺中间 CA openssl s_client -showcerts 数证书张数
9002 后 console 403 管理端口只收管理流量且强制 SSL 换 https://host:9002/console

六、怎么确认真的强制生效了?6 条验证命令

配置完成不等于策略生效。下面 6 条验证按“从外到内”的顺序排列,依次检查客户端看到的跳转、TLS 握手、证书、协议套件、监听端口和日志统计;其中任何一条不通过,就说明 weblogic 强制https 没有真正生效。命令里的 app.example.com、7001/7002 请替换为你的实际值(WebLogic 默认 ListenPort 为 7001,SSL ListenPort 为 7002)。

  1. 第一步:查看跳转状态码与 Location。只看响应头,不要下载正文:

    # -I 只取响应头,不下载正文
    curl -sSI http://app.example.com:7001/
    # 期望:HTTP/1.1 302 Moved Temporarily
    #       Location: https://app.example.com:7002/
    
    # 打成一行便于脚本断言(%{redirect_url} 需 curl >= 7.18.0)
    curl -sS -o /dev/null -w '%{http_code} %{redirect_url}n' http://app.example.com:7001/
    # 期望输出:302 https://app.example.com:7002/

    如果返回 200,说明只启用了 SSL 端口,但没有配置重定向;如果返回 302 但 Location 为空,说明重定向过滤器没有匹配到 URL 模式。WebLogic 默认使用 302 而不是 301,因为 301 会被浏览器长期缓存,策略回滚时客户端不会重新请求。

  2. 第二步:确认跟随跳转后的最终页面可以正常打开。-L 会跟随跳转:

    curl -sSL -o /dev/null -w '%{http_code} %{url_effective}n' http://app.example.com/
    # 期望:200 https://app.example.com/...(最终 URL 以 https 开头)

    000 表示 TCP 连接或 TLS 握手失败;495/496 是 nginx 风格的状态码,WebLogic 自身不会返回,出现它通常说明前置了负载均衡或反向代理,并且客户端证书策略没有对齐,对应服务端日志为 SSLHandshakeException: no cipher suites in common 或 Received fatal alert: bad_certificate。

  3. 第三步:核对证书与协议版本。-servername 用于传递 SNI(RFC 6066);在多域名场景下如果漏掉这个参数,就会拿到默认证书,从而造成误判:

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

    据 Let's Encrypt 文档,2017 年之后签发的证书不再依赖 CN,主流浏览器只校验 SAN,所以必须确认 SAN 中包含实际访问的域名;notAfter 距今小于 30 天就应续签(Let's Encrypt 证书有效期 90 天,官方建议剩余 30 天时自动续期)。

  4. 第四步:验证弱协议与弱套件已经关闭。

    # 期望握手失败:alert protocol version 或 handshake failure
    openssl s_client -connect app.example.com:7002 -tls1 </dev/null
    
    # nmap 7.x 的 ssl-enum-ciphers 脚本,输出中不应出现 TLSv1.0 与 3DES、RC4
    nmap --script ssl-enum-ciphers -p 7002 app.example.com

    协议与套件最终由 JVM 决定;WebLogic 12.2.1/14.1.1 都会读取 java.security 中的禁用列表,可以这样确认默认值:

    grep '^jdk.tls.disabledAlgorithms' $JAVA_HOME/jre/lib/security/java.security
    # JDK 8u161+ 默认已含 3DES_EDE_CBC、RC4;JDK 11/17(14.1.1 常用)默认还禁用 TLSv1、TLSv1.1
  5. 第五步:确认监听端口状态。

    ss -lntp | grep -E ':(7001|7002)'
    # 期望只剩 7002;7001 仍在监听说明 ListenPortEnabled 未生效
    connect('weblogic','welcome1','t3://admin.example.com:7001')
    cd('/Servers/Managed1')
    ls()                        # ListenPortEnabled 应为 false
    cd('/Servers/Managed1/SSL/Managed1')
    ls()                        # ListenPort 为 7002、Enabled 为 true

    ListenPortEnabled 属于静态配置,改完后必须在控制台激活并重启受管服务器;仅重新连接 WLST 不会生效,这也是 weblogic 强制https 最常见的“配置已改但 7001 仍在监听”原因。

  6. 第六步:查看日志与外部评级。WebLogic 访问日志为 Common Log Format,第 9 列即状态码:

    awk '$9==302' $DOMAIN/servers/Managed1/logs/access.log | wc -l
    awk '{print $9}' $DOMAIN/servers/Managed1/logs/access.log | sort | uniq -c

    302 的条数应与明文访问量吻合;如果为 0,先确认 HTTP 访问日志是否开启(该日志默认关闭,路径为“域 → 服务器 → 日志 → HTTP 访问日志”)。最后用 Qualys SSL Labs 对域名做一次评级,配置了 HSTS(响应头 Strict-Transport-Security: max-age=31536000,见 RFC 6797)且仅保留 TLSv1.2/1.3 时通常可达 A 或 A+。

观察到的现象 最可能的病因 处理动作
curl 返回 200 且无 Location 仅启用 SSL 端口,未配重定向 检查重定向过滤器或虚拟主机 URL 匹配
curl 输出以 000 开头 7002 未监听或握手失败 查看 ss -lntp 与 Managed 日志中的 SSLHandshakeException
s_client 提示 alert protocol version JDK 已禁用 TLSv1/1.1(符合预期) 无需处理;确认业务客户端支持 TLSv1.2+
SSL Labs 评级 B 及以下 残留 3DES/RC4 或未开 HSTS 核对 jdk.tls.disabledAlgorithms,补发 HSTS 头

七、上线前加固清单:TLS 版本、HSTS、证书续期与监控

HSTS 在 WebLogic 控制台里没有独立开关——截至 14.1.1,Server → SSL 页面只有协议版本、密码套件、证书与密钥库,没有 Strict-Transport-Security 这一项。按 RFC 6797 第 6.1 节,HSTS 只能由 HTTPS 响应携带,浏览器收到 http 响应里的该头会直接忽略,所以注入点必须在 TLS 终结之后。常见两种做法:在 Nginx/OHS 用 add_header ... always 下发,或在应用里写一个 Filter,判断 request.isSecure() 后再 resp.setHeader("Strict-Transport-Security", "max-age=300")。首次上线不要直接拉满一年,先用 300 秒观察一周,确认没有遗漏的 http 内嵌资源与子域后再改 31536000; includeSubDomains——HSTS 一旦被缓存,回滚成本远高于上线成本。

代理层同时承担 TLS 版本收敛与 OCSP stapling,这两件事 WebLogic 自身都做不了(WebLogic 不提供 stapling 配置项,也没有“禁用 TLS 1.1”的开关,只有 12.2.1.3 起新增的 Minimum TLS Protocol Version 字段):

# nginx 1.18+(ssl_stapling 需 1.3.7+),Mozilla "intermediate" 配置基线
server {
    listen 443 ssl;
    server_name app.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    ssl_protocols       TLSv1.2 TLSv1.3;        # 与 Mozilla Server Side TLS 推荐一致,淘汰 TLS1.0/1.1
    ssl_prefer_server_ciphers off;

    ssl_stapling on;                            # OCSP stapling,WebLogic 端无对应配置
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 必须是含中间 CA 的链,只放叶证书会 stapling 失败

    add_header Strict-Transport-Security "max-age=300" always;  # 观察期值,稳定后改 31536000; includeSubDomains

    location / { proxy_pass https://10.0.0.11:7002; }  # 回源仍走 7002,weblogic 强制 https 在此闭环
}

若 TLS 直接终结在 WebLogic(未加代理),用 WLST 收敛协议版本,注意老版本没有这个属性:

# 适用 12.2.1.3+ / 14.1.1;12.2.1.0~12.2.1.2 会报 AttributeError: setMinimumTLSProtocolVersion
connect('weblogic','welcome1','t3://127.0.0.1:7001')
edit(); startEdit()
cd('/Servers/AdminServer/SSL/AdminServer')
cmo.setMinimumTLSProtocolVersion('TLSv1.2')
activate()

证书续期按 CA/B Forum Baseline Requirements 上限 398 天,Let's Encrypt 则是 90 天,自动化不是可选项。acme.sh 的 --reloadcmd 只在证书真正更新时执行,可安全挂重启动作:

acme.sh --install-cert -d app.example.com 
  --key-file       /etc/nginx/ssl/privkey.pem 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "nginx -t && systemctl reload nginx"   # TLS 终结在 WebLogic 时改为重启受管服务器
证书类型 验证方式 典型价格(元/年) 有效期上限 适用场景
DV 单域名 HTTP-01 / DNS-01 自动 0–100 90 天(LE)/398 天 对外单域名、测试环境
OV 单域名 企业资料人工审核 800–2500 398 天 对外主域名、合规要求
OV 通配符 审核 + 泛域名 3000–8000 398 天 多子域统一入口

监控只盯两件事:端口存活与证书到期。openssl x509 -checkend 在剩余时间大于给定秒数时返回 0,可直接接告警:

# 剩余不足 30 天(2592000 秒)时输出 "Certificate will expire" 并以非 0 退出
openssl s_client -connect app.example.com:7002 </dev/null 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 
  || echo "ALERT: cert expires in <30 days"

规模化场景交给 Prometheus blackbox_exporter 的 https 探针,1 分钟粒度抓 probe_ssl_earliest_cert_expiry。但探针自身最容易翻车:健康检查地址从 http://ip:7001/health 改成 https://ip:7002/health 后,内部 CA 或自签证书会让 JVM 抛出 sun.security.validator.ValidatorException: PKIX path building failed,实例被 LB 摘除。先把内部 CA 导入信任库,再改探针:

keytool -importcert -noprompt -alias internal-ca -file ca.crt 
  -keystore "$JAVA_HOME/jre/lib/security/cacerts" -storepass changeit   # 默认口令 changeit

最后做一次外部视角验收:nmap -p 7001,7002 app.example.com 确认 7001 为 closed/filtered(而不是 open),再从两个不同网络位置分别访问 http:// 与 https:// 各一次,确认跳转链路只有一跳——出现 301 跳 http 再 302 跳 https 的叠加,说明前置代理与 WebLogic 的 weblogic 强制 https 规则重复生效,需在代理层统一收敛。

不够。web.xml 里的 transport-guarantee 只是声明「该资源必须走安全通道」,前提是目标 Server 的 SSL 监听端口已启用、identity keystore 已配好;否则容器无法完成跳转,会直接返回 HTTP 403 并提示 Transport guarantee constraint could not be satisfied。

先确认控制台地址是否改成了 https://host:7002/console;如果之前启用了 Administration Port(默认 9002),则只能通过 https://host:9002/console 访问,且该端口只接受管理流量。要回退可 WLST 执行 cmo.setAdministrationPortEnabled(false) 或 cmo.setListenPortEnabled(true) 后重启 AdminServer。

通常不需要,而且两边都配反而容易出循环重定向。若 Nginx 终结 TLS 后以 http 回源 7001,应移除应用里的 transport-guarantee,并在 WebLogic 侧设 Frontend Host/Frontend HTTPS Port 或开启 WebLogicPluginEnabled 让代理发送 WL-Proxy-SSL: true,保证应用生成的绝对 URL 是 https。

按三步查:一是控制台 Servers > Configuration > General 的 SSL Listen Port Enabled 是否勾选、端口是否为 7002;二是 Keystore 页签的 KeyStores 类型、identity.jks 路径、别名与私钥口令是否正确;三是 web.xml 的 url-pattern 是否覆盖了实际请求路径。三项任一不满足都会复现该 403。

单应用、无统一入口时用 WebLogic 的 transport-guarantee 或直接关掉 ListenPortEnabled 更省事,改动局限在实例内;已有统一入口、多应用共享域名时,用 Nginx/OHS 做 301 与 HSTS 更合适,证书轮换、OCSP stapling、限流都能集中管理,应用侧零改动。

关闭 ListenPortEnabled、启用 SSL 端口、修改 keystore 与协议版本都需要重启对应 Server,单实例一般 2–5 分钟;仅修改 web.xml 的 transport-guarantee 只需重新部署应用,通常 10–60 秒。生产环境建议先重启 AdminServer,再逐个滚动重启 Managed Server。

取决于运行 JDK:12.2.1.x 官方认证组合以 JDK 8 为主,JDK 8 不支持 TLS 1.3,因此控制台里看不到该选项;14.1.1 可运行在 JDK 11 上,配合 SSL > Advanced 的 Enabled SSL Protocols 勾选 TLSv1.3 才能启用。升级前务必确认客户端与内部调用链是否支持 TLS 1.3。


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

内容审核

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