SwiftyKeychainKit

SwiftyKeychainKit is a simple Swift wrapper for Keychain Services API with the benefits of static typing. Define your keys in one place, use value types easily, and get extra safety and convenient compile-time checks for free.

Features

• Static typing and compile-time checks
• Swift 5 compatible

Usage

Basic

let keychain = Keychain(service: "com.swifty.keychain")
let accessTokenKey = KeychainKey<String>(key: "accessToken")

// Save or modify value
try? keychain.save("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9", for : accessTokenKey)

// Get value 
let value = try keychain.get(accessTokenKey)

// Remove value 
try keychain.remove(accessTokenKey)

// Remove all values 
try keychain.removeAll()

Instantiation

// Generic password
let keychain = Keychain(service: "com.swifty.keychainkit")

// Internet password
let keychain = Keychain(server: URL(string: "https://www.google.com")!, protocolType: .https)

Define keys

For extra convenience, define your keys by extending KeychainKeys class and adding static properties:

extension KeychainKeys {
    static let username = KeychainKey<String>(key: "username")
    static let age = KeychainKey<Int>(key: "age")
}

and later in the code use shortcut dot syntax:

// save
try? keychain.save("John Snow", for: .username)

// get
let username = try keychain.get(.username)

Geting values

You can use subscripts and dynamicCallable syntax sugar to get value as Result<ValueType, KeychainError>

let username = try keychain[.username].get()

// or 

if case .success(let age) = keychain[.age] {
    ...
}

let username = try keychain(.username).get()

// or 

if case .success(let age) = keychain(.age) {
    ...
}

Both subscripts and dynamicCallable syntaxt available only for geting values. Currently Swift language limitation do not allow implement setter with error handling.

Default values

You can provide default value for get method and it will used than keychain key is nil and no error throw.

try keychain.get(.username, default: "Daenerys Targaryen")

// or

try keychain[.age, default: 18].get() 

Supported types

• Int
• String
• Double
• Float
• Bool
• Data

and more:

• Codable
• NSCoding

Supported attributes

Common

• kSecAttrAccessGroup
• kSecAttrAccessible
• kSecAttrDescription
• kSecAttrComment
• kSecAttrCreator
• kSecAttrType
• kSecAttrLabel
• kSecAttrIsInvisible
• kSecAttrIsNegative
• kSecAttrAccount
• kSecAttrSynchronizable

Generic password

• kSecAttrAccessControl
• kSecAttrService
• kSecAttrGeneric

Internet password

• kSecAttrSecurityDomain
• kSecAttrServer
• kSecAttrProtocol
• kSecAttrAuthenticationType
• kSecAttrPort
• kSecAttrPath

Supporting more types

TBD

Requirement

Swift version 5.0

Installation

CocoaPods

pod 'SwiftyKeychainKit', '1.0.0-beta.2'

Swift Package Manager

let package = Package(
    dependencies: [
        .Package(url: "https://github.com/andriyslyusar/SwiftyKeychainKit.git", .exact("1.0.0-beta.2"))
    ]
)

Carthage

github "andriyslyusar/SwiftyKeychainKit" "1.0.0-beta.2"

Acknowledgement

• SwiftyUserDefaults - API design inspiration
• KeychainAccess - API wrapper knowledge source

Author

Andriy Slyusar

• https://twitter.com/andriyslyusar
• https://github.com/andriyslyusar

License

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