
Une application Django réutilisable simple et super rapide qui bloque les tentatives de connexion par force brute.
Ce projet est retiré et n'est plus maintenu. Les versions existantes et la documentation restent disponibles. Consultez the retirement issue <https://github.com/jazzband/help/issues/450>_ pour les travaux d'archivage restants sur 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: Versions de Python prises en charge :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: Versions de Django prises en charge
.. 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: Couverture
.. image:: https://readthedocs.org/projects/django-defender/badge/?version=latest :alt: État de la documentation :target: https://django-defender.readthedocs.io/en/latest/?badge=latest
Une application Django réutilisable simple qui empêche les tentatives de connexion par force brute. L'objectif est de la rendre aussi rapide que possible, afin de ne pas ralentir les tentatives de connexion.
Nous utiliserons un cache afin de ne pas avoir à interroger la base de données à chaque tentative de connexion. La première version sera basée sur Redis, mais l'objectif est de rendre cela configurable afin que chacun puisse utiliser le backend qui correspond le mieux à ses besoins.
Si vous utilisez defender sur votre site, soumettez une PR pour l'ajouter à la liste.
La documentation est disponible sur Read the Docs :
https://django-defender.readthedocs.io
Journalise toutes les tentatives de connexion dans la base de données
Prise en charge des proxys inverses avec différents en-têtes pour les adresses IP
Limitation du débit basée sur
Utilisation de Redis pour la liste noire
Configuration
Serveur Redis
Durée du blocage
Nombre de tentatives incorrectes avant blocage
Couverture de code de 95 %
Documentation complète
Possibilité de stocker les tentatives de connexion dans la base de données
Commande de gestion pour nettoyer la table des tentatives de connexion
Pages d'administration
Peut être facilement adapté à une méthode d'authentification personnalisée.
Des signaux sont envoyés lors du blocage d'un nom d'utilisateur ou d'une IP
Pages d'administration
.. 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
Téléchargez le code et lancez l'installation de l'une des manières suivantes selon la méthode.
Pour installer la version prête pour la production depuis PyPI :
.. code-block:: bash
pip install django-defender
Pour installer la version de développement depuis le code source après téléchargement :
.. code-block:: bash
python setup.py install
Pour installer la version de développement de la branche master depuis le dépôt GitHub :
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
Tout d'abord, vous devez ajouter ce projet à votre liste INSTALLED_APPS dans
settings.py
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
Ensuite, installez le middleware FailedLoginMiddleware
.. code-block:: python
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'defender.middleware.FailedLoginMiddleware', ]
Si vous souhaitez gérer les utilisateurs bloqués via l'admin Django, ajoutez
ce qui suit à votre 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... ]
Migrations
Vous devrez créer dans votre base de données les tables nécessaires au fonctionnement.
.. code-block:: bash
python manage.py migrate defender
Commandes de gestion
cleanup_django_defender
Si vous avez un site à fort trafic, la table AccessAttempts se remplira assez rapidement. Si vous n'avez pas besoin de conserver les données à des fins d'audit, une commande de gestion vous aide à la garder propre.
Elle consultera votre paramètre DEFENDER_ACCESS_ATTEMPT_EXPIRATION pour déterminer
quels enregistrements seront supprimés. Par défaut, si non spécifié, 24 heures.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Vous pouvez configurer cela comme une tâche cron quotidienne ou hebdomadaire pour limiter la taille de la table.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Performance
L'objectif de defender est d'être aussi rapide que possible afin de ne pas ralentir le processus de connexion. Pour nous assurer que nos objectifs sont atteints, nous avons besoin d'un moyen de tester l'application pour vérifier que nous sommes sur la bonne voie. La meilleure façon de faire est de comparer la vitesse d'une connexion Django normale avec defender et django-axes.
La connexion Django normale serait notre référence, et nous nous attendons à ce qu'elle soit la plus rapide des 3 méthodes, car aucune vérification supplémentaire n'a lieu.
La connexion avec defender sera très probablement plus lente que la connexion Django, et espérons-le plus rapide que la connexion django-axes. L'objectif est de réduire au minimum la différence entre la connexion brute classique et defender.
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.