TLS 1.3下NSURLAuthenticationMethodClientCertificate未触发，TLS 1.2正常

问题背景 #

在Cocoa应用中，TLS 1.3环境下客户端证书认证流程异常：URLSession:didReceiveChallenge:completionHandler仅响应NSURLAuthenticationMethodServerTrust类型挑战，完全不触发NSURLAuthenticationMethodClientCertificate，但控制台日志明确显示服务器已发起证书请求：

boringssl_context_info_handler(2391) [C1.1.1.1:2][0x120607a10] Client handshake state: TLS 1.3 client read_certificate_request

该功能在TLS 1.2下可正常工作。

排查与解决方法 #

• 系统自动匹配证书导致代理跳过
  iOS 13+/macOS 10.15+对TLS 1.3的处理会优先自动匹配钥匙串中符合服务器要求的证书，匹配成功则直接使用，不会触发代理。
  处理方式：检查钥匙串是否存在匹配证书，若需手动处理认证，可临时移除该证书；或自定义URLCredentialStorage替换默认存储，阻断系统自动匹配逻辑。

• 预配置客户端凭证绕过代理触发逻辑
  TLS 1.3握手流程更紧凑，系统可能跳过代理直接使用默认凭证，可提前将客户端证书配置到会话中：

  // 从钥匙串加载客户端身份证书与证书链
  SecIdentityRef identity = ...; // 替换为你的证书身份引用
  NSArray *certChain = ...; // 替换为关联的证书链数组
  URLCredential *clientCredential = [[URLCredential alloc] initWithIdentity:identity certificates:certChain persistence:URLCredentialPersistenceNone];
  
  // 配置保护空间并绑定凭证
  NSURLProtectionSpace *protectionSpace = [[NSURLProtectionSpace alloc] initWithHost:@"你的服务器域名" port:443 protocol:NSURLProtectionSpaceHTTPS realm:nil authenticationMethod:NSURLAuthenticationMethodClientCertificate];
  [[URLCredentialStorage sharedCredentialStorage] setCredential:clientCredential forProtectionSpace:protectionSpace];
  
  // 使用配置好的凭证创建会话
  NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:nil];
  

• TLS 1.3协议兼容性问题
  BoringSSL在TLS 1.3下的客户端证书处理逻辑与TLS 1.2存在差异，可先强制降级到TLS 1.2验证问题是否消失：

  NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
  config.TLSMinimumSupportedProtocol = kTLSProtocol12;
  config.TLSMaximumSupportedProtocol = kTLSProtocol12;
  

  若降级后恢复正常，说明是系统TLS 1.3处理逻辑的问题，可提交反馈给Apple，同时采用预配置凭证的方式适配TLS 1.3环境。

• 服务器证书请求扩展不兼容
  TLS 1.3的证书请求可能包含TLS 1.2没有的扩展字段，若系统无法识别这些扩展，会跳过代理触发。需检查服务器端配置，确保使用iOS/macOS支持的标准签名算法、证书类型，避免自定义扩展。

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