captcha_image

git.splent.io/splent-io/splent_feature_captcha_image

v0.3.1 light security

About

An image captcha the product draws itself, with digits read out for whoever cannot see it, no keys and no third party, as the provider of captcha

Provides

Services
ImageCaptchaService
Routes
/captcha/audio/captcha/image
Hooks filled
layout.scripts
Translations
es

Configuration

Setting Default What it does
CAPTCHA_IMAGE_MAX_AGE 600 How long, in seconds, an image can be answered after it was drawn. A form left open longer is refused once and comes back with a new image. It also bounds how long a solved image can be replayed by a client that resends an old session cookie. A value that is not a positive whole number falls back to 600.
CAPTCHA_IMAGE_MAX_IMAGES 300 The forms that ask for an answer are captcha's choice now, CAPTCHA_PROTECTED_FORMS. CAPTCHA_IMAGE_FORMS, which chose them before, is not declared here any more, so no merge writes it again. While a product still sets it, it is read as CAPTCHA_PROTECTED_FORMS with a warning, until the next minor version. How many images one address can have drawn in CAPTCHA_IMAGE_WINDOW_SECONDS, counting the widget's first image, every "New image" and every recording. Past it /captcha/image and /captcha/audio answer 429 and the widget says why. It is far above what a classroom or an office behind one address needs, because a spent budget refuses everyone behind it. 0 turns it off.
CAPTCHA_IMAGE_WINDOW_SECONDS 600 No description yet.
CAPTCHA_IMAGE_ALTERNATIVE audio What the widget offers, next to the image, to a visitor who cannot see it. "audio" reads a few digits out, in English, typed in the same box, from the same budget. It is the weaker check, since a bot can listen too and speech recognition reads digits well (see the README). "none" offers nothing, and shuts out whoever cannot see the image. A word the feature does not know falls back to "audio", and is logged.

These are the defaults. A product changes them in its own pyproject.toml, under [tool.splent.config], or in .env.deploy in production.

Dependencies

Requires

In product lines

  • openhubs_spl In a group Exactly one of the captcha group, when a product takes that group Needs captcha

Extension points

Templates
captcha_image/widget.html
Services
ImageCaptchaService
Routes
A refinement can add routes to its blueprint

Other features fill its hook slots. A refinement can override its templates and services or extend its models without forking it.

Compatibility

Python
>=3.13
SPLENT framework
>=1.30.0
Python packages
captcha==0.7.1