= OTP login extension =

This package is an extension package to BASE that adds support
for authenticating users using one-time passcodes (OTP). For
example, with the [https://freeotp.github.io/ FreeOTP] smartphone 
app or any other [https://en.wikipedia.org/wiki/Google_Authenticator Google authenticator] 
compatible app.
 

== Documentation ==

 * BASE 3.15 and Java 11 or higher is required.
 * [wiki:net.sf.basedb.otp/install Installation instructions]
 * [wiki:net.sf.basedb.otp/using How to use]


== License ==

[http://www.gnu.org/licenses/agpl-3.0.html GNU Affero General Public License version 3]


== Download ==

|| '''Version''' || '''Revision''' || '''Date'''        || '''Binary (tar.gz)''' || '''BASE Version'''* ||  ||
|| 1.3           || 5562           || August 14, 2019   || [attachment:wiki:net.sf.basedb.otp:base-otp-1.3.tar.gz?format=raw base-otp-1.3.tar.gz] (81 kB) || 3.15 || [query:"group=resolution&milestone=OTP login v1.3&order=priority" changelog] ||
|| 1.2           || 5206           || January 8, 2019   || [attachment:wiki:net.sf.basedb.otp:base-otp-1.2.tar.gz?format=raw base-otp-1.2.tar.gz] (80 kB) || 3.14 || [query:"group=resolution&milestone=OTP login v1.2&order=priority" changelog] ||
|| 1.1           || 4949           || August 29, 2018   || [attachment:wiki:net.sf.basedb.otp:base-otp-1.1.tar.gz?format=raw base-otp-1.1.tar.gz] (79 kB) || 3.13 || [query:"group=resolution&milestone=OTP login v1.1&order=priority" changelog] ||
|| 1.0           || 4938           || August 23, 2018   || [attachment:wiki:net.sf.basedb.otp:base-otp-1.0.tar.gz?format=raw base-otp-1.0.tar.gz] (79 kB) || 3.13 || [query:"group=resolution&milestone=OTP login v1.0&order=priority" changelog] ||


'''*''' In general, each release works with the specified and later BASE versions.

'''Source code''' can be downloaded from the subversion repository. Use the following command to get source code for the 1.3 version:

 `svn co https://baseplugins.thep.lu.se/svn/extensions/net.sf.basedb.otp/tags/1.3 otp-1.3`


The latest development (''maybe unstable; do not use on a production server'') revision can be checked out from the repository using the following command:

 `svn co https://baseplugins.thep.lu.se/svn/extensions/net.sf.basedb.otp/trunk otp-dev`



== Contribute ==

After making modifications to the source code, compose a clear and concise log message to describe those changes and the reasons for them. Then, send an email to the developers list containing your log message and the output of svn diff (from the top of your subversion working copy). If the community members consider your changes acceptable, someone who has commit privileges will add your changes to the public source code tree. Recall that permission to directly commit changes to the repository is granted on merit - if you demonstrate comprehension of subversion, programming competency, and a ''team spirit'', you will likely be awarded that permission.


== Todo ==
[[TicketQuery(status!=closed&component=net.sf.basedb.otp)]]