調用基於 HTTPS 的 WebService 時,常遇到兩類證書問題:服務端證書非受信 CA 簽發(自簽名)導致驗證失敗、或服務端要求客戶端證書(雙向 SSL)。本文提供 C# 完整解決方案。
public void CallSslServiceIgnoreCert() {
// 繞過服務端證書驗證(僅限測試!生產嚴禁)
ServicePointManager.ServerCertificateValidationCallback
= (sender, cert, chain, errors) => true; // Lambda 表達式 .NET 3.5+
// 或完整委托寫法
// ServicePointManager.ServerCertificateValidationCallback
// = new RemoteCertificateValidationCallback(ValidateServerCertificate);
MyServiceSoapClient client = new MyServiceSoapClient();
// 如果服務端需客戶端證書,取消下面註釋並配置證書路徑
// client.ClientCertificates.Add(
// X509Certificate.CreateFromCertFile(Path.GetFullPath(@"..\..\Resources\client.cer")));
string result = client.DoSomeThing("Hello World!");
Console.WriteLine(result);
}
// 完整驗證邏輯示例(生產環境應實現真實驗證)
private bool ValidateServerCertificate(object sender, X509Certificate cert,
X509Chain chain, SslPolicyErrors errors) {
// 可在此檢查 cert.Subject、cert.Thumbprint、chain.ChainStatus 等
return errors == SslPolicyErrors.None; // 正常驗證
}
public void CallMutualSslService() {
ServicePointManager.ServerCertificateValidationCallback = (s, c, ch, e) => true; // 仍需驗證服務端,或用正規 CA
MyServiceSoapClient client = new MyServiceSoapClient();
// 加載客戶端證書(.pfx 含私鑰,或 .cer 僅公鑰視服務端要求)
X509Certificate2 clientCert = new X509Certificate2(
Path.GetFullPath(@"..\..\Resources\client.pfx"),
"pfx_password", // 私鑰密碼
X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.Exportable
);
client.ClientCertificates.Add(clientCert);
string result = client.DoSomeThing("Hello Mutual SSL!");
Console.WriteLine(result);
}
| 類/屬性 | 用途 |
|---|---|
ServicePointManager.ServerCertificateValidationCallback | 全局服務端證書驗證回調,返回 true 信任 |
ClientCertificates.Add(X509Certificate2) | 添加客戶端證書參與雙向握手 |
X509Certificate2 | 支持 .pfx/.p12(含私鑰)、.cer/.crt(僅公鑰) |
X509KeyStorageFlags | 控制私鑰存儲位置(機器/用戶)、可導出性、持久化 |
Path.GetFullPath | 將相對路徑轉絕對路徑,避免工作目錄變化導致找不到文件 |
const string EXPECTED_THUMBPRINT = "A1 B2 C3 ...";
ServicePointManager.ServerCertificateValidationCallback = (s, cert, chain, err) => {
if (err == SslPolicyErrors.None) return true;
if (err == SslPolicyErrors.RemoteCertificateChainErrors) {
return cert.GetCertHashString().Equals(EXPECTED_THUMBPRINT, StringComparison.OrdinalIgnoreCase);
}
return false;
};
StoreLocation.LocalMachine/CurrentUser, StoreName.My)載入,而非文件系統:using (var store = new X509Store(StoreName.My, StoreLocation.LocalMachine)) {
store.Open(OpenFlags.ReadOnly);
var certs = store.Certificates.Find(X509FindType.FindByThumbprint, "THUMBPRINT", false);
if (certs.Count > 0) client.ClientCertificates.Add(certs[0]);
}
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;
ASMX WebService 屬於 legacy 技術(2002 年引入)。新項目建議:
理解 SSL 證書驗證機制,無論何種通信框架都能游刃有餘地處理安全傳輸需求。