
Generador extensible de telemetría del sistema macOS.
MacNoise genera actividad real de macOS para la validación de EDR y la ingeniería de detección. Ejecute módulos individuales o escenarios YAML para ejercitar conexiones de red, escrituras de archivos, ejecución de procesos, persistencia, acceso a TCC y otros comportamientos contra sus controles de seguridad.
Para conocer los antecedentes sobre la motivación y el diseño, consulte la publicación del blog de lanzamiento.
MacNoise está destinado a pruebas de seguridad autorizadas en sistemas de su propiedad o para los que cuente con permiso escrito explícito para probar. Los módulos realizan la actividad real que describen. No están en sandbox y algunas acciones pueden eliminar o alterar de forma irreversible datos del sistema y del usuario. Revise el comportamiento de los módulos y la salida de simulación (dry-run) antes de la ejecución. Usted es responsable de la selección del objetivo, la autorización y las consecuencias. Los autores no asumen ninguna responsabilidad por el uso indebido.
Compile desde una copia del repositorio con Go 1.24 o posterior y Make:
make build
Ejecuta el binario en macOS. Para compilar de forma cruzada, usa make build-amd64 para Macs Intel, make build-arm64 para Apple silicon, o make release para ambos.
Lista los módulos e inspecciona el que quieras ejecutar:
./macnoise list
./macnoise info file_create
Previsualiza los parámetros y, a continuación, ejecuta el mismo comando sin --dry-run:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
El segundo comando crea un archivo, emite telemetría y ejecuta la limpieza. Para previsualizar una secuencia conectada de módulos:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
Ejecutar escenarios para conectar las salidas de los módulos, capturar la salida para su análisis, o conservar artefactos para escaneos posteriores.
El catálogo de módulos generado enumera cada módulo, parámetro, salida, tipo de evento, privilegio y mapeo ATT&CK. Las guías por categoría explican los requisitos de plataforma y el comportamiento de los módulos:
| Categoría | Descripción |
|---|---|
| network | Conexiones TCP, HTTP, listeners, reverse shells, DNS y TLS |
| process | Ejecución, entrega de señales, inyección de dylib, evasión de Gatekeeper y osascript |
| file | Descubrimiento, lecturas, copias, creación, modificación, archivado, ocultación y cifrado señuelo |
| tcc | Sondas de Acceso Total al Disco, Contactos, Accesibilidad y Grabación de Pantalla |
| credential | Acceso nativo al almacén de credenciales |
| volume | Creación de imágenes de disco y ciclo de vida de volúmenes montados |
| service | Enumeración de Launchd, persistencia mediante LaunchAgent y LaunchDaemon, cron, perfiles de shell y elementos de inicio de sesión |
| plist | Creación y modificación de plist |
| evasion | Borrado de registros, timestomping, eliminación del historial y suplantación |
Use ./macnoise list --category network para filtrar la lista. Para ejecutar una categoría o todos los módulos registrados, use ./macnoise run --category network o ./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 | Predeterminado | Descripción |
|---|---|---|
--format | human | Formato de salida: human o jsonl |
--output | (ninguno) | Escribir la salida en un archivo (además de stdout) |
--verbose | false | Actualmente se acepta sin cambiar la salida |
--dry-run | false | Previsualizar acciones sin ejecutarlas |
--no-cleanup | false | Conservar artefactos después de la ejecución |
--timeout | 30 | Tiempo de espera por módulo en segundos. 0 desactiva el tiempo de espera |
--audit-log | (ninguno) | Escribir registros de auditoría OCSF 1.7.0 en un archivo JSONL |
--config | (ninguno) | Cargar valores predeterminados desde un archivo de configuración YAML |
--run-id | generado | Establecer el identificador de correlación para esta ejecución |
De forma predeterminada, MacNoise ejecuta la limpieza del módulo después de la ejecución. La limpieza elimina los artefactos que la invocación creó y que aún posee. No puede revertir la actividad de red, de procesos o destructiva ya completada.
Para validar que tu stack detecta la persistencia por sí mismo, deja el artefacto en su lugar mientras se ejecuta el escaneo. Los ejemplos incluyen un LaunchAgent en ~/Library/LaunchAgents, una entrada de cron y un perfil de shell modificado:
./macnoise run svc_launch_agent --no-cleanup
Cada módulo que omite la limpieza imprime un diagnóstico, y el registro de auditoría registra cleanup_result: skipped. Utilice el catálogo de módulos y las guías de categorías para revisar los artefactos que crea un módulo.
Usted es responsable de eliminarlos por su cuenta. Volver a ejecutar el mismo módulo sin el flag limpiará únicamente lo que esa ejecución creó, no lo que dejó atrás una ejecución anterior con --no-cleanup.
MacNoise emite sus propias descripciones de las acciones intentadas a stdout. Sus controles de seguridad recopilan su propia telemetría a partir de la actividad en el host. Utilice --format jsonl para eventos estructurados de MacNoise y --output para añadir una copia a un archivo:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
Añade --audit-log para registrar la ejecución de módulos, los resultados de los prerrequisitos y la limpieza, y las asignaciones de MITRE en OCSF 1.7.0 JSONL:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl