view @ 511:9cf5a22e30a1

allow_unencrypted_plain_auth is not required
date Fri, 03 Apr 2015 00:57:11 +0000
parents 528721aaea46
line wrap: on
line source

#summary provides captcha protection for registration form
#labels Stage-Beta

= Introduction =

Prosody-captcha is a little modification of prosody's "mod_register.lua" module that provides captcha protection for registration form.

= Installation =
First of all you should build and install lua bindings for libgd — [ lua-gd].

Then clone repsository lua-captcha:

*{{{ $ git clone }}}*

install it:

*{{{ $ make install }}}*

= Configuration =

After that you would configure prosody. This module requires from you 4 fields, you should add this into your VirtualHost entry.

captcha_config = {
        dir = "/tmp"; -- Directory used to storage captcha images. Please make sure prosody user allowed to write there.
        timeout = 60; -- Timeout when captcha will expire
        web_path = "challenge"; -- Web path used to separate main prosody site from itself modules.
        font = "/usr/lib/prosody/FiraSans-Regular.ttf" -- Font used for captcha text

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.

After this all you can try to register on your server and see the captcha.

= TODO =
  * Maybe use recaptcha instead of libgd.