منصوبے کے بارے میں

# ASGARD **بلیو ٹیم سیکیورٹی سویٹ — 9 ماڈیوز، ایک ہی اصول: اگر ٹیسٹ نہیں ہوا، تو وہ موجود نہیں ہے۔** ایسگارڈ ایک دفاعی سیکیورٹی (بلیو ٹیم) ٹولز کا سویٹ ہے جو ایس ایم آئی اور آزاد تجزیہ کاروں کے لیے بنایا گیا ہے جو تجارتی ایس او سی پلیٹ فارم کا متحمل نہیں ہو سکتے، لیکن انہیں سراغ رسانی، تحقیق، آرکیسٹریشن اور اپنی قانونی تعمیل کا مظاہرہ کرنے کی ضرورت ہے۔ ہر ماڈیول **ایک ہی کام** کرتا ہے اور اسے اچھی طرح کرتا ہے: کوئی مونولیت نہیں، کوئی کلاؤڈ فراہم کنندہ پر لازمی انحصار نہیں، کوئی ایسی خصوصیت نہیں جو README میں بیان ہو لیکن کوڈ میں واقعی موجود نہ ہو۔ پوری سویٹ نے ایک مکمل تکنیکی آڈٹ سے گزرنا ہے جس نے حقیقی سیکیورٹی بگز کو درست کیا، بشمول دو معاملات جہاں سافٹ ویئر کامیابی کا دعوی کر رہا تھا جو واقعی کبھی نہیں ہوئی تھی۔ ## فن تعمیر تین فعال گروہس: - **سراغ رسانی** — سینسرز: Heimdall لاگز دیکھتا ہے، Bifrost نیٹ ورک دیکھتا ہے، Yggdrasil ایکٹو ڈائریکٹری دیکھتا ہے۔ - **جواب اور انٹیلیجنس** — الرٹ کے بعد کیا ہوتا ہے: Mjolnir ہوسٹ کا فورنسک ٹرائیج کرتا ہے، Fenrir عوامی تھریٹ انٹیلیجنس سے افزودہ کرتا ہے، Sleipnir YAML پلے بکس کے ذریعے سب کی آرکیسٹریشن کرتا ہے۔ - **گورننس** — وہ حصہ جو عام طور پر خالص تکنیکی سیکیورٹی پورٹ فولیوز میں غائب ہوتا ہے: Forseti سیکیورٹی پوسچر کو GDPR/NIS2 تعمیل اسکور میں تبدیل کرتا ہے، Gjallarhorn اطلاعات کو مرکزی بناتا ہے۔ **Ragnarök** کمانڈ پوائنٹ ہے: ایک ڈیسک ٹاپ ایپ (Tauri + FastAPI) ایک گفتگو اسسٹنٹ کے ساتھ جو بنیادی ماڈیولز پر اقدامات تجویز کرتا ہے — لیکن کبھی بھی واضح تصدیق کے بغیر انہیں انجام نہیں دیتا۔ ## ماڈیولز | ماڈیول | کیا کرتا ہے | اسٹیک | ٹیسٹ | |---|---|---|---| | **Heimdall** | ہلکا HIDS اور ونڈوز ایجنٹ: SSH/ونڈوز ایونٹ لاگز میں brute-force کی سراغ رسانی، کنفیگر کرنے کے قابل TTL کے ساتھ فائر وال لیول پر IP بلاک کرتا ہے، Telegram/Gjallarhorn کے ذریعے مطلع کرتا ہے | Python, PowerShell, FastAPI, SQLite | 38 ✅ | | **Mjolnir** | سمجھا ہوا ہوسٹ پر خودکار فورنسک ٹرائیج: پروسیس/نیٹ ورک اسنیپ شاٹ، VirusTotal پر ہیش تصدیق (کیش اور ریٹ لیمیٹنگ کے ساتھ)، حقیقی YARA اسکین (yara-python)، Markdown/HTML رپورٹ | Python, psutil, yara-python | 49 ✅ | | **Bifrost** | ملٹی تھریڈ نیٹ ورک اسکینر بنر گرینگ کے ساتھ، GeoIP/WHOIS افزودگی، LAN دریافت، خفیہ کردہ رپورٹس (PBKDF2 + Fernet) | Python, FastAPI | 46 ✅ | | **Yggdrasil** | ایکٹو ڈائریکٹری (LDAP/LDAPS) اور کلاؤڈ مائیکروسافٹ 365 / Entra ID سیکیورٹی آڈٹ (MFA پوسچر، گلوبل ایڈمنز، لیگیسی آتھ) حقیقی مائیکروسافٹ گراف API (app-only OAuth2) یا JSON ایکسپورٹ کے ذریعے | Python, ldap3, msal | 54 ✅ | | **Fenrir** | عوامی تھریٹ انٹیلیجنس ایگریگیٹر: CISA KEV ہمیشہ فعال، OTX اختیاری، STIX 2.1 ایکسپورٹ، لاک پروٹیکشن کے ساتھ SQLite | Python | 48 ✅ | | **Sleipnir** | SOAR انجن: YAML پلے بکس چلاتا ہے جو دیگر ماڈیولز کی آرکیسٹریشن کرتے ہیں، مستقل حالت اور واقعے کے آڈٹ ٹریل کے ساتھ | Python, PyYAML | 32 ✅ | | **Forseti** | ایس ایم آئی کے لیے GDPR/NIS2/DORA/ISO27001 تعمیل چیکر: 41 حقیقی کنٹرولز (13 GDPR + 12 NIS2 + 8 DORA + 8 ISO27001)، اسکورنگ، فرق اور ٹھوس اصلاح کے ساتھ رپورٹ | Python | 44 ✅ | | **Gjallarhorn** | مرکزی الرٹنگ ہب (Telegram/webhook/SMTP/Teams/Jira/ServiceNow) ڈی ڈوپ اور تھروٹلنگ کے ساتھ، Heimdall اور Sleipnir کے ذریعے استعمال ہوتا ہے | Python, FastAPI | 63 ✅ | | **Ragnarök** | ڈیسک ٹاپ اور ویب آرکیسٹریٹر (Tauri + FastAPI) اے آئی اسسٹنٹ کے ساتھ (FastEmbed + ChromaDB)، ملٹی یوزر RBAC، سیکیورٹی ہارڈننگ اور آڈٹ لاگ | Tauri, Rust, Python | 264 ✅ | ## فوری آغاز (Docker — مکمل سویٹ) 9 ماڈیولز git submodule ہیں، سادہ فولڈرز نہیں — `--recursive` کے ساتھ کلون کریں، ورنہ ماڈیول ڈائریکٹریز خالی ہوں گی اور نہ صرف Docker بلڈ بلکہ `install.sh`/`install.ps1` بھی ناکام ہو جائیں گے۔ ```bash git clone --recursive https://github.com/Fioru12/Asgard.git cd Asgard ./install.sh # Linux / macOS / Git Bash .\install.ps1 # Windows PowerShell ``` پھر **http://localhost:8080/dashboard** کھولیں — پہلی بار شروع کرنے کی گائیڈڈ پروسیجر آپ کو ایڈمن اکاؤنٹ بنانے میں رہنمائی کرے گی۔ localhost پر بے نقاب سروسز: | سروس | URL | |---------|-----| | Ragnarök (ڈیش بورڈ + API) | http://localhost:8080 | | Heimdall | http://localhost:18000 | | Gjallarhorn | http://localhost:8090 | | Forseti | http://localhost:8091 | | Bifrost | http://localhost:8092 | ## فوری آغاز (دستی — واحد ماڈیول) ہر ماڈیول آزاد ہے: اسے کلون کریں، انسٹال کریں، اکیلے استعمال کریں۔ ```bash git clone https://github.com/Fioru12/<Modulo>.git cd <Modulo> pip install -r requirements.txt pytest -v # تصدیق کریں کہ آپ کے ماحول میں سب کچھ کام کرتا ہے python main.py --help ``` ہر ماڈیول کا اپنا `README.md` ہے جس میں مخصوص فوری آغاز، کنفیگریشن کے لیے `.env.example`، اور ایک سیکشن "میں نے اسے کیوں بنایا" ہے جو اس حقیقی مسئلے کی وضاحت کرتا ہے جس کا جواب دیتا ہے۔ ## ڈیزائن کے اصول - **صفر خواہش مآب خصوصیات۔** اگر کسی ماڈیول کا README کسی چیز کی وضاحت کرتا ہے، تو اس چیز کا ایک ٹیسٹ ہے جو اسے ثابت کرتا ہے۔ جہاں کوئی ماڈیول ڈیمو/سمیولیٹڈ موڈ کی حمایت کرتا ہے، اس کی صراحت کی جاتی ہے، کبھی حقیقی ڈیٹا کے طور پر پیش نہیں کیا جاتا۔ - **شور سے ناکام ہوں، خاموشی سے نہیں۔** ایک سیکیورٹی ایکشن جو ناکام ہوتا ہے وہ واضح طور پر بتاتا ہے — وہ کامیابی کا بہروپ نہیں اختیار کرتا جو موجود نہیں ہے۔ - **ہر بے نقاب API پر ڈیفالٹ توثیق**، اگر واضح طور پر کنفیگر نہیں کیا گیا تو کلید خود بخود پیدا ہوتی ہے۔ - **حقیقی نتائج کے ساتھ ہر ایکشن کے لیے ایک انسان لوپ میں رہتا ہے** (IP بلاک کرنا، پلے بک چلانا، Ragnarök میں اے آئی کی تجویز کردہ ایکشن)۔ **[Fioru12](https://github.com/Fioru12) کے ذریعے تیار کردہ**