# HG changeset patch # User Matthew Wild # Date 1535576279 -3600 # Node ID 4c3230c22c18194722b9647be5dcd5897a3cd5d2 # Parent 87769f53fdc8b10e294c089dd5ea3c83d06d46e4 mod_register_json: Update README diff -r 87769f53fdc8 -r 4c3230c22c18 mod_register_json/README.markdown --- a/mod_register_json/README.markdown Mon Aug 27 18:14:28 2018 +0200 +++ b/mod_register_json/README.markdown Wed Aug 29 21:57:59 2018 +0100 @@ -24,7 +24,15 @@ Where the encoded content is this (example) JSON Array: - {"username":"usernameofchoice","password":"theuserpassword","ip":"theremoteaddroftheuser","mail":"usermail@usermaildomain.tld","auth\_token":"yourauthtokenofchoice"}\ +``` + { + "username":"john.smith", + "password":"secret-password", + "ip":"192.168.0.0", + "mail":"john.smith@mail.example.net", + "auth_token":"yourauthtokenofchoice" + } +``` Your form implementation needs to pass **all** parameters, the auth\_token is needed to prevent misuses, if the request is successful @@ -63,14 +71,23 @@ Hint: pairing with mod\_register\_redirect is helpful, to allow server registrations only via your webform. + +Required configuration: + +``` + reg_servlet_auth_token = "your-secret-token" +``` + Optional configuration directives: +``` reg_servlet_base = "/base-path/" -- Base path of the plugin (default is register_account) reg_servlet_secure = true -- Have the plugin only process requests on https (default is true) reg_servlet_ttime = seconds -- Specifies the time (in seconds) between each request coming from the same remote address. reg_servlet_bl = { "1.2.3.4", "4.3.2.1" } -- The ip addresses in this list will be blacklisted and will not be able to submit registrations. reg_servlet_wl = { "1.2.3.4", "4.3.2.1" } -- The ip addresses in this list will be ignored by the throttling. reg_servlet_filtered_mails = { ".*banneddomain.tld", ".*deamailprovider.tld" } -- allows filtering of mail addresses via Lua patterns. +``` Compatibility -------------