mod_register
- Details
- Usage
- Configuration
- Example

mod_register

Enabling this module allows users to register new accounts and change passwords.

Details

mod_register implements XEP-0077. User passwords can be changed even if new user registration is disabled.

Usage

    modules_enabled = {
        -- Other modules
        "register"; -- Enable mod_register
    }

Configuration

Option	Default	Notes
allow_registration	false	Whether to allow registration of new accounts via Jabber clients
registration_blacklist	{ }	List of IP addresses to deny registration
registration_whitelist	{ }	List of IP addresses to allow registration (bypassing all throttling and limits)
whitelist_registration_only	false	Whether to only allow IPs in registration_whitelist to register
min_seconds_between_registrations	nil	The number of seconds a client at a particular IP address must wait before it can register another account

Example

    modules_enabled = {
        -- Other modules
        "register"; -- Enable mod_register
    }
 
    allow_registration = true -- Allow users to register new accounts
    registration_blacklist = { "127.0.0.1", "123.123.123.123" } -- 2 IP addresses blacklisted
    registration_whitelist = { } -- No IP addresses whitelisted
    whitelist_registration_only = false -- Anyone can register apart from blacklisted IP addresses
    min_seconds_between_registrations = 300 -- Clients must wait 5 minutes before they can register another account