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.
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.
- libcurl v7.15.4 or later
# layman -a sinustrom # emerge -a oath-uri
To build and install
oath-uri tool and library after extracting sources run:
$ cmake . $ make $ make install
- Webpage and documentation: https://sinustrom.info/projects/oath-uri/
- Source repository: https://github.com/zpuskas/oath-uri
- Issues: https://github.com/zpuskas/oath-uri/issues
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