Xamarin Forms调用Vimeo Config接口遇SSL证书验证失败求助

问题描述 #

使用WebClient请求Vimeo视频配置接口（如https://player.vimeo.com/video/431550943/config）时，抛出CERTIFICATE_VERIFY_FAILED错误，无法正常获取视频配置信息。

原因分析 #

1. Mono环境下的根证书存储过期，Vimeo更新SSL证书后，本地信任链不包含对应的根证书
2. WebClient是过时的网络请求类，在Xamarin等Mono衍生环境中，默认证书验证逻辑存在兼容性问题

解决方案 #

1. 替换为HttpClient（推荐方案）

HttpClient是官方推荐的现代网络请求类，证书处理逻辑更完善，同时支持异步操作。修改后的代码如下：

public async Task ExtractConfiguration(string vimeoUrl)
{
    try
    {
        using (var httpClient = new HttpClient())
        {
            string strResponse = await httpClient.GetStringAsync(vimeoUrl);
            VimeoConfig vimeoConfig = JsonConvert.DeserializeObject<VimeoConfig>(strResponse);
            
            if(vimeoConfig.request.files.progressive.Count != 0)
            {
                string url = vimeoConfig.request.files.progressive[0].url;
                CrossMediaManager.Current.Speed = 1F;
                // 执行UI操作
            }
            else
            {
                // 无可用视频链接时的UI操作
            }
        }
    }
    catch(Exception e)
    {
        Debug.WriteLine("ExtractConfiguration Exception:>>" + e);
    }
}

2. 更新Mono根证书

对于Xamarin Android/iOS项目：

• 升级项目使用的Android SDK/iOS SDK版本，新版本通常包含更新的根证书库
• 手动导入Vimeo当前使用的根证书：
  1. 从浏览器访问Vimeo的配置接口，导出网站的根证书（格式为DER或PEM）
  2. 将证书文件添加到项目的资源目录（如Android项目的Resources/raw）
  3. 在应用启动时加载证书并添加到系统信任链：

// 在App.xaml.cs的OnStart方法中执行
using (var stream = Resources.OpenRawResource(Resource.Raw.vimeo_root_cert))
{
    byte[] certBytes = new byte[stream.Length];
    stream.Read(certBytes, 0, certBytes.Length);
    var certificate = new X509Certificate2(certBytes);
    
    using (var store = new X509Store(StoreName.Root, StoreLocation.CurrentUser))
    {
        store.Open(OpenFlags.ReadWrite);
        store.Add(certificate);
        store.Close();
    }
}

3. 临时跳过证书验证（仅调试用，生产环境禁止）

如果只是临时调试，可以强制跳过证书验证，但绝对不能在生产环境使用，会导致安全风险：

public void ExtractConfiguration(string vimeoUrl)
{
    try
    {
        // 临时跳过验证，调试完成后务必删除
        ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, errors) => true;
        
        using (var objClient = new WebClient())
        {
            string strResponse = objClient.DownloadString(vimeoUrl);
            VimeoConfig vimeoConfig = JsonConvert.DeserializeObject<VimeoConfig>(strResponse);
            
            if(vimeoConfig.request.files.progressive.Count != 0)
            {
                string url = vimeoConfig.request.files.progressive[0].url;
                CrossMediaManager.Current.Speed = 1F;
                // 执行UI操作
            }
            else
            {
                // 无可用视频链接时的UI操作
            }
        }
        
        // 恢复默认验证逻辑
        ServicePointManager.ServerCertificateValidationCallback -= (sender, cert, chain, errors) => true;
    }
    catch(Exception e)
    {
        Debug.WriteLine("ExtractConfiguration Exception:>>" + e);
    }
}

注意事项 #

• 生产环境必须保证证书验证正常，禁止跳过验证，否则会面临中间人攻击风险
• 优先使用HttpClient替代WebClient，后者已被官方标记为过时，不再维护

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