Mercurial > prosody-modules
view mod_captcha_registration/README.md @ 6319:04c3273cb81f
mod_auth_cyrus: Add empty 'profile' table to SASL handler objects
This is for compatibility with Prosody's built-in util.sasl objects.
A SASL profile table usually includes methods supported by the backend, which
can be used by SASL mechanism handlers to perform operations (such as testing
the password). It also optionally contains a 'cb' field with channel binding
method handlers.
The Cyrus backend doesn't support channel binding, and doesn't have the same
concept of auth backend methods (it handles all that internally, and Prosody
has no insight or control over it).
Thus, we create an empty profile which informs Prosody that the SASL handler
does not support any of the auth or channel binding methods. Some features
will not work, but they didn't work anyway. This just makes it explicit.
This fixes a traceback in mod_sasl2_fast, which expected SASL handlers to
always contain a 'profile' field.
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Thu, 04 Sep 2025 10:14:46 +0100 |
| parents | fe081789f7b5 |
| children |
line wrap: on
line source
--- labels: - 'Stage-Beta' summary: provides captcha protection for registration form ... 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](https://github.com/ittner/lua-gd/). Then clone repsository lua-captcha: $ git clone https://github.com/mrDoctorWho/lua-captcha 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.