如何使用C#对接需上传下载共3个证书的API并完成调用配置

你提到的对接逻辑属于双向TLS认证场景：你说的“上传3个证书”是指TLS握手阶段客户端向服务端提交身份证书，“下载3个证书”是指提前获取服务端可信证书用来校验服务端身份合法性，具体实现方式如下：

一、核心实现代码 #

常规双向TLS场景下不需要手动在业务请求中上传证书，.NET底层会在TLS握手时自动完成证书交互，示例代码如下：

using System.Net.Http;
using System.Security.Cryptography.X509Certificates;

// 1. 加载3个需要提交给服务端的客户端证书，pfx格式通常需要传入证书密码
var clientCert1 = new X509Certificate2("client_cert1.pfx", "证书访问密码");
var clientCert2 = new X509Certificate2("client_cert2.pfx", "证书访问密码");
var clientCert3 = new X509Certificate2("client_cert3.pfx", "证书访问密码");

// 2. 配置HTTP请求处理器
var handler = new HttpClientHandler();
// 添加客户端证书，握手阶段会自动提交给服务端
handler.ClientCertificates.Add(clientCert1);
handler.ClientCertificates.Add(clientCert2);
handler.ClientCertificates.Add(clientCert3);
// 自定义服务端证书校验逻辑，用你提前下载的3个服务端证书做信任校验
handler.ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) =>
{
    // 加载提前下载的3个可信服务端证书
    var trustedServerCerts = new List<X509Certificate2>
    {
        new X509Certificate2("server_cert1.cer"),
        new X509Certificate2("server_cert2.cer"),
        new X509Certificate2("server_cert3.cer")
    };
    // 校验服务端返回的证书是否在信任列表中
    return trustedServerCerts.Any(trustedCert => trustedCert.Thumbprint == cert.Thumbprint);
};

// 3. 发起业务请求
using var httpClient = new HttpClient(handler);
// 按需配置请求头、请求参数
var response = await httpClient.GetAsync("目标API接口地址");
response.EnsureSuccessStatusCode();
var responseContent = await response.Content.ReadAsStringAsync();

如果API特殊要求在业务请求参数中传递证书内容，直接读取证书文件字节流转为Base64编码，按接口要求放入请求头或请求体即可。

相关证书参考：

二、常见注意事项 #

• 不要硬编码证书密码到代码中，建议通过环境变量、配置中心等加密方式存储
• 提前确认证书用途：客户端证书需要开启“客户端身份验证”扩展密钥用法，服务端证书需要开启“服务器身份验证”扩展密钥用法
• 部署到Linux环境时需要给证书文件开启读取权限，同时安装libssl相关基础依赖
• 也可以将证书导入到系统证书存储区，通过X509Store类读取证书，避免本地证书文件泄露风险

三、资料查阅渠道 #

• 微软官方文档中HttpClient、X509Certificate2、HttpClientHandler类的API参考
• .NET官方网络编程教程中的TLS/SSL配置章节
• GitHub上C#双向SSL认证相关的开源实现示例

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