UICKeyChainStore is a simple wrapper for Keychain on iOS. Makes using Keychain APIs as easy as NSUserDefaults.
Objective-C Ruby
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 211 commits behind kishikawakatsumi:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Lib
Mac
UICKeyChainStore.xcworkspace
iOS
.gitattributes
.gitignore
.travis.yml
LICENSE
README.md
Rakefile
UICKeyChainStore.podspec

README.md

UICKeyChainStore License MIT

Version Platform Build Status Analytics

UICKeyChainStore is a simple wrapper for Keychain on iOS and OS X. Makes using Keychain APIs as easy as NSUserDefaults.

Installation

CocoaPods

pod 'UICKeyChainStore'

Manual Install

  1. Add Security.framework to your target.
  2. Copy files in Lib (UICKeyChainStore.h and UICKeyChainStore.m) to your project.

Usage

Using convienient class methods

Add items using default service name (=bundle identifer).

[UICKeyChainStore setString:@"kishikawakatsumi" forKey:@"username"];
[UICKeyChainStore setString:@"password1234" forKey:@"password"];

//=> ["username" = "kishikawakatsumi", "password" = "password1234"]

Or specify the service name.

[UICKeyChainStore setString:@"kishikawakatsumi" forKey:@"username" service:@"com.kishikawakatsumi"];
[UICKeyChainStore setString:@"password1234" forKey:@"password" service:@"com.kishikawakatsumi"];

Remove items.

[UICKeyChainStore removeItemForKey:@"username" service:@"com.kishikawakatsumi"];
[UICKeyChainStore removeItemForKey:@"password" service:@"com.kishikawakatsumi"];

=====

Using store object, easier to edit multiple items

Instantiate store object with default service name.

UICKeyChainStore *store = [UICKeyChainStore keyChainStore];

Or specify the service name.

UICKeyChainStore *store = [UICKeyChainStore keyChainStoreWithService:@"com.kishikawakatsumi"];

Add items and save.

[store setString:@"kishikawakatsumi@mac.com" forKey:@"username"];
[store setString:@"password1234" forKey:@"password"];

[store synchronize]; // Write to keychain.

Remove items.

[store removeItemForKey:@"username"];
[store removeItemForKey:@"password"];

[store synchronize]; // Write to keychain.

=====

Object Subscripting

UICKeyChainStore *store = [UICKeyChainStore keyChainStoreWithService:@"com.kishikawakatsumi"];
store[@"username"] = @"kishikawakatsumi@mac.com";
store[@"password"] = @"password1234";
[store synchronize];

Debug print

UICKeyChainStore *store = [UICKeyChainStore keyChainStoreWithService:@"com.kishikawakatsumi"];
NSLog(@"%@", store); // Print all keys and values for the service.

Easy as that. (See UICKeyChainStore.h for all of the methods.)

License

UICKeyChainStore is available under the MIT license. See the LICENSE file for more info.