====== authgoogle2fa Plugin ======

---- plugin ----
description: Adds Google Authenticator 2FA to DokuWiki plaintext auth.
author     : Daniel Popp
email      : dan@danpopp.net
type       : Auth Plugin
lastupdate : 2014-02-27
compatible : 2014-02-27, Weatherwax, Binky
depends    : 
conflicts  : 
similar    : auth:mOTP
tags       : 2FA, two-factor, Google, two-factor authentication

downloadurl: https://github.com/danpopp/dokuwiki-google-authenticator-twofactor/zipball/master
bugtracker : https://github.com/danpopp/dokuwiki-google-authenticator-twofactor/issues
sourcerepo : https://github.com/danpopp/dokuwiki-google-authenticator-twofactor

screenshot_img : 
----

===== Installation =====
Copy the unzipped folder to your /lib/plugins/ directory, and activate the plugin then set your options in the Admin-->Configuration Settings.

===== Troubleshooting =====

You can revert to the originial auth plugin by editing the file conf/local.php:

  $conf['authtype'] = 'authplain';


===== Configuration and Settings =====
The available settings are as follows:
  * Your Google Authenticator secret.
  * The timeout slack, default is 2 ( 2*30 seconds = 60 seconds ).
  * Whether you want to enable two-factor authentication or not...
  * The URL to your Google Authenticator QR code image (optional).

===== Development =====

Please check GitHub for the latest.

=== Change Log ===

  * **2013-12-25**
    * Initial release

=== Known Bugs and Issues ===

This plugin removes the "Remember Me" checkbox.

=== ToDo/Wish List ===

  * Ability to generate Google Authenticator Secrets and QR codes on the fly.
  * Show the QR code on the configuration settings page.
  * Allow user to custom-configure site name in Google Authenticator (currently defaults to DokuWiki).
===== FAQ =====

Feel free to ask.

===== Discussion =====

None yet :o)