當需要安全地保存使用者名稱、密碼、認證權杖等敏感資訊時,Keychain 是最理想的選擇。本文從 Keychain 的基本概念談起,涵蓋其資料結構、四大操作 API,並以實例示範密碼的存取與刪除。
根據蘋果的說法,iOS 裝置中的 Keychain 是一個安全的儲存容器,可為不同應用保存使用者名稱、密碼、網路密碼、認證權杖等敏感資訊。蘋果自己也用它來保存 Wi-Fi 密碼、VPN 憑證等。它其實是一個位於 /private/var/Keychains/keychain-2.db 的 SQLite 資料庫,其中所有資料都經過加密。
開發者通常希望能利用作業系統提供的功能保存憑證,而非存到 NSUserDefaults 或 plist 這類明文位置。這樣一來,使用者不必每次都重新登入,App 可在下次啟動時用這些資料自動登入。值得注意的是,Keychain 的資料存在於每個 App 沙盒之外。
透過 keychain access groups,可以在多個 App 之間共享 Keychain 資料,前提是保存資料時要指定 group。保存資料到 Keychain 最簡單的方式是使用蘋果提供的 KeychainItemWrapper。第一步是建立它的實例:
KeychainItemWrapper *wrapper = [[KeychainItemWrapper alloc] initWithIdentifier:@"Password" accessGroup:nil];
識別符(Identifier)在稍後取用資料時會用到。若想跨 App 共享資訊,需指定存取群組(access group),有相同群組的 App 才能存取相同的 Keychain 資料:
KeychainItemWrapper *wrapper = [[KeychainItemWrapper alloc]
initWithIdentifier:@"Account Number"
accessGroup:@"YOUR_APP_ID_HERE.com.yourcompany.GenericKeychainSuite"];
要把資訊存入 Keychain,使用 setObject:forKey: 方法:
[wrapper setObject:(id)kSecClassGenericPassword forKey:(id)kSecClass]; [wrapper setObject:@"username" forKey:(id)kSecAttrAccount]; [wrapper setObject:@"password" forKey:(id)kSecValueData]; [wrapper setObject:(id)kSecAttrAccessibleAlwaysThisDeviceOnly forKey:(id)kSecAttrAccessible];
kSecAttrAccessible 用來指定何時允許存取資料,可設定六種值。要特別注意:絕對不要使用 kSecAttrAccessibleAlways,較安全的選擇是 kSecAttrAccessibleWhenUnlocked。以 ThisDeviceOnly 結尾的選項,資料會以硬體相關的金鑰加密,無法被傳輸或在其他裝置上讀取;雖然更安全,但除非有充分理由,否則不建議使用,因為它會阻礙備份之間的資料遷移。
從 Keychain 取資料:
NSString *accountName = [wrapper objectForKey:(id)kSecAttrAccount];
鑰匙串中的條目稱為 SecItem,實際上以 CFDictionary 形式儲存。SecItem 有五類:通用密碼、網際網路密碼、憑證、金鑰與身份。大多數情況下我們用的是通用密碼;網際網路密碼複雜得多、優勢有限,除非在開發網頁瀏覽器,否則用不著。KeychainItemWrapper 正是只用通用密碼,這也是它受歡迎的原因之一。
每個 Keychain 條目如圖所示,整體是一個字典結構:

