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

iOS 密碼存儲:Keychain 的深入實踐

編輯:iOS 相關資訊

密碼存儲是 iOS 開發中一個老生常談卻至關重要的問題。本文整理 Keychain 的相關知識,並示範如何打造一個類似 SSKeychain 的封裝類。

開源庫的選擇與踩坑

專案中原本使用的是 SFHFKeychainUtils,一直穩定運行。出於技術好奇心,筆者在 GitHub 上搜索 ios keychain,找出了星數最多的兩個開源庫:SSKeychain 與 UICKeyChainStore。最終選擇了星數更多的 SSKeychain,pod install 後接入專案。但使用一段時間後卻頻繁出現 errSecDefault 問題。出於無奈轉而研究 UICKeyChainStore,卻發現它沒有提供 account 支持。種種因素促使筆者回頭深入研究 Keychain 的實現細節,遂有此文。

蘋果官方對 Keychain 的說明

根據蘋果官方文件(Keychain Services Programming Guide),關於 iOS 的關鍵要點如下:

鑰匙鏈是一個加密的容器,保存了多個程式和安全服務的密碼。它是安全的存儲容器——當鑰匙鏈鎖定時,任何人都無法訪問其受保護的內容。在 Mac OS X 下,使用者可輸入主密碼來解鎖,從而讓信任的程式訪問內容;而在 iOS 中,每個應用程式始終只能訪問自己的鑰匙鏈項,使用者無需(也無法)解鎖鑰匙鏈。

iOS 中只有一個可供訪問的鑰匙鏈。儘管它存儲了系統上所有應用的鑰匙鏈項,但一個應用程式只能訪問屬於自己的鑰匙鏈項。

provisioning profile 的重要性:在 iPhone 上,鑰匙鏈的訪問權限取決於簽署應用時使用的 provisioning profile。因此,務必在應用的不同版本之間保持一致地使用同一個 provisioning profile。

鑰匙鏈的結構:每個鑰匙鏈可包含任意數量的鑰匙鏈項,每個項包含數據加上一組屬性。需要保護的項(如密碼、私鑰)其數據會被加密;不需保護的項(如證書)則不加密。

iOS 鑰匙鏈服務的搜索字典

在 iOS 中,鑰匙鏈服務使用鍵值對字典來指定鑰匙鏈項的屬性,以便查找或創建。典型的搜索字典包含:

  • class key:指定要搜索的鑰匙鏈項類型(如互聯網密碼、通用密碼)。
  • 一或多個鍵值對,指定匹配的屬性數據(如標籤、創建日期)。
  • 一或多個搜索鍵值對,用於精確匹配。
  • 一個返回值鍵值對,指定想要的返回數據類型(如字典或引用)。

打造類似 SSKeychain 的封裝類

0. 設置密碼(添加 / 更新)

+ (BOOL)setPassword:(NSString *)password
         forService:(NSString *)serviceName
            account:(NSString *)account {
    NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
    [keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount];       // 賬戶
    [keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService];    // 服務名
    [keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];   // 類型
    [keyChainDic setObject:[password dataUsingEncoding:NSUTF8StringEncoding] forKey:(__bridge id)kSecValueData];   // 密碼數據

    // 先查詢是否已存在
    CFMutableDictionaryRef outDictionary = nil;
    OSStatus keychainErr = SecItemCopyMatching((__bridge CFDictionaryRef)keyChainDic, (CFTypeRef *)&outDictionary);
    BOOL resultState = NO;

    if (keychainErr == noErr) {
        // 已存在則更新
        OSStatus errorCode = SecItemUpdate((__bridge CFDictionaryRef)keyChainDic,
                                           (__bridge CFDictionaryRef)keyChainDic);
        resultState = (errorCode == noErr);
    } else if (keychainErr == errSecItemNotFound) {
        // 不存在則新增
        OSStatus errorCode = SecItemAdd((__bridge CFDictionaryRef)keyChainDic, NULL);
        resultState = (errorCode == noErr);
    }
    return resultState;
}

1. 獲取密碼

+ (NSString *)passwordForService:(NSString *)serviceName account:(NSString *)account {
    NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
    [keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount];
    [keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService];
    [keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];
    [keyChainDic setObject:(__bridge id)kCFBooleanTrue forKey:(__bridge id)kSecReturnData];

    CFDataRef passwordData = NULL;
    OSStatus keychainError = SecItemCopyMatching((__bridge CFDictionaryRef)keyChainDic, (CFTypeRef *)&passwordData);

    NSString *pwdStr = nil;
    if (keychainError == noErr) {
        pwdStr = [[NSString alloc] initWithBytes:[(__bridge_transfer NSData *)passwordData bytes]
                                          length:[(__bridge NSData *)passwordData length]
                                        encoding:NSUTF8StringEncoding];
    }
    return pwdStr;
}

2. 刪除密碼

+ (BOOL)deletePasswordForService:(NSString *)serviceName account:(NSString *)account {
    NSMutableDictionary *keyChainDic = [[NSMutableDictionary alloc] init];
    [keyChainDic setObject:account forKey:(__bridge id)kSecAttrAccount];
    [keyChainDic setObject:serviceName forKey:(__bridge id)kSecAttrService];
    [keyChainDic setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];

    OSStatus keychainError = SecItemDelete((__bridge CFDictionaryRef)keyChainDic);
    return (keychainError == noErr);
}

透過以上三個方法——設置、獲取、刪除——就完成了一個簡潔實用的密碼存取封裝類。使用 Keychain 而非 NSUserDefaults 來存儲敏感信息,是因為前者提供了系統級的加密保護,能更好地保障用戶的賬戶安全。

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