|
1786
|
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 || |