Keychain 是 Apple 提供的安全儲存機制,專門用來放使用者名稱、密碼、憑證這類敏感資料。它最大的特性是:資料不會隨著 App 被刪除而消失——除非開發者在程式碼中明確刪除,否則重新安裝後仍能讀回來。這讓「記住我的帳密」得以實現,同時由系統加密保護。
對比之下,NSUserDefaults 存的是明文 plist,任何能取得 App 沙存檔案的人都看得到內容,絕對不該用來放密碼。
使用 Keychain 需要把 Security.framework 加入專案。由於這套 C API 不支援 ARC,在 ARC 專案中必須為相關檔案啟用 MRC:選中專案 → TARGETS → 對應 target → Build Phases → Compile Sources,在該檔案後加上 -fno-objc-arc。
#import <Foundation/Foundation.h> #import <Security/Security.h> @interface KeyChain : NSObject + (void)save:(NSString *)service data:(id)data; // 寫入 + (id)load:(NSString *)service; // 讀取 + (void)delete:(NSString *)service; // 刪除 @end
#import "KeyChain.h"
@implementation KeyChain
/**
* 本類需在 MRC 模式下運作。ARC 專案的設定方式:
* 選中專案 → TARGETS → 對應 target → Build Phases → Compile Sources,
* 在檔案後加上 -fno-objc-arc
**/
+ (NSMutableDictionary *)getKeychainQuery:(NSString *)service {
return [NSMutableDictionary dictionaryWithObjectsAndKeys:
(id)kSecClassGenericPassword, (id)kSecClass,
service, (id)kSecAttrService,
service, (id)kSecAttrAccount,
(id)kSecAttrAccessibleAfterFirstUnlock, (id)kSecAttrAccessible,
nil];
}
#pragma mark - 寫入
+ (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);
}
#pragma mark - 讀取
+ (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);
}
}
if (keyData) CFRelease(keyData); // CF 物件要自行釋放
return ret;
}
#pragma mark - 刪除
+ (void)delete:(NSString *)service {
NSMutableDictionary *keychainQuery = [self getKeychainQuery:service];
SecItemDelete((CFDictionaryRef)keychainQuery);
}
@end
先定義幾個服務識別碼(慣例是用反轉 DNS 格式):
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:@"userName" forKey:KEY_USERNAME]; [userNamePasswordKVPairs setObject:@"password" forKey:KEY_PASSWORD];
呼叫工具類完成增、讀、刪:
// A. 寫入 [KeyChain save:KEY_USERNAME_PASSWORD data:userNamePasswordKVPairs]; // B. 讀取 NSMutableDictionary *readUsernamePassword = (NSMutableDictionary *)[KeyChain load:KEY_USERNAME_PASSWORD]; NSString *userName = [readUsernamePassword objectForKey:KEY_USERNAME]; NSString *password = [readUsernamePassword objectForKey:KEY_PASSWORD]; NSLog(@"username = %@", userName); NSLog(@"password = %@", password); // C. 刪除(例如使用者登出時) [KeyChain delete:KEY_USERNAME_PASSWORD];
把密碼原字串寫進 Keychain 只能算「比 plist 安全」,但仍不理想。更好的做法是只存雜湊值或 token:註冊時用加鹽雜湊(若為自行實作服務端)保存驗證碼;登入成功後保存的是伺服器核發的 token,而不是使用者密碼本身。
範例中的 load: 找不到資料時會回傳 nil,後續 objectForKey: 對 nil 是安全的,但邏輯上必須判斷,否則會出現「帳號欄位是空的卻直接送出登入」這種情況。
正式專案應檢查 SecItemCopyMatching 的回傳碼:errSecSuccess 是成功,errSecItemNotFound 是沒有資料(正常情況),其他錯誤碼(例如 -34018 在模擬器鑰匙串未初始化時出現)才需要處理。
若有多支 App 需要共用同一組登入狀態,可在查詢字典中加上 kSecAttrAccessGroup,並在 entitlements 中設定鑰匙串存取群組。
預設的 kSecAttrAccessibleAfterFirstUnlock 不會跨裝置同步。若希望使用者在多台裝置間共用帳密,需改用 kSecAttrSynchronizable 相關設定——但這牽涉隱私與送審說明,請審慎評估。