
विस्तारणीय MacOS सिस्टम टेलीमेट्री जनरेटर।
MacNoise EDR सत्यापन और डिटेक्शन इंजीनियरिंग के लिए वास्तविक macOS गतिविधि उत्पन्न करता है। नेटवर्क कनेक्शन, फ़ाइल लेखन, प्रक्रिया निष्पादन, persistence, TCC पहुँच और अन्य व्यवहारों को अपने सुरक्षा नियंत्रणों के विरुद्ध परखने के लिए अलग-अलग मॉड्यूल या YAML परिदृश्य चलाएँ।
प्रेरणा और डिज़ाइन की पृष्ठभूमि के लिए, रिलीज़ ब्लॉग पोस्ट देखें।
MacNoise उन सिस्टमों पर अधिकृत सुरक्षा परीक्षण के लिए है जिनके आप स्वामी हैं या जिनका परीक्षण करने के लिए आपके पास स्पष्ट लिखित अनुमति है। मॉड्यूल वही वास्तविक गतिविधि करते हैं जिसका वे वर्णन करते हैं। वे सैंडबॉक्स्ड नहीं हैं, और कुछ क्रियाएँ सिस्टम और उपयोगकर्ता डेटा को अपरिवर्तनीय रूप से हटा या बदल सकती हैं। निष्पादन से पहले मॉड्यूल के व्यवहार और dry-run आउटपुट की समीक्षा करें। लक्ष्य चयन, अनुमति और परिणामों के लिए आप ज़िम्मेदार हैं। लेखक दुरुपयोग के लिए कोई दायित्व नहीं मानते।
Go 1.24 या बाद के संस्करण और Make के साथ किसी checkout से बिल्ड करें:
make build
macOS पर बाइनरी चलाएँ। क्रॉस-कंपाइल करने के लिए, Intel Mac के लिए make build-amd64, Apple silicon के लिए make build-arm64, या दोनों के लिए make release का उपयोग करें।
मॉड्यूल की सूची बनाएँ और जिसे आप चलाना चाहते हैं उसका निरीक्षण करें:
./macnoise list
./macnoise info file_create
पैरामीटर का पूर्वावलोकन करें, फिर --dry-run के बिना वही कमांड निष्पादित करें:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
दूसरा कमांड एक फ़ाइल बनाता है, टेलीमेट्री उत्सर्जित करता है, और क्लीनअप चलाता है। मॉड्यूल के जुड़े अनुक्रम का पूर्वावलोकन करने के लिए:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
परिदृश्य चलाएँ मॉड्यूल आउटपुट को जोड़ने के लिए, विश्लेषण के लिए आउटपुट कैप्चर करें, या बाद के स्कैन के लिए आर्टिफ़ैक्ट्स बनाए रखें।
जनरेट की गई मॉड्यूल कैटलॉग हर मॉड्यूल, पैरामीटर, आउटपुट, इवेंट प्रकार, विशेषाधिकार और ATT&CK मैपिंग को सूचीबद्ध करती है। श्रेणी गाइड प्लेटफ़ॉर्म आवश्यकताओं और मॉड्यूल व्यवहार की व्याख्या करते हैं:
| श्रेणी | विवरण |
|---|---|
| network | TCP कनेक्शन, HTTP, लिसनर, रिवर्स शेल, DNS, और TLS |
| process | निष्पादन, सिग्नल डिलीवरी, dylib इंजेक्शन, Gatekeeper बायपास, और osascript |
| file | खोज, पढ़ना, प्रतिलिपि बनाना, निर्माण, संशोधन, संग्रहण, छिपाना, और डिकॉय एन्क्रिप्शन |
| tcc | Full Disk Access, Contacts, Accessibility, और Screen Recording प्रोब |
| credential | नेटिव क्रेडेंशियल-स्टोर एक्सेस |
| volume | डिस्क-इमेज निर्माण और माउंटेड-वॉल्यूम लाइफ़साइकल |
| service | Launchd गणना, LaunchAgent और LaunchDaemon स्थायित्व, cron, शेल प्रोफ़ाइल, और Login Items |
| plist | Plist निर्माण और संशोधन |
| evasion | लॉग साफ़ करना, टाइमस्टॉम्पिंग, इतिहास हटाना, और मास्करेडिंग |
सूची को फ़िल्टर करने के लिए ./macnoise list --category network का उपयोग करें। किसी श्रेणी या हर पंजीकृत मॉड्यूल को निष्पादित करने के लिए, ./macnoise run --category network या ./macnoise run --all का उपयोग करें।
macnoise run <module> [--param key=val ...] Run a specific module
macnoise run --category <cat> Run all modules in a category
macnoise run --all Run all modules
macnoise list [--category <cat>] List modules
macnoise info <module> Show module details, params, MITRE
macnoise scenario <file.yaml> [--input key=val] [--report report.json]
Run a YAML scenario
macnoise categories List categories with counts
macnoise version Print version
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--format | human | आउटपुट फ़ॉर्मेट: human या jsonl |
--output | (कोई नहीं) | आउटपुट को फ़ाइल में लिखें (stdout के अतिरिक्त) |
--verbose | false | वर्तमान में आउटपुट बदले बिना स्वीकार किया जाता है |
--dry-run | false | क्रियाओं को निष्पादित किए बिना पूर्वावलोकन करें |
--no-cleanup | false | निष्पादन के बाद आर्टिफ़ैक्ट्स बनाए रखें |
--timeout | 30 | प्रति-मॉड्यूल टाइमआउट सेकंड में। 0 टाइमआउट अक्षम करता है |
--audit-log | (कोई नहीं) | OCSF 1.7.0 ऑडिट रिकॉर्ड को JSONL फ़ाइल में लिखें |
--config | (कोई नहीं) | YAML कॉन्फ़िग फ़ाइल से डिफ़ॉल्ट लोड करें |
--run-id | जनरेट किया गया | इस रन के लिए सहसंबंध पहचानकर्ता सेट करें |
डिफ़ॉल्ट रूप से, MacNoise निष्पादन के बाद मॉड्यूल क्लीनअप चलाता है। क्लीनअप उन आर्टिफ़ैक्ट्स को हटाता है जो इनवोकेशन ने बनाए थे और अभी भी उनके स्वामित्व में हैं। यह पूर्ण हो चुकी नेटवर्क, प्रोसेस, या विनाशकारी गतिविधि को उलट नहीं सकता।
यह सत्यापित करने के लिए कि आपका स्टैक स्वयं पर्सिस्टेंस का पता लगाता है, स्कैन चलने के दौरान आर्टिफ़ैक्ट को यथावत रहने दें। उदाहरणों में ~/Library/LaunchAgents में एक LaunchAgent, एक cron प्रविष्टि, और एक संशोधित शेल प्रोफ़ाइल शामिल हैं:
./macnoise run svc_launch_agent --no-cleanup
जो भी मॉड्यूल cleanup छोड़ता है, वह एक diagnostic प्रिंट करता है, और audit log में cleanup_result: skipped दर्ज होता है। किसी मॉड्यूल द्वारा बनाए गए artifacts की समीक्षा करने के लिए module catalog और category guides का उपयोग करें।
इन्हें हटाने की ज़िम्मेदारी आपकी है। उसी मॉड्यूल को बिना flag के दोबारा चलाने पर केवल उसी run में बनाई गई चीज़ें साफ़ होंगी, पिछले --no-cleanup run से बची चीज़ें नहीं।
MacNoise प्रयास किए गए actions के अपने विवरण stdout पर भेजता है। आपके security controls होस्ट पर होने वाली गतिविधि से अपनी telemetry एकत्र करते हैं। संरचित MacNoise events के लिए --format jsonl और किसी फ़ाइल में प्रति जोड़ने के लिए --output का उपयोग करें:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
--audit-log जोड़ें ताकि मॉड्यूल निष्पादन, पूर्वापेक्षा और क्लीनअप परिणाम, और MITRE मैपिंग को OCSF 1.7.0 JSONL में रिकॉर्ड किया जा सके:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl
रन पहचानकर्ता, पूर्वावलोकन, और सफ़ाई निदान stderr पर जाते हैं। प्रत्येक टेलीमेट्री इवेंट में schema 2.0 में एक outcome और एक टाइप्ड subject होता है। subject उस फ़ाइल, प्रक्रिया, नेटवर्क एंडपॉइंट, सेवा, या संसाधन की पहचान करता है जो शामिल है: