
Gerador extensível de telemetria do sistema MacOS.
O MacNoise gera atividade real do macOS para validação de EDR e engenharia de detecção. Execute módulos individuais ou cenários YAML para exercitar conexões de rede, gravações de arquivos, execução de processos, persistência, acesso ao TCC e outros comportamentos contra seus controles de segurança.
Para saber mais sobre a motivação e o design, consulte o post do blog de lançamento.
O MacNoise destina-se a testes de segurança autorizados em sistemas que você possui ou para os quais tem permissão escrita explícita para testar. Os módulos executam a atividade real que descrevem. Eles não são isolados em sandbox, e algumas ações podem excluir ou alterar irreversivelmente dados do sistema e do usuário. Revise o comportamento do módulo e a saída de simulação (dry-run) antes da execução. Você é responsável pela seleção do alvo, pela autorização e pelas consequências. Os autores não assumem qualquer responsabilidade por uso indevido.
Compile a partir de um checkout com Go 1.24 ou superior e Make:
make build
Execute o binário no macOS. Para compilação cruzada, use make build-amd64 para Macs Intel, make build-arm64 para Apple silicon, ou make release para ambos.
Liste os módulos e inspecione o que você deseja executar:
./macnoise list
./macnoise info file_create
Visualize os parâmetros e, em seguida, execute o mesmo comando sem --dry-run:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
O segundo comando cria um arquivo, emite telemetria e executa a limpeza. Para visualizar uma sequência conectada de módulos:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
Execute cenários para conectar saídas de módulos, capturar saída para análise, ou reter artefatos para varreduras posteriores.
O catálogo de módulos gerado lista cada módulo, parâmetro, saída, tipo de evento, privilégio e mapeamento ATT&CK. Os guias de categoria explicam os requisitos de plataforma e o comportamento dos módulos:
| Categoria | Descrição |
|---|---|
| network | Conexões TCP, HTTP, listeners, reverse shells, DNS e TLS |
| process | Execução, entrega de sinais, injeção de dylib, bypass do Gatekeeper e osascript |
| file | Descoberta, leituras, cópias, criação, modificação, arquivamento, ocultação e criptografia de iscas |
| tcc | Sondagens de Acesso Total ao Disco, Contatos, Acessibilidade e Gravação de Tela |
| credential | Acesso nativo ao armazenamento de credenciais |
| volume | Criação de imagens de disco e ciclo de vida de volumes montados |
| service | Enumeração de Launchd, persistência via LaunchAgent e LaunchDaemon, cron, perfis de shell e Itens de Login |
| plist | Criação e modificação de plists |
| evasion | Limpeza de logs, timestomping, remoção de histórico e mascaramento |
Use ./macnoise list --category network para filtrar a lista. Para executar uma categoria ou todos os módulos registrados, use ./macnoise run --category network ou ./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 | Padrão | Descrição |
|---|---|---|
--format | human | Formato de saída: human ou jsonl |
--output | (nenhum) | Grava a saída em arquivo (além do stdout) |
--verbose | false | Atualmente aceito sem alterar a saída |
--dry-run | false | Pré-visualiza as ações sem executá-las |
--no-cleanup | false | Retém artefatos após a execução |
--timeout | 30 | Timeout por módulo em segundos. 0 desativa o timeout |
--audit-log | (nenhum) | Grava registros de auditoria OCSF 1.7.0 em um arquivo JSONL |
--config | (nenhum) | Carrega padrões de um arquivo de configuração YAML |
--run-id | gerado | Define o identificador de correlação para esta execução |
Por padrão, o MacNoise executa a limpeza dos módulos após a execução. A limpeza remove artefatos que a invocação criou e ainda possui. Ela não pode reverter atividades de rede, de processo ou destrutivas já concluídas.
Para validar que sua stack detecta a persistência por conta própria, deixe o artefato no lugar enquanto a varredura é executada. Exemplos incluem um LaunchAgent em ~/Library/LaunchAgents, uma entrada de cron e um perfil de shell modificado:
./macnoise run svc_launch_agent --no-cleanup
Cada módulo que ignora a limpeza imprime um diagnóstico, e o log de auditoria registra cleanup_result: skipped. Use o catálogo de módulos e os guias de categoria para revisar os artefatos que um módulo cria.
Você é responsável por removê-los por conta própria. Executar novamente o mesmo módulo sem a flag limpará apenas o que aquela execução criou, não o que uma execução anterior com --no-cleanup deixou para trás.
O MacNoise emite suas próprias descrições das ações tentadas para stdout. Seus controles de segurança coletam sua própria telemetria a partir da atividade no host. Use --format jsonl para eventos estruturados do MacNoise e --output para anexar uma cópia a um arquivo:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
Adicione --audit-log para registrar a execução do módulo, os resultados dos pré-requisitos e da limpeza, e os mapeamentos MITRE em OCSF 1.7.0 JSONL:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl
Identificadores de execução, pré-visualizações e diagnósticos de limpeza vão para stderr. Cada evento de telemetria carrega um outcome e um subject tipado no schema 2.0. O subject identifica o arquivo, processo, endpoint de rede, serviço ou recurso envolvido: