LUKeychainAccess

A wrapper for iOS Keychain Services that behaves just like NSUserDefaults.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

135

Maintenance

Last Commit

2yrs ago

Contributors

9

Package

Dependencies

0

License

MIT

Categories

Readme

LUKeychainAccess BuddyBuild

A wrapper for iOS Keychain Services that behaves just like NSUserDefaults.

Usage

Import the following files into your project, then #import the LUKeychainAccess.h file.

  • LUKeychainAccess.h
  • LUKeychainAccess.m

Add Security.framework under "Link Binary With Libraries" in "Build Phases" of your build target.

Use LUKeychainAccess just as you would use NSUserDefaults:

[[LUKeychainAccess standardKeychainAccess] setBool:NO forKey:@"authorized"];
BOOL authorized = [[LUKeychainAccess standardKeychainAccess] boolForKey:@"authorized"];

There are methods for getting and setting BOOL, double, float and NSInteger types, as well as NSString, NSData and generic NSObject objects. You may use any object that can be encoded with NSKeyedArchiver.

Accessibility

Keychain Services has several options for when a keychain item can be readable.

This option can be set in LUKeychainAccess through the accessibilityState parameter. Its possible values match those provided by Apple:

  • LUKeychainAccessAttrAccessibleAfterFirstUnlock
  • LUKeychainAccessAttrAccessibleAfterFirstUnlockThisDeviceOnly
  • LUKeychainAccessAttrAccessibleAlways
  • LUKeychainAccessAttrAccessibleAlwaysThisDeviceOnly
  • LUKeychainAccessAttrAccessibleWhenUnlocked
  • LUKeychainAccessAttrAccessibleWhenUnlockedThisDeviceOnly

The default value is LUKeychainAccessAttrAccessibleWhenUnlocked.

Error Handling

An instance of LUKeychainAccess may be optionally given a error handler, which can be any object that implements the LUKeychainErrorHandler protocol. This error handler will be notified if an error occurs.

Requirements

LUKeychainAccess requires iOS 9.0+. The tests are written using Kiwi.

License

LUKeychainAccess is written by Costa Walcott, and is Copyright 2012-2018 SCVNGR, Inc D.B.A. LevelUp. It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100