您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

詳解 iOS 開發中 Keychain 鑰匙串的相關使用

編輯:iOS 相關教學

當需要安全地保存使用者名稱、密碼、認證權杖等敏感資訊時,Keychain 是最理想的選擇。本文從 Keychain 的基本概念談起,涵蓋其資料結構、四大操作 API,並以實例示範密碼的存取與刪除。

一、Keychain 基礎

根據蘋果的說法,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];

Keychain 的資料結構

鑰匙串中的條目稱為 SecItem,實際上以 CFDictionary 形式儲存。SecItem 有五類:通用密碼、網際網路密碼、憑證、金鑰與身份。大多數情況下我們用的是通用密碼;網際網路密碼複雜得多、優勢有限,除非在開發網頁瀏覽器,否則用不著。KeychainItemWrapper 正是只用通用密碼,這也是它受歡迎的原因之一。

每個 Keychain 條目如圖所示,整體是一個字典結構:

1. kSecClass 定義屬於哪一類型的 Keychain。

2. 不同類型包含不同的 Attributes,用來描述該條目的具體資訊。

3. 每個條目可包含一個密碼項來儲存對應的密碼。

二、Keychain 的四大操作 API

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);

三、Keychain 使用實作

首先引入 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 提供了加密與系統級別的安全保障,是保存敏感資訊時最推薦的做法。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved