
एक सरल, अत्यधिक तेज़ 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
कोड डाउनलोड करें, और विधि के आधार पर निम्नलिखित में से किसी एक तरीके से सेटअप चलाएँ।
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 job के रूप में सेट कर सकते हैं।
.. code-block:: bash
24 0 * * * /usr/bin/python manage.py cleanup_django_defender >> /var/log/django_defender_cleanup.log
प्रदर्शन
defender का लक्ष्य इसे यथासंभव तेज़ बनाना है ताकि यह लॉगिन प्रक्रिया को धीमा न करे। यह सुनिश्चित करने के लिए कि हमारे लक्ष्य पूरे हों, हमें एप्लिकेशन का परीक्षण करने का एक तरीका चाहिए ताकि हम यह सुनिश्चित कर सकें कि हम सही रास्ते पर हैं। ऐसा करने का सबसे अच्छा तरीका यह तुलना करना है कि defender और django-axes के साथ एक सामान्य Django लॉगिन कितनी तेज़ी से होता है।
सामान्य django लॉगिन हमारा बेसलाइन होगा, और हम उम्मीद करते हैं कि यह तीनों विधियों में सबसे तेज़ होगा, क्योंकि इसमें कोई अतिरिक्त जाँच नहीं होती है।
defender लॉगिन संभवतः django लॉगिन से धीमा होगा, और उम्मीद है कि django-axes लॉगिन से तेज़ होगा। लक्ष्य यह है कि नियमित raw लॉगिन और defender के बीच यथासंभव कम अंतर हो।
django-axes लॉगिन की गति संभवतः तीनों में सबसे धीमी होगी क्योंकि यह अधिक जाँच करता है और बहुत सारे डेटाबेस क्वेरी करता है।
लॉगिन की गति निर्धारित करने का सबसे अच्छा तरीका प्रत्येक सेटअप के साथ एक एप्लिकेशन पर लोड टेस्ट करना और प्रत्येक प्रकार के लिए लॉगिन समय की तुलना करना है।
लोड परीक्षण
यह सुनिश्चित करने के लिए कि हम सभी प्रकार के लॉगिन को कवर करें, हमारे लोड टेस्ट में एक से अधिक टेस्ट होने चाहिए।
#. सभी सफल: हम केवल सफल लॉगिन के साथ एक लोड टेस्ट करेंगे।
#. मिश्रित: कुछ सफल कुछ असफल: हम कुछ सफल लॉगिन और कुछ असफलताओं के साथ लोड टेस्ट करेंगे ताकि यह देख सकें कि असफलता प्रदर्शन को कैसे प्रभावित करती है।
#. सभी असफल: हम सभी असफल लॉगिन के साथ लोड टेस्ट करेंगे और प्रदर्शन में अंतर देखेंगे।