mirror of
https://github.com/jazzband/django-axes.git
synced 2026-03-16 22:30:23 +00:00
Keep track of failed login attempts in Django-powered sites.
12a806be28
Add Jazzband as maintainer from 2016 onwards when the project started receiving contributions from Jazzband. Fixes #409 |
||
|---|---|---|
| axes | ||
| docs | ||
| .coveragerc | ||
| .gitignore | ||
| .prospector.yaml | ||
| .pyup.yml | ||
| .travis.yml | ||
| CHANGES.rst | ||
| codecov.yml | ||
| LICENSE | ||
| manage.py | ||
| MANIFEST.in | ||
| mypy.ini | ||
| pytest.ini | ||
| README.rst | ||
| requirements.txt | ||
| setup.py | ||
| tox.ini | ||
Django Axes =========== .. image:: https://jazzband.co/static/img/badge.svg :target: https://jazzband.co/ :alt: Jazzband .. image:: https://img.shields.io/github/stars/jazzband/django-axes.svg?label=Stars&style=socialcA :target: https://github.com/jazzband/django-axes :alt: GitHub .. image:: https://img.shields.io/pypi/v/django-axes.svg :target: https://pypi.org/project/django-axes/ :alt: PyPI release .. image:: https://img.shields.io/readthedocs/django-axes.svg :target: https://django-axes.readthedocs.io/ :alt: Documentation .. image:: https://secure.travis-ci.org/jazzband/django-axes.svg?branch=master :target: http://travis-ci.org/jazzband/django-axes :alt: Build Status .. image:: https://codecov.io/gh/jazzband/django-axes/branch/master/graph/badge.svg :target: https://codecov.io/gh/jazzband/django-axes :alt: Coverage .. image:: https://pyup.io/repos/github/jazzband/django-axes/shield.svg :target: https://pyup.io/repos/github/jazzband/django-axes/ :alt: Updates Axes is a very simple way for you to keep track of failed login attempts for your login and administration views. The name is sort of a geeky pun, since it can be interpreted as: * ``access``, as in monitoring access attempts, or * ``axes``, as in tools you can use hack (generally on wood). In this case, however, the hacking part of it can be taken a bit further: Axes is intended to help you *stop* people from hacking the website. Functionality ------------- Axes records login attempts to your Django powered site and prevents attackers from brute forcing the site when they exceed the configured attempt limit. Axes can track the attempts and persist them in the database indefinitely, or alternatively use a fast and DDoS resistant cache implementation. Axes can be configured to monitor login attempts by IP address, username, user agent, or their combinations. Axes supports cool off periods, IP address whitelisting and blacklisting, user account whitelisting, and other features for Django access management. Documentation ------------- For more information on installation and configuration see the documentation at: https://django-axes.readthedocs.io/ Issues ------ If you have questions or have trouble using the app please file a bug report at: https://github.com/jazzband/django-axes/issues Contributions ------------- This is a `Jazzband <https://jazzband.co>`_ project. By contributing you agree to abide by the `Contributor Code of Conduct <https://jazzband.co/about/conduct>`_ and follow the `guidelines <https://jazzband.co/about/guidelines>`_. It is best to separate proposed changes and PRs into small, distinct patches by type so that they can be merged faster into upstream and released quicker: * features, * bugfixes, * code style improvements, and * documentation improvements.