Latest 1.0.0
License MIT
Platforms ios 8.0, osx 10.10, watchos 2.0, tvos 9.0, requires ARC
Frameworks Security

Carthage compatible


Swift wrapper for working with the Keychain API implemented with Protocol Oriented Programming.

You create an implementation of the KeychainGenericPasswordType protocol that encapsulates the data that you want to store in the Keychain. Most of the implementation is done for you by using default protocol implementations, such as setting the default service name and access mode (kSecAttrAccessibleWhenUnlocked).

Then you call the KeychainItemType methods to save, remove or fetch the item from the provided as argument KeychainServiceType protocol implementation.

SwiftKeychain Protocols

Let’s say we want to store the access token and username for an Instagram account in the Keychain:

struct InstagramAccount: KeychainGenericPasswordType {

    let accountName: String
    let token: String
    var data = [String: AnyObject]()

    var dataToStore: [String: AnyObject] {
        return ["token": token]

    var accessToken: String? {
        return data["token"] as? String

    init(name: String, accessToken: String = "") {
        accountName = name
        token = accessToken

In var dataToStore: [String: AnyObject] you return the Dictionary that you want to be saved in the Keychain and when you fetch the item from the Keychain its data will be populated in your var data: [String: AnyObject] property.

Save Item

let newAccount = InstagramAccount(name: "John", accessToken: "123456")

do {

    try newAccount.saveInKeychain()

} catch {


Note: The provided implementation of the KeychainServiceType protocol will replace the item if it already exists in the Keychain database.

Remove Item

let account = InstagramAccount(name: "John")

do {

    try account.removeFromKeychain()

} catch {


Fetch Item

var account = InstagramAccount(name: "John")

do {

    try account.fetchFromKeychain()

    if let token = account.accessToken {

        print("name: (account.accountName), token: (token)")

} catch {



SwiftKeychain requires Swift 2.0 and XCode 7 and supports iOS, OSX, watchOS and tvOS.


Copy the Keychain/Keychain.swift file to your project.


Add the following line to your Cartfile

github "yankodimitrov/SwiftKeychain" "master"


Add the following line to your Podfile

pod “SwiftKeychain”


SwiftKeychain is released under the MIT license. See the LICENSE.txt file for more info.

Latest podspec

    "name": "SwiftKeychain",
    "version": "1.0.0",
    "summary": "Swift wrapper for working with the Keychain API implemented with Protocol Oriented Programming.",
    "description": "Swift wrapper for working with the Keychain API implemented with Protocol Oriented Programming with support for iOS, OSX, watchOS and tvOS.",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE.txt"
    "authors": {
        "Yanko Dimitrov": "[email protected]"
    "social_media_url": "",
    "platforms": {
        "ios": "8.0",
        "osx": "10.10",
        "watchos": "2.0",
        "tvos": "9.0"
    "source": {
        "git": "",
        "tag": "v1.0.0"
    "source_files": "Keychain/Keychain.swift",
    "frameworks": "Security",
    "requires_arc": true

Pin It on Pinterest

Share This