Jenkins使用dependency-check-cli扫描jar包报Sonatype OSS Index SSL握手错误
故障根因
该错误本质是Jenkins运行Dependency Check时使用的JRE信任库中没有ossindex.sonatype.org的有效证书链,你之前导入证书未生效,大概率是导入的JRE路径和Jenkins实际使用的JRE路径不匹配、或只导入了站点叶子证书未导入完整证书链导致。
修复步骤
- 第一步:确认Jenkins实际使用的JDK路径
登录Jenkins控制台,访问「系统管理」->「系统信息」,找到java.home属性对应的路径,这才是Jenkins运行时实际调用的JRE路径,不要使用系统默认配置的JDK路径,多数情况下Jenkins会配置单独的JDK版本。 - 第二步:导出完整证书链
不要仅导出站点的单张叶子证书,要导出完整的根证书+中级证书链,执行以下命令将完整证书链保存到ossindex.crt文件:openssl s_client -showcerts -connect ossindex.sonatype.org:443 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > ossindex.crt - 第三步:导入证书到对应JRE信任库
用第一步拿到的java.home路径替换下方命令中的{JAVA_HOME_PATH},执行导入操作,cacerts默认密码为changeit:
导入时提示是否信任证书,输入# 如果之前导入过同别名证书,先执行删除命令 keytool -delete -alias ossindex -keystore {JAVA_HOME_PATH}/jre/lib/security/cacerts -storepass changeit # 导入新证书 keytool -importcert -file ossindex.crt -alias ossindex -keystore {JAVA_HOME_PATH}/jre/lib/security/cacerts -storepass changeityes回车确认即可。
注意:如果Jenkins所在服务器通过公司代理访问外网,多数公司代理会对HTTPS请求做证书替换,这种情况需要将代理的自签名根证书一同导入到JRE信任库中,否则依然会报证书校验错误。
- 第四步:重启Jenkins服务生效
证书导入完成后必须重启Jenkins进程,新的信任库配置才会被加载。 - (可选)临时规避方案
如果你不需要使用Sonatype OSS Index的分析能力,可以直接关闭该分析器跳过证书校验:
命令行调用时添加启动参数:
使用Jenkins插件的话,在Dependency Check构建步骤的高级配置里,勾选「禁用OSS Index分析器」选项即可。--disableOssIndex
验证方法
重启后重新执行构建任务,查看日志中是否还有SSLHandshakeException报错,正常情况下Sonatype OSS Index Analyzer可正常执行,不会抛出构建失败错误。
内容的提问来源于stack exchange,提问作者Ankit Patra
相关产品推荐
相关产品推荐

