KillerBee

KillerBee एक ढांचा और उपकरण है जो ZigBee और IEEE 802.15.4 नेटवर्कों के परीक्षण और ऑडिटिंग के लिए है।

सूचना

• usb0.x समर्थन को हटाया/निष्क्रिय किया जा रहा है
• Apimote v1 समर्थन को हटाया/निष्क्रिय किया जा रहा है

यदि आपको इन सुविधाओं की आवश्यकता है, तो कृपया अपनी उपयोग स्थिति और आवश्यकताओं को समझाने के लिए एक मुद्दा बनाएँ।

KillerBee 3.0.0-beta अद्यतन

सभी को नमस्कार, KillerBee में आपके निरंतर समर्थन और रुचि के लिए धन्यवाद।

जैसा कि हम कोड को साफ करने, Python 3 में स्थानांतरित करने, सुविधाएँ, कार्यक्षमता और स्थिरता जोड़ने के लिए नए प्रयास कर रहे हैं, हम इस ओवरहाल का उपयोग परियोजना के लक्ष्यों और उपयोगों पर पुनर्विचार करने और उन्हें प्राप्त करने के सर्वोत्तम तरीके के अवसर के रूप में कर रहे हैं।

यह प्रयास एक प्रमुख संस्करण अद्यतन का परिणाम देगा क्योंकि हम पुराने कार्यों और निर्भरताओं को हटा रहे हैं और सुविधाओं को व्यवस्थित करने और कार्यक्षमता को विस्तारित करने में सक्षम बनाने के लिए कोड का पुनर्गठन कर रहे हैं।

यह KillerBee को बनाने वाले भागों को परिभाषित करने का भी एक प्रयास है, जिसका उद्देश्य KillerBee में सुविधाओं के चारों ओर अधिक स्पष्ट रेखाएँ खींचना और इसे एक पुस्तकालय के रूप में मानना है। इस और भविष्य के लक्ष्यों के बारे में विवरण के लिए ARCHITECTURE.md देखें।

MAINTAINERS/LICENSE

BSD लाइसेंस के तहत वितरित, विवरण के लिए LICENSE.txt देखें। सर्वाधिकार सुरक्षित।

मुख्य टूलकिट निम्नलिखित द्वारा लिखा गया/है:

• 2009, Joshua Wright [email protected]
• 2010-2019, Ryan Speers [email protected]
• 2010-2011, Ricky Melgares [email protected]

हम ढांचे में कई योगदानकर्ताओं की सराहना करते हैं, जिनमें निम्नलिखित शामिल हैं जिन्होंने क्षमताएँ प्रदान की हैं:

• गुमनाम योगदानकर्ता
• Spencer McIntyre (scapy विस्तार)
• Bryan Halfpap [email protected] (अतिरिक्त उपकरण)
• Travis Goodspeed
• Mike Kershaw (dragorn)
• Chris Wang (aikiba)
• Nick DePetrillo
• Ed Skoudis
• Matt Carpenter
• Sergey Bratus (डार्टमाउथ में अनुसंधान सहायता)
• Jeff Spielberg
• Scytmo (बग फिक्स और CC2530/1 EMK बोर्ड समर्थन)
• Adam Laurie/rfidiot (APS क्रिप्टो कार्यान्वयन, फर्मवेयर, DFU और BOOTLOADER, SubGHZ, SiLabs NodeTest)
• Steve Martin
• Taylor Centers [email protected] (Python 3 पोर्ट)
• SecureAB (Python 3)
• Jan Rude (Python 3, Sewio)
• Damien Cauquil (CC2531 BumbleBee)

REQUIREMENTS

KillerBee को Linux सिस्टम पर विकसित और परीक्षण किया गया है। MacOS का उपयोग संभव है लेकिन समर्थित नहीं है।

हमने न्यूनतम सॉफ्टवेयर निर्भरताओं का उपयोग करने का प्रयास किया है, हालांकि, स्थापना से पहले निम्नलिखित Python मॉड्यूल स्थापित करना आवश्यक है। स्थापना आवश्यकताओं का पता लगाएगी और आपको संकेत देगी कि क्या आवश्यक है।

