README.md 2.4 KB

iOS/Swift helper functions for storing text in Keychain

This is a collection of helper functions for saving text and data in the Keychain. As you probably noticed Apple's keychain API is a bit verbose. This class was designed to provide shorter syntax for accomplishing a simple task: reading/writing text values for specified keys. Tested in iOS 7 and 8.

What's Keychain?

Keychain is a secure storage on iOS device. You can store all kind of sensitive data in it: user passwords, credit card numbers, secret tokens etc. Once stored in Keychain this information is only available to your app, other apps can't see it. Besides that, iOS makes sure this information is kept and processed securely. For example, text stored in Keychain can not be extracted from iPhone backup or from its file system.

Installation

Copy KeychainSwift.swift into your project.

Usage

KeychainSwift.set("hello world", forKey: "my key")

KeychainSwift.get("my key")

KeychainSwift.delete("my key")

KeychainSwift.clear() // delete everything from app's Keychain

In addition to strings one can set/get NSData objects.

KeychainSwift.set(nsDataObject, forKey: "my key")

KeychainSwift.getData("my key")

Advanced options

Keychain item access

Use withAccess attribute to specify when your app needs access to the text in the keychain item. By default the .AccessibleWhenUnlocked option is used. It is recommended to use most restrictive option that is suitable for you app in order provide the best data protection.

KeychainSwift.set("Hello world", forKey: "key 1", withAccess: .AccessibleWhenUnlocked)

You can use .AccessibleAfterFirstUnlock if you need your app to access the keychain item while in the background. It may be needed for the Apple Watch apps.

See the list of all available access options.

Demo app

Sacing and reading text from Keychaing in iOS and Swift

Reference

The code is based on this example: https://gist.github.com/s-aska/e7ad24175fb7b04f78e7

Repository home

https://github.com/exchangegroup/keychain-swift