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