CORE TopoGen

समृद्ध वेब GUI या कमांड-लाइन इंटरफ़ेस का उपयोग करके परिदृश्य XML फ़ाइलों से पुनरुत्पादनीय CORE नेटवर्क टोपोलॉजी जनरेट करें।

विषय-सूची

• मुख्य विशेषताएँ
• स्क्रीनशॉट
• त्वरित आरंभ
  • पूर्वापेक्षाएँ
  • निर्भरताएँ स्थापित करें
  • वेब UI लॉन्च करें
  • CLI चलाएँ
• पूर्ण पूर्वावलोकन कार्यप्रवाह
• फीचर की गहन समीक्षा
  • योजना शब्दार्थ
  • राउटर कनेक्टिविटी और एकत्रीकरण
  • ट्रैफ़िक, विभाजन और सेवाएँ
  • रिपोर्ट और आर्टिफैक्ट्स
• आर्किटेक्चर अवलोकन
• समस्या निवारण
• अतिरिक्त दस्तावेज़ीकरण
• योगदान
• उद्धरण

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

• एकल-स्रोत योजना – ब्राउज़र या किसी भी XML संपादक में परिदृश्य संपादित करें और CLI के साथ परिणाम पुनः उत्पन्न करें।
• नियतात्मक पूर्वावलोकन – वैकल्पिक RNG सीड होस्ट विस्तार, राउटर स्थान, कनेक्टिविटी, सेवाओं, विभाजन और भेद्यता आवंटन को लॉक कर देता है।
• लाइव लॉग डॉक – रन आउटपुट स्ट्रीम करें, स्तर या टेक्स्ट/regex द्वारा फ़िल्टर करें, और लंबे रनों के लिए ऑटो-फ़ॉलो टॉगल करें।
• समृद्ध टोपोलॉजी नीतियाँ – प्रति-रूटिंग-आइटम R2R मेश, R2S एकत्रीकरण, होस्ट समूहीकरण सीमाएँ और स्विच री-होमिंग।
• डिस्क पर आर्टिफैक्ट्स – ट्रैफ़िक स्क्रिप्ट्स, विभाजन नियम, docker-compose परिभाषाएँ, Markdown रिपोर्ट और JSON सारांश निरीक्षण के लिए पूर्वानुमानित स्थानों पर लिखे जाते हैं।
• हार्डवेयर-इन-द-लूप अनुकूल – संपादक में सीधे HITL अटैचमेंट प्रबंधित करें; टोपोलॉजी को नियतात्मक बनाए रखने के लिए विकल्प मौजूदा राउटर/स्विच या नया राउटर प्रावधान करने तक सीमित हैं।

स्क्रीनशॉट

WebUI छवि गैलरी देखें docs/screenshots.md।

त्वरित आरंभ

पूर्वापेक्षाएँ

• Python 3.10+ (3.11 अनुशंसित)
• CORE 9.2 या नया संस्करण जिसमें core-daemon चल रहा हो
• nginx/envoy रिवर्स प्रॉक्सी या भेद्यता compose लक्ष्यों के लिए Docker (वैकल्पिक)

निर्भरताएँ स्थापित करें

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

वेब UI लॉन्च करें

python main.py

• डिफ़ॉल्ट रूप से http://127.0.0.1:9090 पर जाएँ (रिवर्स प्रॉक्सी nginx compose लक्ष्य https://localhost)।
• पहली लॉन्च पर coreadmin / coreadmin खाता सीड होता है; इसे तुरंत Profile → Change Password के अंतर्गत बदलें।
• make host-web, make host-web-nginx, या make host-web PROXY=envoy के साथ TLS रिवर्स प्रॉक्सी कॉन्फ़िगर करें। सहायक स्क्रिप्ट scripts/dev_gen_certs.sh SAN समर्थन के साथ सेल्फ-साइन्ड प्रमाणपत्र जारी करती है।
• HITL संपादक नोट: “Attach to” ड्रॉपडाउन अब Existing Router, Existing Switch, या New Router प्रदान करता है। पुराने New Switch विकल्प को छिपे हुए स्विच फैन-आउट को रोकने के लिए हटा दिया गया था; इसका उपयोग करने वाले सहेजे गए परिदृश्य लोड के दौरान में सामान्यीकृत हो जाते हैं।