Ubuntu सिस्टम पर, आप निम्नलिखित कमांड के साथ आवश्यक निर्भरताएँ स्थापित कर सकते हैं:

# apt-get install python-usb python-crypto python-serial python-dev libgcrypt-dev

Mac OS पर, आप निम्नलिखित कमांड के साथ निर्भरताएँ स्थापित कर सकते हैं

# brew install libusb libgcrypt
# pip3 install pyusb scapy

Scapy विस्तार पैच के लिए python-dev और libgcrypt की आवश्यकता है।

यह भी ध्यान दें कि यह एक काफी उन्नत और मैत्रीपूर्ण आक्रमण मंच है। यह Cain & Abel नहीं है। यह डेवलपर्स और उन्नत विश्लेषकों के लिए है जो ZigBee और IEEE 802.15.4 नेटवर्कों पर आक्रमण कर रहे हैं। मैं अनुशंसा करता हूँ कि आप ZigBee प्रोटोकॉल की कुछ समझ प्राप्त करें (पुस्तक ZigBee Wireless Networks and Transceivers by Shahin Farahani उचित है, हालांकि अभी भी महान नहीं है) और इस ढांचे में गहराई से जाने से पहले Python भाषा से परिचित हों।

INSTALLATION

KillerBee मानक Python 'setup.py' स्थापना फ़ाइल का उपयोग करता है, एक बार निर्भरताएँ स्थापित हो जाने के बाद।

KillerBee को निम्नलिखित कमांड से स्थापित करें:

# python3 setup.py install

DIRECTORIES

KillerBee कोड के लिए निर्देशिका संरचना निम्नानुसार वर्णित है:

• doc - KillerBee लाइब्रेरी पर HTML दस्तावेज़, epydoc की सौजन्य से।
• firmware - समर्थित KillerBee हार्डवेयर उपकरणों के लिए फर्मवेयर।
• killerbee - Python लाइब्रेरी स्रोत।
• sample - नमूना पैकेट कैप्चर, नीचे संदर्भित।
• scripts - विकास में उपयोग की जाने वाली शेल स्क्रिप्ट।
• tools - इस ढांचे का उपयोग करके विकसित ZigBee और IEEE 802.15.4 आक्रमण उपकरण।

REQUIRED HARDWARE

KillerBee ढांचे को कई उपकरणों का समर्थन करने के लिए विस्तारित किया जा रहा है। वर्तमान में River Loop ApiMote, Atmel RZ RAVEN USB Stick, MoteIV Tmote Sky, TelosB mote, Sewino Sniffer, और Silicon Labs Node Test फर्मवेयर चलाने वाले विभिन्न हार्डवेयर के लिए समर्थन है।

हार्डवेयर समर्थन और फर्मवेयर प्रोग्रामिंग के विवरण के लिए firmware/README.md देखें।

Freaklab के Freakduino का समर्थन जोड़े गए हार्डवेयर और डार्टमाउथ arduino स्केच के साथ और Zigduino बोर्ड उपलब्ध हैं लेकिन सूचीबद्ध नहीं हैं क्योंकि वे अनुरक्षित नहीं हैं। आपको इन्हें killerbee/config.py में खोजने के लिए सक्षम करना होगा और फिर KillerBee को पुनः स्थापित करना होगा।

TOOLS

KillerBee में ZigBee और IEEE 802.15.4 नेटवर्कों पर आक्रमण करने के लिए डिज़ाइन किए गए कई उपकरण शामिल हैं, जो KillerBee ढांचे का उपयोग करके बनाए गए हैं। प्रत्येक उपकरण के अपने उपयोग निर्देश हैं जो उपकरण को "-h" तर्क के साथ चलाकर दस्तावेज़ीकृत हैं, और नीचे संक्षेप में दिए गए हैं।

• zbid - KillerBee और संबंधित उपकरणों द्वारा उपयोग किए जा सकने वाले उपलब्ध इंटरफ़ेस की पहचान करता है।
• zbwireshark - zbdump के समान लेकिन वास्तविक समय कैप्चर और Wireshark में देखने के लिए एक नामित पाइप प्रदान करता है।
• zbdump - IEEE 802.15.4 फ्रेम को libpcap या Daintree SNA पैकेट कैप्चर फ़ाइल में कैप्चर करने के लिए tcpdump जैसा उपकरण। फ़ाइल में लिखते समय tcpdump जैसे वास्तविक समय के आँकड़े प्रदर्शित नहीं करता है।
• zbreplay - एक रीप्ले आक्रमण लागू करता है, निर्दिष्ट Daintree DCF या libpcap पैकेट कैप्चर फ़ाइल से पढ़ता है, और फ्रेम को पुनः प्रेषित करता है। ACK फ्रेम पुनः प्रेषित नहीं किए जाते हैं।
• zbstumbler - सक्रिय ZigBee और IEEE 802.15.4 नेटवर्क खोज उपकरण। Zbstumbler चैनल हॉपिंग करते हुए बीकन अनुरोध फ्रेम भेजता है, और खोजे गए उपकरणों के बारे में संक्षिप्त जानकारी रिकॉर्ड और प्रदर्शित करता है। परिणामों को CSV फ़ाइल में भी लॉग कर सकता है।
• zbpanidconflictflood - दो killerbee इंटरफ़ेस की आवश्यकता है एक killerbee इंटरफ़ेस पैकेट सुनता है और उनके PAN ID को चिह्नित करता है। दूसरा इंटरफ़ेस लगातार पाए गए PAN ID के साथ बीकन पैकेट भेजता है। समान PAN ID वाले बीकन पैकेट PAN समन्वयक को विश्वास दिलाते हैं कि PAN ID विरोध है, और समन्वयक नेटवर्क को नए PAN ID पर पुनः संरेखित करने की प्रक्रिया शुरू करता है। यह प्रक्रिया बार-बार दोहराई जाती है। आमतौर पर, नेटवर्क उपकरण तेजी से बदलाव के साथ नहीं रह सकते और कुछ सेकंड के बाद नेटवर्क टूट जाता है। कोई लक्ष्यीकरण निर्मित नहीं है: यह उस चैनल पर सभी zigbee नेटवर्कों को नष्ट कर सकता है जिस पर आप आक्रमण कर रहे हैं। सावधानी से उपयोग करें।
• zborphannotify - लक्ष्य उपकरण से एक अनाथ अधिसूचना पैकेट को PAN समन्वयक को जाली बनाकर समन्वयक व्यवहार का परीक्षण करता है।
• zbrealign - समन्वयक से लक्ष्य उपकरण के लिए 802.15.4 PAN पुनःसंरेखण फ्रेम को जाली बनाता है। उपकरण के PAN ID या चैनल को रीसेट कर सकता है।
• zbfakebeacon - बीकन फ्रेम को जाली बनाता है, या तो उन्हें स्पैम करके या बीकन अनुरोध के जवाब में।
• zbopenear - डेटा कैप्चर में सहायता करता है जहां उपकरण कई चैनलों या तेज़-आवृत्ति-हॉपिंग पर काम कर रहे हैं। यह क्रमिक रूप से सभी चैनलों पर कई इंटरफ़ेस असाइन करता है।
• zbassocflood - लक्ष्य PANID से बार-बार जुड़ता है ताकि उपकरण को बहुत अधिक जुड़े स्टेशनों से क्रैश करने का प्रयास किया जा सके।
• zbconvert - पैकेट कैप्चर को Libpcap से Daintree SNA प्रारूप में, या इसके विपरीत, परिवर्तित करता है।
• zbdsniff - ZigBee ट्रैफ़िक को कैप्चर करता है, NWK फ्रेम और ओवर-द-एयर कुंजी प्रावधान की तलाश करता है। जब कोई कुंजी मिलती है, तो zbdsniff कुंजी को stdout पर प्रिंट करता है। नमूना पैकेट कैप्चर sample/zigbee-network-key-ota.dcf का उपयोग इस कार्यक्षमता को प्रदर्शित करने के लिए किया जा सकता है।
• zbfind - RSSI मापकर IEEE 802.15.4 ट्रांसमीटर के स्थान को ट्रैक करने के लिए एक GTK GUI अनुप्रयोग। zbfind निष्क्रिय रूप से (केवल पैकेट सुनें) या सक्रिय रूप से बीकन अनुरोध फ्रेम भेजकर और ZigBee राउटर और समन्वयकों से प्रतिक्रियाएँ रिकॉर्ड करके खोज कर सकता है। यदि इस उपकरण को शुरू करने के बाद बहुत सारी त्रुटियाँ मिलती हैं, तो सुनिश्चित करें कि आपका वेरिएबल सही ढंग से सेट है।

