Software /
code /
prosody-modules
Comparison
mod_block_registrations/README.wiki @ 1782:29f3d6b7ad16
Import wiki pages
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 24 Aug 2015 16:43:56 +0200 |
comparison
equal
deleted
inserted
replaced
1781:12ac88940fe3 | 1782:29f3d6b7ad16 |
---|---|
1 #summary Prevent registration of user accounts according to policies | |
2 #labels Stage-Beta | |
3 | |
4 = Introduction = | |
5 | |
6 On a server with public registration it is usually desirable to prevent registration of certain "reserved" accounts, such as "admin". | |
7 | |
8 This plugin allows you to reserve individual usernames, or those matching certain patterns. It also allows you to ensure that usernames conform to a certain pattern. | |
9 | |
10 = Configuration = | |
11 | |
12 Enable the module as any other: | |
13 | |
14 {{{ | |
15 modules_enabled = { | |
16 "block_registrations"; | |
17 } | |
18 }}} | |
19 | |
20 You can then set some options to configure your desired policy: | |
21 | |
22 || *Option* || *Default* || *Description* || | |
23 || block_registrations_users || { "admin" } || A list of reserved usernames || | |
24 || block_registrations_matching || { } || A list of [http://www.lua.org/manual/5.1/manual.html#5.4.1 Lua patterns] matching reserved usernames (slower than block_registrations_users) || | |
25 || block_registrations_allow || nil || A pattern that registered user accounts MUST match to be allowed || | |
26 | |
27 Some examples: | |
28 | |
29 {{{ | |
30 block_registrations_users = { "admin", "root", "xmpp" } | |
31 block_registrations_matching = { | |
32 "master$" -- matches anything ending with master: postmaster, hostmaster, webmaster, etc. | |
33 } | |
34 block_registrations_allow = "^[a-zA-Z0-9_-.]$" -- Allow only simple ASCII characters in usernames | |
35 }}} | |
36 | |
37 = Compatibility = | |
38 || 0.9 || Works || | |
39 || 0.8 || Should work || |