CLI चलाएँ

python -m core_topo_gen.cli --xml path/to/scenario.xml --seed 42 --verbose

लोकप्रिय विकल्प:

• --scenario NAME किसी विशिष्ट परिदृश्य प्रविष्टि का चयन करें
• --host / --port CORE gRPC एंडपॉइंट को ओवरराइड करें (डिफ़ॉल्ट 127.0.0.1:50051)
• --layout-density {compact|normal|spacious} मानचित्र स्पेसिंग समायोजित करें
• --seg-include-hosts, --seg-allow-docker-ports, --nat-mode, --dnat-prob विभाजन को सूक्ष्म-ट्यून करें
• --traffic-pattern, --traffic-rate, --traffic-content ट्रैफ़िक डिफ़ॉल्ट ओवरराइड करें

पूर्ण पूर्वावलोकन कार्यप्रवाह

1. Save XML – संपादक ऑटो-सेव करता है, लेकिन “Save XML” दबाने से सुसंगत पूर्वावलोकन सुनिश्चित होते हैं।
2. (वैकल्पिक) Set seed – नियतात्मक टोपोलॉजी आउटपुट पाने के लिए एक पूर्णांक सीड दर्ज करें।
3. Generate Full Preview – किसी भी CORE कॉल से पहले राउटर/होस्ट संख्या, R2R/R2S नीतियाँ, विभाजन, सेवाएँ, ट्रैफ़िक और भेद्यता आवंटन दिखाता है।
4. संरचित अनुभागों की समीक्षा करें – संरचित कार्ड और रॉ JSON के बीच टॉगल करें; इतिहास अंतिम 25 पूर्वावलोकन स्थानीय स्टोरेज में संग्रहीत करता है।
5. Run (Seed) – CLI को अतुल्यकालिक रूप से लॉन्च करता है, लॉग को डॉक में स्ट्रीम करता है और ./reports/ में Markdown रिपोर्ट लिखता है।

फीचर की गहन समीक्षा

योजना शब्दार्थ

• होस्ट योजना Base Hosts (घनत्व) और Count पंक्तियों का सम्मान करती है; राउंड-ट्रिप निष्ठा के लिए मेटाडेटा XML (base_nodes, additive_nodes, combined_nodes, आदि) में लिखा जाता है।
• राउटर और भेद्यता योजना explicit_count, derived_count और total_planned के माध्यम से व्युत्पन्न बनाम स्पष्ट संख्याएँ कैप्चर करती है।
• परिदृश्य-स्तरीय scenario_total_nodes नियोजित होस्ट, राउटर और भेद्यता लक्ष्यों का सारांश प्रस्तुत करता है।
• पार्सर सहायक मेटाडेटा को प्रोग्रामेटिक रूप से उजागर करते हैं: core_topo_gen.parsers.planning_metadata.parse_planning_metadata()।
• हार्डवेयर-इन-द-लूप योजनाएँ प्रति-परिदृश्य प्राथमिकताएँ (सक्षम स्थिति, इंटरफ़ेस सूची, अटैचमेंट विकल्प) बनाए रखती हैं। अटैचमेंट existing_router, existing_switch, या new_router में सामान्यीकृत होते हैं; पुराने new_switch मानों को में बदल दिया जाता है ताकि पूर्वावलोकन नियतात्मक बने रहें और स्विच ओवरले अंतर्निहित रूप से संश्लेषित न हों।

राउटर कनेक्टिविटी और एकत्रीकरण

• प्रति-रूटिंग-आइटम r2r_mode Exact, Uniform, NonUniform, Min, Max और --router-mesh-style से जुड़े पुराने मेश का समर्थन करता है।
• R2S नीतियाँ (r2s_mode, r2s_edges, वैकल्पिक r2s_hosts_min/max) होस्ट को समर्पित स्विच के पीछे पुनः समूहित करती हैं, जिसमें “Exact=1” प्रति राउटर सभी होस्ट को एक ही स्विच में एकत्रित करता है।
• पूर्वावलोकन JSON और रनटाइम आँकड़े त्वरित संतुलन जाँच के लिए राउटर डिग्री, एकत्रीकरण संख्याएँ और Gini गुणांक कैप्चर करते हैं।

