अपडेट पर वापस जाएँ
New releaseAug 2, 2026

macnoise v0.2.1

विस्तारणीय MacOS सिस्टम टेलीमेट्री जनरेटर।

साझा करें
MacNoise लोगो

CI Release

MacNoise

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 मैपिंग को सूचीबद्ध करती है। श्रेणी गाइड प्लेटफ़ॉर्म आवश्यकताओं और मॉड्यूल व्यवहार की व्याख्या करते हैं:

श्रेणीविवरण
networkTCP कनेक्शन, HTTP, लिसनर, रिवर्स शेल, DNS, और TLS
processनिष्पादन, सिग्नल डिलीवरी, dylib इंजेक्शन, Gatekeeper बायपास, और osascript
fileखोज, पढ़ना, प्रतिलिपि बनाना, निर्माण, संशोधन, संग्रहण, छिपाना, और डिकॉय एन्क्रिप्शन
tccFull Disk Access, Contacts, Accessibility, और Screen Recording प्रोब
credentialनेटिव क्रेडेंशियल-स्टोर एक्सेस
volumeडिस्क-इमेज निर्माण और माउंटेड-वॉल्यूम लाइफ़साइकल
serviceLaunchd गणना, LaunchAgent और LaunchDaemon स्थायित्व, cron, शेल प्रोफ़ाइल, और Login Items
plistPlist निर्माण और संशोधन
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

ग्लोबल फ़्लैग

फ़्लैगडिफ़ॉल्टविवरण
--formathumanआउटपुट फ़ॉर्मेट: human या jsonl
--output(कोई नहीं)आउटपुट को फ़ाइल में लिखें (stdout के अतिरिक्त)
--verbosefalseवर्तमान में आउटपुट बदले बिना स्वीकार किया जाता है
--dry-runfalseक्रियाओं को निष्पादित किए बिना पूर्वावलोकन करें
--no-cleanupfalseनिष्पादन के बाद आर्टिफ़ैक्ट्स बनाए रखें
--timeout30प्रति-मॉड्यूल टाइमआउट सेकंड में। 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 से बची चीज़ें नहीं।

आउटपुट और audit records कैप्चर करना

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 उस फ़ाइल, प्रक्रिया, नेटवर्क एंडपॉइंट, सेवा, या संसाधन की पहचान करता है जो शामिल है:

श्रेणियाँ