Lightweight version of django-simple-captcha for work with django-rest-framework
Project description
Django rest captcha
Lightweight version of django-simple-captcha for work with django-rest-framework.
Features
- speed: used
cache
instead database - safety: union methods for generate key and image. (You can't generate many images for one key)
- easy: only one extended rest api (for generate, refresh image).
Usage
Add RestCaptchaSerializer
to your protected request validator:
from rest_captcha serializer import RestCaptchaSerializer
class HumanOnlyDataSerializer(RestCaptchaSerializer):
pass
This code add to your serializer two required fields (captcha_key, captcha_value):
For provide this fields client(js code) should generate key:
> curl -X POST http:localhost:8000/api/captcha/ | python -m json.tool
{
'image_type': 'image/png',
'image_decode': 'base64',
'captcha_key': 'de67e7f3-72d9-42d8-9677-ea381610363d',
'captcha_value': '... image encoded in base64'
}
captcha_value
- is base64 encoded PNG image, client should decode and show this image to human for validation and send letters from captcha to protected api.
If human have mistake - client should re generate your image.
Note: See also trottling for protect public api
Install
> pip install django-rest-captcha
Add to your settings.py
Add to installed apps:
INSTALLED_APPS = (
...
'rest_captcha',
)
Set rest_captcha settings (if you want), see defaults:
REST_CAPTCHA = {
'CAPTCHA_CACHE': 'default',
'CAPTCHA_TIMEOUT': 300, # 5 minutes
'CAPTCHA_LENGTH': 4,
'CAPTCHA_FONT_SIZE': 22,
'CAPTCHA_IMAGE_SIZE': (90, 40),
'CAPTCHA_LETTER_ROTATION': (-35, 35),
'CAPTCHA_FOREGROUND_COLOR': '#001100',
'CAPTCHA_BACKGROUND_COLOR': '#ffffff',
'CAPTCHA_FONT_PATH': FONT_PATH,
'CAPTCHA_CACHE_KEY': 'rest_captcha_{key}.{version}',
'FILTER_FUNCTION': 'rest_captcha.captcha.filter_default',
'NOISE_FUNCTION': 'rest_captcha.captcha.noise_default'
}
We recommended use redis or memcache. And LocMemCache for local tests with bigger value of MAX_ENTRIES:
CACHES={
'default': {
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
'LOCATION': 'rest-captcha',
'MAX_ENTRIES': 10000,
}
}
Add hooks to your app router (urls.py)
urlpatterns = [
...
url(r'api/captcha/', include('rest_captcha.urls')),
]
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-rest-captcha-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed89f2e3aae1d16e3065326c808d358d251f3704a7167dde616b862bcd54716a |
|
MD5 | 3ecdfab8bc212cb2fea1a48a4b5d3e52 |
|
BLAKE2b-256 | 5e0f267f7e69942d07397dedcf4437ffa0c604f274747650ec6b5ee599984c2c |
Hashes for django_rest_captcha-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d173f45462bf9a7b01cb269fd92f3c4fa7ffece555fbe763b3e47036115ed245 |
|
MD5 | 47c7fc0d284503b1960f86822d76c0bb |
|
BLAKE2b-256 | 7fb6a1de5b1bc438612f8f2405eebc91d3bc25cf61405522cb34c948adf55ed4 |