An open source C/C++ library and command line tool to generate OATH TOTP/HOTP key sharing URI for soft tokens.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
liboathuri
man
oathuri
scripts
.gitignore
AUTHORS
CHANGELOG
CMakeLists.txt
COPYING
README.md

README.md

oath-uri

oath-uri is an open source C/C++ library and command line tool to generate OATH TOTP/HOTP key sharing URI for soft tokens, also known as one-time password authentication applications.

When setting up two-factor authentication a secret must be shared with the user to set up their soft token (typically a smartphone authenticator app). This information is usually delivered via QR codes, which use a special key URI format.

The oathuri command line tool is intended to be used in tandem with qrencode to provide an easy way to generate authenticator application key sharing URIs and associated QR codes. Find out how to use it by reading the oathuri(1) man page.

liboathuri is used under the hood for this and it's also available to be used by your C/C++ software. To learn the API read the oathuri.h(3) man page.

The code is made available in the hopes of making two-factor authentication available to wider audiences in a more user friendly (plus yet another) way and contribute to increasing security across the Internet.

Dependencies

Build time

Run time

Installing

Distros

  • Gentoo
    # layman -a sinustrom
    # emerge -a oath-uri
    

From Source

To build and install oath-uri tool and library after extracting sources run:

$ cmake .
$ make
$ make install

Links

License and Copyright

Copyright (C) 2017-2018 Zoltan Puskas
The library is licensed under GNU LGPLv2.1 or later
The command line tool is licensed under GNU GPLv3 or later