MacNoise 为 EDR 验证和检测工程生成真实的 macOS 活动。运行单个模块或 YAML 场景,以针对你的安全控制措施触发网络连接、文件写入、进程执行、持久化、TCC 访问及其他行为。
有关动机和设计的背景信息,请参阅发布博客文章。
MacNoise 旨在用于对你拥有或已获得明确书面许可进行测试的系统上开展经授权的安全测试。模块会执行其所描述的真实活动。它们并未运行在沙箱中,某些操作可能会不可逆地删除或更改系统和用户数据。在执行前请审查模块行为和试运行输出。你需对目标选择、授权及后果负责。作者对滥用不承担任何责任。
使用 Go 1.24 或更高版本以及 Make,从代码检出目录构建:
make build
在 macOS 上运行该二进制文件。要进行交叉编译,Intel Mac 使用 make build-amd64,Apple 芯片使用 make build-arm64,或使用 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、监听器、反向 shell、DNS 和 TLS |
| process | 执行、信号传递、dylib 注入、Gatekeeper 绕过和 osascript |
| file | 发现、读取、复制、创建、修改、归档、隐藏和诱饵加密 |
| tcc | 完全磁盘访问权限、通讯录、辅助功能和屏幕录制探测 |
| credential | 原生凭据存储访问 |
| volume | 磁盘映像创建和已挂载卷生命周期 |
| service | Launchd 枚举、LaunchAgent 和 LaunchDaemon 持久化、cron、shell 配置文件和登录项 |
| 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 在执行后运行模块清理。清理会移除本次调用创建且仍归其所有的工件。它无法撤销已完成的网络、进程或破坏性活动。
要验证你的技术栈本身能否检测持久化,请在扫描运行期间将工件保留在原位。示例包括 ~/Library/LaunchAgents 中的 LaunchAgent、cron 条目以及被修改的 shell 配置文件:
./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。每个遥测事件在 schema 2.0 中都带有一个 outcome 和一个带类型的 subject。该 subject 标识所涉及的文件、进程、网络端点、服务或资源:
outcome | 含义 | 人类可读标记 |
|---|---|---|
executed | 操作已执行,且完成了模块所声称的行为 | [+] |
denied | 操作已执行,但环境拒绝了它 | [-] |
indeterminate | 操作已执行,但无法得出任何结论 | [?] |
error | MacNoise 自身未能执行该操作 | [!] |
被拒绝的 TCC 探测会记录一个被环境拒绝的操作。error 表示 MacNoise 未能执行该操作。审计日志会在 unmapped.outcome 处记录结果。声明为敏感的参数在受管审计参数中会被替换为 [REDACTED],而命令行身份信息会隐去 --param 和 --input 的值。
审计日志会跨运行追加记录。使用 --run-id 设置关联标识符,或让 MacNoise 自动生成一个。有关事件分类的详细信息,请参阅 CONTRIBUTING.md。
场景可在单个 YAML 文件中将模块连接为有序序列。先预览场景,然后执行它并写入报告:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
./macnoise scenario configs/scenarios/file_flow.yaml --report /tmp/report.json
从 configs/scenarios/ 中选择一个场景:
| 文件 | 描述 |
|---|---|
network_only.yaml | 组合的 TCP、监听器、DNS、HTTP beacon 和 HTTP 外传操作 |
edr_validation.yaml | 全面的 EDR 检测覆盖 |
full_sweep.yaml | 所有类别 |
lazarus_group.yaml | Lazarus Group:dylib 注入、服务发现、反向 shell、LaunchAgent 持久化 |
amos_atomic_stealer.yaml | AMOS / Atomic Stealer:MaaS 信息窃取器、Gatekeeper 绕过、钥匙串转储、ZIP 外传、后门持久化 |
clickfix.yaml | ClickFix:粘贴到终端中的混淆单行命令、base64 解码、第二阶段获取、LaunchAgent 持久化 |
ransomware.yaml | 勒索软件影响:投放明文诱饵文件、加密它们,然后投放勒索信 |
discovery.yaml | 组合的基于 argv 的系统、账户、网络和安全软件发现配方 |
process_chain.yaml | 由显式参数向量构建的三进程 shell 链 |
file_flow.yaml | 连接的创建、修改、有界发现、读取、复制和归档流程 |
mounted_execution.yaml | 从观察到的磁盘映像挂载点创建并执行载荷 |
AMOS 场景引用了用于其序列和步骤注释的威胁报告。Lazarus 场景将具有代表性的 macOS 技术分组到一个序列中。每个步骤注释都指明了它所演练的 MITRE ATT&CK 技术。
将执行报告与你的安全控制措施收集的遥测和告警进行比较。缺失的告警需要结合该操作的结果和你的检测规则进行调查。
场景文件使用 version: 1。此示例将类型化输入传递给 file_create,然后归档其声明的 path 输出。将其保存为 archive.yaml:
version: 1
name: Archive one generated artifact
on_error: stop
inputs:
content:
type: string
required: true
steps:
- id: create
module: file_create
params:
filename: artifact.txt
content:
input: content
- id: archive
module: file_archive
params:
source_path:
output: create.path
tool: tar
output_path: /tmp/macnoise_example.tar.gz
outputs:
archive:
output: archive.path
Supply the input and preview the sequence:
./macnoise scenario archive.yaml --input content=example --dry-run
MacNoise 在预览或执行前会校验参数类型、名称和引用。只有已声明的模块输出才能被引用。on_error 默认为 stop。当后续模块调用应在失败后继续运行时,将其设置为 continue。取消操作始终会停止运行。
使用 include 步骤复用本地场景。包含文件相对于包含它的文件解析,必须位于根场景目录之下,拒绝循环引用,且最多允许八层嵌套。MacNoise 会为本次运行创建一个私有工作区,并按相反顺序清理被调用的模块。除非使用 --no-cleanup,否则清理会删除生成的产物,因此报告中的路径在执行后可能已不存在。
从场景模板开始,了解类型化输入、输出和连接的数据流。
版本 1.0 定义了受支持的 CLI 命令和标志、模块名称与契约、场景 schema 1、遥测 schema 2.0 以及场景报告 schema 1.0。未来对这些接口的不兼容变更需要新的主版本发布。
有关原语、场景和核心变更的路径,请参阅 CONTRIBUTING.md。