SSKeychain在iOS中的原理和使用说明

1.keychain的功能

     keychain，中文翻译成钥匙串，可以算作是Apple一切从用户需求出发的一个例子吧。目前手机和电脑早已经不仅仅是打电话和上网这些功能了，个人电脑或者智能手机可以看作是一个人的特征的标识，手机或者电脑中保存了大量用户所独有的数据信息，每个人都应当关注自己信息的保密问题。去年CSDN网站被报到出用明文保存密码，并且被黑客获取，这也提醒着大家需要注意对密码的管理。

     Apple应该很早就意识到了这样的问题，不过keychain项目也是几经波折才发展成现在这个样子。目前keychain的主要功能就是帮助用户安全地记住他的密码，keychain保存的密码文件都是经过加密的，其它人不能直接通过打开keychain的文件获得保存在keychain中的密码。在mac上可以安装钥匙串应用，一般情况下只有用户正确输入了mac系统的用户名和密码才能查看到用户保存在keychain中的密码。

     Apple还提供了使用keychain保存密码的API，如果应用程序使用了keychain API来保存密码，保存密码的结果都可以在钥匙串应用中查看到。Apple自带的浏览器Safari就是用的keychain来保存密码的，当用户在一个网页中输入了用户名和密码之后，Safari会询问用户是否需要记住密码。如果用户选择记住Safari则会采用keychain进行密码的保存，在下次用户再次访问同一个网站的时候，系统会自动进行用户名和密码的填充。同时在钥匙串程序中，可以看到Safari保存的针对特定网页的用户名，在输入了系统登录密码之后可以查看到对应的密码明文。

2.IOS中使用keychain和userdefaults保存数据的对比

     userdefault适合保存一些轻量级的数据，使用userdefault保存的数据加载的时候要快一些，数据以明文的形式保存在.plist文件中，不适合用来保存密码信息。文件的位置是Library/Application Support/iPhone Simulator/模拟器版本/Applications/应用对应的数字/Library/Preference/.plist文件

     keychain采用的是将数据加密之后再保存到本地的，这样对数据而言有更高的安全性，适合保存密码之类的数据。数据保存的目录是Library/Application Support/iPhone Simulator/模拟器版本/Library/Keychains/

3.SSKeychain的使用

     Apple针对keychain也提供了丰富的开发文档说明，包括有Keychain Services Programming Guide：文章中包含了使用mac和ios的keychain开发，首先介绍的是keychain的基本功能和概念，然后还有一个基本的例子介绍了基本的使用keychain API的方法。在文章中还提到了Sample Code：GenericKeyChain，是使用keychain的一个例子。

     对于只需要保存用户名和密码的应用来说，SSKeyChain可能更加适合，它对keychain做了相应的封装，接口相对来说更加简单。文章介绍一个轻量级IOS框架：SSKeyChain中提到了github中的SSKeyChain，并且介绍了相应的使用方法。github下的有相应的源码和简介：SSKeyChain源码。

     按照说明可以将SSKeyChain的类文档加入到xcode里面去，也可以直接进行在线的查看。

4.对SSKeyChain中的password，service，account的理解和使用

     既然说到要用SSKeyChain来保存用户名和密码，那么需要使用到的SSKeyChain的功能应该就包括添加用户名和密码、删除用户名和密码、查询用户名和密码。

     SSKeyChain的方法中涉及到的变量主要有三个，分别如这一小节的标题所示，是password、service、account。password、account分别保存的是密码和用户名信息。service保存的是服务的类型，就是用户名和密码是为什么应用保存的一个标志。比如一个用户可以再不同的论坛中使用相同的用户名和密码，那么service保存的信息分别标识不同的论坛。由于包名通常具有一定的唯一性，通常在程序中可以用包的名称来作为service的标识。

     下面两张图分别展示了测试代码和测试结果。setPassword的功能是保存account、service、password的，accoutsForService是提取对应于特定service的所有accouts，从返回结果可以看出是返回结果是Array类型的，并且Array的每一个元素是以key-value格式保存的数据。如果需要找出特定的用户名的话，需要使用valueForKey@“acct”来定位用户名。（由于在这之前keychain已经保存了一个数据，所以lastObject对应的下标是2.）

     在具体的使用过程中，根据需求，可以用在同一个service中保存多个用户名和密码，在需要提取的时候提取最后一个，或者根据用户名来提取特定密码。也可以在同一个service中只保存一个用户名和密码，在需要保存新的用户名和密码的时候将原来保存的密码删除。

在Xcode中安装SSKeyChain的帮助文档需要以下步骤：

1. 打开菜单 Xcode -> Preferences
2. 选择 Downloads
3. 选择 Documentation
4. 点击底部的加号按钮，并输入以下URL： http://docs.samsoff.es/com.samsoffes.sskeychain.atom
5. 点击”SSKeyChain Documentation”旁边的install按钮。 (如果你看不到它，也没有提示任何错误，请重启Xcode)

确保在Organizer中可选的docset中能够看到SSKeychain。

此外，可以在线查看SSKeychain Documentation。

调试

如果无法保存钥匙串，请使用SSKeychain.h中提供的错误代码，例如：

NSError *error = nil;

NSString *password = [SSKeychainpasswordForService:@"MyService" account:@"samsoffes"error:&error];

if ([error code] == SSKeychainErrorNotFound) {

NSLog(@"Passwordnot found");

}

显然，你对做这个应该很熟悉了。访问钥匙串是件痛苦的事情，你要随时检查它的每个错误和失败。SSKeychain并没有使它（钥匙串）变得更稳定，它仅仅是繁琐的C APIs封装。

示例代码

保存一个UUID字符串到钥匙串：

CFUUIDRef uuid = CFUUIDCreate(NULL);assert(uuid != NULL);CFStringRef uuidStr = CFUUIDCreateString(NULL, uuid);

[SSKeychain setPassword: [NSString stringWithFormat:@"%@", uuidStr]

forService:@"com.yourapp.yourcompany"account:@"user"];

然后，从钥匙串读取UUID：

NSString *retrieveuuid = [SSKeychainpasswordForService:@"com.yourapp.yourcompany"account:@"user"];

注意: setPassword和passwordForSevice方法中的services 和 accounts 参数应该是一致的。