如何为Log4j HTTP Appender临时禁用SSL证书验证适配Splunk Cloud

我之前也踩过这个坑，Splunk HEC的自签名证书确实会让Log4j的HTTP Appender卡壳。要实现类似curl -k的临时禁用SSL验证效果，分两种情况处理，取决于你用的是Log4j 2.x还是1.x：

一、临时全局禁用（仅测试用，不推荐） #

如果只是临时快速测试，可以通过JVM启动参数全局跳过SSL证书校验，这会让整个应用信任所有SSL证书：

java -Djavax.net.ssl.trustStore=/dev/null -Djavax.net.ssl.trustStorePassword=changeit -Djavax.net.ssl.trustStoreType=JKS -Dcom.sun.net.ssl.checkRevocation=false -jar your-app.jar

⚠️ 注意：这个方法会影响JVM内所有SSL连接，风险极高，绝对不要在生产环境使用！

二、针对Log4j HTTP Appender单独禁用（推荐，仅影响该Appender） #

1. Log4j 2.x版本 #

Log4j 2支持自定义SSL上下文，我们可以创建一个信任所有证书的TrustManager，然后配置给HTTP Appender：

步骤1：创建自定义信任管理器类

import javax.net.ssl.*;
import java.security.cert.X509Certificate;

public class TrustAllCertificates implements X509TrustManager {
    @Override
    public void checkClientTrusted(X509Certificate[] chain, String authType) {}

    @Override
    public void checkServerTrusted(X509Certificate[] chain, String authType) {}

    @Override
    public X509Certificate[] getAcceptedIssuers() {
        return new X509Certificate[0];
    }

    // 提供静态方法返回信任所有证书的SocketFactory
    public static SSLSocketFactory createTrustAllSocketFactory() {
        try {
            SSLContext sslContext = SSLContext.getInstance("TLS");
            sslContext.init(null, new TrustManager[]{new TrustAllCertificates()}, null);
            return sslContext.getSocketFactory();
        } catch (Exception e) {
            throw new RuntimeException("Failed to create trust-all SSL socket factory", e);
        }
    }
}

步骤2：修改Log4j 2配置文件

如果是XML配置（log4j2.xml）：

<Appenders>
    <Http name="Splunk" url="https://your-splunk-hec-endpoint:8088/services/collector/event">
        <!-- 配置Splunk HEC的认证Token -->
        <Property name="Authorization">Splunk your-hec-token-here</Property>
        <!-- 配置自定义SSL上下文，使用我们的信任管理器 -->
        <SslConfiguration>
            <CustomSslProtocol socketFactory="com.your-package.TrustAllCertificates$createTrustAllSocketFactory"/>
        </SslConfiguration>
        <!-- 使用Json格式输出日志，符合Splunk HEC要求 -->
        <JsonLayout compact="true"/>
    </Http>
</Appenders>

如果是Properties配置（log4j2.properties）：

appender.Splunk.type = Http
appender.Splunk.url = https://your-splunk-hec-endpoint:8088/services/collector/event
appender.Splunk.property.Authorization = Splunk your-hec-token-here
appender.Splunk.ssl.type = SslConfiguration
appender.Splunk.ssl.customSslProtocol.socketFactory = com.your-package.TrustAllCertificates$createTrustAllSocketFactory
appender.Splunk.layout.type = JsonLayout
appender.Splunk.layout.compact = true

2. Log4j 1.x版本 #

Log4j 1.x的HTTPPostAppender没有直接的SSL配置项，需要自定义Appender来替换默认的HttpClient：

步骤1：创建自定义Appender类

import org.apache.log4j.net.HTTPPostAppender;
import org.apache.http.client.HttpClient;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.ssl.SSLContexts;

import javax.net.ssl.SSLContext;
import java.security.KeyManagementException;
import java.security.NoSuchAlgorithmException;

public class TrustAllHTTPPostAppender extends HTTPPostAppender {
    @Override
    protected HttpClient createHttpClient() {
        try {
            // 创建信任所有证书的SSL上下文
            SSLContext sslContext = SSLContexts.custom()
                    .loadTrustMaterial((chain, authType) -> true)
                    .build();
            // 禁用主机名验证
            SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(
                    sslContext, NoopHostnameVerifier.INSTANCE);
            // 构建自定义HttpClient
            return HttpClients.custom()
                    .setSSLSocketFactory(sslSocketFactory)
                    .build();
        } catch (NoSuchAlgorithmException | KeyManagementException e) {
            throw new RuntimeException("Failed to create trust-all HttpClient", e);
        }
    }
}

步骤2：修改Log4j 1.x配置文件（log4j.properties）

# 使用自定义的Appender
log4j.appender.Splunk=com.your-package.TrustAllHTTPPostAppender
# Splunk HEC的URL
log4j.appender.Splunk.URL=https://your-splunk-hec-endpoint:8088/services/collector/event
# 配置认证Header
log4j.appender.Splunk.Header=Authorization:Splunk your-hec-token-here
# 使用Json格式输出日志
log4j.appender.Splunk.layout=org.apache.log4j.JsonLayout

重要提醒 #

• 以上方法仅适合临时测试，生产环境强烈建议将Splunk HEC的自签名证书导入到JVM的信任存储中（使用keytool命令），或者更换为CA签发的合法证书。
• 禁用SSL验证会导致你的应用容易受到中间人攻击，绝对不能在生产环境使用！

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