Winforms嵌入WebView2如何实现服务端TLS证书自定义验证?
WebView2 Winform 自定义服务端TLS证书验证实现方案
WebView2 从 1.0.1020.30 版本开始正式提供了ServerCertificateErrorDetected事件,完全可以实现你需要的自定义证书校验能力,无需全局忽略所有证书错误,灵活度完全对标HttpClientHandler.ServerCertificateCustomValidationCallback。
实现步骤
- 第一步:升级项目的
Microsoft.Web.WebView2Nuget 包到 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
相关产品推荐
相关产品推荐

