#summary XEP-077 IBR Registration Redirect.
#labels Stage-Stable

= Introduction =

Registration Redirect as explained in the [http://xmpp.org/extensions/xep-0077.html#redirect IBR XEP].

= Details =

This module shows instructions on how to register to the server, should it be necessary to perform it through other means Out-Of-Band or not, and also let's registrations origining from ip addresses in the whitelist to go through normally.

= Usage =

Copy the module file into your Prosody modules directory.

The module will work "out of the box" as long as at least an admin entry is specified (see admins = {} option into prosody's documentation).
These are the optional parameters you can specify into your global server/hostname configuration:
{{{
registration_whitelist = { "*your whitelisted web server ip address*" }
registrarion_url = "*your web registration page url*"
registration_text = "Your custom instructions banner here"
registration_oob = true (default) or false, in the case there's no applicable OOB method (e.g. the server admins needs to be contacted by phone)
}}}

To not employ any whitelisting (i.e. registration is handled externally).
{{{
no_registration_whitelist = true
}}}

= Compatibility =

 * 0.9 works
 * 0.8 works
 * 0.7 might not work
 * 0.6 won't work
 * 0.5 won't work