根據 Apple 的說明,iOS 設備中的 Keychain 是一個安全的儲存容器,可用來為不同應用保存敏感資訊,如使用者名稱、密碼、網絡密碼、認證令牌等。Apple 自身便用它保存 Wi-Fi 密碼、VPN 憑證等。它本質上是一個位於 /private/var/Keychains/keychain-2.db 的 sqlite 資料庫,其中保存的所有數據都經過加密。
開發者通常希望利用作業系統提供的功能來保存憑證,而非將其存入 NSUserDefaults 或 plist 檔案,目的是讓使用者無需每次重新登錄。Keychain 的資訊存在於每個應用的沙盒之外。
透過 keychain access groups 可在應用之間共享數據,保存時需指定 group。保存數據到 Keychain 的最佳方式是使用 Apple 提供的 KeychainItemWrapper。第一步是創建該類的實例:
KeychainItemWrapper *wrapper = [[KeychainItemWrapper alloc] initWithIdentifier:@"Password" accessGroup:nil];
標識符(Identifier)在後續取數據時會用到。若想跨應用共享資訊,則需指定訪問組(access group),擁有相同訪問組的應用可訪問相同的 Keychain 資訊:
KeychainItemWrapper *wrapper = [[KeychainItemWrapper alloc] initWithIdentifier:@"Account Number" accessGroup:@"YOUR_APP_ID_HERE.com.yourcompany.GenericKeychainSuite"];
使用 setObject:forKey: 方法保存資訊。其中 kSecClass 指定保存的資訊類別(此處為通用密碼),kSecValueData 用來保存任意數據(此處為密碼):
[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 有五類:通用密碼、互聯網密碼、證書、密鑰和身份,最常用的是通用密碼。互聯網密碼要複雜得多且優勢有限,除非開發網頁瀏覽器,否則通常不必使用。
說明:每個 Keychain 條目整體是一個字典結構:

1. kSecClass key 定義屬於哪一種類型的 Keychain;
2. 不同類型包含不同的 Attributes,定義該 item 的具體資訊;
3. 每個 item 可包含一個密碼項來存儲對應密碼。
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:(id)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);
}
}
查找(透過 kSecMatchLimit、kSecReturnAttributes 等參數配置查詢條件)
修改:先以 SecItemCopyMatching 查到目標條目,再透過 SecItemUpdate 更新其 kSecValueData。
刪除:以包含 kSecClass 與 kSecAttrAccount 的 query 調用 SecItemDelete 即可。
以下封裝 WQKeyChain 類,實現通用密碼的保存、讀取與刪除:
@implementation WQKeyChain
+ (NSMutableDictionary *)getKeychainQuery:(NSString *)service {
return [NSMutableDictionary dictionaryWithObjectsAndKeys:
(__bridge_transfer id)kSecClassGenericPassword, (__bridge_transfer id)kSecClass,
service, (__bridge_transfer id)kSecAttrService,
service, (__bridge_transfer id)kSecAttrAccount,
(__bridge_transfer id)kSecAttrAccessibleAfterFirstUnlock, (__bridge_transfer id)kSecAttrAccessible,
nil];
}
+ (void)save:(NSString *)service data:(id)data {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
// 添加新項前先刪除舊項
SecItemDelete((__bridge_retained CFDictionaryRef)keychainQuery);
[keychainQuery setObject:[NSKeyedArchiver archivedDataWithRootObject:data] forKey:(__bridge_transfer id)kSecValueData];
SecItemAdd((__bridge_retained CFDictionaryRef)keychainQuery, NULL);
}
+ (id)load:(NSString *)service {
id ret = nil;
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
[keychainQuery setObject:(id)kCFBooleanTrue forKey:(__bridge_transfer id)kSecReturnData];
[keychainQuery setObject:(__bridge_transfer id)kSecMatchLimitOne forKey:(__bridge_transfer id)kSecMatchLimit];
CFDataRef keyData = NULL;
if (SecItemCopyMatching((__bridge_retained CFDictionaryRef)keychainQuery, (CFTypeRef *)&keyData) == noErr) {
@try {
ret = [NSKeyedUnarchiver unarchiveObjectWithData:(__bridge_transfer NSData *)keyData];
} @catch (NSException *e) {
NSLog(@"Unarchive of %@ failed: %@", service, e);
}
}
return ret;
}
+ (void)delete:(NSString *)service {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((__bridge_retained CFDictionaryRef)keychainQuery);
}
@end
再封裝 WQUserDataManager,以固定 key 管理密碼的存取:
static NSString * const KEY_IN_KEYCHAIN = @"com.wuqian.app.allinfo";
static NSString * const KEY_PASSWORD = @"com.wuqian.app.password";
+(void)savePassWord:(NSString *)password {
NSMutableDictionary *usernamepasswordKVPairs = [NSMutableDictionary dictionary];
[usernamepasswordKVPairs setObject:password forKey:KEY_PASSWORD];
[WQKeyChain save:KEY_IN_KEYCHAIN data:usernamepasswordKVPairs];
}
+(id)readPassWord {
NSMutableDictionary *pair = (NSMutableDictionary *)[WQKeyChain load:KEY_IN_KEYCHAIN];
return [pair objectForKey:KEY_PASSWORD];
}
+(void)deletePassWord {
[WQKeyChain delete:KEY_IN_KEYCHAIN];
}
最後在介面中調用即可驗證效果:
-(IBAction)btnAciton:(id)sender
{
[WQUserDataManager savePassWord:self.textfield.text];
self.label.text = [WQUserDataManager readPassWord];
}

