|
1782
|
1 #summary provides captcha protection for registration form |
|
|
2 #labels Stage-Beta |
|
|
3 |
|
|
4 = Introduction = |
|
|
5 |
|
|
6 Prosody-captcha is a little modification of prosody's "mod_register.lua" module that provides captcha protection for registration form. |
|
|
7 |
|
|
8 = Installation = |
|
|
9 First of all you should build and install lua bindings for libgd — [https://github.com/ittner/lua-gd/ lua-gd]. |
|
|
10 |
|
|
11 Then clone repsository lua-captcha: |
|
|
12 |
|
|
13 *{{{ $ git clone https://github.com/mrDoctorWho/lua-captcha }}}* |
|
|
14 |
|
|
15 install it: |
|
|
16 |
|
|
17 *{{{ $ make install }}}* |
|
|
18 |
|
|
19 = Configuration = |
|
|
20 |
|
|
21 After that you would configure prosody. This module requires from you 4 fields, you should add this into your VirtualHost entry. |
|
|
22 |
|
|
23 {{{ |
|
|
24 captcha_config = { |
|
|
25 dir = "/tmp"; -- Directory used to storage captcha images. Please make sure prosody user allowed to write there. |
|
|
26 timeout = 60; -- Timeout when captcha will expire |
|
|
27 web_path = "challenge"; -- Web path used to separate main prosody site from itself modules. |
|
|
28 font = "/usr/lib/prosody/FiraSans-Regular.ttf" -- Font used for captcha text |
|
|
29 } |
|
|
30 }}} |
|
|
31 |
|
|
32 You can run script "install.lua" to install this or instead of that while prosody developers didn't accepted "dataforms" changes you should replace standard prosody "dataforms.lua" located in ubuntu in /usr/lib/prosody/util by another one from this repository. You should do the same thing with "mod_register.lua" located in ubuntu in /usr/lib/prosody/modules. |
|
|
33 |
|
|
34 After this all you can try to register on your server and see the captcha. |
|
|
35 |
|
|
36 = TODO = |
|
|
37 * Maybe use recaptcha instead of libgd. |
