首页 > 代码库 > keychain
keychain
有用户就用用户名和密码,而现在的应用都少不了一个保存用户名和密码用于自动登录的功能,本文介绍使用iOS自带的Keychain方法保存用户名和密码。
说到保存用户名和密码,以前有用过本地的数据库来保存,也接触过用userdefault来保存,后来在一个项目中发现了一个新的方法——用Keychain来保存。用过mac的人都不会对钥匙串感到陌生,这也是一个钥匙串,比起用数据库或者userdefault什么的来保存,这种方法会更安全一些,而且保存的内容不会随着应用的更新等删除,可以始终保存在沙盒中。这个方法还有一个优势,就是可以让用户名和密码在不同应用之间使用,一次保存,多次使用,这里推测一下,不知道使用第三方登录功能是不是用这个来实现的呢。一般自动登录不外乎对用户名和密码的保存、读取和修改,这里也主要讲这个三个功能的实现。
1、准备工作
要使用Keychain来操作,前期的准备还是有点麻烦的,因为不是直接可以拿来用的,而需要在工程中额外添加一些东西:
1)、导入secutity.framework
第一步需要额外导入一个安全框架,导入方法如下:
先在左侧文件列表中选中项目名称,然后选中TARGETS,中间界面选中Build Phases,在Link Binary With Libraries中点击加号,搜索找到secutity.framework导入即可:
这样就把secutity.framework导入到了我们的工程中来。
2)、添加KeychainItemWrapper.h/.m文件
除了secutity.framework,我们还要添加一个东西到工程中,就是KeychainItemWrapper.h和KeychainItemWrapper.m文件,这两个也需要额外引入才能在我们自己的代码中引用,就当成是引用第三方类库一样吧,这两个文件直接复制进工程里面就好了,可以在我的示例工程中复制。
3)、禁用KeychainItemWrapper.h/.m文件的ARC
现在已经流行ARC机制,我们创建工程也是默认的全局使用ARC,但是这两个文件因为年代久远吧,还不是ARC而是MRC,可以在其代码中看到大量MRC的内容比如release之类的,如果不加修改,直接运行会报很多错误,所以有两个解决办法,第一个把所有报错的地方由MRC方式改成ARC方式,这种方法太麻烦,第二种就是直接禁用这个文件的ARC就好了,方法如下:
先在左侧文件列表中选中项目名称,然后选中TARGETS,中间界面选中Build Phases,然后在Compile Sources中找到要禁用的文件,这里是KeychainItemWrapper.m,然后双击修改其Compiler Flags值为 -fno-objc-arc,如下:
这样再运行就不会出错了。
以上是准备工作,接下来进入代码。
2、使用Keychain保存用户名与密码
一般在应用的登录界面都会有保存用户名和密码的选项,这里我们模拟一下,在界面中放两个输入框用来输入用户名和密码,然后一个登录按钮来实现跳转和保存,界面如下:
把输入框和按钮都关联到我们的ViewController中去,然后在登录按钮的响应方法中实现保存功能,注意,在我们的ViewController中要导入Keychain文件才能正常使用:
- // ViewController.m中
- #import "KeychainItemWrapper.h"
- - (IBAction)login:(id)sender {
- NSString *username = self.usernameLabel.text;// 获取输入的用户名
- NSString *password = self.passwordLabel.text;// 获取输入的密码
- if (![username isEqualToString:@""] && ![password isEqualToString:@""]) {// 非空则保存
- KeychainItemWrapper *keychain = [[KeychainItemWrapper alloc] initWithIdentifier:@"Login" accessGroup:nil];// 1
- [keychain setObject:username forKey:(__bridge id)(kSecAttrAccount)];// 2
- [keychain setObject:password forKey:(__bridge id)(kSecValueData)];// 3
- }
- }
其他的不用多说,主要说说三行Keychain的操作:
1:这里是创建了一个keychain的对象,用来保存用户名和密码,创建的过程中有两个参数,一个是Identifier,这个参数是一个字符串,用来标识keychain,以后都根据这个标识来找到这里保存的内容;第二个是创建组,如果要在多个应用中使用Keychain,就要设置这个参数,是组的标识,这里我们只在本应用使用,就设为nil。Keychain还有很多属性可以设置,这里是最简单的用法,基本可以满足需求,如果想了解更多,可以继续查找资料了解。
2:我们的目的就是保存用户名和密码,Keychain保存非常简单,这一句代码就把用户名保存进去了,Keychain自己带有一些key值,各有各的用处,最常用的就是保存用户名和密码的,一般我们保存用户名就是放在这个Key中就好了。
3:同2一样,一般我们保存密码就是放在这个Key中的。除了这两个以外,还有一些其他的Key,有兴趣的可以继续了解。
这样我们就将用户名和密码保存在Keychain中了,非常简单吧。
3、获取用户名和密码
在一般的思路中,第一次登陆成功后,我们将已经验证正确的用户名和密码保存在keychain里,以后每次打开应用,我们就应该从keychain中获取曾经保存的用户名和密码来通过验证而不需要用户再次输入,对吧,要读取也非常简单,我们先创建一个界面,放两个Label用来在登录后从keychain中获取用户名和密码并显示出来,如下:
其实获取和保存就是两个相反的过程,也就是先通过之前保存时设的标识找到keychain,然后获取对应Key的内容:
- // InfoViewController.m中
- #import "KeychainItemWrapper.h"
- - (void)viewDidLoad {
- [super viewDidLoad];
- // Do any additional setup after loading the view.
- KeychainItemWrapper *keychain = [[KeychainItemWrapper alloc] initWithIdentifier:@"Login" accessGroup:nil];// 通过同样的标志创建keychain
- // 获取对应Key里保存的用户名和密码
- NSString *username = [keychain objectForKey:(__bridge id)(kSecAttrAccount)];
- NSString *password = [keychain objectForKey:(__bridge id)(kSecValueData)];
- // 显示
- self.usernameLabel.text = username;
- self.passwordLabel.text = password;
- }
一目了然,跟保存几乎一样只是设置变成了读取,这样就可以输入什么,显示什么了:
4、修改keychain中的值
一般有用户的应用,都会提供修改密码的功能,如果用户登录后修改了密码,我们总不能要求用户退出登录重新登录一次才能保存密码对吧,另一个情况,如果用户换了一个账号登录,那就是用户名和密码都改了,所以修改keychain中的值也是一个比较常用的功能。我们在界面中加一个新密码的输入框,加一个修改密码的按钮,再加一个显示新密码的Label,如图:
其实修改keychain中的值也特别简单,就跟修改dictionary中的值一样,通过标识找到keychain后,重新set对应Key的值就好了:
- // InfoViewController.m中
- #import "KeychainItemWrapper.h"
- - (IBAction)changePW:(id)sender {
- NSString *nPW = self.nPWText.text;// 获取新密码输入框的值
- if (![nPW isEqualToString:@""]) {// 非空则修改
- KeychainItemWrapper *keychain = [[KeychainItemWrapper alloc] initWithIdentifier:@"Login" accessGroup:nil];// 找到keychain
- [keychain setObject:nPW forKey:(__bridge id)(kSecValueData)];// 设置密码对应Key的值
- //重新读取并显示
- NSString *nPassword = [keychain objectForKey:(__bridge id)(kSecValueData)];
- self.nPWLabel.text = nPassword;
- }
- [self.nPWText resignFirstResponder];// 收起键盘
- }
这样就可以修改了,再次获取的时候就是新设的值了,如下:
Keychain要完全了解,还是比较复杂的,但是最常用的功能,其实也就上面这些了,用起来非常简单方便,以后有机会再详细了解更多的内容吧。
这里可以下载到我的示例工程:https://github.com/Cloudox/KeyChainTest
keychain