Plain Text Authentication Backend

This backend uses a plain text file conf/users.auth.php to store user information and passwords. Passwords are stored encrypted. ¹⁾

This is the default backend.

The backend will be enabled with the configuration option

$conf['authtype'] = "plain";

( this should be in your conf/local.php )

Empty lines, and everything after a # character are ignored. Each line contains a colon separated array of 5 fields which are:

• Login - This has to be a valid pagename
• Password - Encrypted password. The encryption method could be defined through the option passcrypt
• 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

Since conf/users.auth.php is a plain text file, it can be edited with any text editor. For a small PHP command line script that eases the task of adding/changing users, have a look at adduser.php. Further tips on handling the plain auth file can be found here.