您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

用 Keychain 保存用戶名與密碼:為什麼不能只靠 NSUserDefaults

編輯:iOS 開發綜合

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

幾個實務上必須補強的地方

1. 密碼不該用明文放在字典裡

把密碼原字串寫進 Keychain 只能算「比 plist 安全」,但仍不理想。更好的做法是只存雜湊值或 token:註冊時用加鹽雜湊(若為自行實作服務端)保存驗證碼;登入成功後保存的是伺服器核發的 token,而不是使用者密碼本身。

2. 讀取要處理「不存在」的情況

範例中的 load: 找不到資料時會回傳 nil,後續 objectForKey: 對 nil 是安全的,但邏輯上必須判斷,否則會出現「帳號欄位是空的卻直接送出登入」這種情況。

3. 使用 recordNotFound 以外的錯誤碼

正式專案應檢查 SecItemCopyMatching 的回傳碼:errSecSuccess 是成功,errSecItemNotFound 是沒有資料(正常情況),其他錯誤碼(例如 -34018 在模擬器鑰匙串未初始化時出現)才需要處理。

4. 加上 kSecAttrAccessGroup 讓自家 App 共用

若有多支 App 需要共用同一組登入狀態,可在查詢字典中加上 kSecAttrAccessGroup,並在 entitlements 中設定鑰匙串存取群組。

5. 注意 iCloud 鑰匙串同步

預設的 kSecAttrAccessibleAfterFirstUnlock 不會跨裝置同步。若希望使用者在多台裝置間共用帳密,需改用 kSecAttrSynchronizable 相關設定——但這牽涉隱私與送審說明,請審慎評估。

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