
Erweiterbarer Generator für MacOS-Systemtelemetrie.
MacNoise erzeugt echte macOS-Aktivität für EDR-Validierung und Detection Engineering. Führe einzelne Module oder YAML-Szenarien aus, um Netzwerkverbindungen, Dateischreibvorgänge, Prozessausführung, Persistenz, TCC-Zugriff und andere Verhaltensweisen gegen deine Sicherheitskontrollen zu testen.
Hintergrundinformationen zur Motivation und zum Design findest du im Release-Blogbeitrag.
MacNoise ist für autorisiertes Sicherheitstesting auf Systemen gedacht, die dir gehören oder für die du eine ausdrückliche schriftliche Genehmigung zum Testen hast. Die Module führen die reale Aktivität aus, die sie beschreiben. Sie sind nicht sandboxed, und einige Aktionen können System- und Benutzerdaten unwiderruflich löschen oder verändern. Prüfe das Verhalten der Module und die Dry-Run-Ausgabe vor der Ausführung. Du bist verantwortlich für Zielauswahl, Autorisierung und Konsequenzen. Die Autoren übernehmen keine Haftung für Missbrauch.
Baue aus einem Checkout mit Go 1.24 oder neuer und Make:
make build
Führe die Binärdatei unter macOS aus. Für die Cross-Kompilierung verwende make build-amd64 für Intel-Macs, make build-arm64 für Apple Silicon oder make release für beide.
Liste die Module auf und inspiziere das Modul, das du ausführen möchtest:
./macnoise list
./macnoise info file_create
Vorschau der Parameter anzeigen und anschließend denselben Befehl ohne --dry-run ausführen:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
Der zweite Befehl erstellt eine Datei, sendet Telemetrie und führt die Bereinigung aus. Um eine zusammenhängende Abfolge von Modulen in der Vorschau anzuzeigen:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
Run-Szenarien ausführen, um Modulausgaben zu verbinden, Ausgabe erfassen zur Analyse oder Artefakte aufbewahren für spätere Scans.
Der generierte Modulkatalog listet jedes Modul, jeden Parameter, jede Ausgabe, jeden Ereignistyp, jede Berechtigung und jede ATT&CK-Zuordnung auf. Die Kategorieanleitungen erläutern Plattformanforderungen und das Verhalten der Module:
| Kategorie | Beschreibung |
|---|---|
| network | TCP-Verbindungen, HTTP, Listener, Reverse Shells, DNS und TLS |
| process | Ausführung, Signalzustellung, Dylib-Injection, Gatekeeper-Bypass und osascript |
| file | Discovery, Lesen, Kopieren, Erstellen, Ändern, Archivieren, Verstecken und Decoy-Verschlüsselung |
| tcc | Sondierungen für Full Disk Access, Kontakte, Bedienungshilfen und Bildschirmaufnahme |
| credential | Nativer Zugriff auf den Credential-Store |
| volume | Erstellung von Disk-Images und Lebenszyklus gemounteter Volumes |
| service | Launchd-Enumeration, LaunchAgent- und LaunchDaemon-Persistenz, Cron, Shell-Profile und Login Items |
| plist | Erstellung und Änderung von Plists |
| evasion | Log-Löschung, Timestomping, Entfernung des Verlaufs und Maskerade |
Verwenden Sie ./macnoise list --category network, um die Liste zu filtern. Um eine Kategorie oder alle registrierten Module auszuführen, verwenden Sie ./macnoise run --category network oder ./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
| Flag | Standardwert | Beschreibung |
|---|---|---|
--format | human | Ausgabeformat: human oder jsonl |
--output | (keine) | Ausgabe in Datei schreiben (zusätzlich zu stdout) |
--verbose | false | Derzeit akzeptiert, ohne die Ausgabe zu ändern |
--dry-run | false | Aktionen in der Vorschau anzeigen, ohne sie auszuführen |
--no-cleanup | false | Artefakte beibehalten nach der Ausführung |
--timeout | 30 | Timeout pro Modul in Sekunden. 0 deaktiviert den Timeout |
--audit-log | (keine) | OCSF 1.7.0-Audit-Datensätze in eine JSONL-Datei schreiben |
--config | (keine) | Standardwerte aus einer YAML-Konfigurationsdatei laden |
--run-id | generiert | Korrelationskennung für diesen Lauf festlegen |
Standardmäßig führt MacNoise nach der Ausführung die Modulbereinigung durch. Die Bereinigung entfernt Artefakte, die der Aufruf erstellt hat und noch besitzt. Sie kann abgeschlossene Netzwerk-, Prozess- oder destruktive Aktivitäten nicht rückgängig machen.
Um zu überprüfen, ob Ihr Stack Persistenz selbst erkennt, lassen Sie das Artefakt während des Scans an Ort und Stelle. Beispiele hierfür sind ein LaunchAgent in ~/Library/LaunchAgents, ein Cron-Eintrag und ein modifiziertes Shell-Profil:
./macnoise run svc_launch_agent --no-cleanup
Jedes Modul, das die Bereinigung überspringt, gibt eine Diagnosemeldung aus, und das Audit-Log zeichnet cleanup_result: skipped auf. Verwende den Modulkatalog und die Kategorieanleitungen, um die Artefakte zu überprüfen, die ein Modul erzeugt.
Du bist selbst dafür verantwortlich, diese zu entfernen. Das erneute Ausführen desselben Moduls ohne das Flag bereinigt nur das, was dieser Lauf erzeugt hat, nicht das, was ein vorheriger --no-cleanup-Lauf hinterlassen hat.
MacNoise gibt seine eigenen Beschreibungen der versuchten Aktionen an stdout aus. Deine Sicherheitskontrollen erfassen ihre eigene Telemetrie aus der Aktivität auf dem Host. Verwende --format jsonl für strukturierte MacNoise-Ereignisse und --output, um eine Kopie an eine Datei anzuhängen:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
Fügen Sie --audit-log hinzu, um die Modulausführung, Voraussetzungs- und Bereinigungsergebnisse sowie MITRE-Zuordnungen in OCSF 1.7.0 JSONL aufzuzeichnen:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl