iOS 的 Keychain 服務提供了一種安全保存私密資料(密碼、序號、憑證等)的機制。每個 App 預設擁有獨立的 Keychain 空間,而自 iOS 3.0 起,多個 App 之間共享 Keychain 成為可能。
日常開發中,我們一般用 NSUserDefaults 存放 App 設定;但若要保存敏感資訊,就該改用 Keychain。兩者一個關鍵差異是:App 卸載後 NSUserDefaults 的內容會被清除,Keychain 中的資料則會保留。因此首次寫入 Keychain 時,務必先判斷是否殘留著先前未清乾淨的資料,避免狀態錯亂。
Keychain(鑰匙串)源自 Mac OS 的密碼管理系統,後續被引入 iOS。對開發者而言,它最大的價值是把敏感資料的加密與解密交給系統處理,不必自行實作。
蘋果官方提供了 KeychainItemWrapper,社群則常用 SFHFKeychainUtils。KeychainItemWrapper 的 .h 與 .m 檔可在 GenericKeychain 範例專案中找到。使用它之後,操作 Keychain 幾乎就跟操作 NSDictionary 一樣直覺:
KeychainItemWrapper *keychainItem = [[[KeychainItemWrapper alloc]
initWithIdentifier:@"Identifier"
accessGroup:@"cn.limc.app.boundle"] autorelease];
// 讀取
NSString *value = [keychainItem objectForKey:keyForValue];
// 寫入
NSString *valueToWrite = @"value to store";
[keychainItem setObject:valueToWrite forKey:keyForValue];
若想完全掌握行為,可以自己包一層。以下是保存使用者名稱與密碼的實作:
CHKeychain.h
#import <Foundation/Foundation.h> #import <Security/Security.h> @interface CHKeychain : NSObject + (void)save:(NSString *)service data:(id)data; + (id)load:(NSString *)service; + (void)delete:(NSString *)service; @end
CHKeychain.m
#import "CHKeychain.h"
@implementation CHKeychain
+ (NSMutableDictionary *)getKeychainQuery:(NSString *)service {
return [NSMutableDictionary dictionaryWithObjectsAndKeys:
(id)kSecClassGenericPassword, (id)kSecClass,
service, (id)kSecAttrService,
service, (id)kSecAttrAccount,
(id)kSecAttrAccessibleAfterFirstUnlock, (id)kSecAttrAccessible,
nil];
}
+ (void)save:(NSString *)service data:(id)data {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((CFDictionaryRef)keychainQuery);
[keychainQuery setObject:[NSKeyedArchiver archivedDataWithRootObject:data]
forKey:(id)kSecValueData];
SecItemAdd((CFDictionaryRef)keychainQuery, NULL);
}
+ (id)load:(NSString *)service {
id ret = nil;
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
[keychainQuery setObject:(id)kCFBooleanTrue forKey:(id)kSecReturnData];
[keychainQuery setObject:(id)kSecMatchLimitOne forKey:(id)kSecMatchLimit];
CFDataRef keyData = NULL;
if (SecItemCopyMatching((CFDictionaryRef)keychainQuery, (CFTypeRef *)&keyData) == noErr) {
@try {
ret = [NSKeyedUnarchiver unarchiveObjectWithData:(NSData *)keyData];
} @catch (NSException *e) {
NSLog(@"Unarchive of %@ failed: %@", service, e);
} @finally {
}
}
if (keyData) CFRelease(keyData);
return ret;
}
+ (void)delete:(NSString *)service {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((CFDictionaryRef)keychainQuery);
}
@end
NSString * const KEY_USERNAME_PASSWORD = @"com.company.app.usernamepassword"; NSString * const KEY_USERNAME = @"com.company.app.username"; NSString * const KEY_PASSWORD = @"com.company.app.password";
NSMutableDictionary *usernamepasswordKVPairs = [NSMutableDictionary dictionary]; [usernamepasswordKVPairs setObject:txtfldUsername.text forKey:KEY_USERNAME]; [usernamepasswordKVPairs setObject:txtfldPassword.text forKey:KEY_PASSWORD]; [CHKeychain save:KEY_USERNAME_PASSWORD data:usernamepasswordKVPairs];
NSMutableDictionary *usernamepasswordKVPairs =
(NSMutableDictionary *)[CHKeychain load:KEY_USERNAME_PASSWORD];
txtfldUsername.text = [usernamepasswordKVPairs objectForKey:KEY_USERNAME];
txtfldPassword.text = [usernamepasswordKVPairs objectForKey:KEY_PASSWORD];
[CHKeychain delete:KEY_USERNAME_PASSWORD];
如此一來,一個以 Keychain 保存帳號密碼的簡易機制就完成了。若要跨 App 共享,還需在 Entitlements 中設定相同的 Keychain Access Group,並在初始化時傳入對應的 accessGroup 參數。