Diff

mod_block_registrations/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parent 1782:29f3d6b7ad16
child 2272:65d9093525ca
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_block_registrations/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,44 @@
+Introduction
+============
+
+On a server with public registration it is usually desirable to prevent
+registration of certain "reserved" accounts, such as "admin".
+
+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.
+
+Configuration
+=============
+
+Enable the module as any other:
+
+    modules_enabled = {
+      "block_registrations";
+    }
+
+You can then set some options to configure your desired policy:
+
+  Option                           Default         Description
+  -------------------------------- --------------- -------------------------------------------------------------------------------------------------------------------------------------------------
+  block\_registrations\_users      `{ "admin" }`   A list of reserved usernames
+  block\_registrations\_matching   `{ }`           A list of [Lua patterns](http://www.lua.org/manual/5.1/manual.html#5.4.1) matching reserved usernames (slower than block\_registrations\_users)
+  block\_registrations\_allow      `nil`           A pattern that registered user accounts MUST match to be allowed
+
+Some examples:
+
+    block_registrations_users = { "admin", "root", "xmpp" }
+    block_registrations_matching = {
+      "master$" -- matches anything ending with master: postmaster, hostmaster, webmaster, etc.
+    }
+    block_registrations_allow = "^[a-zA-Z0-9_-.]$" -- Allow only simple ASCII characters in usernames
+
+Compatibility
+=============
+
+  ----- -------------
+  0.9   Works
+  0.8   Should work
+  ----- -------------
+
+