
Una aplicación reutilizable de Django simple y muy rápida que bloquea los intentos de inicio de sesión por fuerza bruta.
Este proyecto está retirado y ya no se mantiene. Las versiones y la documentación existentes siguen disponibles. Consulte the retirement issue <https://github.com/jazzband/help/issues/450>_ para el trabajo restante de archivado en 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 sencilla aplicación reutilizable de Django que bloquea a las personas que intentan forzar el inicio de sesión por fuerza bruta. El objetivo es hacerlo lo más rápido posible, para no ralentizar los intentos de inicio de sesión.
Usaremos una caché para que no tenga que consultar la base de datos en cada intento de inicio de sesión. La primera versión estará basada en Redis, pero el objetivo es hacerlo configurable para que las personas puedan usar el backend que mejor se adapte a sus necesidades.
Si está usando defender en su sitio, envíe un PR para añadirlo a la lista.
La documentación está disponible en Read the Docs:
https://django-defender.readthedocs.io
Registra todos los intentos de inicio de sesión en la base de datos
Compatibilidad con proxies inversos con diferentes cabeceras para direcciones IP
Limitación de tasa basada en
Usa Redis para la lista negra
Configuración
Servidor Redis
Duración del bloqueo
Número de intentos incorrectos antes del bloqueo
95% de cobertura de código
Documentación completa
Capacidad de almacenar los intentos de inicio de sesión en la base de datos
Comando de gestión para limpiar la tabla de la base de datos de intentos de inicio de sesión
Páginas de administración
Se puede adaptar fácilmente a un método de autenticación personalizado.
Se envían señales al bloquear un nombre de usuario o una IP
Páginas de administración
.. 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
Descargue el código y ejecute la instalación de una de las siguientes formas según el método.
Para instalar la versión lista para producción desde PyPI:
.. code-block:: bash
pip install django-defender
Para instalar la versión de desarrollo desde el código fuente tras la descarga:
.. code-block:: bash
python setup.py install
Para instalar la versión de desarrollo de la rama master desde el repositorio de GitHub:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
En primer lugar, debe añadir este proyecto a su lista de INSTALLED_APPS en
settings.py
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
A continuación, instala el 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 quieres gestionar los usuarios bloqueados a través del admin de Django, añade
lo siguiente a tu 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... ]
Migraciones
Necesitarás crear las tablas en tu base de datos que son necesarias para el funcionamiento.
.. code-block:: bash
python manage.py migrate defender
Comandos de gestión
cleanup_django_defender
Si tienes un sitio web con mucho tráfico, la tabla AccessAttempts se llenará bastante rápido. Si no necesitas conservar los datos con fines de auditoría, hay un comando de gestión que te ayudará a mantenerla limpia.
Consultará tu configuración DEFENDER_ACCESS_ATTEMPT_EXPIRATION para determinar
qué registros se eliminarán. Por defecto, si no se especifica, es de 24 horas.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Puedes configurar esto como un cron job diario o semanal para mantener reducido el tamaño de la tabla.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Rendimiento
El objetivo de defender es ser lo más rápido posible para que no ralentice el proceso de inicio de sesión. Para asegurarnos de cumplir nuestros objetivos, necesitamos una forma de probar la aplicación y asegurarnos de que vamos por el buen camino. La mejor forma de hacerlo es comparar la rapidez con la que se realiza un inicio de sesión normal de Django con defender y django-axes.
El inicio de sesión normal de django sería nuestra línea base, y esperamos que sea el más rápido de los 3 métodos, porque no se realizan comprobaciones adicionales.
El inicio de sesión con defender probablemente será más lento que el inicio de sesión de django, y esperemos que más rápido que el inicio de sesión de django-axes. El objetivo es que haya la menor diferencia posible entre el inicio de sesión normal sin procesar y defender.
La velocidad de inicio de sesión de django-axes probablemente será la más lenta de las tres, ya que realiza más comprobaciones y hace muchas consultas a la base de datos.
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.