ट्रैफ़िक, विभाजन और सेवाएँ

• ट्रैफ़िक स्क्रिप्ट /tmp/traffic में (साथ की सेवाओं के साथ) रखी जाती हैं और पैटर्न, दर, जिटर और सामग्री संकेतों के लिए ओवरराइड का सम्मान करती हैं।
• विभाजन स्क्रिप्ट /tmp/segmentation में segmentation_summary.json के साथ रखी जाती हैं; NAT मोड, DNAT संभावना, होस्ट समावेशन और docker पोर्ट स्वीकृतियाँ कॉन्फ़िगर करने योग्य हैं।
• Docker भेद्यताएँ /tmp/vulns में प्रति-नोड docker-compose फ़ाइलें जोड़ती हैं, जिनका मेटाडेटा CORE नोड्स में एम्बेडेड होता है।
• कस्टम ट्रैफ़िक प्लगइन्स कस्टम-निर्मित प्रेषक/रिसीवर कोड के लिए core_topo_gen.plugins.traffic.register() के माध्यम से पंजीकृत हो सकते हैं।

रिपोर्ट और आर्टिफैक्ट्स

• Markdown रिपोर्टें (./reports/scenario_report_<timestamp>.md) टोपोलॉजी आँकड़े, योजना मेटाडेटा, विभाजन परिणाम और रनटाइम आर्टिफैक्ट्स सूचीबद्ध करती हैं। प्रत्येक रन Markdown फ़ाइल के साथ एक JSON सारांश (scenario_report_<timestamp>.json) और राउटर डिग्री डेटा उपलब्ध होने पर प्रति-रन कनेक्टिविटी CSV भी उत्पन्न करता है।
• रन इतिहास Reports पृष्ठ के लिए outputs/run_history.json में संग्रहीत किया जाता है।
• सुरक्षित विलोपन रिपोर्ट बनाए रखता है, जबकि GUI के माध्यम से परिदृश्य हटाए जाने पर outputs/ के अंतर्गत संबद्ध आउटपुट साफ़ करता है।

आर्किटेक्चर अवलोकन

समस्या निवारण

• **core-python नहीं मिला** – make host-webसे पहलेWEBUI_PYसेट करें याpython3पर निर्भर रहें; बैकएंड आवश्यकता पड़ने परsys.executable` पर फॉलबैक करता है।
• खाली TLS प्रमाणपत्र फ़ोल्डर (nginx/certs) – nginx compose करने से पहले scripts/dev_gen_certs.sh या make dev-certs चलाएँ।
• core-daemon अगम्य` – डेमन स्थिति और होस्ट/पोर्ट सत्यापित करें; GUI रन मोडल कनेक्शन समस्याओं को तुरंत प्रदर्शित करेगा।
• Docker भेद्यताएँ छोड़ी गईं – सुनिश्चित करें कि छवियाँ Vulnerabilities कैटलॉग के माध्यम से डाउनलोड/पुल की गई हैं और Docker होस्ट के लिए उपलब्ध है।
• लॉग डॉक ऑटो-स्क्रॉल नहीं करता – ऑटो-फ़ॉलो पुनः सक्षम करने के लिए “Follow Off/On” टॉगल पर क्लिक करें।

अतिरिक्त दस्तावेज़ीकरण

• API.md – वेब UI बैकएंड द्वारा उजागर REST एंडपॉइंट
• SCENARIO_XML_SCHEMA.md – स्कीमा वॉकथ्रू और उदाहरण

योगदान

पुल रिक्वेस्ट और इश्यू रिपोर्ट का स्वागत है! परिवर्तन सबमिट करने से पहले कृपया प्रासंगिक pytest लक्ष्य (pytest -q) चलाएँ और व्यवहार बदलने पर दस्तावेज़ीकरण को अद्यतन रखें।

अपने कार्य को उद्धृत करें:

@article{rodriguez2025agentcyte,

title={AgentCyTE: Leveraging Agentic AI to Generate Cybersecurity Training & Experimentation Scenarios},

author={Rodriguez, Ana M and Acosta, Jaime and Kotal, Anantaa and Piplai, Aritran},

journal={Annual Computer Security Applications Conference Workshop (ACSACW)},

year={2025}

}