You need to enable JavaScript to run this app. Java实现基于SHA-256算法的Digest认证登录及SSLHandshakeException问题修正
优惠活动
大模型
产品
解决方案
定价
更多

Java实现基于SHA-256算法的Digest认证登录及SSLHandshakeException问题修正

故障定位与修复方案

核心故障点拆解

触发SSLHandshakeException的直接原因

  • 通过System.setProperty设置的TLS协议参数,仅对JDK原生HttpURLConnection生效,Apache HttpClient使用独立的连接层和SSL上下文,完全不会读取该全局配置,等于设置的协议列表根本没作用到客户端。
  • 手动配置的协议列表包含已被所有主流服务端禁用的SSLv3,会导致协议协商优先级异常,直接触发握手失败。
  • 目标为内网HTTPS服务,大概率使用自签名证书/私有CA签发证书,未被JDK默认信任库信任,TLS握手阶段直接中断。
  • 证书为IP地址签发,缺少域名匹配的SAN字段,主机名校验环节触发握手失败。

Digest认证流程的原生逻辑错误

  • 提前将未获取服务端挑战参数的空DigestScheme写入AuthCache,破坏了HttpClient内置的401挑战自动协商流程,无法正确拿到服务端返回的nonce、realm、opaque等必要参数。
  • 解析WWW-Authenticate响应头时取键值错误:代码中wwwAuth.get("Digest realm")的写法完全错误,头元素的键就是realm,Digest是认证方案标识不是键名,此处会直接取到null值,导致后续参数覆盖操作全部失效。
  • 手动提前固定nc、cnonce、algorithm参数,和DigestScheme内部的自动计算逻辑冲突,会导致服务端校验时发现请求参数不符合RFC规范被拒绝。
  • 低版本Apache HttpClient的DigestScheme仅支持MD5算法,无法处理服务端要求的SHA-256哈希计算逻辑。

修正后的可运行代码

import java.security.SecureRandom;
import java.security.cert.X509Certificate;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.config.Registry;
import org.apache.http.config.RegistryBuilder;
import org.apache.http.conn.socket.ConnectionSocketFactory;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.impl.conn.BasicHttpClientConnectionManager;
import org.apache.http.util.EntityUtils;

public class DigestTest {
    private static final String URL = "https://10.0.1.190/API/Web/Login";
    private static final String USER = "admin";
    private static final String PASSWORD = "testing123456";

    public static void main(String[] args) throws Exception {
        new DigestTest().run();
    }

    public void run() throws Exception {
        // 构建适配内网自签名证书的SSL上下文
        TrustManager[] trustAllCerts = new TrustManager[]{
            new X509TrustManager() {
                @Override
                public void checkClientTrusted(X509Certificate[] certs, String authType) {}
                @Override
                public void checkServerTrusted(X509Certificate[] certs, String authType) {}
                @Override
                public X509Certificate[] getAcceptedIssuers() {return new X509Certificate[0];}
            }
        };
        SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
        sslContext.init(null, trustAllCerts, new SecureRandom());

        // 配置连接层:仅启用受支持的TLS版本,关闭IP证书的主机名校验
        SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(
            sslContext,
            new String[]{"TLSv1.2", "TLSv1.3"},
            null,
            NoopHostnameVerifier.INSTANCE
        );

        Registry<ConnectionSocketFactory> socketFactoryRegistry = RegistryBuilder.<ConnectionSocketFactory>create()
            .register("https", sslSocketFactory)
            .register("http", new PlainConnectionSocketFactory())
            .build();

        BasicHttpClientConnectionManager connManager = new BasicHttpClientConnectionManager(socketFactoryRegistry);

        // 配置认证凭证
        CredentialsProvider credsProvider = new BasicCredentialsProvider();
        credsProvider.setCredentials(
            new AuthScope("10.0.1.190", 443),
            new UsernamePasswordCredentials(USER, PASSWORD)
        );

        // 构建HttpClient,开启Digest认证自动协商
        try (CloseableHttpClient httpclient = HttpClients.custom()
            .setConnectionManager(connManager)
            .setDefaultCredentialsProvider(credsProvider)
            .build()
        ) {
            HttpPost httpPost = new HttpPost(URL);
            // 自动完成完整认证流程:首次请求无认证头→收到401挑战→解析SHA-256算法要求→计算认证值→重发带认证头的请求
            try (CloseableHttpResponse response = httpclient.execute(httpPost)) {
                System.out.println("最终响应状态码:" + response.getStatusLine().getStatusCode());
                System.out.println("响应内容:" + EntityUtils.toString(response.getEntity(), "UTF-8"));
            }
        }
    }
}

落地验证要点

  • 代码中的全信任证书、关闭主机名校验的配置仅适配内网测试场景,生产环境需将私有CA导入JDK默认信任库,删除全信任逻辑。
  • 不需要手动拆分两次请求完成认证:HttpClient的自动协商逻辑和Postman内部处理逻辑完全一致,会自动识别服务端挑战头中的algorithm=SHA-256参数,完成对应哈希计算。
  • 需确保使用的Apache HttpClient版本为4.5.13及以上,该版本才完整支持SHA-256的Digest认证算法,低版本会固定使用MD5计算哈希,导致服务端返回401拒绝。

内容的提问来源于stack exchange,提问作者Assasin

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 02:45:08