WPF中WebView2控件如何通过HttpClientHandler附加X509证书调用WebAPI？

WebView2没有像HttpClientHandler那样直接配置客户端证书的API，要实现这个需求，核心思路是拦截WebView2的资源请求，在请求中附加指定的X509证书，具体步骤如下：

1. 初始化WebView2并注册请求拦截事件 #

先确保WebView2的CoreWebView2实例就绪，然后针对目标API的URL注册请求过滤和拦截事件：

XAML布局（示例） #

<Window x:Class="WpfWebView2CertDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:wv2="clr-namespace:Microsoft.Web.WebView2.Wpf;assembly=Microsoft.Web.WebView2.Wpf"
        Title="WebView2 Cert Demo" Height="450" Width="800" Loaded="Window_Loaded">
    <Grid>
        <wv2:WebView2 x:Name="webView" />
    </Grid>
</Window>

后台逻辑代码 #

using Microsoft.Web.WebView2.Core;
using System.Security.Cryptography.X509Certificates;
using System.Windows;

namespace WpfWebView2CertDemo
{
    public partial class MainWindow : Window
    {
        private const string TargetApiUrlPattern = "https://your-target-api-domain.com/*";
        private const string CertificateThumbprint = "你的证书指纹（注意大小写，通常为大写）";

        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Window_Loaded(object sender, RoutedEventArgs e)
        {
            // 初始化CoreWebView2实例
            await webView.EnsureCoreWebView2Async();

            // 添加请求过滤规则，只拦截目标API的请求
            webView.CoreWebView2.AddWebResourceRequestedFilter(TargetApiUrlPattern, CoreWebView2WebResourceContext.All);

            // 注册资源请求拦截事件
            webView.CoreWebView2.WebResourceRequested += OnWebResourceRequested;

            // 导航到目标API地址
            webView.CoreWebView2.Navigate("https://your-target-api-domain.com/");
        }

        private void OnWebResourceRequested(object sender, CoreWebView2WebResourceRequestedEventArgs e)
        {
            // 获取目标证书
            var clientCert = GetClientCertificate();
            if (clientCert != null)
            {
                // 将证书附加到当前请求
                e.Request.ClientCertificate = clientCert;
            }
        }

        private X509Certificate2 GetClientCertificate()
        {
            // 从当前用户的个人证书存储中查找证书（也可从PFX文件加载）
            using var certStore = new X509Store(StoreName.My, StoreLocation.CurrentUser);
            certStore.Open(OpenFlags.ReadOnly);

            // 根据指纹查找证书，validOnly设为false允许查找过期证书（按需调整）
            var certCollection = certStore.Certificates.Find(
                X509FindType.FindByThumbprint,
                CertificateThumbprint,
                validOnly: false);

            return certCollection.Count > 0 ? certCollection[0] : null;
        }
    }
}

2. 证书加载的补充说明 #

• 如果证书是从PFX文件加载，替换GetClientCertificate方法为：

  private X509Certificate2 GetClientCertificate()
  {
      // 从PFX文件加载证书，需提供密码
      return new X509Certificate2(
          path: @"C:\path\to\your\certificate.pfx",
          password: "你的证书密码",
          keyStorageFlags: X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.UserKeySet);
  }
  

• 确保当前运行程序的用户对证书有访问权限，若证书存储在LocalMachine位置，可能需要管理员权限。

3. 关键注意事项 #

• 过滤规则TargetApiUrlPattern要精准，避免拦截无关请求，提升性能。
• 当WebAPI验证证书后完成重定向，WebView2会自动渲染跳转后的页面，无需额外处理。
• 若遇到证书验证失败，可检查证书指纹是否正确、证书是否在有效期内、API端的指纹校验逻辑是否匹配。

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