1. kSecClass 定義屬於哪一類型的 Keychain。
2. 不同類型包含不同的 Attributes,用來描述該條目的具體資訊。
3. 每個條目可包含一個密碼項來儲存對應的密碼。
iOS 的 Security.framework 提供了四個主要方法:
// 查詢 OSStatus SecItemCopyMatching(CFDictionaryRef query, CFTypeRef *result); // 新增 OSStatus SecItemAdd(CFDictionaryRef attributes, CFTypeRef *result); // 更新 OSStatus SecItemUpdate(CFDictionaryRef query, CFDictionaryRef attributesToUpdate); // 刪除 OSStatus SecItemDelete(CFDictionaryRef query);
首先引入 Security 框架:#import <Security/Security.h>
- (IBAction)add:sender {
if (nameField.text.length > 0 && passwordField.text.length > 0) {
NSMutableDictionary* dic = [NSMutableDictionary dictionary];
[dic setObject:(id)kSecClassGenericPassword forKey:(id)kSecClass];
[dic setObject:nameField.text forKey:(id)kSecAttrAccount];
[dic setObject:[passwordField.text dataUsingEncoding:NSUTF8StringEncoding] forKey:(id)kSecValueData];
OSStatus s = SecItemAdd((CFDictionaryRef)dic, NULL);
NSLog(@"%d", s);
}
}
- (IBAction)sel:sender {
NSDictionary* query = [NSDictionary dictionaryWithObjectsAndKeys:
(id)kSecClassGenericPassword, (id)kSecClass,
(id)kSecMatchLimitAll, (id)kSecMatchLimit,
(id)kCFBooleanTrue, (id)kSecReturnAttributes, nil];
CFTypeRef result = nil;
OSStatus s = SecItemCopyMatching((CFDictionaryRef)query, &result);
NSLog(@"%d", s);
NSLog(@"%@", result);
}
先查詢到既有條目,再更新其密碼資料:
OSStatus status = SecItemUpdate((CFDictionaryRef)updateItem, (CFDictionaryRef)update); NSLog(@"%d", status);
- (IBAction)del:sender {
if (nameField.text.length > 0) {
NSDictionary* query = [NSDictionary dictionaryWithObjectsAndKeys:
(id)kSecClassGenericPassword, (id)kSecClass,
nameField.text, (id)kSecAttrAccount, nil];
OSStatus status = SecItemDelete((CFDictionaryRef)query);
NSLog(@"%d", status);
}
}
以下封裝一個 WQKeyChain 工具類,示範密碼的儲存、讀取與刪除:
@implementation WQKeyChain
+ (NSMutableDictionary *)getKeychainQuery:(NSString *)service {
return [NSMutableDictionary dictionaryWithObjectsAndKeys:
(__bridge id)kSecClassGenericPassword, (__bridge id)kSecClass,
service, (__bridge id)kSecAttrService,
service, (__bridge id)kSecAttrAccount,
(__bridge id)kSecAttrAccessibleAfterFirstUnlock, (__bridge id)kSecAttrAccessible, nil];
}
+ (void)save:(NSString *)service data:(id)data {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((__bridge CFDictionaryRef)keychainQuery); // 先刪除舊資料
[keychainQuery setObject:[NSKeyedArchiver archivedDataWithRootObject:data]
forKey:(__bridge id)kSecValueData];
SecItemAdd((__bridge CFDictionaryRef)keychainQuery, NULL);
}
+ (id)load:(NSString *)service {
id ret = nil;
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
[keychainQuery setObject:(id)kCFBooleanTrue forKey:(__bridge id)kSecReturnData];
[keychainQuery setObject:(__bridge id)kSecMatchLimitOne forKey:(__bridge id)kSecMatchLimit];
CFDataRef keyData = NULL;
if (SecItemCopyMatching((__bridge CFDictionaryRef)keychainQuery, (CFTypeRef *)&keyData) == noErr) {
@try {
ret = [NSKeyedUnarchiver unarchiveObjectWithData:(__bridge NSData *)keyData];
} @catch (NSException *e) {
NSLog(@"Unarchive of %@ failed: %@", service, e);
}
}
return ret;
}
+ (void)delete:(NSString *)service {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((__bridge CFDictionaryRef)keychainQuery);
}
@end
再封裝一層 WQUserDataManager,讓呼叫端更簡潔:
static NSString * const KEY_IN_KEYCHAIN = @"com.wuqian.app.allinfo";
static NSString * const KEY_PASSWORD = @"com.wuqian.app.password";
+(void)savePassWord:(NSString *)password {
NSMutableDictionary *pairs = [NSMutableDictionary dictionary];
[pairs setObject:password forKey:KEY_PASSWORD];
[WQKeyChain save:KEY_IN_KEYCHAIN data:pairs];
}
+(id)readPassWord {
NSMutableDictionary *pairs = (NSMutableDictionary *)[WQKeyChain load:KEY_IN_KEYCHAIN];
return [pairs objectForKey:KEY_PASSWORD];
}
+(void)deletePassWord {
[WQKeyChain delete:KEY_IN_KEYCHAIN];
}
介面上只要一行就能完成儲存並立即讀取顯示:
-(IBAction)btnAciton:(id)sender {
[WQUserDataManager savePassWord:self.textfield.text];
self.label.text = [WQUserDataManager readPassWord];
}
執行效果如下:


相較於明文儲存,Keychain 提供了加密與系統級別的安全保障,是保存敏感資訊時最推薦的做法。