Mercurial > prosody-wiki

annotate mod_captcha_registration.wiki @ 513:5812db271428

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_privilege: better explanations of configuration, typos fixes
author Goffi <goffi@goffi.org>
date Thu, 07 May 2015 23:10:55 +0200
parents 528721aaea46
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
447
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
1 #summary provides captcha protection for registration form
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
2 #labels Stage-Beta
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
3
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
4 = Introduction =
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
5
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
6 Prosody-captcha is a little modification of prosody's "mod_register.lua" module that provides captcha protection for registration form.
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
7
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
8 = Installation =
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
9 First of all you should build and install lua bindings for libgd — [https://github.com/ittner/lua-gd/ lua-gd].
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
10
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
11 Then clone repsository lua-captcha:
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
12
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
13 *{{{ $ git clone https://github.com/mrDoctorWho/lua-captcha }}}*
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
14
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
15 install it:
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
16
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
17 *{{{ $ make install }}}*
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
18
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
19 = Configuration =
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
20
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
21 After that you would configure prosody. This module requires from you 4 fields, you should add this into your VirtualHost entry.
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
22
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
23 {{{
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
24 captcha_config = {
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
25 dir = "/tmp"; -- Directory used to storage captcha images. Please make sure prosody user allowed to write there.
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
26 timeout = 60; -- Timeout when captcha will expire
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
27 web_path = "challenge"; -- Web path used to separate main prosody site from itself modules.
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
28 font = "/usr/lib/prosody/FiraSans-Regular.ttf" -- Font used for captcha text
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
29 }
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
30 }}}
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
31
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
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.
f8ab8f686f93 Created wiki page through web user interface for mod_captcha_registraion
mrDoctorWho@gmail.com
parents:
diff changeset
33
448
d9b3a6f5e959 Edited wiki page mod_captcha_registration through web user interface.
mrDoctorWho@gmail.com
parents: 447
diff changeset
34 After this all you can try to register on your server and see the captcha.
d9b3a6f5e959 Edited wiki page mod_captcha_registration through web user interface.
mrDoctorWho@gmail.com
parents: 447
diff changeset
35
d9b3a6f5e959 Edited wiki page mod_captcha_registration through web user interface.
mrDoctorWho@gmail.com
parents: 447
diff changeset
36 = TODO =
454
528721aaea46 a bunch of pages: strip trailing whitespace
Kim Alvefur <zash@zash.se>
parents: 448
diff changeset
37 * Maybe use recaptcha instead of libgd.