
Um aplicativo Django reutilizável simples e super rápido que impede tentativas de login por força bruta.
Este projeto está descontinuado e não é mais mantido. As versões e a documentação existentes permanecem disponíveis. Consulte a issue de descontinuação <https://github.com/jazzband/help/issues/450>_ para o trabalho restante de arquivamento no 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
Um aplicativo Django reutilizável simples que impede que pessoas façam ataques de força bruta em tentativas de login. O objetivo é tornar isso o mais rápido possível, para que não atrasemos as tentativas de login.
Usaremos um cache para que não seja necessário acessar o banco de dados a cada tentativa de login. A primeira versão será baseada em Redis, mas o objetivo é tornar isso configurável para que as pessoas possam usar o backend que melhor atenda às suas necessidades.
Se você usa o defender em seu site, envie um PR para adicionar à lista.
A documentação está disponível no Read the Docs:
https://django-defender.readthedocs.io
Registra todas as tentativas de login no banco de dados
Suporte a proxies reversos com diferentes cabeçalhos para endereços IP
Limitação de taxa baseada em
Usa Redis para a lista de bloqueio
Configuração
Servidor Redis
Duração do bloqueio
Número de tentativas incorretas antes do bloqueio
95% de cobertura de código
Documentação completa
Capacidade de armazenar tentativas de login no banco de dados
Comando de gerenciamento para limpar a tabela de banco de dados de tentativas de login
Páginas de administração
Pode ser facilmente adaptado a métodos de autenticação personalizados.
Sinais são enviados ao bloquear nome de usuário ou IP
Páginas de administração
.. 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
Baixe o código e execute a configuração de uma das seguintes formas, dependendo do método.
Para instalar a versão pronta para produção a partir do PyPI:
.. code-block:: bash
pip install django-defender
Para instalar a versão de desenvolvimento a partir do código-fonte após o download:
.. code-block:: bash
python setup.py install
Para instalar a versão de desenvolvimento do branch master a partir do repositório do GitHub:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
Antes de tudo, você deve adicionar este projeto à sua lista de INSTALLED_APPS em
settings.py
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
Em seguida, instale o 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 você quiser gerenciar os usuários bloqueados através do Django admin, então adicione o
seguinte ao seu 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... ]
Migrações
Você precisará criar tabelas no seu banco de dados que são necessárias para a operação.
.. code-block:: bash
python manage.py migrate defender
Comandos de gerenciamento
cleanup_django_defender
Se você tem um site com muito tráfego, a tabela AccessAttempts ficará cheia muito rapidamente. Se você não precisa manter os dados para fins de auditoria existe um comando de gerenciamento para ajudá-lo a mantê-la limpa.
Ele irá consultar a sua configuração DEFENDER_ACCESS_ATTEMPT_EXPIRATION para determinar
quais registros serão excluídos. O padrão, se não especificado, é 24 horas.
.. code-block:: bash
$ python manage.py cleanup_django_defender
Você pode configurar isso como um cron job diário ou semanal para manter o tamanho da tabela reduzido.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
Desempenho
O objetivo do defender é torná-lo o mais rápido possível para que ele não atrase o processo de login. Para garantir que nossos objetivos sejam alcançados, precisamos de uma forma de testar a aplicação para garantir que estamos no caminho certo. A melhor maneira de fazer isso é comparar quão rápido um login normal do Django leva com o defender e o django-axes.
O login normal do django seria nossa linha de base, e esperamos que seja o mais rápido dos 3 métodos, porque não há verificações adicionais acontecendo.
O login do defender provavelmente será mais lento que o login do django, e esperançosamente mais rápido que o login do django-axes. O objetivo é tornar a diferença a menor possível entre o login bruto regular e o defender.
A velocidade de login do django-axes provavelmente será a mais lenta dos três, já que ele faz mais verificações e realiza muitas consultas ao banco de dados.
A melhor maneira de determinar a velocidade de um login é fazer um teste de carga contra uma aplicação com cada configuração, e comparar os tempos de login para cada tipo.
Teste de carga
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.