2013-03-31 12:27:08 +00:00
|
|
|
Django Axes
|
|
|
|
|
===========
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
.. image:: https://img.shields.io/readthedocs/django-axes.svg
|
|
|
|
|
:target: https://django-axes.readthedocs.io/
|
|
|
|
|
:alt: Documentation
|
|
|
|
|
|
2016-10-27 17:13:02 +00:00
|
|
|
.. image:: https://secure.travis-ci.org/jazzband/django-axes.svg?branch=master
|
2016-07-30 15:50:55 +00:00
|
|
|
:target: http://travis-ci.org/jazzband/django-axes
|
|
|
|
|
:alt: Build Status
|
|
|
|
|
|
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
|
|
|
|
2019-01-20 16:36:16 +00:00
|
|
|
.. image:: https://pyup.io/repos/github/jazzband/django-axes/shield.svg
|
|
|
|
|
:target: https://pyup.io/repos/github/jazzband/django-axes/
|
|
|
|
|
:alt: Updates
|
2019-01-14 22:02:03 +00:00
|
|
|
|
2013-03-31 12:27:08 +00:00
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
Axes is a very simple way for you to keep track of failed
|
|
|
|
|
login attempts for your login and administration views.
|
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
|
|
|
|
|
* ``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:
|
2019-03-02 21:09:31 +00:00
|
|
|
Axes is intended to help you *stop* people from hacking the website.
|
2019-03-02 20:34:58 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
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
|
|
|
|
|
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
Contributions
|
|
|
|
|
-------------
|
2018-12-25 17:51:33 +00:00
|
|
|
|
2019-02-10 18:47:41 +00:00
|
|
|
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>`_.
|
|
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
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:
|
2018-12-25 17:51:33 +00:00
|
|
|
|
2019-03-02 20:34:58 +00:00
|
|
|
* features,
|
|
|
|
|
* bugfixes,
|
|
|
|
|
* code style improvements, and
|
|
|
|
|
* documentation improvements.
|
