Skip to main content

Add captcha field for django admin's login page.

Project description


Add captcha field and rsa encryption password field for django admin's login page.


pip install django-admin-safe-login




CAPTCHA_IMAGE_SIZE = (100, 30)  # required
DJANGO_ADMIN_SAFE_LOGIN_ENABLE_CAPTCHA = True # optional, default to True
DJANGO_ADMIN_SAFE_LOGIN_BACKGROUND_IMAGE = "django-admin-safe-login/img/example-background.jpg"  # optional, default to no-image.
DJANGO_ADMIN_SAFE_LOGIN_BOX_MARGIN_RIGHT = "200px" # optional, default to auto
DJANGO_ADMIN_SAFE_LOGIN_BOX_MARGIN_LEFT = "auto" # optional, default to auto
DJANGO_ADMIN_SAFE_LOGIN_BOX_MARGIN_TOP = "100px" # optional, default to auto
DJANGO_ADMIN_SAFE_LOGIN_BOX_MARGIN_BOTTOM = "100px" # optional, default to auto
DJANGO_ADMIN_SAFE_LOGIN_TEMPLATE = "" # optional, default to "admin/login.html".


  1. Insert django_static_jquery3, django_secure_password_input, django-simple-tags, captcha and django_admin_safe_login into INSTALLED_APPS.
  2. Application django_static_jquery3 provides static jquery.js.
  3. Application django_secure_password_input provides rsa encryption and decryption function for password field.
  4. Application django_admin_safe_login provides all functions about safe login.
  5. Application captcha provides image captcha functions.
  6. Application django-simple-tags provides custom template tags used in our admin/login.html.
  7. Configuration item CAPTCHA_IMAGE_SIZE is required, and must set to (100, 30) so that it will not break the display style. If you want other size image, you have to rewrite some css code.
  8. Configurations about password RSA encryption, see details at
  9. Configurations about captcha, see detail at
  10. Configurations about password reset, see detail at (search: Adding a password reset feature).


from django.urls import path
from django.urls import include
from django.contrib.auth import views as auth_views

urlpatterns = [
    path('captcha/', include("captcha.urls")),


  1. Include captcha.urls is required so that the captcha image can be displayed.
  2. Reset Password Link only shows when you enabled admin_password_reset views in your urls.

Changes about admin/login.html

We have override some part of admin/login.html. But the admin/login.html content may change in future releases. So you should known what part is overrided.

  1. Our new admin/login.html extends from system's admin/login.html.
  2. We override the extrastyle block to add extra js and css.
  3. The function adding background image and changing login box position is implemented in our new extrastyle block.
  4. We override the whole content block.
  5. We copied the whole content block from django's default admin/login.html.
  6. We added blocks inside content block: form, form-row-username, from-row-password, form-row-extra, form-row-captcha, password-reset-url, before-submit-row, submit-row, after-submit-row.


Release Time Changes Notice
v0.1.0 2020/03/06 1. First release.
v0.2.0 2020/03/07 2. Add rsa encryption and decrption functions for password field.
3. Fix requirements.txt missing django-static-jquery3 problem.
v0.3.0 2020/05/20 4. Add background image setting.
5. Add login box position setting.
6. Use admin/login.html override instead of creating a new template.
7. Fix document.
8. Fix translation.
9. Fix problem that include demo and example code in the final package.
v0.3.1 2020/09/01 10. Rename zh_Hans to zh_hans.
11. Depends on django-static-jquery3>=5.0.0.
v0.3.2 2020/09/01 12. Depends on django-secure-password-input>=0.1.1.
v0.3.3 2020/09/24 13. Add app_requires.
14. Add License file.
v0.3.4 2021/04/12 15. Test with django 3.2.
16. Auto get captcha refresh url.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-admin-safe-login, version 0.3.4
Filename, size File type Python version Upload date Hashes
Filename, size django-admin-safe-login-0.3.4.tar.gz (7.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page