It's better when it's simple

User Tools

Site Tools


authg2fa Plugin

Compatible with DokuWiki

  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" unknown
  • 2018-04-22 "Greebo" unknown
  • 2017-02-19 "Frusterick Manners" yes

plugin Another Google 2 Factor Authentication Plugin

Last updated on

:!: This plugin is no longer maintained.


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Copy the unzipped folder to your /lib/plugins directory and activate the plugin. Then, set your options in Admin → Configuration Settings. Don't forget to change the authentication type to authg2fa instead of authplain.

You can revert to authplain by editing your /conf/local.php file:

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


Using the standard DokuWiki settings, users aren't able to change their DokuWiki passwords anymore. They will be always prompted with “Wrong Password”.

A DokuWiki setting can disable password verification on profile update:

$conf['profileconfirm'] = false;

The other problem is periodic rechecking of the user's credentials. By default, DokuWiki tries every 900 seconds to check the password. As there is no current 2FA secret available by that time, the check will fail and the user is logged out. You can increase the Timeout to, e.g. 24h, by settings:

$conf['auth_security_timeout'] = 24*3600;

Configuration and Settings

The available settings are as follows:

  • Enable/Disable G2FA authentication
  • Force G2FA authentication for all users (disallow others)
  • Hint G2FA (notify the user to update his/her profile)

The individual G2FA secrets can be configured in the user's profile and the QR Code displayed. An admin plugin is provided which allows the generation of new secrets. This is not yet feature complete.


The plugin is heavily based on authgoogl2fa, but extended by many features. Feel free to comment and request features below.

You can follow the development on

Change Log


Please use the bug tracker at

it would be nice if the user could test the just created/imported code to be sure that everything is ok. — Finkregh 2014-06-25 12:16

plugin/authg2fa.txt · Last modified: 2020-08-04 22:27 by

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki