在 App 內嵌 UIWebView 時載入某些 HTTPS 站點,可能收到這樣的錯誤:
error: NSURLConnection/CFURLConnection HTTP load failed (kCFStreamErrorDomainSSL, -9813)
這類錯誤通常不是程式碼寫錯,而是憑證信任鏈出了問題。本文說明成因,並示範如何讓 webview 也能載入使用自簽憑證的站點。
HTTPS 是 HTTP 與 SSL/TLS 的組合,主要目標是在不安全的網路上建立加密信道,並在憑證可驗證、可信任的前提下,抵禦竊聽與中間人攻擊。
它的信任是「繼承式」的:作業系統與瀏覽器預先安裝了一批受信任的憑證頒發機構(CA)憑證,於是「CA 說這張憑證可信,我就信」。問題在於——如果伺服器管理員自己簽發憑證(自簽憑證),而這張憑證又不是由任何已知 CA 簽署,那麼客戶端自然無法驗證,於是拒絕連線。這也正是瀏覽器遇到這類站點時會跳出「是否繼續」提示的原因。
-9813 這個錯誤碼對應的正是 SSL 層的憑證或協定驗證失敗,常見原因包括憑證過期、憑證鏈不完整、缺少中間憑證,或伺服器只支援已被系統禁用的舊版協定與加密套件。
思路是:攔下 webview 即將發出的請求,改用 NSURLConnection 先跑一次,在身份驗證回呼中把該站點標記為可信任,然後讓 webview 重發一次同樣的請求。
#pragma mark - UIWebViewDelegate
- (BOOL)webView:(UIWebView *)awebView
shouldStartLoadWithRequest:(NSURLRequest *)request
navigationType:(UIWebViewNavigationType)navigationType
{
NSString *scheme = [[request URL] scheme];
NSLog(@"scheme = %@", scheme);
// 判斷是否為 https
if ([scheme isEqualToString:@"https"]) {
// 尚未完成信任處理時,改用 NSURLConnection 重發請求
if (!self.isAuthed) {
originRequest = request;
NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:self];
[conn start];
[awebView stopLoading];
return NO; // 攔下這次導航
}
}
[self reflashButtonState];
[self freshLoadingView:YES];
self.currenURL = [request URL];
return YES;
}
- (void)connection:(NSURLConnection *)connection
willSendRequestForAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge
{
if ([challenge previousFailureCount] == 0) {
self.authed = YES;
// NSURLCredential 表示不可變的身份驗證憑證
NSURLCredential *credential =
[NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust];
[challenge.sender useCredential:credential forAuthenticationChallenge:challenge];
} else {
// 驗證失敗,中止挑戰
[[challenge sender] cancelAuthenticationChallenge:challenge];
}
}
#pragma mark - NSURLConnectionDataDelegate
- (NSURLRequest *)connection:(NSURLConnection *)connection
willSendRequest:(NSURLRequest *)request
redirectResponse:(NSURLResponse *)response
{
NSLog(@"%@", request);
return request;
}
- (void)connection:(NSURLConnection *)connection
didReceiveResponse:(NSURLResponse *)response
{
self.authed = YES;
// 信任手續完成,讓 webview 重新載入原始請求
[webView loadRequest:originRequest];
[connection cancel];
}
無條件信任任何憑證,等於關掉了 HTTPS 最重要的保護——中間人攻擊將變得易如反掌。上面的程式碼只適合兩種情況:公司內網使用自簽憑證的內部系統,或你自己開發測試環境。
正式環境的正確做法是:
改用 ATS 例外而非全面關閉。在 Info.plist 中為特定網域設定 NSAppTransportSecurity 的 NSExceptionDomains,只對該網域放寬,而非全域 NSAllowsArbitraryLoads。
修正伺服器端憑證。最常見的根因是缺漏中間憑證,導致憑證鏈不完整。把完整的 chain 部署上去,-9813 通常就消失了。
實作憑證或公鑰綁定(pinning)。若確實需要信任自簽憑證,應內嵌該憑證的預期指紋比對,而不是對所有挑戰一律放行。
改用 WKWebView。UIWebView 自 iOS 12 起已被蘋果標記為淘汰,App Store 也不再接受新提交。新專案請一律使用 WKWebView,其 navigationDelegate 搭配 WKNavigationDelegate 的 didReceive challenge: 提供相同能力,且安全性設計更嚴謹。