
拡張可能なMacOSシステムテレメトリジェネレータ。
MacNoise は、EDR の検証や検出エンジニアリングのために実際の macOS アクティビティを生成します。個々のモジュールまたは YAML シナリオを実行して、ネットワーク接続、ファイル書き込み、プロセス実行、永続化、TCC アクセス、その他の動作をセキュリティ制御に対して試すことができます。
動機と設計の背景については、リリースブログ記事を参照してください。
MacNoise は、所有しているシステム、またはテストする明示的な書面による許可を得ているシステムでの許可されたセキュリティテストを目的としています。モジュールは、その説明どおりの実際のアクティビティを実行します。サンドボックス化されておらず、一部の操作はシステムやユーザーデータを不可逆的に削除または変更する可能性があります。実行前にモジュールの動作とドライラン出力を確認してください。対象の選択、許可、および結果についてはお客様の責任となります。作者は悪用について一切の責任を負いません。
Go 1.24 以降と Make を使用して、チェックアウトからビルドします:
make build
macOS 上でバイナリを実行します。クロスコンパイルするには、Intel Mac の場合は make build-amd64、Apple silicon の場合は 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
2番目のコマンドはファイルを作成し、テレメトリを出力し、クリーンアップを実行します。接続されたモジュールのシーケンスをプレビューするには:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
実行シナリオでモジュールの出力を接続し、出力のキャプチャで分析を行い、またはアーティファクトの保持で後のスキャンに備えます。
生成されたモジュールカタログには、すべてのモジュール、パラメータ、出力、イベントタイプ、権限、および ATT&CK マッピングが一覧表示されています。カテゴリガイドでは、プラットフォーム要件とモジュールの動作について説明しています:
| カテゴリ | 説明 |
|---|---|
| network | TCP 接続、HTTP、リスナー、リバースシェル、DNS、および TLS |
| process | 実行、シグナル送信、dylib インジェクション、Gatekeeper バイパス、および osascript |
| file | 探索、読み取り、コピー、作成、変更、アーカイブ、隠蔽、およびデコイ暗号化 |
| tcc | フルディスクアクセス、連絡先、アクセシビリティ、および画面収録のプローブ |
| 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 は実行後にモジュールのクリーンアップを実行します。クリーンアップは、その呼び出しが作成し、まだ所有しているアーティファクトを削除します。完了したネットワーク、プロセス、または破壊的なアクティビティを元に戻すことはできません。
スタックが永続化自体を検出できることを検証するには、スキャンの実行中にアーティファクトをそのまま残してください。例としては、~/Library/LaunchAgents 内の LaunchAgent、cron エントリ、変更されたシェルプロファイルなどがあります:
./macnoise run svc_launch_agent --no-cleanup
クリーンアップをスキップする各モジュールは診断情報を出力し、監査ログには cleanup_result: skipped が記録されます。モジュールカタログとカテゴリガイドを使用して、モジュールが作成するアーティファクトを確認してください。
これらを削除する責任はあなたにあります。 フラグを付けずに同じモジュールを再実行すると、その実行で作成されたものだけがクリーンアップされ、以前の --no-cleanup 実行で残されたものはクリーンアップされません。
MacNoise は試行されたアクションに関する独自の説明を stdout に出力します。セキュリティ制御はホスト上のアクティビティから独自のテレメトリを収集します。構造化された MacNoise イベントには --format jsonl を、ファイルへのコピーを追記するには --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 に出力されます。すべてのテレメトリイベントは、スキーマ 2.0 において outcome と 1 つの型付き subject を持ちます。subject は、関与するファイル、プロセス、ネットワークエンドポイント、サービス、またはリソースを識別します:
outcome | 意味 | ヒューマンマーカー |
|---|---|---|
executed | アクションが実行され、モジュールが主張する通りの結果になった | [+] |
denied | アクションは実行されたが、環境によって拒否された | [-] |
indeterminate | アクションは実行されたが、何も結論付けられない | [?] |
error | MacNoise 自体がアクションの実行に失敗した | [!] |
拒否された TCC プローブは、環境が拒否したアクションを記録します。error は、MacNoise がアクションの実行に失敗したことを意味します。監査ログは結果を unmapped.outcome に記録します。機密として宣言されたパラメータは、管理された監査パラメータ内で [REDACTED] に置き換えられ、コマンドラインの識別情報は --param と --input の値を伏せます。
監査ログは実行をまたいでレコードを追記します。--run-id を使用して相関識別子を設定するか、MacNoise に生成させてください。イベント分類の詳細については、CONTRIBUTING.md を参照してください。
シナリオは、1 つの 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 ビーコン、HTTP 外部送信オペレーションを組み合わせたもの |
edr_validation.yaml | 包括的な EDR 検出カバレッジ |
full_sweep.yaml | すべてのカテゴリ |
lazarus_group.yaml | Lazarus Group: dylib インジェクション、サービスディスカバリ、リバースシェル、LaunchAgent 永続化 |
amos_atomic_stealer.yaml | AMOS / Atomic Stealer: MaaS インフォスティーラー、Gatekeeper バイパス、キーチェーンダンプ、ZIP 外部送信、バックドア永続化 |
clickfix.yaml | ClickFix: 難読化されたワンライナーを Terminal に貼り付け、base64 デコード、セカンドステージ取得、LaunchAgent 永続化 |
ransomware.yaml | ランサムウェアの影響: 平文のデコイを配置し、それらを暗号化してから身代金要求文書をドロップ |
discovery.yaml | argv ベースのシステム、アカウント、ネットワーク、セキュリティソフトウェアのディスカバリレシピを組み合わせたもの |
process_chain.yaml | 明示的な引数ベクトルから構築された 3 プロセスのシェルチェーン |
file_flow.yaml | 作成、変更、範囲限定ディスカバリ、読み取り、コピー、アーカイブを連結したフロー |
mounted_execution.yaml | 観測されたディスクイメージのマウントポイントからペイロードを作成して実行 |
AMOS シナリオは、そのシーケンスとステップ注釈に使用された脅威レポートを引用しています。Lazarus シナリオは代表的な macOS テクニックを 1 つのシーケンスにグループ化しています。各ステップのコメントには、それが実行する MITRE ATT&CK テクニック名が記載されています。
実行レポートを、セキュリティコントロールが収集したテレメトリおよびアラートと比較してください。アラートが欠落している場合は、そのアクションの結果と検出ルールに照らして調査する必要があります。
シナリオファイルは version: 1 を使用します。この例では、型付き入力を file_create に渡し、その後、宣言された path 出力をアーカイブします。これを archive.yaml として保存します: