iOS KeyChain使用和封裝，唯一標(biāo)識(shí)符存儲(chǔ)

最近項(xiàng)目需要存儲(chǔ)用戶的唯一標(biāo)識(shí)符，但是由于如果用戶重裝APP，獲取到的又會(huì)是一個(gè)新的UDID。查詢了一系列資料下來(lái)，可以用Keychain進(jìn)行存儲(chǔ)UDID，然后就算重裝了APP，也能從Keychain中讀取出之前存儲(chǔ)的UDID。

Keychain存儲(chǔ)在iOS系統(tǒng)的內(nèi)部數(shù)據(jù)庫(kù)中,由系統(tǒng)進(jìn)行管理和加密，哪怕APP被刪除了，它存儲(chǔ)在Keychain中的數(shù)據(jù)也不會(huì)被刪除。

So，Keychain使用走起～
首先一定要在Capabilities中打開(kāi)Keychain，如圖：

6B836BEE-1CDC-4D49-8E7E-50490DE2E953.png

好吧，不打開(kāi)的話進(jìn)行Keychain操作將會(huì)返回一個(gè)34018的錯(cuò)誤碼。。

當(dāng)然別忘記引入import <Security/Security.h>

Keychain存儲(chǔ)的流程如圖所示：

B9C180AB-88D0-44B6-905E-37802CC13B6E.png

簡(jiǎn)單來(lái)說(shuō)，如果要存儲(chǔ)一個(gè)password，需要先遍歷Keychain，看它的password是否已經(jīng)存在于Keychain中，存在的話就更新它的值，不存在就存儲(chǔ)。
所以這就使用到蘋果提供的方法：

// 查詢
OSStatus SecItemCopyMatching(CFDictionaryRef query, CFTypeRef *result);

// 添加
OSStatus SecItemAdd(CFDictionaryRef attributes, CFTypeRef *result);

// 更新
OSStatus SecItemUpdate(CFDictionaryRef query, CFDictionaryRef attributesToUpdate);

// 刪除
OSStatus SecItemDelete(CFDictionaryRef query)

接下來(lái)看看操作Keychain常用的key-value.

kSecClass:有五個(gè)值，分別為
      kSecClassGenericPassword(通用密碼－－也是接下來(lái)使用的)、
      kSecClassInternetPassword(互聯(lián)網(wǎng)密碼)、
      kSecClassCertificate(證書)、
      kSecClassKey(密鑰)、
      kSecClassIdentity(身份)

kSecAttrService:服務(wù)
kSecAttrServer:服務(wù)器域名或IP地址
kSecAttrAccount:賬號(hào)
kSecAttrAccessGroup: 可以在應(yīng)用之間共享keychain中的數(shù)據(jù)
kSecMatchLimit:返回搜索結(jié)果，kSecMatchLimitOne（一個(gè)）、kSecMatchLimitAll（全部）
//

這是基于CoreFundation框架的操作，通過(guò)帶有以上key－value值的字典進(jìn)行操作，所以寫起來(lái)還是有些繁瑣的。所幸蘋果提供了一個(gè)源碼Demo。demo中使用service和account以及accessGroup進(jìn)行password的存儲(chǔ)，也就是一個(gè)kSecClassGenericPassword類型的Keychain表，一個(gè)account對(duì)應(yīng)一個(gè)password，可以很方便在APP中進(jìn)行Key-Value類型的存儲(chǔ)。

不過(guò)由于它是使用Swift編寫的，在我的小項(xiàng)目中不適合引入混編，所以我就按著demo 的邏輯抄了個(gè)OC版的出來(lái)。個(gè)人看來(lái)，OC的還是好懂點(diǎn)，去除了各種try catch，思路上會(huì)清晰很多。

初始化方法：

- (instancetype)initWithSevice:(NSString *)service account :(NSString *)account accessGroup:(NSString *)accessGroup {
    if (self = [super init]) {
        _service = service;
        _account = account;
        _accessGroup = accessGroup;//可以在不同的app當(dāng)中共享
    }
    return self;
}

主要方法有：

- (void)savePassword:(NSString *)password;
- (BOOL)deleteItem;

- (NSString *)readPassword;

//返回當(dāng)前accessGroup下的service的所有Keychain Item
+ (NSArray *)passwordItemsForService:(NSString *)service accessGroup:(NSString *)accessGroup;

（具體代碼在后面貼吧，防止影響篇幅，有興趣的朋友也可以下demo看看）

使用起來(lái)就是：
存儲(chǔ)：

    KeychainWrapper *wrapper = [[KeychainWrapper alloc] initWithSevice:kKeychainService account:self.accountField.text accessGroup:kKeychainAccessGroup];
    [wrapper savePassword:self.passwordField.text];

讀取當(dāng)前account 的password：

KeychainWrapper *item = [[KeychainWrapper alloc] initWithSevice:service account:acount accessGroup:accessGroup];
[item readPassword];

返回當(dāng)前accessGroup下的service的所有Keychain：

NSArray *keychains = [KeychainWrapper passwordItemsForService:kKeychainService accessGroup:kKeychainAccessGroup];

踩坑：OSStatus狀態(tài)錯(cuò)誤碼：

  • 50: 請(qǐng)求參數(shù)錯(cuò)誤。我就曾經(jīng)把kSecAttrService寫成了kSecAttrServer，crash到哭了。。。
  • 34018:前面說(shuō)的Capabilities...

代碼：