अतिरिक्त उपकरण, जो विशेष मामलों के लिए हैं या स्थिर नहीं हैं, निम्नलिखित रिपॉजिटरी में संग्रहीत हैं: Api-Do परियोजना रिपॉजिटरी: http://code.google.com/p/zigbee-security/ और https://github.com/riverloopsec/beekeeperwids पर।

FRAMEWORK

KillerBee को हवाई इंटरफ़ेस या एक समर्थित पैकेट कैप्चर फ़ाइल (libpcap) से पैकेट स्निफ़ करने, और मनमाने पैकेट इंजेक्ट करने की प्रक्रिया को सरल बनाने के लिए डिज़ाइन किया गया है। IEEE 802.15.4, ZigBee NWK और ZigBee APS पैकेट डिकोडर सहित सहायक फ़ंक्शन भी उपलब्ध हैं।

KillerBee API epydoc प्रारूप में दस्तावेज़ीकृत है, इस वितरण के doc/ निर्देशिका में HTML दस्तावेज़ के साथ। यदि आपने epydoc स्थापित किया है, तो आप चाहें तो मुद्रण के लिए एक सुविधाजनक PDF भी उत्पन्न कर सकते हैं, जैसा दिखाया गया है:

$ cd killerbee
$ mkdir pdf
$ epydoc --pdf -o pdf killerbee/

pdf/ निर्देशिका में "api.pdf" नामक एक फ़ाइल होगी जिसमें ढांचा दस्तावेज़ शामिल है।

KillerBee ढांचे का उपयोग शुरू करने के लिए, शामिल उपकरणों पर एक नज़र डालें (आरंभ करने के लिए zbdump और zbreplay अच्छे उदाहरण हैं)।

चूंकि KillerBee एक Python लाइब्रेरी है, यह अन्य Python सॉफ़्टवेयर के साथ भी अच्छी तरह से एकीकृत होती है। उदाहरण के लिए, Sulley लाइब्रेरी Pedram Amini द्वारा लिखित एक फज़िंग ढांचा है। Sulley म्यूटेशन सुविधाओं और KillerBee के पैकेट इंजेक्शन सुविधाओं का उपयोग करके, लक्ष्य को दोषपूर्ण ZigBee डेटा उत्पन्न करने और प्रेषित करने के लिए एक तंत्र बनाना सीधा है।

QUESTIONS/COMMENTS/CONCERNS

कृपया https://github.com/riverloopsec/killerbee/issues पर टिकट प्रणाली का उपयोग करें।

मूल संस्करण इसके द्वारा लिखा गया था: [email protected]। वर्तमान संस्करण, फिक्स, आदि इसके द्वारा संभाले जाते हैं: [email protected]। (सभी योगदानकर्ताओं/क्रेडिट के लिए ऊपर सूची देखें।)

योगदानकर्ताओं/डेवलपर्स के लिए, विवरण और मार्गदर्शन के लिए DEVELOPMENT.md देखें।