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.