
تطبيق Django بسيط وسريع جداً وقابل لإعادة الاستخدام يمنع الأشخاص من هجمات القوة الغاشمة على تسجيل الدخول.
هذا المشروع متقاعد ولم يعد يُصان. تظل الإصدارات والتوثيق الحالية متاحة. راجع the retirement issue <https://github.com/jazzband/help/issues/450>_ للاطلاع على أعمال الأرشفة المتبقية على 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
تطبيق Django بسيط قابل لإعادة الاستخدام يمنع الأشخاص من تخمين بيانات تسجيل الدخول بالقوة الغاشمة. الهدف هو جعل هذا الأمر بأسرع شكل ممكن، حتى لا نُبطئ محاولات تسجيل الدخول.
سنستخدم ذاكرة تخزين مؤقت (cache) حتى لا نضطر إلى الوصول إلى قاعدة البيانات في كل مرة للتحقق منها عند كل محاولة تسجيل دخول. ستكون النسخة الأولى مبنية على Redis، لكن الهدف هو جعل هذا قابلاً للتكوين بحيث يمكن للأشخاص استخدام أي خلفية (backend) تناسب احتياجاتهم على أفضل وجه.
إذا كنت تستخدم defender على موقعك، فأرسل PR لإضافته إلى القائمة.
التوثيق متاح على Read the Docs:
https://django-defender.readthedocs.io
تسجيل جميع محاولات تسجيل الدخول في قاعدة البيانات
دعم الوكلاء العكسيين (reverse proxies) برؤوس مختلفة لعناوين IP
تحديد المعدل بناءً على
استخدام Redis للقائمة السوداء
التكوين
خادم Redis
مدة الحظر
عدد المحاولات غير الصحيحة قبل الحظر
تغطية اختبارات بنسبة 95%
توثيق كامل
إمكانية تخزين محاولات تسجيل الدخول في قاعدة البيانات
أمر إداري لتنظيف جدول قاعدة بيانات محاولات تسجيل الدخول
صفحات الإدارة
يمكن تكييفه بسهولة مع طرق مصادقة مخصصة.
تُرسل الإشارات (signals) عند حظر اسم مستخدم أو عنوان 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
نزّل الكود، ثم شغّل الإعداد بإحدى الطرق التالية حسب الطريقة المتبعة.
لتثبيت النسخة الجاهزة للإنتاج من PyPI:
.. code-block:: bash
pip install django-defender
لتثبيت نسخة التطوير من الكود المصدري بعد التنزيل:
.. code-block:: bash
python setup.py install
لتثبيت نسخة التطوير من فرع master من مستودع GitHub:
.. code-block:: bash
pip install -e git+http://github.com/kencochran django-defender.git#egg=django_defender-dev
أولاً وقبل كل شيء، يجب إضافة هذا المشروع إلى قائمة INSTALLED_APPS في
settings.py
.. 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... ]
الترحيلات (Migrations)
ستحتاج إلى إنشاء جداول في قاعدة البيانات الخاصة بك ضرورية للتشغيل.
.. 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 سيكون خط الأساس لدينا، ونتوقع أن يكون الأسرع من بين الطرق الثلاث، لأنه لا تحدث أي فحوصات إضافية.
من المرجح أن يكون تسجيل الدخول عبر defender أبطأ من تسجيل الدخول عبر Django، و نأمل أن يكون أسرع من تسجيل الدخول عبر django-axes. الهدف هو جعل الفرق بين تسجيل الدخول الخام العادي و defender صغيرًا قدر الإمكان.
من المحتمل أن تكون سرعة تسجيل الدخول عبر django-axes هي الأبطأ من بين الثلاثة نظرًا لأنه يقوم بمزيد من الفحوصات وينفذ الكثير من استعلامات قاعدة البيانات.
أفضل طريقة لتحديد سرعة تسجيل الدخول هي إجراء اختبار حمل ضد تطبيق مع كل إعداد، ومقارنة أوقات تسجيل الدخول لكل نوع.
اختبار الحمل
للتأكد من أننا نغطي جميع أنواع تسجيل الدخول المختلفة، في اختبار الحمل لدينا نحتاج إلى أكثر من اختبار واحد.
#. كل النجاح: سنقوم بإجراء اختبار حمل لا يحتوي إلا على عمليات تسجيل دخول ناجحة.
#. مختلط: بعض النجاح وبعض الفشل: سنقوم باختبار الحمل مع بعض عمليات تسجيل الدخول الناجحة وبعض حالات الفشل لمعرفة كيف يؤثر الفشل على الأداء.
#. كل حالات الفشل: سنقوم باختبار الحمل مع جميع عمليات تسجيل الدخول الفاشلة ونرى الفرق في الأداء.
سنحتاج إلى تطبيق نموذجي يمكننا استخدامه لاختبار الحمل، والفرق الوحيد هو التكوين حيث نقوم بتحميل defender أو axes أو لا شيء منهما.
يمكننا استخدام خدمة اختبار حمل مستضافة، أو شيء مثل jmeter. في كلتا الحالتين نحتاج إلى أن نكون متسقين في جميع الاختبارات. إذا استخدمنا jmeter، يجب أن تكون لدينا إعدادات jmeter الخاصة بنا ليتمكن الآخرون من تشغيل الاختبارات بأنفسهم.
نتائج اختبارات الحمل