BlackBerryC2 2.0.0-beta

BlackBerryC2 एक एन्क्रिप्टेड रिमोट एडमिनिस्ट्रेशन और C2 फ्रेमवर्क है, जिसे विशेष रूप से शैक्षिक उपयोग, सुरक्षा अनुसंधान और नियंत्रित प्रयोगशाला वातावरण के लिए डिज़ाइन किया गया है।

यह प्रोजेक्ट दर्शाता है कि कैसे एक कस्टम कमांड-एंड-कंट्रोल सर्वर बनाया जाए जिसमें एप्लिकेशन-लेयर क्रिप्टोग्राफी, सत्र प्रबंधन और सुरक्षित क्लाइंट संचार हो, बिना बाहरी TLS स्टैक पर निर्भर हुए।

⚠️ महत्वपूर्ण सूचना

यह प्रोजेक्ट मैलवेर नहीं है और अनधिकृत पहुंच के लिए नहीं है।

BlackBerryC2:

• स्वयं प्रसार नहीं करता
• स्वचालित रूप से कमजोरियों का शोषण नहीं करता
• पर्सिस्टेंस मैकेनिज्म शामिल नहीं करता
• एंटीवायरस सॉफ्टवेयर से बचने का प्रयास नहीं करता

केवल उन सिस्टमों और नेटवर्कों पर उपयोग करें जिनके आप मालिक हैं या जिनके परीक्षण के लिए आपके पास स्पष्ट अधिकार है।

Python निर्भरताएँ:

pip install cryptography prompt_toolkit zstandard

zstandard वैकल्पिक है लेकिन 1 GB से बड़े ट्रांसफर के लिए अनुशंसित है।

मुख्य विशेषताएँ

• कस्टम TCP-आधारित एन्क्रिप्टेड C2 सर्वर (v2.0)
• ECDHE (secp256r1) कुंजी विनिमय — अस्थायी या स्थायी
• प्रति सत्र AES-256-GCM प्रमाणित एन्क्रिप्शन
• प्रति-पैकेट HMAC-SHA256 प्रमाणीकरण + एंटी-रीप्ले अनुक्रम संख्या
• एकाधिक समवर्ती क्लाइंट सत्र
• टैब-पूर्णता (prompt_toolkit) के साथ इंटरैक्टिव ऑपरेटर कंसोल
• एन्क्रिप्टेड रिमोट कमांड निष्पादन
• zlib / Zstandard कंप्रेशन के साथ एन्क्रिप्टेड फ़ाइल ट्रांसफर
• रिकर्सिव डायरेक्टरी अपलोड/डाउनलोड (get -r, put -r)
• बैकग्राउंड ट्रांसफर (-b फ्लैग) — नॉन-ब्लॉकिंग, रद्द करने योग्य
• ट्रांसफर रिज्यूम समर्थन (.partial + .resume फ़ाइलें)
• क्लाइंट पेलोड जनरेटर (generate-payload)
• IP ब्लॉकिंग: स्थायी ब्लॉकलिस्ट + अस्थायी ऑटो-बैन
• स्कैन/फ्लड पहचान: कनेक्ट स्कैन, बैनर ग्रैब, हैंडशेक विफलता, हार्टबीट फ्लड
• वैकल्पिक HTTP(S)/TLS प्रॉक्सी समर्थन (BlackBerryHTTPs_TLSProxyGUI)
• SPA (सिंगल पैकेट ऑथराइजेशन) और पोर्ट-नॉकिंग प्री-ऑथ
• BerryTransfer मोड — समर्पित फ़ाइल-ट्रांसफर-ओनली सर्वर (कोई शेल नहीं)
• एन्क्रिप्टेड सत्र लॉग (AES-256-GCM + PBKDF2, 600k पुनरावृत्तियाँ)
• इन-शेल व्यूअर के साथ एन्क्रिप्टेड सर्वर लॉग (log कमांड)
• स्टार्टअप कॉन्फ़िगरेशन logs/last_start.json में सहेजा गया

क्रिप्टोग्राफिक डिज़ाइन

BlackBerryC2 v2.0 सुरक्षित संचार इस प्रकार स्थापित करता है:

1. क्लाइंट TCP के माध्यम से कनेक्ट होता है; सर्वर सेवा बैनर भेजता है।
2. क्लाइंट REQUEST_PUBKEY भेजता है।
3. सर्वर अपनी अस्थायी ECDHE सार्वजनिक कुंजी (secp256r1) भेजता है।
4. क्लाइंट अपनी ECDHE सार्वजनिक कुंजी + HMAC-SHA256 प्रमाणीकरण टैग भेजता है।
5. सर्वर पूर्व-साझा रहस्य (HMAC_PRE_SHARED_SECRET) के विरुद्ध HMAC को सत्यापित करता है।
6. दोनों पक्ष साझा रहस्य पर HKDF-SHA256 के माध्यम से 256-बिट AES सत्र कुंजी प्राप्त करते हैं।
7. सभी आगे के संचार AES-256-GCM का उपयोग करते हैं, जिसमें प्रति-पैकेट HMAC-SHA256 और एंटी-रीप्ले अनुक्रम संख्याएँ होती हैं।

प्रत्येक सत्र बनाए रखता है:

• अपनी स्वयं की AES-256 कुंजी और HMAC कुंजी
• स्वतंत्र नॉन्स (प्रति संदेश 12-बाइट यादृच्छिक)
• पृथक एंटी-रीप्ले ट्रैकर (अनुक्रम विंडो ±100)
• फ्लड सुरक्षा दर सीमक (कॉन्फ़िगर करने योग्य कमांड/सेकंड)

सभी क्रिप्टोग्राफिक कुंजियाँ रनटाइम पर उत्पन्न होती हैं और पुनरारंभ पर कभी पुन: उपयोग नहीं की जाती हैं (जब तक --persistente सेट न हो)।

सर्वर चलाना

python3 BlackBerryC2_server.py

डिफ़ॉल्ट कॉन्फ़िगरेशन:

• होस्ट: 0.0.0.0
• पोर्ट: 9949

कमांड-लाइन तर्क

उदाहरण:

# मूल स्टार्टअप (लॉग पासफ़्रेज़ के लिए संकेत)
python3 BlackBerryC2_server.py

# स्थायी ECDHE कुंजियाँ + वर्बोज़
python3 BlackBerryC2_server.py -p -vv

# कस्टम पोर्ट, कोई HMAC जाँच नहीं
python3 BlackBerryC2_server.py -P 8080 --no-secure

# पोर्ट-नॉकिंग कस्टम पोर्ट पर
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# ऑटो-कन्फ़र्म के साथ BerryTransfer मोड
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# सर्वर शुरू किए बिना लॉग देखें/डिक्रिप्ट करें
python3 BlackBerryC2_server.py --logs

ऑपरेटर कंसोल कमांड

सर्वर प्रबंधन

प्रॉक्सी

सत्र कमांड (select <ID> के अंदर)

सामान्य

फ़ाइल ट्रांसफर

BerryTransfer मोड

BerryTransfer एक समर्पित केवल-फ़ाइल-ट्रांसफर सर्वर मोड है जो scp से प्रेरित है। सक्रिय होने पर, सर्वर सभी शेल एक्सेस को अस्वीकार कर देता है और केवल BT:* प्रोटोकॉल कमांड स्वीकार करता है।

प्रारंभ:

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # GET के लिए कोई ऑपरेटर प्रॉम्प्ट नहीं

BerryTransfer शेल कमांड:

ट्रांसफर लॉग logs/bt_transfer.jsonl में लिखा जाता है (वैकल्पिक रूप से AES-256-GCM एन्क्रिप्टेड)।

SPA / पोर्ट-नॉकिंग

जब --spa सक्रिय होता है, तो क्लाइंट को TCP कनेक्शन स्वीकार किए जाने से पहले UDP के माध्यम से प्रमाणित होना चाहिए।

SPA मोड (डिफ़ॉल्ट): क्लाइंट SPA_UDP_PORT पर 32-बाइट HMAC-SHA256 टोकन भेजता है।

token = HMAC-SHA256(HMAC_SECRET, "{ip}:{time_window_30s}")

नॉक मोड: क्लाइंट एक टाइमआउट विंडो के भीतर क्रम में UDP पोर्ट के अनुक्रम पर नॉक करता है।

python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 7001,7002,7003 --knock-timeout 10

अधिकृत IP --spa-ttl सेकंड (डिफ़ॉल्ट 60) के लिए वैध रहते हैं।

सुरक्षा विशेषताएँ

लॉगिंग

बिल्ट-इन व्यूअर से लॉग देखें:

BlackBerry> log

या स्टैंडअलोन (कोई सर्वर नहीं):

python3 BlackBerryC2_server.py --logs

इच्छित उपयोग

यह प्रोजेक्ट केवल इसके लिए है:

• शैक्षिक प्रदर्शन
• सुरक्षा अनुसंधान
• नियंत्रित प्रयोगशाला वातावरण
• अधिकृत पैठ परीक्षण

अनधिकृत उपयोग सख्त वर्जित है।

लाइसेंस

पूर्ण लाइसेंस विवरण के लिए LICENSE फ़ाइल देखें।

अस्वीकरण

यह सॉफ्टवेयर "जैसा है" प्रदान किया जाता है, बिना किसी प्रकार की वारंटी के। लेखक इस सॉफ्टवेयर के दुरुपयोग या इसके कारण होने वाली क्षति के लिए कोई जिम्मेदारी नहीं लेते हैं।