mod_auth_simple

Authenticate users from a plain text file. Part of the bundled plug-ins.

mod_auth_simple reads registered accounts from a flat text file. It is the simplest way to add a handful of registered users, operators and admins without a database.

Loading

plugin /var/lib/uhub/mod_auth_simple.so "file=/etc/uhub/users.conf"

Configuration

Option	Default	Description
file	—	Path to the accounts file (required).
readonly	yes	The hub never writes back to the file; registration/update/delete are refused.
exclusive	no	When enabled, only accounts listed in this file may log in — any other nick is denied instead of being passed on to the hub's own ACL.

File format

One account per line, whitespace-separated:

credential username password

credential is one of admin, super, op, reg/user or a bot class — the same credential keywords used in the hub's ACL file. For example:

admin alice s3cr3t
op    bob   hunter2
reg   carol passw0rd

For a database-backed store with self-service registration instead, see mod_auth_sqlite.