Cygor

सामान्य अवलोकन

Cygor एक मॉड्यूलर एसेट डिस्कवरी फ्रेमवर्क है जो स्कैनिंग, पार्सिंग और सेवा गणना को एक वर्कफ्लो में लाता है। यह अलग-अलग टूल्स के पैचवर्क को एक स्वचालित प्रक्रिया से बदल देता है जो डिस्कवरी, एनरिचमेंट और लक्षित गणना को सहजता से संभालता है — मैनुअल ओवरहेड को कम करता है और आपको टूल प्रबंधन के बजाय परिणामों पर ध्यान केंद्रित करने देता है।

Cygor का वेब UI कच्चे स्कैन डेटा की अराजकता को लेता है और इसे एक एकल, दृश्य कमांड सेंटर में व्यवस्थित करता है। अंतहीन XML, JSON या फ्लैट टेक्स्ट को छानने के बजाय, परिणाम स्वचालित रूप से पार्स, एनरिच और एक ही स्थान पर प्रदर्शित होते हैं जो तेजी से ट्राइएज और निर्णय लेने के लिए बनाया गया है।

FastAPI और Bootstrap 5 द्वारा संचालित, डैशबोर्ड इसे आसान बनाता है:

• एक नज़र में बड़ी तस्वीर देखें — काउंटर और सारांश सेवा वितरण, स्थिति कोड रुझान और OS फिंगरप्रिंट प्रकट करते हैं।
• तुरंत गहराई में जाएं — उच्च-स्तरीय मीट्रिक से प्रति-होस्ट विवरण, पोर्ट और मॉड्यूल परिणामों में एक क्लिक से पिवट करें।
• एक्सपोज़र की कल्पना करें — Cygor का एक मॉड्यूल जिसे Lockon कहा जाता है, सक्रिय वेब सेवाओं के स्क्रीनशॉट लेता है और आउटपुट सीधे एम्बेडेड होते हैं, डैशबोर्ड छोड़े बिना तत्काल संदर्भ देते हैं।
• ट्राइएज के दौरान व्यवस्थित रहें — समीक्षित बनाम असमीक्षित निष्कर्षों को चिह्नित करें, परिणामों को फ़िल्टर और सॉर्ट करें, और सबसे अधिक मूल्य वाले लक्ष्यों पर ध्यान केंद्रित करें।

वेब UI केवल प्रस्तुति के लिए नहीं है — यह दक्षता और स्पष्टता के बारे में है। सभी एकत्रित डेटा को एक एकल, इंटरैक्टिव कार्यक्षेत्र में लाकर, यह फ़ाइलों को पार्स करने या आउटपुट को समेटने में लगने वाले समय को कम करता है और परीक्षकों को उस पर ध्यान केंद्रित करने देता है जो मायने रखता है: पर्यावरण को समझना और उस पर कार्य करना।

इसे Cygor क्यों कहा जाता है?

मेरे द्वारा बनाए गए बहुत से टूल, तकनीक और व्यापार कौशल Spawn Universe से प्रेरित हैं। यदि आपने कभी Spawn कॉमिक नहीं पढ़ी है, तो यह ठीक है क्योंकि मैं कुछ जानकारी साझा करूँगा कि मैंने इस टूल के नाम के लिए चरित्र को क्यों चुना।

नाम Cygor Spawn ब्रह्मांड में Cy-Gor से लिया गया है, जो एक दुखद एंटी-हीरो है। एक बार माइकल कोनिचनी — एक सरकारी ऑपरेटिव और अल सीमन्स का करीबी दोस्त — उसने सीमन्स की हत्या के बाद भ्रष्टाचार को उजागर करने की कोशिश की। हालांकि, उसे पकड़ लिया गया और प्रोजेक्ट सिमियन में मजबूर किया गया, जो डॉ. फ्रेडरिक विल्हेम के सिमियन प्रयोग थे, जहां एक गोरिल्ला के शरीर को आक्रामक साइबरनेटिक्स के माध्यम से कोनिचनी के दिमाग के साथ मिला दिया गया। परिणाम Cy-Gor नामक जानवर था — साइबरनेटिक गोरिल्ला का संक्षिप्त रूप।

कैद से भागने के बाद, Cy-Gor ने हिंसक उत्पात मचाया, यहां तक कि भ्रम और क्रोध के दौरे में सरकारी डेटा केंद्रों को भी तोड़ दिया। हालांकि कई बार शिकार किया गया और फिर से पकड़ा गया, आखिरकार उसने उन प्रणालियों के खिलाफ लड़ाई लड़ी जो उसे नियंत्रित करना चाहते थे — ट्रैकिंग इम्प्लांट हटाकर और अपना रास्ता खुद बनाने के लिए स्वतंत्र होकर, मशीन, जानवर और मनुष्य के बीच फटा हुआ।

• संदर्भ: https://www.spawnworld.com/encyclopedia/cygor.htm

Cygor का उपयोग किसे करना चाहिए?

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

टूल्स जो Cygor उपयोग करता है:

• Nmap – विश्वसनीय सेवा और संस्करण पहचान; XML आउटपुट को संरचित होस्ट/सेवा डेटा में पार्स किया जाता है।
• Masscan – बड़े नेटवर्क में तेजी से डिस्कवरी के लिए हाई-स्पीड पोर्ट स्कैनिंग।
• Naabu – सरल, तेज़ TCP पोर्ट स्कैनर जो Masscan/Nmap वर्कफ्लो को पूरक करता है।
• Playwright – Lockon द्वारा वेब स्क्रीनशॉट कैप्चर करने के लिए उपयोग किया जाने वाला ब्राउज़र ऑटोमेशन इंजन।
• वेब सामग्री डिस्कवरी – ffuf, feroxbuster, gobuster और dirsearch को webenum मॉड्यूल द्वारा समानांतर रूप से व्यवस्थित किया जाता है (केवल स्थापित टूल चलते हैं)।
• सेवा गणना टूलिंग – rpcclient/polenum (MSRPC), ldapsearch/ldapdomaindump (LDAP), snmpwalk/onesixtyone (SNMP), dig/dnsrecon (DNS), और showmount (NFS) एक्सप्लोरर मॉड्यूल का समर्थन करते हैं; प्रत्येक मॉड्यूल स्वच्छता से छोड़ देता है यदि उसका टूल अनुपस्थित है।
• Python लाइब्रेरीज़ – (requests, colorama, SQLModel, आदि) पार्सिंग, एनरिचमेंट, आउटपुट फ़ॉर्मेटिंग और डेटाबेस हैंडलिंग के लिए।

Cygor स्थापित करना

Cygor को स्थापित करने के लिए कुछ विधियाँ समर्थित हैं: pip, pipx, uv और docker।

pipx से स्थापित करना

कुछ निर्भरताएँ (जैसे gssapi Kerberos/WinRM के लिए) C एक्सटेंशन बनाती हैं, इसलिए पहले बिल्ड टूलचेन और Kerberos हेडर स्थापित करें:

# Debian/Ubuntu/Kali:
sudo apt install -y build-essential python3-dev libkrb5-dev

# स्थिर संस्करण:
pipx install cygor

# स्रोत से स्थापित करें:
git clone https://github.com/tjnull/cygor
cd cygor
pipx install .

Docker का उपयोग करके Cygor तैनात करना

Cygor के Docker सेटअप में एप्लिकेशन और PostgreSQL डेटाबेस सेवा दोनों शामिल हैं। यदि PostgreSQL उपलब्ध नहीं है तो सिस्टम स्वचालित रूप से SQLite पर वापस आ जाता है।

त्वरित प्रारंभ

उत्पादन (अनुशंसित):

# विकल्प 1: रैपर स्क्रिप्ट का उपयोग करें (स्वचालित रूप से पोर्ट विवादों को संभालता है)
./docker-compose-up.sh up --build

# विकल्प 2: डायरेक्ट docker compose (डिफ़ॉल्ट पोर्ट का उपयोग करता है)
docker compose up --build

डेवलपमेंट (स्रोत कोड माउंटेड के साथ):

# विकल्प 1: रैपर स्क्रिप्ट का उपयोग करें (स्वचालित रूप से पोर्ट विवादों को संभालता है)
./docker-compose-up.sh dev up --build

# विकल्प 2: डायरेक्ट docker compose (डिफ़ॉल्ट पोर्ट का उपयोग करता है)
docker compose -f docker-compose-dev.yaml up --build

Docker Compose सेवाएँ

Docker Compose सेटअप में शामिल हैं:

• PostgreSQL सेवा: स्वचालित रूप से कॉन्फ़िगर किया गया डेटाबेस (यदि अनुपलब्ध हो तो SQLite पर वापस आता है)
• Cygor सेवा: वेब UI और एप्लिकेशन
• स्वचालित पोर्ट डिटेक्शन: पोर्ट विवादों की जाँच करता है और यदि आवश्यक हो तो वैकल्पिक पोर्ट का उपयोग करता है
• स्थायी वॉल्यूम:
  • results/: स्कैन आउटपुट, credrecon परिणाम, और डेटाबेस फ़ाइलें
  • cygor-config/: स्थानीय कॉन्फ़िग वॉल्यूम (स्वचालित रूप से बनाया गया)

पोर्ट कॉन्फ़िगरेशन

डिफ़ॉल्ट रूप से:

• उत्पादन: PostgreSQL होस्ट पोर्ट 5432 पर उजागर (यदि उपलब्ध हो)
• डेवलपमेंट: PostgreSQL होस्ट पोर्ट 5434 पर उजागर (यदि उपलब्ध हो)
• आंतरिक: कंटेनर हमेशा आंतरिक रूप से पोर्ट 5432 का उपयोग करते हैं (Docker नेटवर्क)

यदि पोर्ट उपयोग में हैं, तो आप यह कर सकते हैं:

1. रैपर स्क्रिप्ट का उपयोग करें (अनुशंसित - स्वचालित रूप से उपलब्ध पोर्ट का पता लगाती है):

   ./docker-compose-up.sh up --build
   

2. पोर्ट मैन्युअल रूप से सेट करें:

   export POSTGRES_HOST_PORT=5435
   docker compose up --build
   

3. पोर्ट मैपिंग हटाएं (यदि आपको बाहरी PostgreSQL एक्सेस की आवश्यकता नहीं है): docker-compose.yaml में ports: अनुभाग को टिप्पणी करें

मैनुअल Docker बिल्ड

Docker इमेज को मैन्युअल रूप से बनाने के लिए:

docker build -t cygor .

एक एकल कंटेनर चलाएं (PostgreSQL सेवा के बिना):

docker run --rm -v ./results:/opt/cygor/results \
  -e CYGOR_RESULTS_DIR=/opt/cygor/results \
  cygor web --host 0.0.0.0 --port 8080 --load-dir /opt/cygor/results

डेटाबेस व्यवहार

• Docker Compose के साथ: PostgreSQL सेवा का उपयोग करता है (स्वचालित रूप से कॉन्फ़िगर)
• यदि PostgreSQL विफल होता है: स्वचालित रूप से SQLite पर वापस आता है
• स्टैंडअलोन कंटेनर: डिफ़ॉल्ट रूप से SQLite का उपयोग करता है (जब तक CYGOR_DB_URL सेट न हो)

पर्यावरण चर

Docker के लिए प्रमुख पर्यावरण चर: