|
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. |
