It's better when it's simple

User Tools

Site Tools


authg2fa Plugin

Compatible with DokuWiki

Hrun, Binky, Ponder Stibbons, Detritus, Elenor Of Tsort, Frusterick Manners

plugin Another Google 2 Factor Authentication Plugin

Last updated on

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to motp, authgoogle2fa

Tagged with !discontinued, 2fa, authentication, authenticator, google, two-factor

:!: 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.

plugin/authg2fa.txt · Last modified: 2023-12-19 18:52 by andyboeh

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