Xamarin Forms(iOS) 如何实现应用登录与PowerApp WebView的Cookie共享？

问题场景 #

在跨端应用中，需要让原生端完成的Microsoft账号登录会话，和内嵌在WebView中的PowerApp实现会话互通：

• 安卓端已通过 Android.Webkit.CookieManager.Instance.SetAcceptThirdPartyCookies(Control, true); 开启第三方Cookie接收，功能运行正常
• iOS端尝试设置NSHttpCookieStorage.SharedStorage.AcceptPolicy = NSHttpCookieAcceptPolicy.Always; 无效果，找不到和安卓对等的第三方Cookie开启方案

问题根因 #

iOS端的WKWebView（Xamarin Forms默认的iOS WebView渲染内核）对跨域第三方Cookie的管控逻辑和安卓差异极大：

1. WkWebView默认使用独立的WKWebsiteDataStore存储Cookie，完全不读取系统全局的NSHttpCookieStorage，修改全局Cookie接收策略的操作，根本不会作用到WebView本身的存储逻辑上
2. 从iOS 13开始苹果收紧了WKWebView的跨域权限，默认不允许WebView携带非第一方域下的Cookie，单纯改接收策略不会放开跨域凭证的自动携带

可直接落地的适配步骤 #

• 替换WebView配置，让内核直接复用系统共享数据存储
  在iOS自定义WebView渲染器的实例初始化阶段，给WKWebView绑定和系统一致的WebsiteDataStore，同时开启跨域权限：

  var webViewConfig = new WKWebViewConfiguration
  {
      // 关键：使用系统默认的共享数据存储，替代WKWebView自带的独立存储
      WebsiteDataStore = WKWebsiteDataStore.DefaultDataStore
  };
  // 开启跨域访问权限，对应iOS对第三方Cookie的内核层开关
  webViewConfig.SetValueForKey(NSObject.FromObject(true), new NSString("allowUniversalAccessFromFileURLs"));
  

• 主动同步Microsoft相关域的登录Cookie到WebView存储
  即使切换了共享存储，WKWebView也不会自动拉取已经存在的系统Cookie，需要在WebView首次加载PowerApp地址之前，手动把Microsoft登录域下的会话Cookie同步到WebView的数据存储里：

  var relevantDomains = new[] { "microsoftonline.com", "powerapps.com", "office.com" };
  foreach (var cookie in NSHttpCookieStorage.SharedStorage.Cookies)
  {
      // 只同步Microsoft相关域的Cookie，避免无关Cookie造成加载异常
      if (relevantDomains.Any(d => cookie.Domain.Contains(d)))
      {
          WKWebsiteDataStore.DefaultDataStore.HttpCookieStore.SetCookie(cookie);
      }
  }
  

• 兼容iOS 15+的智能防跟踪机制
  iOS 15及以上版本开启的ITP智能防跟踪会主动拦截跨域携带的Cookie，这种情况不要纯依赖Cookie同步逻辑，需要在WebView的导航代理里，给PowerApp域的请求手动带上原生登录获取的认证凭证：

  public override void DecidePolicy(WKWebView webView, WKNavigationAction navigationAction, Action<WKNavigationActionPolicy> decisionHandler)
  {
      var request = navigationAction.Request.MutableCopy() as NSMutableUrlRequest;
      // 给所有PowerApp域的请求追加认证头
      if (request.Url.Host.Contains("powerapps.com"))
      {
          request.Headers = new NSDictionary(
              "Authorization", $"Bearer {原生端获取的Microsoft登录访问令牌}",
              "Cookie", $"手动拼接的会话Cookie字符串"
          );
      }
      decisionHandler(WKNavigationActionPolicy.Allow);
  }
  

避坑提醒 #

• 不要使用已经被废弃的UIWebView组件，这个组件没有官方的第三方Cookie适配接口，无论怎么调整策略都无法实现会话共享
• 不要将WKWebsiteDataStore设置为NonPersistentDataStore，这个是无状态临时存储，写入的Cookie不会被持久保留，刷新页面就会丢失
• 权限设置要在WebView加载第一个页面之前完成，等页面开始加载再修改配置，所有设置都不会生效

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