Voltar às atualizações
New releaseSep 15, 2026

macnoise v1.0.0

Gerador extensível de telemetria do sistema MacOS.

Compartilhar
Logotipo do MacNoise

CI Release

MacNoise

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.

Antes de executar

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.

Início rápido

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.

Encontrar um módulo

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:

CategoriaDescrição
networkConexões TCP, HTTP, listeners, reverse shells, DNS e TLS
processExecução, entrega de sinais, injeção de dylib, bypass do Gatekeeper e osascript
fileDescoberta, leituras, cópias, criação, modificação, arquivamento, ocultação e criptografia de iscas
tccSondagens de Acesso Total ao Disco, Contatos, Acessibilidade e Gravação de Tela
credentialAcesso nativo ao armazenamento de credenciais
volumeCriação de imagens de disco e ciclo de vida de volumes montados
serviceEnumeração de Launchd, persistência via LaunchAgent e LaunchDaemon, cron, perfis de shell e Itens de Login
plistCriação e modificação de plists
evasionLimpeza 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.

Comandos

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

Flags globais

FlagPadrãoDescrição
--formathumanFormato de saída: human ou jsonl
--output(nenhum)Grava a saída em arquivo (além do stdout)
--verbosefalseAtualmente aceito sem alterar a saída
--dry-runfalsePré-visualiza as ações sem executá-las
--no-cleanupfalseRetém artefatos após a execução
--timeout30Timeout 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-idgeradoDefine o identificador de correlação para esta execução

Reter artefatos

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.

Captura de saída e registros de auditoria

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:

Categorias