
Расширяемый генератор системной телеметрии MacOS.
MacNoise генерирует реальную активность macOS для проверки EDR и разработки средств обнаружения. Запускайте отдельные модули или YAML-сценарии, чтобы проверить сетевые подключения, запись файлов, выполнение процессов, механизмы закрепления, доступ к TCC и другие поведения против ваших средств защиты.
О мотивации и архитектуре см. пост в блоге о релизе.
MacNoise предназначен для авторизованного тестирования безопасности на системах, которыми вы владеете или на тестирование которых у вас есть явное письменное разрешение. Модули выполняют реальную активность, которую они описывают. Они не изолированы в песочнице, и некоторые действия могут безвозвратно удалить или изменить системные и пользовательские данные. Перед запуском изучите поведение модуля и вывод пробного запуска. Вы несёте ответственность за выбор цели, авторизацию и последствия. Авторы не несут ответственности за неправомерное использование.
Соберите из рабочей копии репозитория с помощью Go 1.24 или новее и Make:
make build
Запустите бинарный файл на macOS. Для кросс-компиляции используйте make build-amd64 для Intel Mac, make build-arm64 для Apple silicon или make release для обоих.
Перечислите модули и изучите тот, который хотите запустить:
./macnoise list
./macnoise info file_create
Просмотрите параметры, затем выполните ту же команду без --dry-run:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
Вторая команда создаёт файл, отправляет телеметрию и выполняет очистку. Чтобы просмотреть связанную последовательность модулей:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
Запустите сценарии, чтобы связать выходные данные модулей, захватите вывод для анализа или сохраните артефакты для последующих сканирований.
Сгенерированный каталог модулей перечисляет каждый модуль, параметр, выходные данные, тип события, привилегию и сопоставление с ATT&CK. Руководства по категориям объясняют требования к платформе и поведение модулей:
| Категория | Описание |
|---|---|
| network | TCP-соединения, HTTP, прослушиватели, обратные оболочки, DNS и TLS |
| process | Выполнение, доставка сигналов, инъекция dylib, обход Gatekeeper и osascript |
| file | Обнаружение, чтение, копирование, создание, изменение, архивирование, скрытие и шифрование-приманка |
| tcc | Проверки Full Disk Access, Contacts, Accessibility и Screen Recording |
| credential | Доступ к нативному хранилищу учётных данных |
| volume | Создание образов дисков и жизненный цикл смонтированных томов |
| service | Перечисление Launchd, персистентность LaunchAgent и LaunchDaemon, cron, профили оболочки и элементы входа |
| plist | Создание и изменение plist |
| evasion | Очистка журналов, подмена временных меток, удаление истории и маскировка |
Используйте ./macnoise list --category network для фильтрации списка. Чтобы выполнить категорию или все зарегистрированные модули, используйте ./macnoise run --category network или ./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
| Флаг | По умолчанию | Описание |
|---|---|---|
--format | human | Формат вывода: human или jsonl |
--output | (нет) | Записать вывод в файл (в дополнение к stdout) |
--verbose | false | В настоящее время принимается без изменения вывода |
--dry-run | false | Предварительный просмотр действий без выполнения |
--no-cleanup | false | Сохранить артефакты после выполнения |
--timeout | 30 | Тайм-аут на модуль в секундах. 0 отключает тайм-аут |
--audit-log | (нет) | Записывать записи аудита OCSF 1.7.0 в файл JSONL |
--config | (нет) | Загрузить значения по умолчанию из файла конфигурации YAML |
--run-id | генерируется | Задать идентификатор корреляции для этого запуска |
По умолчанию MacNoise выполняет очистку модулей после выполнения. Очистка удаляет артефакты, которые создал данный запуск и которыми он всё ещё владеет. Она не может отменить завершённую сетевую, процессную или деструктивную активность.
Чтобы проверить, что ваш стек сам обнаруживает механизмы персистентности, оставьте артефакт на месте во время сканирования. Примеры включают LaunchAgent в ~/Library/LaunchAgents, запись cron и изменённый профиль оболочки:
./macnoise run svc_launch_agent --no-cleanup
Каждый модуль, пропускающий очистку, выводит диагностическое сообщение, а журнал аудита записывает cleanup_result: skipped. Используйте каталог модулей и руководства по категориям, чтобы просмотреть артефакты, создаваемые модулем.
Вы несёте ответственность за их удаление самостоятельно. Повторный запуск того же модуля без флага очистит только то, что создал этот запуск, а не то, что осталось от предыдущего запуска с --no-cleanup.
MacNoise выдаёт собственные описания предпринятых действий в stdout. Ваши средства защиты собирают собственную телеметрию из активности на хосте. Используйте --format jsonl для структурированных событий MacNoise и --output для добавления копии в файл:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
Добавьте --audit-log для записи выполнения модуля, результатов проверки предварительных условий и очистки, а также сопоставлений MITRE в формате OCSF 1.7.0 JSONL:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl
Идентификаторы запусков, предварительные просмотры и диагностика очистки выводятся в stderr. Каждое событие телеметрии содержит outcome и один типизированный subject в схеме 2.0. Subject идентифицирует файл, процесс, сетевую конечную точку, службу или ресурс, участвующий в событии:
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.