You need to enable JavaScript to run this app. Groovy脚本在NiFi中如何基于JKS实现HTTPS调用的SSL配置
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 17:54:08