Learn about DokuWiki
Learn about DokuWiki
This module provides the Two Factor Authentication plugin with the needed functionality to use Yubikeys as a means to provide login OTPs.
This plugin requires configuration prior to being functional. By default it is off and will need to be turned on.
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.
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.
“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.
None at this time. Law of odds says someone will find something broken soon.
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.