- (void)savePassword:(NSString *)password {
    NSData *encodePasswordData = [password dataUsingEncoding:NSUTF8StringEncoding];
    
    // if password was existed, update
    NSString *originPassword = [self readPassword];
    
    if (originPassword.length > 0) {
        NSMutableDictionary *updateAttributes = [NSMutableDictionary dictionary];
        updateAttributes[(__bridge id)kSecValueData] = encodePasswordData;
        
        NSMutableDictionary *query = [self keychainQueryWithService:_service account:_account accessGroup:_accessGroup];
        OSStatus statusCode = SecItemUpdate(
                                           (__bridge CFDictionaryRef)query,
                                           (__bridge CFDictionaryRef)updateAttributes);
        NSAssert(statusCode == noErr, @"Couldn't update the Keychain Item." );
    }else{
        // else , add
        NSMutableDictionary *attributes = [self keychainQueryWithService:_service account:_account accessGroup:_accessGroup];
        attributes[(__bridge id)kSecValueData] = encodePasswordData;
        
        OSStatus status = SecItemAdd((__bridge CFDictionaryRef)attributes, nil);
        
        NSAssert(status == noErr, @"Couldn't add the Keychain Item.");
    }
}

- (NSString *)readPassword {
    NSMutableDictionary *attributes = [self keychainQueryWithService:_service account:_account accessGroup:_accessGroup];
    attributes[(__bridge id)kSecMatchLimit] = (__bridge id)(kSecMatchLimitOne);
    attributes[(__bridge id)kSecReturnAttributes] = (__bridge id _Nullable)(kCFBooleanTrue);
    attributes[(__bridge id)kSecReturnData] = (__bridge id _Nullable)(kCFBooleanTrue);
    
    CFMutableDictionaryRef queryResult = nil;
    OSStatus keychainError = noErr;
    keychainError = SecItemCopyMatching((__bridge CFDictionaryRef)attributes,(CFTypeRef *)&queryResult);
    if (keychainError == errSecItemNotFound) {
        if (queryResult) CFRelease(queryResult);
        return nil;
    }else if (keychainError == noErr) {
        
        if (queryResult == nil){return nil;}
        
        NSMutableDictionary *resultDict = (__bridge NSMutableDictionary *)queryResult;
        NSData *passwordData = resultDict[(__bridge id)kSecValueData];
        
        NSString *password = [[NSString alloc] initWithData:passwordData encoding:NSUTF8StringEncoding];
        
        return password;
    }else
    {
        NSAssert(NO, @"Serious error.\n");
        if (queryResult) CFRelease(queryResult);
    }
    
    return nil;
}

- (NSMutableDictionary *)keychainQueryWithService:(NSString *)service account:(NSString *)account accessGroup:(NSString *)accessGroup {
    
    NSMutableDictionary *query = [NSMutableDictionary dictionary];
    
    query[(__bridge id)kSecClass] = (__bridge id)kSecClassGenericPassword;
    
    query[(__bridge id)kSecAttrService] = service;
    
    query[(__bridge id)kSecAttrAccount] = account;
    
    query[(__bridge id)kSecAttrAccessGroup] = accessGroup;
    
    return query;
}

+ (NSArray *)passwordItemsForService:(NSString *)service accessGroup:(NSString *)accessGroup {
    NSMutableDictionary *query = [[[self alloc]init] keychainQueryWithService:service account:nil accessGroup:accessGroup];
    
    query[(__bridge id)kSecMatchLimit] = (__bridge id)kSecMatchLimitAll;
    query[(__bridge id)kSecReturnAttributes] = (__bridge id _Nullable)(kCFBooleanTrue);
    query[(__bridge id)kSecReturnData] = (__bridge id _Nullable)(kCFBooleanFalse);
    
    CFMutableArrayRef queryResult = nil;
    OSStatus status = noErr;
    status = SecItemCopyMatching((__bridge CFDictionaryRef)query,(CFTypeRef *)&queryResult);
    
    if (status == errSecItemNotFound) {
        return @[];
    }else if (status == noErr) {
        
        NSArray<NSDictionary *> *resultArray = (__bridge NSArray<NSDictionary *> *)queryResult;
        
        if (resultArray.count == 0){return @[];}
        
        NSMutableArray *passwordItems = [NSMutableArray array];
        
        for (NSDictionary *result in resultArray) {
            NSString *acount = result[(__bridge id)kSecAttrAccount];
            
            if (acount.length > 0) {
                KeychainWrapper *item = [[KeychainWrapper alloc] initWithSevice:service account:acount accessGroup:accessGroup];
                [passwordItems addObject:item];
            }
        }
        
        return passwordItems;
    }else {
        NSAssert(NO, @"Serious error.\n");
        if (queryResult) CFRelease(queryResult);
        return @[];
    }
}

- (BOOL)deleteItem {
    // Delete the existing item from the keychain.
    NSMutableDictionary *query = [self keychainQueryWithService:self.service account:self.account accessGroup:self.accessGroup];
    
    OSStatus status = SecItemDelete((__bridge CFDictionaryRef)query);
    
    if (status != noErr && status != errSecItemNotFound) {
        return NO;
    }
    return true;
}

demo
參考：
https://developer.apple.com/library/prerelease/content/documentation/Security/Conceptual/keychainServConcepts/iPhoneTasks/iPhoneTasks.html#//apple_ref/doc/uid/TP30000897-CH208-SW1
http://www.360doc.com/content/15/0708/15/20918780_483580050.shtml
https://my.oschina.net/w11h22j33/blog/206713

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容