密碼存儲是 iOS 開發中一個老生常談卻至關重要的問題。本文整理 Keychain 的相關知識,並示範如何打造一個類似 SSKeychain 的封裝類。
專案中原本使用的是 SFHFKeychainUtils,一直穩定運行。出於技術好奇心,筆者在 GitHub 上搜索 ios keychain,找出了星數最多的兩個開源庫:SSKeychain 與 UICKeyChainStore。最終選擇了星數更多的 SSKeychain,pod install 後接入專案。但使用一段時間後卻頻繁出現 errSecDefault 問題。出於無奈轉而研究 UICKeyChainStore,卻發現它沒有提供 account 支持。種種因素促使筆者回頭深入研究 Keychain 的實現細節,遂有此文。
根據蘋果官方文件(Keychain Services Programming Guide),關於 iOS 的關鍵要點如下:
鑰匙鏈是一個加密的容器,保存了多個程式和安全服務的密碼。它是安全的存儲容器——當鑰匙鏈鎖定時,任何人都無法訪問其受保護的內容。在 Mac OS X 下,使用者可輸入主密碼來解鎖,從而讓信任的程式訪問內容;而在 iOS 中,每個應用程式始終只能訪問自己的鑰匙鏈項,使用者無需(也無法)解鎖鑰匙鏈。
iOS 中只有一個可供訪問的鑰匙鏈。儘管它存儲了系統上所有應用的鑰匙鏈項,但一個應用程式只能訪問屬於自己的鑰匙鏈項。
provisioning profile 的重要性:在 iPhone 上,鑰匙鏈的訪問權限取決於簽署應用時使用的 provisioning profile。因此,務必在應用的不同版本之間保持一致地使用同一個 provisioning profile。
鑰匙鏈的結構:每個鑰匙鏈可包含任意數量的鑰匙鏈項,每個項包含數據加上一組屬性。需要保護的項(如密碼、私鑰)其數據會被加密;不需保護的項(如證書)則不加密。
在 iOS 中,鑰匙鏈服務使用鍵值對字典來指定鑰匙鏈項的屬性,以便查找或創建。典型的搜索字典包含:
+ (BOOL)setPassword:(NSString *)password
forService:(NSString *)serviceName
account:(NSString *)account {
NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
[keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount]; // 賬戶
[keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService]; // 服務名
[keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass]; // 類型
[keyChainDic setObject:[password dataUsingEncoding:NSUTF8StringEncoding] forKey:(__bridge id)kSecValueData]; // 密碼數據
// 先查詢是否已存在
CFMutableDictionaryRef outDictionary = nil;
OSStatus keychainErr = SecItemCopyMatching((__bridge CFDictionaryRef)keyChainDic, (CFTypeRef *)&outDictionary);
BOOL resultState = NO;
if (keychainErr == noErr) {
// 已存在則更新
OSStatus errorCode = SecItemUpdate((__bridge CFDictionaryRef)keyChainDic,
(__bridge CFDictionaryRef)keyChainDic);
resultState = (errorCode == noErr);
} else if (keychainErr == errSecItemNotFound) {
// 不存在則新增
OSStatus errorCode = SecItemAdd((__bridge CFDictionaryRef)keyChainDic, NULL);
resultState = (errorCode == noErr);
}
return resultState;
}
+ (NSString *)passwordForService:(NSString *)serviceName account:(NSString *)account {
NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
[keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount];
[keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService];
[keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];
[keyChainDic setObject:(__bridge id)kCFBooleanTrue forKey:(__bridge id)kSecReturnData];
CFDataRef passwordData = NULL;
OSStatus keychainError = SecItemCopyMatching((__bridge CFDictionaryRef)keyChainDic, (CFTypeRef *)&passwordData);
NSString *pwdStr = nil;
if (keychainError == noErr) {
pwdStr = [[NSString alloc] initWithBytes:[(__bridge_transfer NSData *)passwordData bytes]
length:[(__bridge NSData *)passwordData length]
encoding:NSUTF8StringEncoding];
}
return pwdStr;
}
+ (BOOL)deletePasswordForService:(NSString *)serviceName account:(NSString *)account {
NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
[keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount];
[keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService];
[keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];
OSStatus keychainError = SecItemDelete((__bridge CFDictionaryRef)keyChainDic);
return (keychainError == noErr);
}
透過以上三個方法——設置、獲取、刪除——就完成了一個簡潔實用的密碼存取封裝類。使用 Keychain 而非 NSUserDefaults 來存儲敏感信息,是因為前者提供了系統級的加密保護,能更好地保障用戶的賬戶安全。