Table of Contents
Plain Text Authentication Plugin
Compatible with DokuWiki
(bundled)
Needed for authclientcert
Description
This plugin uses a plain text file conf/users.auth.php
to store user information and passwords. Passwords are stored using one way encryption (aka. hashing).
This is the default backend.
Usage
The Auth is used default, when no other authentication plugin is set from the admin screen.
Login as superuser, click “Admin” and choose “Configuration Settings”, go to section “Authentication settings”, setting option “authtype” to authplain
activates this plugin.
Copy the configuration setting to the conf/local.protected.php
file to protect the settings against changes via Config Manager.
Administration of users and its groups is done in the User manager, which is fully supported by this plugin.
Configuration
The backend will be enabled with the authtype configuration option by selecting authplain
.
There are more authentication related settings available.
Storage
File Format
Empty lines, and everything after a #
character are ignored. Each line contains a colon separated array of 5 fields loginname:password:Real Name:e-mail:groups
which are:
- Login name — This has to be a valid pagename
- Password — Encrypted password. The encryption method can be anything accepted by passcrypt option (DokuWiki will autodetect the used encryption)
- Real Name — Real name of the user
- E-Mail — Email address of user
- Groups — Comma separated list of groups a user is member of. The group names must follow the rules of valid pagenames.
To create MD5 hash values from a string you could use the script encode/decode. Due to the much better built-in functions of DokuWiki this script is deprecated and only stored here for nostalgia.
Example:
andi:ece23254502f07722a98aa5b7c70baa6:Andreas Gohr:andi@splitbrain.org:admin,users,upload
Editing
Since conf/users.auth.php
is a plain text file, it can be edited with any text editor.