JBoss EAP 7.3部署SSL后连接LDAP遇SSLHandshakeException求助

这是典型的SSL证书信任链缺失问题：当JBoss启用SSL后，它的JVM信任库没有包含LDAP服务器的根证书或中间证书，导致无法完成LDAP的SSL证书验证，从而抛出javax.net.ssl.SSLHandshakeException错误。回滚SSL配置后，JBoss不再强制验证LDAP的SSL证书链，所以连接恢复正常。结合你已经做的操作，给你几个针对性的解决步骤：

1. 确认LDAP服务器的SSL证书链完整性 #

首先要获取LDAP服务器的完整证书链，确保没有缺失中间证书：

• 执行以下OpenSSL命令导出LDAP证书：

  openssl s_client -connect your-ldap-server:636 -showcerts
  

  把输出中所有从-----BEGIN CERTIFICATE-----到-----END CERTIFICATE-----的证书内容分别保存为.crt文件（比如ldap-root.crt、ldap-intermediate.crt）。
• 用keytool检查证书的签发者：

  keytool -printcert -file ldap-server.crt
  

  确认签发者的证书（根/中间CA）是否能被JBoss信任。

2. 将LDAP证书导入JBoss专属信任库 #

JBoss EAP 7.3默认使用独立的信任库，优先操作这个库避免影响其他应用：

• 找到JBoss信任库的位置，通常是$JBOSS_HOME/standalone/configuration/truststore.jks（域模式对应domain/configuration/truststore.jks），确认信任库密码（默认是changeit，若已修改需用实际密码）。
• 执行导入命令：

  keytool -importcert -alias ldap-server -file ldap-server.crt -keystore $JBOSS_HOME/standalone/configuration/truststore.jks -storepass your-truststore-password
  

  如果有中间证书，需按链的顺序依次导入（先导入根CA，再导入中间CA）。
• 验证证书是否导入成功：

  keytool -list -keystore $JBOSS_HOME/standalone/configuration/truststore.jks -storepass your-truststore-password | grep ldap-server
  

3. 确保JBoss SSL配置正确引用信任库 #

检查JBoss的配置文件（standalone.xml或domain.xml），确认SSL安全域正确关联了信任库：
找到<security-realms>下的SSL配置段，确保包含truststore配置：

<security-realm name="ApplicationRealm">
    <server-identities>
        <ssl>
            <keystore path="server.keystore" relative-to="jboss.server.config.dir" keystore-password="your-server-keystore-pass" />
            <!-- 新增或确认信任库配置 -->
            <truststore path="truststore.jks" relative-to="jboss.server.config.dir" truststore-password="your-truststore-pass" />
        </ssl>
    </server-identities>
</security-realm>

如果你的LDAP连接是通过应用程序代码实现的，还要确保代码使用JBoss的信任库（而非默认JRE信任库），可以通过设置系统属性javax.net.ssl.trustStore指向JBoss的truststore.jks。

4. 启用SSL调试日志定位问题（可选） #

如果上述步骤仍未解决，开启SSL调试日志可以帮你定位具体缺失的证书：
在JBoss启动参数中添加：

-Djavax.net.debug=ssl,handshake

启动后查看日志，你能看到SSL握手过程中每个证书的验证细节，从而明确是哪个环节的证书未被信任。

内容的提问来源于stack exchange，提问作者KD Sharma