Mercurial > prosody-wiki
annotate mod_block_registrations.wiki @ 510:82c627fc3477
Created wiki page through web user interface.
| author | MWild1@gmail.com |
|---|---|
| date | Mon, 02 Mar 2015 19:53:24 +0000 |
| parents | 26ac8c0e6ecf |
| children |
| rev | line source |
|---|---|
| 358 | 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 || | |
|
431
0bf555b3a3fa
mod_block_registrations: block_registrations_matching, not _patterns
Kim Alvefur <zash@zash.se>
parents:
358
diff
changeset
|
24 || block_registrations_matching || { } || A list of patterns matching reserved usernames (slower than block_registrations_users) || |
| 358 | 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" } | |
| 432 | 31 block_registrations_matching = { |
| 358 | 32 "master$" -- matches 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 || | |
|
431
0bf555b3a3fa
mod_block_registrations: block_registrations_matching, not _patterns
Kim Alvefur <zash@zash.se>
parents:
358
diff
changeset
|
39 || 0.8 || Should work || |