You need to enable JavaScript to run this app. Winforms嵌入WebView2如何实现服务端TLS证书自定义验证?
优惠活动
大模型
产品
解决方案
定价
更多

Winforms嵌入WebView2如何实现服务端TLS证书自定义验证?

WebView2 Winform 自定义服务端TLS证书验证实现方案

WebView2 从 1.0.1020.30 版本开始正式提供了ServerCertificateErrorDetected事件,完全可以实现你需要的自定义证书校验能力,无需全局忽略所有证书错误,灵活度完全对标HttpClientHandler.ServerCertificateCustomValidationCallback。


实现步骤

  • 第一步:升级项目的Microsoft.Web.WebView2 Nuget 包到 1.0.1020.30 及以上版本
  • 第二步:监听WebView2的CoreWebView2InitializationCompleted事件,确保CoreWebView2初始化完成后再订阅证书错误事件
  • 第三步:在ServerCertificateErrorDetected事件回调中编写自定义校验逻辑,根据校验结果决定是否放行请求

代码示例

private void Form1_Load(object sender, EventArgs e)
{
    // 初始化WebView2
    webView21.EnsureCoreWebView2Async(null);
    webView21.CoreWebView2InitializationCompleted += WebView21_CoreWebView2InitializationCompleted;
}

private void WebView21_CoreWebView2InitializationCompleted(object sender, CoreWebView2InitializationCompletedEventArgs e)
{
    if (!e.IsSuccess) return;
    
    // 订阅证书错误校验事件
    webView21.CoreWebView2.ServerCertificateErrorDetected += CoreWebView2_ServerCertificateErrorDetected;
}

private void CoreWebView2_ServerCertificateErrorDetected(object sender, CoreWebView2ServerCertificateErrorDetectedEventArgs args)
{
    // 1. 获取请求和证书信息
    string requestUrl = args.RequestUri;
    var errorType = args.ErrorStatus;
    var serverCertificate = args.Certificate;
    
    // 2. 自定义校验逻辑,可根据实际需求调整,例如比对自签名证书指纹
    bool isCertTrusted = false;
    string yourTrustedCertSha256 = "替换为你的自签名证书SHA256指纹,大写无空格";
    if (serverCertificate.GetSha256Thumbprint().ToUpper() == yourTrustedCertSha256)
    {
        isCertTrusted = true;
    }

    // 3. 设置处理动作
    if (isCertTrusted)
    {
        // 证书校验通过,放行请求
        args.Action = CoreWebView2ServerCertificateErrorAction.Allow;
    }
    else
    {
        // 校验不通过,走默认逻辑(展示证书错误页)
        args.Action = CoreWebView2ServerCertificateErrorAction.Default;
    }
    args.Handled = true;
}

旧版本兼容备选方案

如果项目受限无法升级WebView2包,可选择以下方案:

  • 系统预埋信任证书:将你的自签名证书导入到当前用户的「受信任的根证书颁发机构」存储区,WebView2会默认信任系统存储区的证书,该方案无需修改代码,缺点是会全局影响当前用户所有应用的证书信任规则
  • 本地代理转发:在本地启动一个内置HTTP代理服务,将WebView2的访问请求全部走该代理,在代理层实现TLS证书自定义校验,校验通过后再转发到嵌入式设备,该方案兼容性最好,但实现复杂度更高

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.13 01:15:02