×
广告

iOS Keychain总结

96
NapoleonY
2016.05.09 17:20* 字数 916

概要

iOS中一般用Keychain存储密码、私钥等需要加密的数据。参考apple 官网介绍

使用方法

先总的说下怎么使用,再具体说说原理。
我自己实现了几个基本的功能:查找、更新、删除、添加。后续会继续补充更多的功能。
已开源到github

  1. 在工程中添加Secutity.framework库。(TARGETS-General-Linked Frameworks and Libraries)
  2. 使用说明
#import "NYKeychain.h"//引入头文件
NSString *serviceName = xxx;//服务名
NSString *account = xxx;//账户名
//其中serviceName和account在程序内部自己定义的常量,keychain根据这两个量保存、查找、更新、替换密码
[NYKeychain setPassword:password forService:serviceName account:account];//保存、更新密码
[NYKeychain passwordForService:serviceName account:account];//查找
 [NYKeychain deletePasswordForService:serviceName account:account];//删除

原理

keychain相当于一个银行的金库,keychain item就相当于金库里的一个个的保险柜,保存在keychain Item里面的密码就相当于保险柜里面存放的金条。

keychain结构
  • 银行金库里有多个保险柜,keychain有多个keychain item;每个保险柜都有两部分组成:保险柜里面的金条以及保险柜的属性(保险柜编号、保险柜位置……);每一个keychain item包含两部分:数据,一系列属性。
  • 保险柜的属性与其要存放的东西有关:可能存放黄金的保险柜在A区,保险柜编号以G开头;而存放重要资料的保险柜在B区,保险柜编号以D开头……而keychain item属性与其要保存的密码有关:是generic passwords还是Internet passwords。例如Internet passwords的属性有security domain,protocol type等等。
  • 每个人只能打开自己的保险柜,每个iOS应用也只能使用自己的keychain items.
Keychain 服务搜索字典

iOS中Keychain Services使用key-value dictionary来指定我们想要创建或者查找的keychain item属性。
一个典型的搜索字典包含以下四部分:

  • The class key-value pair:指定了keychain item类型。
  • 一个或多个key-value pairs:指定keychain item的各种一般属性
  • 一个或多个key-value pairs:指定keychain item的各种查找属性,例如kSecMatchPolicy,为了查找的精确性
  • 一个返回类型的key-value pair:指定想要的返回结果的类型,例如是返回一个dictionary或者persistent reference
    具体可以指定什么属性,可以查找apple官方定义
    例如想要执行一个有如下属性的搜索:想要Apple Store(service name)下ImaUser(account)账户下密码,该搜索条件不敏感,可以用SecItemCopyMatching函数,如图所示:
搜索dictionary

代码详解

与Keychain相关的操作最重要的就是dictionary。所有操作都是围绕配置这个dictionary。
在下面的代码中,首先配置了这个dictionary四个部分的前两个部分,即class key-value pair,一般属性。

- (NSMutableDictionary *)query
{
    NSMutableDictionary *dictionary = [NSMutableDictionary dictionaryWithCapacity:3];
    //要保存的password类型
    [dictionary setObject:(__bridge id)kSecClassGenericPassword forKey:(__bridge id)kSecClass];
    if (self.service) {//AttrService 和AttrAccount是两个主要的属性
        [dictionary setObject:self.service forKey:(__bridge id)kSecAttrService];
    }
    if (self.account) {
        [dictionary setObject:self.account forKey:(__bridge id)kSecAttrAccount];
    }
    return dictionary;
}
使用Keychain item 搜索dictionary

apple提供了四个函数用来进行密码的查找、添加、更新、删除等操作。

SecItemAdd;
SecItemUpdate;
SecItemCopyMatching;
SecItemDelete;
  • 查找
    查找前,先配置dictionary。在下面的代码中配置了这个dictionary四个部分的后两个部分,即Search key-value和返回类型的key-value.
 - (BOOL)fetch
{
    CFTypeRef result = NULL;
    NSMutableDictionary *query = [self query];
    //YES本来是一个值,@YES就变成了一个对象,可用[NSNumber numberWithBool];代替
    [query setObject:@YES forKey:(__bridge id)kSecReturnData];
    [query setObject:(__bridge id)kSecMatchLimitOne forKey:(__bridge id)kSecMatchLimit];
    OSStatus status = SecItemCopyMatching((__bridge CFDictionaryRef)query, &result);
    if (status != errSecSuccess) {
        return NO;
    }
    self.passwordData = (__bridge_transfer NSData *)result;
    return YES;
}
  • 添加、更新
    添加、更新前首先查找。此处的dictionary只配置了四部分中的前两部分,原因是,apple已经有默认的配置。例如在kSecMatchCaseInsensitive key中有一句话:

if this attribute is not provided, then case-sensitive string matching is performed

 - (BOOL)save
{
    NSMutableDictionary *query = nil;
    NSMutableDictionary *searchQuery = [self query];
    //添加前首先查找是否存在要添加的密码
    OSStatus status = SecItemCopyMatching((__bridge CFDictionaryRef)searchQuery, nil);
    if (status == errSecSuccess) {//item 已经存在,更新它
        query = [[NSMutableDictionary alloc] init];
        [query setObject:self.passwordData forKey:(__bridge id)kSecValueData];
        status = SecItemUpdate((__bridge CFDictionaryRef)searchQuery, (__bridge         CFDictionaryRef)query);
    } else if (status == errSecItemNotFound) {//item未找到,创建它
        query = [self query];
        [query setObject:self.passwordData forKey:(__bridge id)kSecValueData];
        status = SecItemAdd((__bridge CFDictionaryRef)query, NULL);
    }
    return (status == errSecSuccess);
}
  • 删除
    删除相对简单,找到了,就删除
 - (BOOL)deleteItem
{
NSMutableDictionary *query = [self query];
OSStatus status = SecItemDelete((__bridge CFDictionaryRef)query);
return (status == errSecSuccess);
}

以上内容都是基础,懂了这些,Keychain相关的其它内容也就不难理解了。以后如果用到,会进一步增加其它复杂的功能。

NJY iOS
Web note ad 1