2019-05-01 13:22:15 +00:00
|
|
|
|
2019-08-30 14:40:21 +00:00
|
|
|
django-axes
|
2013-03-31 12:27:08 +00:00
|
|
|
===========
|
|
|
|
|
|
2016-07-30 14:14:30 +00:00
|
|
|
.. image:: https://jazzband.co/static/img/badge.svg
|
|
|
|
|
:target: https://jazzband.co/
|
|
|
|
|
:alt: Jazzband
|
|
|
|
|
|
2019-01-20 16:36:16 +00:00
|
|
|
.. image:: https://img.shields.io/github/stars/jazzband/django-axes.svg?label=Stars&style=socialcA
|
|
|
|
|
:target: https://github.com/jazzband/django-axes
|
|
|
|
|
:alt: GitHub
|
|
|
|
|
|
2019-01-14 14:43:35 +00:00
|
|
|
.. image:: https://img.shields.io/pypi/v/django-axes.svg
|
|
|
|
|
:target: https://pypi.org/project/django-axes/
|
|
|
|
|
:alt: PyPI release
|
|
|
|
|
|
2021-04-13 16:25:36 +00:00
|
|
|
.. image:: https://img.shields.io/pypi/pyversions/django-axes.svg
|
|
|
|
|
:target: https://pypi.org/project/django-axes/
|
|
|
|
|
:alt: Supported Python versions
|
|
|
|
|
|
|
|
|
|
.. image:: https://img.shields.io/pypi/djversions/django-axes.svg
|
|
|
|
|
:target: https://pypi.org/project/django-axes/
|
|
|
|
|
:alt: Supported Django versions
|
|
|
|
|
|
2019-01-14 14:43:35 +00:00
|
|
|
.. image:: https://img.shields.io/readthedocs/django-axes.svg
|
|
|
|
|
:target: https://django-axes.readthedocs.io/
|
|
|
|
|
:alt: Documentation
|
|
|
|
|
|
2020-11-26 10:31:02 +00:00
|
|
|
.. image:: https://github.com/jazzband/django-axes/workflows/Test/badge.svg
|
|
|
|
|
:target: https://github.com/jazzband/django-axes/actions
|
|
|
|
|
:alt: GitHub Actions
|
2016-07-30 15:50:55 +00:00
|
|
|
|
2018-12-23 15:21:42 +00:00
|
|
|
.. image:: https://codecov.io/gh/jazzband/django-axes/branch/master/graph/badge.svg
|
|
|
|
|
:target: https://codecov.io/gh/jazzband/django-axes
|
|
|
|
|
:alt: Coverage
|
2016-07-30 15:50:55 +00:00
|
|
|
|
2013-03-31 12:27:08 +00:00
|
|
|
|
2020-09-13 13:12:38 +00:00
|
|
|
Axes is a Django plugin for keeping track of suspicious
|
|
|
|
|
login attempts for your Django based website
|
|
|
|
|
and implementing simple brute-force attack blocking.
|
2019-03-02 21:09:31 +00:00
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
The name is sort of a geeky pun, since it can be interpreted as:
|
2008-12-06 10:09:34 +00:00
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
* ``access``, as in monitoring access attempts, or
|
2019-05-01 13:00:08 +00:00
|
|
|
* ``axes``, as in tools you can use to hack (generally on wood).
|
2019-03-02 20:34:58 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Functionality
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Axes records login attempts to your Django powered site and prevents attackers
|
2020-09-13 13:12:38 +00:00
|
|
|
from attempting further logins to your site when they exceed the configured attempt limit.
|
2019-03-02 20:34:58 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
2024-07-01 14:35:43 +00:00
|
|
|
Axes supports cool off periods, IP address allow listing and block listing,
|
|
|
|
|
user account allow listing, and other features for Django access management.
|
2013-11-08 00:08:16 +00:00
|
|
|
|
2008-11-05 22:52:40 +00:00
|
|
|
|
2018-12-25 17:51:33 +00:00
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
|
2019-03-02 21:09:31 +00:00
|
|
|
For more information on installation and configuration see the documentation at:
|
2016-07-30 15:05:13 +00:00
|
|
|
|
|
|
|
|
https://django-axes.readthedocs.io/
|
|
|
|
|
|
2018-12-25 17:51:33 +00:00
|
|
|
|
|
|
|
|
Issues
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
If you have questions or have trouble using the app please file a bug report at:
|
2016-07-30 15:05:13 +00:00
|
|
|
|
|
|
|
|
https://github.com/jazzband/django-axes/issues
|
2018-12-25 17:51:33 +00:00
|
|
|
|
|
|
|
|
|
2023-04-26 18:50:12 +00:00
|
|
|
Contributing
|
2023-04-27 13:47:38 +00:00
|
|
|
------------
|
2018-12-25 17:51:33 +00:00
|
|
|
|
2023-04-26 18:53:37 +00:00
|
|
|
See `CONTRIBUTING <CONTRIBUTING.rst>`__.
|
