
مولّد قابل للتوسيع لبيانات القياس عن بُعد لنظام MacOS.
يولّد MacNoise نشاطًا حقيقيًا على macOS لأغراض التحقق من EDR وهندسة الكشف. شغّل وحدات فردية أو سيناريوهات YAML لاختبار اتصالات الشبكة وكتابة الملفات وتنفيذ العمليات والاستمرارية والوصول إلى TCC وسلوكيات أخرى مقابل ضوابط الأمان لديك.
للاطلاع على خلفية الدوافع والتصميم، راجع منشور المدونة الخاص بالإصدار.
صُمم MacNoise لاختبار أمني مُصرَّح به على أنظمة تملكها أو لديك إذن كتابي صريح لاختبارها. تنفّذ الوحدات النشاط الحقيقي الذي تصفه. وهي ليست معزولة في بيئة رملية، وبعض الإجراءات قد تحذف أو تغيّر بيانات النظام والمستخدم بشكل لا رجعة فيه. راجع سلوك الوحدة ومخرجات التشغيل التجريبي (dry-run) قبل التنفيذ. أنت مسؤول عن اختيار الهدف والتصريح والعواقب. لا يتحمل المؤلفون أي مسؤولية عن سوء الاستخدام.
ابنِ من نسخة مستخرجة من المستودع باستخدام Go 1.24 أو أحدث وMake:
make build
شغّل الملف التنفيذي على macOS. للترجمة المتقاطعة، استخدم make build-amd64 لأجهزة Mac المزوّدة بمعالجات Intel، أو make build-arm64 لأجهزة Apple silicon، أو 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 | فحوصات الوصول الكامل إلى القرص، وجهات الاتصال، وإمكانية الوصول، وتسجيل الشاشة |
| credential | الوصول الأصلي إلى مخزن بيانات الاعتماد |
| volume | إنشاء صور القرص ودورة حياة وحدات التخزين المثبَّتة |
| service | تعداد Launchd، واستمرارية LaunchAgent وLaunchDaemon، وcron، وملفات تعريف الصدفة، وعناصر تسجيل الدخول |
| 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 تنظيف الوحدة بعد التنفيذ. يزيل التنظيف الآثار التي أنشأها الاستدعاء ولا يزال يملكها. لا يمكنه عكس نشاط الشبكة أو العمليات أو النشاط التدميري المكتمل.
للتحقق من أن حزمتك تكشف الاستمرارية بنفسها، اترك الأثر في مكانه أثناء تشغيل الفحص. تشمل الأمثلة LaunchAgent في ~/Library/LaunchAgents، وإدخال cron، وملف تعريف shell معدّل:
./macnoise run svc_launch_agent --no-cleanup
كل وحدة تتخطى التنظيف تطبع تشخيصًا، ويسجّل سجل التدقيق cleanup_result: skipped. استخدم فهرس الوحدات وأدلة الفئات لمراجعة العناصر التي تنشئها الوحدة.
أنت مسؤول عن إزالتها بنفسك. إعادة تشغيل الوحدة نفسها دون العلامة ستُنظّف فقط ما أنشأته تلك التشغيلة، وليس ما خلّفته تشغيلة --no-cleanup سابقة.
تُصدر MacNoise أوصافها الخاصة للإجراءات التي حاولت تنفيذها إلى stdout. وتجمع ضوابط الأمان لديك بياناتها التشخيصية الخاصة من النشاط على المضيف. استخدم --format jsonl لأحداث MacNoise المهيكلة و--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. يحمل كل حدث قياس عن بُعد حقل outcome وحقل subject واحدًا مُحدَّد النوع في المخطط 2.0. يحدد subject الملف أو العملية أو نقطة نهاية الشبكة أو الخدمة أو المورد المعني:
outcome | المعنى | العلامة البشرية |
|---|---|---|
executed | نُفِّذ الإجراء وقام بما تدّعيه الوحدة | [+] |
denied | نُفِّذ الإجراء ورفضته البيئة | [-] |
indeterminate | نُفِّذ الإجراء، لكن لا يمكن استنتاج أي شيء | [?] |
error | فشل MacNoise نفسه في تنفيذ الإجراء | [!] |
يسجّل فحص TCC المرفوض إجراءً رفضته البيئة. أما error فيعني أن MacNoise فشل في تنفيذ الإجراء. يسجّل سجل التدقيق النتيجة في unmapped.outcome. تُستبدل المعاملات المُعلنة كحساسة بـ [REDACTED] في معاملات التدقيق المُدارة، وتُخفي هوية سطر الأوامر قيم --param و--input.
يُلحق سجل التدقيق السجلات عبر عمليات التشغيل. استخدم --run-id لتعيين معرّف ارتباط، أو دع MacNoise يولّد واحدًا. للحصول على تفاصيل تصنيف الأحداث، راجع CONTRIBUTING.md.
تربط السيناريوهات الوحدات في تسلسلات مرتّبة داخل ملف YAML واحد. عاين سيناريو، ثم نفّذه واكتب تقريرًا: