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
registration_throttle_max	nil	Defaults to 1 if min_seconds_between_registrations is set, otherwise unset. New in 0.10
registration_throttle_period	nil	Defaults to the same value as min_seconds_between_registrations. New in 0.10
registration_throttle_cache_size	100	How many IP addresses to keep track of for throttling. New in 0.10
blacklist_on_registration_throttle_overload	false	Determines behavior if the above cache overflows. If true and the IP is still over the limit, add it to the registration blacklist. New in 0.10

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
 
    -- 0.10+ example of max 3 registrations per minute
    registration_throttle_max = 3
    registration_throttle_period = 60