
Un'app django riutilizzabile semplice e super veloce che blocca le persone dai tentativi di login con forza bruta.
Questo progetto è ritirato e non è più mantenuto. Le release e la documentazione esistenti rimangono disponibili. Vedi the retirement issue <https://github.com/jazzband/help/issues/450>_ per il lavoro di archiviazione rimanente su 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
Una semplice app riutilizzabile per Django che blocca i tentativi di brute forcing del login. L'obiettivo è renderla il più veloce possibile, in modo da non rallentare i tentativi di login.
Utilizzeremo una cache in modo che non sia necessario interrogare il database a ogni tentativo di login. La prima versione sarà basata su Redis, ma l'obiettivo è renderla configurabile affinché le persone possano usare il backend che meglio si adatta alle loro esigenze.
Se utilizzi defender sul tuo sito, invia una PR per aggiungerti alla lista.
La documentazione è disponibile su Read the Docs:
https://django-defender.readthedocs.io
Registra tutti i tentativi di login nel database
Supporto per reverse proxy con header diversi per gli indirizzi IP
Limitazione della frequenza basata su
Utilizza Redis per la blacklist
Configurazione
Server Redis
Durata del blocco
Numero di tentativi errati prima del blocco
Copertura del codice al 95%
Documentazione completa
Possibilità di memorizzare i tentativi di login nel database
Comando di gestione per ripulire la tabella del database dei tentativi di login
Pagine di amministrazione
Può essere facilmente adattato a metodi di autenticazione personalizzati.
Vengono inviati segnali quando si blocca un nome utente o un IP
Pagine di amministrazione
.. 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
Scarica il codice ed esegui il setup in uno dei seguenti modi a seconda del metodo.
Per installare la versione pronta per la produzione da PyPI:
.. code-block:: bash
pip install django-defender
Per installare la versione di sviluppo dal codice sorgente dopo il download:
.. code-block:: bash
python setup.py install
Per installare la versione di sviluppo del branch master dal repository GitHub:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
Prima di tutto, devi aggiungere questo progetto alla tua lista di INSTALLED_APPS in
settings.py
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
Successivamente, installa il middleware FailedLoginMiddleware
.. code-block:: python
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'defender.middleware.FailedLoginMiddleware', ]
Se vuoi gestire gli utenti bloccati tramite l'admin di Django, aggiungi
quanto segue al tuo 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... ]
Migrazioni
Dovrai creare nel tuo database le tabelle necessarie per il funzionamento.
.. code-block:: bash
python manage.py migrate defender
Comandi di gestione
cleanup_django_defender
Se hai un sito web con molto traffico, la tabella AccessAttempts si riempirà abbastanza rapidamente. Se non hai bisogno di conservare i dati per scopi di audit, esiste un comando di gestione che ti aiuta a mantenerla pulita.
Esso consulterà l'impostazione DEFENDER_ACCESS_ATTEMPT_EXPIRATION per determinare
quali record verranno eliminati. Il valore predefinito, se non specificato, è 24 ore.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Puoi impostarlo come cron job giornaliero o settimanale per mantenere ridotte le dimensioni della tabella.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Prestazioni
L'obiettivo di defender è essere il più veloce possibile in modo da non rallentare il processo di login. Per assicurarci di raggiungere i nostri obiettivi abbiamo bisogno di un modo per testare l'applicazione e verificare di essere sulla strada giusta. Il modo migliore per farlo è confrontare quanto è veloce un normale login Django con defender e django-axes.
Il login Django normale sarebbe la nostra baseline, e ci aspettiamo che sia il più veloce dei 3 metodi, perché non vengono eseguiti controlli aggiuntivi.
Il login con defender sarà molto probabilmente più lento del login Django, e si spera più veloce del login con django-axes. L'obiettivo è rendere la differenza tra il login normale grezzo e defender il più piccola possibile.
La velocità del login con django-axes sarà probabilmente la più lenta delle tre, poiché esegue più controlli e molte query al database.
Il modo migliore per determinare la velocità di un login è eseguire un load test contro un'applicazione con ciascuna configurazione, e confrontare i tempi di login per ciascun tipo.
Load testing