Groovy脚本在NiFi中如何基于JKS实现HTTPS调用的SSL配置
NiFi ExecuteGroovyScript 脚本基于JKS证书的HTTPS SSL适配实现
核心改造逻辑
原有脚本使用HttpURLConnection的默认SSL逻辑,没有加载本地服务器上存放的JKS格式证书,改造时不需要额外引入第三方依赖,通过JDK内置的密钥、信任管理器体系即可完成配置,整体流程为:
- 读取本地指定路径的JKS格式Keystore、Truststore文件,加载到内存中的KeyStore对象;如果目标服务仅做服务端证书校验,不要求双向认证,可仅加载Truststore完成信任链构建,无需加载Keystore
- 基于加载的证书对象初始化KeyManager、TrustManager,构建独立的不依赖JVM全局配置的SSL上下文
- 针对HTTPS类型的连接,替换默认的SSLSocketFactory为自定义SSL上下文生成的Socket工厂
- 保留原有脚本的FlowFile流转逻辑,不改变现有成功、失败分支的路由规则
可直接运行的改造后脚本
// 自定义证书配置,替换为服务器上的实际路径与密码 def config = [ truststorePath : "/opt/nifi/cert/truststore.jks", truststorePass : "你的truststore访问密码", keystorePath : "/opt/nifi/cert/keystore.jks", keystorePass : "你的keystore访问密码" ] def flowFile = session.get() if (!flowFile) return try { // 加载Truststore def trustStore = KeyStore.getInstance("JKS") new FileInputStream(config.truststorePath).withStream { input -> trustStore.load(input, config.truststorePass.toCharArray()) } def trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm()) trustManagerFactory.init(trustStore) // 加载Keystore,无需双向认证时可移除该段逻辑 def keyStore = KeyStore.getInstance("JKS") new FileInputStream(config.keystorePath).withStream { input -> keyStore.load(input, config.keystorePass.toCharArray()) } def keyManagerFactory = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm()) keyManagerFactory.init(keyStore, config.keystorePass.toCharArray()) // 构建自定义SSL上下文 def sslContext = SSLContext.getInstance("TLS") sslContext.init(keyManagerFactory.keyManagers, trustManagerFactory.trustManagers, new SecureRandom()) def url = new URL("https://xxx.xxx.xxx/sample?key=8B4B4565-313E-462D-8160-175F6F456773") HttpURLConnection connection = (HttpURLConnection) url.openConnection() // 为HTTPS连接应用自定义SSL配置 if (connection instanceof HttpsURLConnection) { connection.setSSLSocketFactory(sslContext.socketFactory) } connection.setRequestMethod("GET") connection.setConnectTimeout(10000) connection.setReadTimeout(15000) connection.connect() if (connection.responseCode == 200 || connection.responseCode == 201) { flowFile = session.putAttribute(flowFile, 'api_responce_code', connection.responseCode.toString()) def responseContent = connection.inputStream.getText() flowFile = session.write(flowFile, { outputStream -> outputStream.write(responseContent.getBytes()) } as OutputStreamCallback) session.transfer(flowFile, REL_SUCCESS) } else { flowFile = session.putAttribute(flowFile, 'api_responce_code', connection.responseCode.toString()) flowFile = session.putAttribute(flowFile, 'api_responce_error', connection.getErrorStream()?.text ?: "无错误流返回") session.transfer(flowFile, REL_FAILURE) } } catch (Exception e) { flowFile = session.putAttribute(flowFile, 'script_exception', e.message) session.transfer(flowFile, REL_FAILURE) }
落地注意事项
- 权限校验:提前确认NiFi进程的运行用户对两个JKS证书文件拥有读权限,避免出现文件访问拒绝的异常
- 配置隔离:这种方式构建的SSL上下文仅作用于当前脚本发起的HTTP连接,不会影响NiFi全局的SSL配置,也不会干扰同流程内其他处理器的HTTPS调用逻辑
- 兼容性:脚本使用的所有密钥、SSL相关API均为JDK标准内置能力,不需要在NiFi环境中添加额外的Groovy依赖包
- 属性兼容:脚本保留了原代码中的属性命名规则,如果后续需要调整属性名,需要同步修改下游处理器的匹配规则,避免流程路由失效
- 异常兜底:脚本增加了顶层异常捕获逻辑,将证书加载、网络调用过程中的错误信息写入FlowFile属性,方便后续排查问题
内容的提问来源于stack exchange,提问作者djgcp
相关产品推荐
相关产品推荐

