
Generatore di telemetria di sistema macOS estensibile.
MacNoise genera attività macOS reali per la validazione EDR e l'ingegneria delle rilevazioni. Esegui singoli moduli o scenari YAML per mettere alla prova connessioni di rete, scritture su file, esecuzione di processi, persistenza, accesso TCC e altri comportamenti contro i tuoi controlli di sicurezza.
Per il contesto sulle motivazioni e sul design, consulta il post del blog di rilascio.
MacNoise è destinato a test di sicurezza autorizzati su sistemi di tua proprietà o per i quali disponi di esplicita autorizzazione scritta all'esecuzione dei test. I moduli eseguono l'attività reale che descrivono. Non sono isolati in sandbox e alcune azioni possono eliminare o alterare in modo irreversibile dati di sistema e dell'utente. Esamina il comportamento dei moduli e l'output della modalità dry-run prima dell'esecuzione. Sei responsabile della selezione dei target, dell'autorizzazione e delle conseguenze. Gli autori non si assumono alcuna responsabilità per uso improprio.
Compila da un checkout con Go 1.24 o successivo e Make:
make build
Esegui il binario su macOS. Per la compilazione incrociata, usa make build-amd64 per i Mac Intel, make build-arm64 per Apple silicon, oppure make release per entrambi.
Elenca i moduli e ispeziona quello che vuoi eseguire:
./macnoise list
./macnoise info file_create
Visualizza in anteprima i parametri, quindi esegui lo stesso comando senza --dry-run:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
Il secondo comando crea un file, emette telemetria ed esegue la pulizia. Per visualizzare in anteprima una sequenza connessa di moduli:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
Esegui gli scenari per collegare gli output dei moduli, cattura l'output per l'analisi, oppure conserva gli artefatti per scansioni successive.
Il catalogo dei moduli generato elenca ogni modulo, parametro, output, tipo di evento, privilegio e mappatura ATT&CK. Le guide per categoria spiegano i requisiti della piattaforma e il comportamento dei moduli:
| Categoria | Descrizione |
|---|---|
| network | Connessioni TCP, HTTP, listener, reverse shell, DNS e TLS |
| process | Esecuzione, invio di segnali, iniezione di dylib, bypass di Gatekeeper e osascript |
| file | Scoperta, lettura, copia, creazione, modifica, archiviazione, occultamento e crittografia esca |
| tcc | Sonde per Full Disk Access, Contatti, Accessibilità e Registrazione schermo |
| credential | Accesso nativo all'archivio delle credenziali |
| volume | Creazione di immagini disco e ciclo di vita dei volumi montati |
| service | Enumerazione di Launchd, persistenza tramite LaunchAgent e LaunchDaemon, cron, profili shell e Login Items |
| plist | Creazione e modifica di plist |
| evasion | Cancellazione dei log, timestomping, rimozione della cronologia e masquerading |
Usa ./macnoise list --category network per filtrare l'elenco. Per eseguire una categoria o tutti i moduli registrati, usa ./macnoise run --category network oppure ./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 | Predefinito | Descrizione |
|---|---|---|
--format | human | Formato di output: human o jsonl |
--output | (nessuno) | Scrive l'output su file (in aggiunta a stdout) |
--verbose | false | Attualmente accettato senza modificare l'output |
--dry-run | false | Anteprima delle azioni senza esecuzione |
--no-cleanup | false | Mantiene gli artefatti dopo l'esecuzione |
--timeout | 30 | Timeout per modulo in secondi. 0 disabilita il timeout |
--audit-log | (nessuno) | Scrive i record di audit OCSF 1.7.0 in un file JSONL |
--config | (nessuno) | Carica i valori predefiniti da un file di configurazione YAML |
--run-id | generato | Imposta l'identificatore di correlazione per questa esecuzione |
Per impostazione predefinita, MacNoise esegue la pulizia dei moduli dopo l'esecuzione. La pulizia rimuove gli artefatti creati dall'invocazione e ancora di sua proprietà. Non può annullare attività di rete, di processo o distruttive già completate.
Per verificare che il tuo stack rilevi autonomamente la persistenza, lascia l'artefatto in posizione durante l'esecuzione della scansione. Esempi includono un LaunchAgent in ~/Library/LaunchAgents, una voce cron e un profilo shell modificato:
./macnoise run svc_launch_agent --no-cleanup
Ogni modulo che salta la pulizia stampa una diagnostica, e il registro di audit registra cleanup_result: skipped. Usa il catalogo dei moduli e le guide per categoria per rivedere gli artefatti creati da un modulo.
Sei responsabile della loro rimozione. Rieseguire lo stesso modulo senza il flag pulirà solo ciò che quella esecuzione ha creato, non ciò che una precedente esecuzione con --no-cleanup ha lasciato.
MacNoise emette le proprie descrizioni delle azioni tentate su stdout. I tuoi controlli di sicurezza raccolgono la propria telemetria dall'attività sull'host. Usa --format jsonl per gli eventi strutturati di MacNoise e --output per aggiungere una copia a un file:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
Aggiungi --audit-log per registrare l'esecuzione del modulo, gli esiti dei prerequisiti e della pulizia, e le mappature MITRE in JSONL OCSF 1.7.0:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl