
Простое сверхбыстрое переиспользуемое приложение Django, которое блокирует попытки брутфорса входа.
Этот проект закрыт и больше не поддерживается. Существующие релизы и документация остаются доступными. См. the retirement issue <https://github.com/jazzband/help/issues/450>_ для оставшейся работы по архивации PyPI.
.. image:: https://jazzband.co/static/img/badge.svg :target: https://jazzband.co/ :alt: Jazzband
.. image:: https://img.shields.io/pypi/pyversions/django-defender.svg :alt: Supported Python versions :target: https://pypi.org/project/django-defender/
.. image:: https://img.shields.io/pypi/djversions/django-defender.svg :target: https://pypi.org/project/django-defender/ :alt: Supported Django versions
.. image:: https://github.com/jazzband/django-defender/workflows/Test/badge.svg :target: https://github.com/jazzband/django-defender/actions :alt: GitHub Actions
.. image:: https://codecov.io/gh/jazzband/django-defender/branch/master/graph/badge.svg :target: https://codecov.io/gh/jazzband/django-defender :alt: Coverage
.. image:: https://readthedocs.org/projects/django-defender/badge/?version=latest :alt: Documentation Status :target: https://django-defender.readthedocs.io/en/latest/?badge=latest
Простое переиспользуемое приложение Django, которое блокирует попытки подбора логина методом перебора. Цель — сделать это как можно быстрее, чтобы мы не замедляли попытки входа.
Мы будем использовать кэш, чтобы не приходилось обращаться к базе данных при каждой попытке входа. Первая версия будет основана на Redis, но цель — сделать это настраиваемым, чтобы люди могли использовать любой бэкенд, который лучше всего подходит для их нужд.
Если вы используете defender на своём сайте, отправьте PR, чтобы добавить себя в список.
Документация доступна на Read the Docs:
https://django-defender.readthedocs.io
Запись всех попыток входа в базу данных
Поддержка обратных прокси с различными заголовками для IP-адресов
Ограничение частоты на основе
Использование Redis для чёрного списка
Конфигурация
Сервер Redis
Длительность блокировки
Количество неверных попыток до блокировки
95% покрытие кода
Полная документация
Возможность сохранять попытки входа в базу данных
Команда управления для очистки таблицы базы данных попыток входа
Страницы администратора
Легко адаптируется к пользовательскому методу аутентификации.
Сигналы отправляются при блокировке имени пользователя или IP
Страницы администратора
.. image:: https://cloud.githubusercontent.com/assets/261601/5950540/8895b570-a729-11e4-9dc3-6b00e46c8043.png :target: https://cloud.githubusercontent.com/assets/261601/5950540/8895b570-a729-11e4-9dc3-6b00e46c8043.png :alt: alt tag
.. image:: https://cloud.githubusercontent.com/assets/261601/5950541/88a35194-a729-11e4-981b-3a55b44ef9d5.png :target: https://cloud.githubusercontent.com/assets/261601/5950541/88a35194-a729-11e4-981b-3a55b44ef9d5.png :alt: alt tag
Скачайте код и запустите установку одним из следующих способов в зависимости от метода.
Чтобы установить готовую к использованию в production версию из PyPI:
.. code-block:: bash
pip install django-defender
Чтобы установить версию для разработки из исходного кода после скачивания:
.. code-block:: bash
python setup.py install
Чтобы установить версию для разработки из ветки master из репозитория GitHub:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
Прежде всего, вы должны добавить этот проект в свой список INSTALLED_APPS в
settings.py
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
Далее установите middleware FailedLoginMiddleware
.. code-block:: python
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'defender.middleware.FailedLoginMiddleware', ]
Если вы хотите управлять заблокированными пользователями через Django admin, добавьте
следующее в ваш urls.py
.. code-block:: python
urlpatterns = [ path('admin/defender/', include('defender.urls')), # defender admin path('admin/', admin.site.urls), # normal admin # your own patterns follow... ]
Миграции
Вам потребуется создать в вашей базе данных таблицы, необходимые для работы.
.. code-block:: bash
python manage.py migrate defender
Команды управления
cleanup_django_defender
Если у вас сайт с большим трафиком, таблица AccessAttempts будет заполняться довольно быстро. Если вам не нужно хранить данные для аудита, есть команда управления, которая поможет поддерживать её в чистоте.
Она будет использовать настройку DEFENDER_ACCESS_ATTEMPT_EXPIRATION, чтобы определить,
какие записи будут удалены. По умолчанию, если не указано иное, — 24 часа.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Вы можете настроить это как ежедневную или еженедельную задачу cron, чтобы сдерживать рост таблицы.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Производительность
Цель defender — быть максимально быстрым, чтобы не замедлять процесс входа. Чтобы убедиться, что наши цели достигнуты, нам нужен способ тестировать приложение и убеждаться, что мы на правильном пути. Лучший способ сделать это — сравнить, насколько быстро проходит обычный вход в Django с defender и django-axes.
Обычный вход в django будет нашей базовой точкой отсчёта, и мы ожидаем, что он будет самым быстрым из трёх методов, поскольку при нём не выполняется никаких дополнительных проверок.
Вход с defender, скорее всего, будет медленнее, чем вход в django, и, надеемся, быстрее, чем вход с django-axes. Цель — сделать разницу между обычным «сырым» входом и defender как можно меньше.
Скорость входа с django-axes, вероятно, будет самой низкой из трёх, поскольку он выполняет больше проверок и делает много запросов к базе данных.
Лучший способ определить скорость входа — провести нагрузочное тестирование приложения с каждой конфигурацией и сравнить время входа для каждого типа.
Нагрузочное тестирование
Чтобы охватить все различные типы входов, в нашем нагрузочном тестировании нужно иметь более одного теста.
#. Все успешные: мы проведём нагрузочное тестирование только с успешными входами.