by mattrubin

mattrubin / OneTimePassword

πŸ”‘ A small library for generating TOTP and HOTP one-time passwords on iOS.

218 Stars 63 Forks Last release: about 1 year ago (3.2.0) MIT License 1.5K Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


TOTP and HOTP one-time passwords for iOS

Build Status Code Coverage Swift 4.2 or 5.0 Available via Carthage and CocoaPods Platforms: iOS, watchOS MIT License

The OneTimePassword library is the core of Authenticator. It can generate both time-based and counter-based one-time passwords as standardized in RFC 4226 and RFC 6238. It can also read and generate the "otpauth://" URLs commonly used to set up OTP tokens, and can save and load tokens to and from the iOS secure keychain.



Add the following line to your Cartfile:

github "mattrubin/OneTimePassword" ~> 3.2

Then run

carthage update OneTimePassword
to install the latest version of the framework.

Be sure to check the Carthage README file for the latest instructions on adding frameworks to an application.


Add the following line to your Podfile:

pod 'OneTimePassword', '~> 3.2'

OneTimePassword, like all pods written in Swift, can only be integrated as a framework. Make sure to add the line

to your Podfile or target to opt into frameworks instead of static libraries.

Then run

pod install
to install the latest version of the framework.


The latest version of OneTimePassword can be compiled with either Swift 4.2 or Swift 5, and can be linked with Swift 4 or Swift 5 projects using the Swift compiler's compatibility mode. To use OneTimePassword with earlier versions of Swift, check out the

, and
branches. To use OneTimePassword in an Objective-C based project, check out the
and the 1.x releases.

Create a Token


struct contains the parameters necessary to generate a one-time password. The
struct associates a

with a
and an

To initialize a token with an

if let token = Token(url: url) {
    print("Password: \(token.currentPassword)")
} else {
    print("Invalid token URL")

To create a generator and a token from user input:

This example assumes the user provides the secret as a Base32-encoded string. To use the decoding function seen below, add

import Base32
to the top of your Swift file.
let name = "..."
let issuer = "..."
let secretString = "..."

guard let secretData = secretString), !secretData.isEmpty else { print("Invalid secret") return nil }

guard let generator = Generator( factor: .timer(period: 30), secret: secretData, algorithm: .sha1, digits: 6) else { print("Invalid generator parameters") return nil }

let token = Token(name: name, issuer: issuer, generator: generator) return token

Generate a One-Time Password

To generate the current password:

let password = token.currentPassword

To generate the password at a specific point in time:

let time = Date(timeIntervalSince1970: ...)
do {
    let passwordAtTime = try token.generator.password(at: time)
    print("Password at time: \(passwordAtTime)")
} catch {
    print("Cannot generate password for invalid time \(time)")


Token persistence is managed by the

class, which represents the iOS system keychain.

let keychain = Keychain.sharedInstance


struct represents a

that has been saved to the keychain, and associates a
with a keychain-provided data

To save a token to the keychain:

do {
    let persistentToken = try keychain.add(token)
    print("Saved to keychain with identifier: \(persistentToken.identifier)")
} catch {
    print("Keychain error: \(error)")

To retrieve a token from the keychain:

do {
    if let persistentToken = try keychain.persistentToken(withIdentifier: identifier) {
        print("Retrieved token: \(persistentToken.token)")
    // Or...
    let persistentTokens = try keychain.allPersistentTokens()
    print("All tokens: \({ $0.token }))")
} catch {
    print("Keychain error: \(error)")

To update a saved token in the keychain:

do {
    let updatedPersistentToken = try keychain.update(persistentToken, with: token)
    print("Updated token: \(updatedPersistentToken)")
} catch {
    print("Keychain error: \(error)")

To delete a token from the keychain:

do {
    try keychain.delete(persistentToken)
    print("Deleted token.")
} catch {
    print("Keychain error: \(error)")


OneTimePassword was created by Matt Rubin and the OneTimePassword authors and is released under the MIT License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.