It's better when it's simple

User Tools

Site Tools


twofactoryubiauth Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin Yubikey OTP support plugin for the Twofactor authentication plugin.

Last updated on

This extension is marked as obsoleted. Therefore it is hidden in the Extension Manager and the extension listing. Furthermore, it is candidate for removal.

Tagged with !obsolete, 2fa, authentication, authenticator, security, two-factor, yubico, yubikey

By Keksbendiger

:!: This plugin is not compatible with the current twofactor plugin.


This module provides the Two Factor Authentication plugin with the needed functionality to use Yubikeys as a means to provide login OTPs.


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

This plugin requires configuration prior to being functional. By default it is off and will need to be turned on.

User Setup

In order to use a Yubikey for authentification, the user will have to setup the wiki and twofactoryubiauth to work together. This can be done through the Two Factor configuration link at the upper right menu.

Once at the Two Factor configuration page, there will be a checkbox to enable use of Yubikey Authentification. If a valid Yubikey OTP is provided, the Yubikey will be paired and the module activated.

Once Yubikey and the wiki are synced, the Public ID of the synced Yubikey can be seen in the 2FA settings screen. The user can also check the “Revoke Yubi Authenticator” option and click “save” to unpair the Yubikey and disable the use of this module. In order to use a Yubikey to authenticate after that, the user will need to pair a new Yubikey.

User Login

At login, the user will supply a Yubikey OTP from the paired Yubikey along with their username and password. If the user has configured other modules for two factor authentication, the token field may be left blank to use those other methods.

Configuration and Settings

“enable” - Turn on or off the use of Yubikey for two factor authentication. Default: off “validationServer” - Adress of the server used to validate the Yubi Password. “clientID” - Yubico Client ID used for the signature. “clientSecret” - Secret used to validate the signature mentioned above, leave empty to disable validation.


There is no additional development planned for this plugin at this time.

Change Log

Known Bugs and Issues

None at this time. Law of odds says someone will find something broken soon.

ToDo/Wish List

None at this time


Feel free to write anything constructive. My hope is that this plugin will provide many admins with useful functionality.

If on a debian system - ensure that php5-gd is installed, otherwise it will just display a blank page instead of the authenticator image.

plugin/twofactoryubiauth.txt · Last modified: 2022-12-07 18:01 by Klap-in

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