Python 3 "Black Hat Python" सोर्स कोड

जस्टिन सीट्ज़ (Justin Seitz) द्वारा लिखित पुस्तक "Black Hat Python" का सोर्स कोड। इस कोड को पूरी तरह से पायथन 3 में परिवर्तित कर दिया गया है, PEP8 मानकों के अनुरूप पुनः स्वरूपित किया गया है, और डिप्रेकेटेड लाइब्रेरीज़ के कार्यान्वयन से जुड़ी निर्भरता संबंधी समस्याओं को दूर करने के लिए रीफैक्टर किया गया है।

यद्यपि पुस्तक में प्रस्तुत सोर्स कोड में कई अनुकूलन लागू किए जा सकते थे, फिर भी कोड को यथासंभव अपरिवर्तित छोड़ दिया गया है ताकि पाठक अपनी सुविधानुसार ऐसे संशोधन स्वयं लागू कर सके। कोड को अपनी वर्तमान स्थिति में docstrings से लेकर type hinting और exception handling तक, साथ ही context managers जैसी वृद्धियों सहित, गंभीर रीफैक्टरिंग प्रयासों की आवश्यकता है, लेकिन ये समस्याएँ स्वयं पाठक के लिए लाभकारी हो सकती हैं यदि उसका उन्हें लागू करने का इरादा हो। इसमें इंडेंटेशन से उत्पन्न कई बग भी हैं, जिन्हें रनटाइम के दौरान घातक त्रुटियों से बचने के लिए सुधार दिया गया है।

इसी प्रकार का एक रूपांतरण मेरे द्वारा टीजे ओ'कॉनर (TJ O'Connor) की पुस्तक "Violent Python" के सोर्स कोड पर उपलब्ध कराया गया है। यदि आपने अभी तक नहीं देखा है तो इसे यहाँ देखें।

उपयोग

बस एक निर्देशिका (DIR) चुनें जिसमें git clone का उपयोग करके प्रोजेक्ट को क्लोन करना है, उसके लिए एक नया वर्चुअल एनवायरनमेंट या venv बनाएं (अनुशंसित) और pip install का उपयोग करके आवश्यकताएँ स्थापित करें।

user@host:~/DIR$ git clone https://github.com/EONRaider/blackhat-python3
user@host:~/DIR$ python3 -m venv venv
user@host:~/DIR$ source venv/bin/activate
(venv) user@host:~/DIR$ pip install -r requirements.txt

नोट्स

• पुस्तक में प्रस्तुत कुछ लिस्टिंग "no starch press" वेबसाइट से उपलब्ध लेखक के कोड रिपॉजिटरी से गायब थीं और उन्हें उनके संबंधित अध्यायों में जोड़ दिया गया है। पुस्तक में प्रस्तुत कोड से संबंधित करने के लिए फ़ाइलों पर आवश्यकतानुसार एक अधिक सटीक नामकरण परंपरा लागू की गई है।
• इंटरप्रेटर द्वारा चेतावनियाँ उत्पन्न करने वाले छोटे बगों को उनकी विशेषताओं को बदले बिना पूरे कोड में ठीक कर दिया गया है।
• कोड को कार्यशील बनाने के लिए आवश्यक सहायक फ़ाइलों को उनके संबंधित अध्यायों में जोड़ा गया है।
• एक व्यक्तिगत टिप्पणी के रूप में, लेखक के लिए एथिकल हैकिंग कार्यों के लिए आवश्यक त्वरित कार्यान्वयन को खतरे में डाले बिना अधिक स्वच्छ कोड लिखना संभव हो सकता था। उन्होंने ऐसा क्यों नहीं किया, यह अज्ञात कारण है।

रीफैक्टरिंग

सोर्स कोड को सही ढंग से लागू करने और घातक त्रुटियों से बचने के लिए किए गए महत्वपूर्ण बग सुधार:

• chapter02/bh_sshserver.py को test_rsa.key फ़ाइल में निहित RSA कुंजी की आवश्यकता थी, जिसे अब संबंधित निर्देशिका में शामिल किया गया है।
• chapter03/sniffer_ip_header_decode.py और sniffer_with_icmp.py और scanner.py सभी में struct के कार्यान्वयन में समस्याओं के कारण IP पैकेट आकारों की परिभाषा और 32/64-बिट आर्किटेक्चर के बीच पोर्टेबिलिटी में गंभीर समस्याएँ थीं। इन मुद्दों के बारे में अधिक जानकारी Stack Overflow पर इस थ्रेड में देखें।
• chapter03/scanner.py netaddr लाइब्रेरी का उपयोग करता था, जिसे अब बनाए नहीं रखा जाता और यह पायथन 3 के साथ कई असंगतियाँ प्रस्तुत करती है। इस कारण कोड को रीफैक्टर किया गया है और अब यह पायथन के stdlib से ipaddress मॉड्यूल का उपयोग करता है।
• chapter04/arper.py और mail_sniffer.py लाइब्रेरी का उपयोग करते थे, जो पायथन 3 के साथ संगत नहीं है। इस कारण कोड को रीफैक्टर किया गया है और अब यह लाइब्रेरी का उपयोग करता है।

अनुवाद

अन्य भाषाओं में योगदान यहाँ देखे जा सकते हैं:

• बेदिरहान बुदक द्वारा तुर्की में अनुवादित

योगदान

सामान्य समझ की बात के रूप में, पहले एक issue के माध्यम से इस रिपॉजिटरी में किए जाने वाले परिवर्तन पर चर्चा करने का प्रयास करें।

1. सुनिश्चित करें कि आप जो संशोधन प्रस्तुत करना चाहते हैं, वे वास्तव में एक पुल रिक्वेस्ट की ओर ले जाते हैं। एक या दो पंक्तियों का परिवर्तन इसके बजाय एक issue के माध्यम से अनुरोधित किया जाना चाहिए।
2. यदि आवश्यक हो, तो प्रोजेक्ट संरचना में परिवर्तनों के विवरण के साथ README.md फ़ाइल को अद्यतन करें।
3. सुनिश्चित करें कि संशोधनों को शामिल करने वाले कमिट संदेश एक मानक का पालन करते हैं। यदि आप नहीं जानते कि कैसे आगे बढ़ना है, तो यहाँ ऐसा करने के तरीके पर एक बेहतरीन संदर्भ है।
4. आपके अनुरोध की समीक्षा यथाशीघ्र की जाएगी (आमतौर पर 48 घंटों के भीतर)।