DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:authplain

Plain Text Authentication Plugin

Compatible with DokuWiki

(bundled)

plugin The default authentication mechanism which uses plain text files

Last updated on
2014-07-01
Provides
Auth
Repository
Source

Tagged with !bundled

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.

plugin/authplain.txt · Last modified: 2015-06-24 23:11 by ach