為滿足蘋果的 ATS 要求,可以用系統自帶的命令行工具做檢測:
nscurl --ats-diagnostics --verbose https://你的域名
輸出中出現 PASS 即表示符合要求。
如需導出服務端證書用於客戶端綁定:
openssl s_client -connect 你的域名:443 </dev/null 2>/dev/null | openssl x509 -outform DER > https.cer
AFSecurityPolicy 提供三種驗證模式:
不做 SSL Pinning,只像瀏覽器那樣在系統信任機構列表中驗證服務端返回的證書。證書由信任機構簽發則通過,若為服務器自建證書則不通過。
使用證書綁定方式驗證,客戶端需保存服務端證書的副本。驗證分兩步:先校驗證書的域名、有效期等信息,再對比服務端返回的證書與客戶端保存的是否一致。
同樣採用證書綁定,客戶端需持有服務端證書副本,但只驗證證書中的公鑰,不檢查有效期等信息。只要公鑰正確,就能保證通信不被竊聽——中間人沒有私鑰,無法解密用公鑰加密的數據。這種方式的好處是證書續期後客戶端無需更新。
典型配置代碼:
// 使用證書綁定模式(針對頒發給本 App 的 SSL 證書)
AFSecurityPolicy *securityPolicy =
[AFSecurityPolicy policyWithPinningMode:AFSSLPinningModeCertificate];
// allowInvalidCertificates:是否允許無效證書(即自建證書),默認為 NO。
// 若需要驗證自建證書,需設置為 YES
securityPolicy.allowInvalidCertificates = YES;
// validatesDomainName:是否需要驗證域名,默認為 YES。
// 若證書上的域名與請求域名不一致,需設為 NO。
// 注意:設為 NO 意味着服務器使用其他可信機構頒發的證書也能建立連接,
// 這非常危險,建議保持 YES,並自行補充域名校驗邏輯。
// 之所以需要這個開關,是因為 SSL 證書上的域名是唯一的:
// 若證書註冊的是 www.example.com,mail.example.com 就無法通過驗證;
// 除非購買通配符證書 *.example.com(成本較高)。
securityPolicy.validatesDomainName = YES;
// validatesCertificateChain:是否驗證整個證書鏈,默認為 YES。
// 設為 YES 時,會把服務器返回的 Trust Object 上的證書鏈
// 與本地導入的證書逐一比對。這意味着如果證書鏈是:
// GeoTrust Global CA
// Google Internet Authority G2
// *.google.com
// 那麼除了導入 *.google.com,還必須導入鏈上所有 CA 證書。
// 自建證書場景下建議設為 YES 以增强安全性;
// 若使用可信 CA 簽發的證書,建議設為 NO,因為逐級比對沒有必要。
securityPolicy.validatesCertificateChain = NO;
requestOperationManager.securityPolicy = securityPolicy;
如果使用自建證書,還需把證書文件加入工程並顯式告訴 AFSecurityPolicy:
NSData *cerData = [self getSSLCerByCerName:@"本地SSL證書的名字"];
[securityPolicy setPinnedCertificates:@[cerData]];
// 讀取 bundle 中的證書數據
+ (NSData *)getSSLCerByCerName:(NSString *)cerName {
NSString *cerPath = [[NSBundle mainBundle] pathForResource:cerName ofType:@"cer"];
NSData *certData = [NSData dataWithContentsOfFile:cerPath];
return certData;
}
驗證相關 API 位於 Security Framework 中,整體流程如下:
1)獲取需要驗證的信任對象(Trust Object)。不同場景獲取方式不同。對於 NSURLConnection,它從 delegate 方法 -connection:willSendRequestForAuthenticationChallenge: 回調的 challenge 參數中取得,即 [challenge.protectionSpace serverTrust]。
2)使用系統默認方式驗證 Trust Object。SecTrustEvaluate 會依據驗證策略,從被审计證書開始一級一級往上,校驗證書鏈上每一級數字簽名的有效性,從而評估證書是否可信。
3)驗證通過後建立連接。一般安全要求下,此時用 Trust Object 生成憑證 [NSURLCredential credentialForTrust:serverTrust],交給 challenge 的 sender 處理:[challenge.sender useCredential:cred forAuthenticationChallenge:challenge]。
4)更嚴格的要求。可以繼續對 Trust Object 做額外校驗,最常見的做法是在本地導入證書,比對 Trust Object 與本地證書是否匹配。
5)驗證失敗。取消本次 Challenge-Response 驗證流程,拒絕連接請求。
補充:如果是自建證書,第 2 步的系統默認驗證必然失敗,因為自建證書的根 CA 數字簽名不在操作系統的信任列表中。此時必須走第 4 步的自定義校驗。
場景一:自建證書,未受安全機構信任
// 只處理服務端證書這一種認證方式
- (BOOL)connection:(NSURLConnection *)connection
canAuthenticateAgainstProtectionSpace:(NSURLProtectionSpace *)protectionSpace {
return [protectionSpace.authenticationMethod isEqualToString:NSURLAuthenticationMethodServerTrust];
}
- (void)connection:(NSURLConnection *)connection
willSendRequestForAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge {
static CFArrayRef certs;
if (!certs) {
NSData *certData = [NSData dataWithContentsOfFile:
[[NSBundle mainBundle] pathForResource:@"本地工程中的SSL證書的名字" ofType:@"cer"]];
SecCertificateRef rootcert =
SecCertificateCreateWithData(kCFAllocatorDefault, CFBridgingRetain(certData));
const void *array[1] = { rootcert };
certs = CFArrayCreate(NULL, array, 1, &kCFTypeArrayCallBacks);
CFRelease(rootcert);
}
SecTrustRef trust = [[challenge protectionSpace] serverTrust];
// 一個證書對應多個域名時,可選擇不驗證域名
NSMutableArray *policies = [NSMutableArray array];
SecPolicyRef policy = SecPolicyCreateBasicX509(); // BasicX509 不校驗域名一致性
[policies addObject:(__bridge_transfer id)policy];
SecTrustSetPolicies(trust, (__bridge CFArrayRef)policies);
int err;
SecTrustResultType trustResult = 0;
err = SecTrustSetAnchorCertificates(trust, certs);
if (err == noErr) {
err = SecTrustEvaluate(trust, &trustResult);
}
CFRelease(trust);
// kSecTrustResultUnspecified:系統隱式信任該證書
// kSecTrustResultProceed:用戶顯式確認信任該證書
BOOL trusted = (err == noErr)
&& ((trustResult == kSecTrustResultProceed)
|| (trustResult == kSecTrustResultUnspecified));
if (trusted) {
[challenge.sender useCredential:
[NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust]
forAuthenticationChallenge:challenge];
} else {
[challenge.sender cancelAuthenticationChallenge:challenge];
}
}
場景二:證書由可信機構簽發,無需在本地存放證書
- (void)connection:(NSURLConnection *)connection
willSendRequestForAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge {
// 1) 獲取 trust object
SecTrustRef trust = challenge.protectionSpace.serverTrust;
SecTrustResultType result;
// 針對一個證書對應多個域名的情況,可選擇不驗證域名
NSMutableArray *policies = [NSMutableArray array];
SecPolicyRef policy = SecPolicyCreateBasicX509();
[policies addObject:(__bridge_transfer id)policy];
SecTrustSetPolicies(trust, (__bridge CFArrayRef)policies);
// 2) 用 SecTrustEvaluate 對 trust 進行驗證
OSStatus status = SecTrustEvaluate(trust, &result);
if (status == errSecSuccess
&& (result == kSecTrustResultProceed || result == kSecTrustResultUnspecified)) {
// 3) 驗證成功,生成憑證並告知 sender 繼續連接
NSURLCredential *cred = [NSURLCredential credentialForTrust:trust];
[challenge.sender useCredential:cred forAuthenticationChallenge:challenge];
} else {
// 5) 驗證失敗,取消本次驗證流程
[challenge.sender cancelAuthenticationChallenge:challenge];
}
}
實踐建議:證書綁定能顯著提升抗中間人攻擊能力,但要特別注意證書續期問題。若採用 PublicKey 模式,可避免證書更新導致的客戶端失效;同時務必保留一份證書備份與應急更新通道。