author | Kim Alvefur <zash@zash.se> |
Wed, 03 Mar 2021 11:43:38 +0100 | |
changeset 4494 | cf2bdb2aaa57 |
parent 4443 | 6ae1c7b9c58b |
child 4916 | b45c23ce24ba |
permissions | -rw-r--r-- |
1807 | 1 |
--- |
2 |
labels: |
|
3 |
- 'Stage-Alpha' |
|
4 |
summary: A web interface to register user accounts |
|
5 |
... |
|
6 |
||
7 |
Introduction |
|
8 |
------------ |
|
9 |
||
10 |
There are various reasons to prefer web registration instead of |
|
11 |
"in-band" account registration over XMPP. For example the lack of |
|
12 |
CAPTCHA support in clients and servers. |
|
13 |
||
14 |
Details |
|
15 |
------- |
|
16 |
||
17 |
mod\_register\_web has Prosody serve a web page where users can sign up |
|
4443
6ae1c7b9c58b
mod_register_web: Update reCAPTCHA URL
Michel Le Bihan <michel@lebihan.pl>
parents:
2787
diff
changeset
|
18 |
for an account. It implements reCAPTCHA to prevent automated sign-ups |
1807 | 19 |
(from bots, etc.). |
20 |
||
21 |
Configuration |
|
22 |
------------- |
|
23 |
||
24 |
The module is served on Prosody's default HTTP ports at the path |
|
25 |
`/register_web`. More details on configuring HTTP modules in Prosody can |
|
26 |
be found in our [HTTP documentation](http://prosody.im/doc/http). |
|
27 |
||
28 |
To configure the CAPTCHA you need to supply a 'captcha\_options' option: |
|
29 |
||
30 |
captcha_options = { |
|
31 |
recaptcha_private_key = "12345"; |
|
32 |
recaptcha_public_key = "78901"; |
|
33 |
} |
|
34 |
||
4443
6ae1c7b9c58b
mod_register_web: Update reCAPTCHA URL
Michel Le Bihan <michel@lebihan.pl>
parents:
2787
diff
changeset
|
35 |
The keys for reCAPTCHA are available in your reCAPTCHA account, visit |
6ae1c7b9c58b
mod_register_web: Update reCAPTCHA URL
Michel Le Bihan <michel@lebihan.pl>
parents:
2787
diff
changeset
|
36 |
[reCAPTCHA](https://developers.google.com/recaptcha/) for more info. |
1807 | 37 |
|
38 |
If no reCaptcha options are set, a simple built in captcha is used. |
|
39 |
||
2787
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
40 |
Customization |
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
41 |
------------- |
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
42 |
|
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
43 |
Copy the files in mod_register_web/templates/ to a new directory. Edit them, |
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
44 |
and set `register_web_template = "/path/to/your/custom-templates"` in your |
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
45 |
config file. |
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
46 |
|
1807 | 47 |
Compatibility |
48 |
------------- |
|
49 |
||
50 |
----- -------------- |
|
2787
8d1634b71066
mod_register_web: Update README to explain customization
Matthew Wild <mwild1@gmail.com>
parents:
1807
diff
changeset
|
51 |
0.10 Works |
1807 | 52 |
0.9 Works |
53 |
0.8 Doesn't work |
|
54 |
----- -------------- |
|
55 |
||
56 |
Todo |
|
57 |
---- |
|
58 |
||
59 |
Different CAPTCHA implementation support |
|
60 |
||
61 |
Collection of additional data, such as email address |
|
62 |
||
63 |
The module kept simple! |