
Eine einfache, superschnelle, wiederverwendbare Django-App, die Brute-Force-Anmeldeversuche blockiert
Dieses Projekt ist eingestellt und wird nicht mehr gepflegt. Bestehende Releases und Dokumentation bleiben verfügbar. Siehe the retirement issue <https://github.com/jazzband/help/issues/450>_ für die verbleibende PyPI-Archivierungsarbeit.
.. 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
Eine einfache wiederverwendbare Django-App, die Personen daran hindert, Login-Versuche per Brute-Force zu erraten. Das Ziel ist, dies so schnell wie möglich zu machen, damit wir die Login-Versuche nicht verlangsamen.
Wir verwenden einen Cache, damit nicht bei jedem Login-Versuch die Datenbank abgefragt werden muss. Die erste Version basiert auf Redis, aber das Ziel ist, dies konfigurierbar zu machen, damit jeder das Backend verwenden kann, das am besten zu seinen Anforderungen passt.
Wenn Sie defender auf Ihrer Website verwenden, reichen Sie einen PR ein, um die Liste zu ergänzen.
Die Dokumentation ist auf Read the Docs verfügbar:
https://django-defender.readthedocs.io
Alle Login-Versuche in der Datenbank protokollieren
Unterstützung für Reverse-Proxys mit unterschiedlichen Headern für IP-Adressen
Ratenbegrenzung basierend auf
Redis für die Blacklist verwenden
Konfiguration
Redis-Server
Sperrdauer
Anzahl fehlerhafter Versuche vor der Sperre
95 % Codeabdeckung
Vollständige Dokumentation
Möglichkeit, Login-Versuche in der Datenbank zu speichern
Management-Befehl zum Bereinigen der Datenbanktabelle mit Login-Versuchen
Admin-Seiten
Kann leicht an benutzerdefinierte Authentifizierungsmethoden angepasst werden.
Signale werden gesendet, wenn ein Benutzername oder eine IP gesperrt wird
Admin-Seiten
.. 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
Laden Sie den Code herunter und führen Sie die Einrichtung je nach Methode auf eine der folgenden Arten aus.
Um die produktionsreife Version von PyPI zu installieren:
.. code-block:: bash
pip install django-defender
Um die Entwicklungsversion nach dem Download aus dem Quellcode zu installieren:
.. code-block:: bash
python setup.py install
Um die Entwicklungsversion des Master-Branches aus dem GitHub-Repository zu installieren:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
Zunächst müssen Sie dieses Projekt zu Ihrer Liste von INSTALLED_APPS in settings.py hinzufügen
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
Als Nächstes installieren Sie die FailedLoginMiddleware-Middleware
.. code-block:: python
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'defender.middleware.FailedLoginMiddleware', ]
Wenn Sie die blockierten Benutzer über das Django-Admin verwalten möchten, fügen Sie
Folgendes zu Ihrer urls.py hinzu
.. code-block:: python
urlpatterns = [ path('admin/defender/', include('defender.urls')), # defender admin path('admin/', admin.site.urls), # normal admin # your own patterns follow... ]
Migrationen
Sie müssen Tabellen in Ihrer Datenbank erstellen, die für den Betrieb notwendig sind.
.. code-block:: bash
python manage.py migrate defender
Management-Befehle
cleanup_django_defender
Wenn Sie eine Website mit viel Traffic haben, wird die Tabelle AccessAttempts ziemlich schnell voll. Wenn Sie die Daten nicht für Prüfzwecke aufbewahren müssen, gibt es einen Management-Befehl, der Ihnen hilft, sie sauber zu halten.
Er orientiert sich an Ihrer Einstellung DEFENDER_ACCESS_ATTEMPT_EXPIRATION, um zu bestimmen,
welche Datensätze gelöscht werden. Der Standardwert, falls nicht angegeben, ist 24 Stunden.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Sie können dies als täglichen oder wöchentlichen Cron-Job einrichten, um die Tabellengröße gering zu halten.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Leistung
Das Ziel von defender ist es, so schnell wie möglich zu sein, damit der Anmeldevorgang nicht verlangsamt wird. Um sicherzustellen, dass unsere Ziele erreicht werden, brauchen wir eine Möglichkeit, die Anwendung zu testen, um sicherzugehen, dass wir auf dem richtigen Weg sind. Der beste Weg dafür ist, zu vergleichen, wie schnell eine normale Django-Anmeldung mit defender und django-axes abläuft.
Die normale Django-Anmeldung wäre unsere Basislinie, und wir erwarten, dass sie die schnellste der 3 Methoden ist, da keine zusätzlichen Prüfungen stattfinden.
Die defender-Anmeldung wäre höchstwahrscheinlich langsamer als die Django-Anmeldung und hoffentlich schneller als die django-axes-Anmeldung. Das Ziel ist, den Unterschied zwischen der regulären rohen Anmeldung und defender so gering wie möglich zu halten.
Die Geschwindigkeit der django-axes-Anmeldung wird wahrscheinlich die langsamste der drei sein, da sie mehr Prüfungen durchführt und viele Datenbankabfragen ausführt.