Installation • Usage • Documentation • License • Issues • Pull Requests
Pure Swift implementation of time-based and HMAC-based one-time password generators. Heavily inspired by the OneTimePassword library from @mattrubin. Protocol based design, so you won't find any subclasses here.
THOTP can be installed via Swift Package Manager.
Supported platforms are iOS (13.0+), tvOS (13.0+), watchOS (6.0+), and macOS (10.15+).
The easiest integration is to use the built in package manager tools in Xcode 11.0+. You can also do it manually.
Add the following as a dependency to your Package.swift:
.package(url: "https://github.com/ericlewis/THOTP.git", .upToNextMajor(from: "1.0.0"))After specifying THOTP as a dependency of the target in which you want to use it, run:
swift package updateBy default, this includes basic concrete types for Password & Generators. If you are interested in persistence, there are a couple of options to choose from:
- Implement
PasswordProtocolwith your own concrete type, such asNSManagedObject - Use Valet-THOTP, which adds extensions + a new concrete type for easily persisting using Valet
The simplest usage is to parse a URL. THOTP is compatible with Google Authenticator's URI Scheme.
let password = try? Password(url: URL(string: "otpauth://totp/test?secret=GEZDGNBV")!)
print(password.currentPassword) // 123321Docs are generated with jazzy & can be found here. The process is currently manual, so it's possible for documentation to be out of date. Tests are a great way to see how to use this library.
This library is released under the MIT License. See LICENSE for details.