
로그인 무차별 대입 공격을 차단하는 간단하고 매우 빠른 Django 재사용 가능 앱
이 프로젝트는 은퇴하여 더 이상 유지 관리되지 않습니다. 기존 릴리스와 문서는 계속 사용할 수 있습니다. 남은 PyPI 아카이브 작업은 the retirement issue <https://github.com/jazzband/help/issues/450>_ 를 참조하세요.
.. 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
로그인 시도 무차별 대입 공격을 차단하는 간단한 Django 재사용 앱입니다. 목표는 로그인 시도를 느리게 만들지 않도록 가능한 한 빠르게 만드는 것입니다.
로그인 시도마다 데이터베이스를 조회할 필요가 없도록 캐시를 사용합니다. 첫 번째 버전은 Redis를 기반으로 하지만, 목표는 각자의 요구에 가장 적합한 백엔드를 사용할 수 있도록 구성 가능하게 만드는 것입니다.
사이트에서 defender를 사용하고 있다면 목록에 추가할 수 있도록 PR을 제출해 주세요.
문서는 Read the Docs에서 확인할 수 있습니다:
https://django-defender.readthedocs.io
모든 로그인 시도를 데이터베이스에 기록
IP 주소에 대해 서로 다른 헤더를 사용하는 리버스 프록시 지원
다음을 기준으로 한 속도 제한
블랙리스트에 Redis 사용
구성
Redis 서버
차단 기간
차단 전 잘못된 시도 횟수
95% 코드 커버리지
전체 문서
로그인 시도를 데이터베이스에 저장하는 기능
로그인 시도 데이터베이스 테이블을 정리하는 관리 명령
관리자 페이지
사용자 정의 인증 방식에 쉽게 적용 가능
사용자 이름 또는 IP 차단 시 시그널 전송
관리자 페이지
.. 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
코드를 다운로드한 후 방법에 따라 다음 중 하나의 방식으로 setup을 실행하세요.
PyPI에서 프로덕션 준비 버전을 설치하려면:
.. code-block:: bash
pip install django-defender
다운로드한 소스 코드에서 개발 버전을 설치하려면:
.. code-block:: bash
python setup.py install
GitHub 저장소에서 master 브랜치 개발 버전을 설치하려면:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
먼저, settings.py 의 INSTALLED_APPS 목록에 이 프로젝트를 추가해야 합니다.
.. code-block:: python
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', # ... 'defender', # ... ]
다음으로 FailedLoginMiddleware 미들웨어를 설치합니다
.. code-block:: python
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'defender.middleware.FailedLoginMiddleware', ]
Django admin을 통해 차단된 사용자를 관리하려면 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... ]
마이그레이션
작동에 필요한 테이블을 데이터베이스에 생성해야 합니다.
.. code-block:: bash
python manage.py migrate defender
관리 명령어
cleanup_django_defender
트래픽이 많은 웹사이트를 운영한다면 AccessAttempts 테이블이 꽤 빠르게 가득 찰 것입니다. 감사 목적으로 데이터를 보관할 필요가 없다면 테이블을 깨끗하게 유지하는 데 도움이 되는 관리 명령어가 있습니다.
이 명령어는 DEFENDER_ACCESS_ATTEMPT_EXPIRATION 설정을 확인하여 어떤 레코드를 삭제할지 결정합니다. 지정하지 않은 경우 기본값은 24시간입니다.
.. code-block:: bash
$ python manage.py cleanup_django_defender
테이블 크기를 줄이기 위해 이를 매일 또는 매주 cron 작업으로 설정할 수 있습니다.
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
성능
defender의 목표는 로그인 프로세스를 느리게 만들지 않도록 가능한 한 빠르게 만드는 것입니다. 목표를 달성했는지 확인하려면 애플리케이션을 테스트할 방법이 필요합니다. 가장 좋은 방법은 일반 Django 로그인이 defender 및 django-axes와 비교하여 얼마나 빠른지 비교하는 것입니다.
일반 Django 로그인이 기준선이 되며, 추가 검사가 수행되지 않으므로 3가지 방법 중 가장 빠를 것으로 예상합니다.
defender 로그인은 Django 로그인보다 느릴 가능성이 높으며, django-axes 로그인보다는 빠르기를 바랍니다. 목표는 일반 순수 로그인과 defender 간의 차이를 최소화하는 것입니다.
django-axes 로그인 속도는 더 많은 검사를 수행하고 많은 데이터베이스 쿼리를 실행하므로 세 가지 중 가장 느릴 것입니다.
로그인 속도를 결정하는 가장 좋은 방법은 각 설정으로 애플리케이션에 대해 부하 테스트를 수행하고 각 유형의 로그인 시간을 비교하는 것입니다.
부하 테스트
부하 테스트에서 모든 다양한 유형의 로그인을 다루기 위해 하나 이상의 테스트가 필요합니다.
#. 모두 성공: 성공적인 로그인만으로 부하 테스트를 수행합니다.
#. 혼합: 일부 성공 일부 실패: 일부 성공적인 로그인과 일부 실패로 부하 테스트를 수행하여 실패가 성능에 미치는 영향을 확인합니다.
#. 모두 실패: 모두 실패하는 로그인으로 부하 테스트를 수행하고 성능 차이를 확인합니다.
부하 테스트에 사용할 샘플 애플리케이션이 필요하며, 유일한 차이점은 defender, axes 또는 어느 것도 로드하지 않는지에 대한 구성입니다.
호스팅 로드 테스팅 서비스를 사용하거나 jmeter 같은 도구를 사용할 수 있습니다. 어느 쪽이든 모든 테스트에서 일관성을 유지해야 합니다. jmeter를 사용한다면, 다른 사람들이 직접 테스트를 실행할 수 있도록 jmeter 설정을 공유해야 합니다.
로드 테스트 결과
결과는 여기에 게시할 예정입니다. 각 테스트를 설명하고, 결과와 몇 가지 차트를 함께 보여드리겠습니다.
django-axes는 훌륭하지만 모든 것을 데이터베이스에 저장하기 때문에 데이터가 많을 때 병목 현상이 발생합니다. 인증 요청이 최대 200-300ms까지 느려집니다. 일부 사이트에서는 큰 문제가 아닐 수 있지만, 다른 사이트에서는 너무 긴 시간입니다.
이 프로젝트는 django-axes의 포크로 시작되었으며, 가능한 한 그들의 코드를 많이 사용하고, 필요 없는 부분은 제거하며, 조회 속도를 높여 로그인을 개선합니다.
#. 누군가 로그인을 시도하면, 먼저 현재 차단되어 있는지 확인합니다. 사용하려는 사용자 이름과 IP 주소를 확인합니다. 차단되어 있으면 5단계로 이동합니다. 차단되어 있지 않으면 2단계로 이동합니다.
#. 차단되어 있지 않으므로, 로그인이 유효한지 확인합니다. 유효하면 6단계로 이동합니다. 유효하지 않으면 3단계로 이동합니다.
#. 로그인 시도가 유효하지 않았습니다. 이 시도의 사용자 이름과 IP 주소를 캐시에 추가합니다. 이로 인해 제한을 초과하면 차단 목록에 추가하고 5단계로 이동합니다. 제한을 초과하지 않으면 4단계로 이동합니다.
#. 로그인이 유효하지 않았지만 제한을 초과하지 않았습니다. 다시 시도할 수 있도록 로그인 화면으로 돌려보냅니다.
#. 사용자가 차단되었습니다: 차단되었음을 알리는 차단 페이지로 보내고, 차단이 해제될 시점의 예상 시간을 알려줍니다.
#. 로그인이 유효합니다. 실패한 모든 로그인 시도를 초기화하고, 목적지로 전달합니다.
Defender는 캐시를 사용하여 실패한 시도를 저장합니다.
캐시 키
카운터:
불리언 (존재하면 차단됨):
django-defender를 약간 커스터마이징할 수 있는 몇 가지 옵션이 있습니다.
이 옵션들은 settings.py 파일에 정의해야 합니다.