
アプリケーションスコープのWindowsネットワークブラウンアウト(ネイティブCおよびBOF形式)
決定論的なレッドチーム検証のための、アプリケーションスコープのWindowsネットワークブラウンアウト。
ネイティブC • Windows Filtering Platform • IPv4 + IPv6 • 動的クリーンアップ
クイックスタート • プロファイル • CLI • 仕組み • ビルド • BOF • 検証
[!CAUTION] 管理された環境でのみ使用してください。 DutchOvenは、あなたが所有するシステム、または評価を明示的に 許可されたシステムでのみ実行してください。これは稼働中のWindowsネットワークポリシーを変更し、昇格した Administratorトークンを必要とします。使用前にSECURITY.mdを確認してください。
DutchOvenは、意図的に小さく作られたWindowsレッドチーム向けプリミティブであり、明示的に指定した実行ファイルパスを 決定論的なネットワークゲートの背後に置きます。各期間中、一致するアプリケーションは一定の間隔でブロックされ、 残りの時間は通過を許可されます。
その結果は、サービス停止や恒久的なファイアウォールルールではなく、再現可能なブラウンアウトです。これにより、 プロセスが稼働したままの状態で、リトライロジック、バッファリング、ヘルス状態の遷移、遅延配信、復旧動作を 測定するための制御された手段が生まれます。
| 設計上の選択 | オペレーターにとっての価値 |
|---|---|
| アプリケーションスコープのWFPフィルター | 実験をオペレーターが指定したパスに限定する |
| 時間制御されたブロック/通過のデューティサイクル | オンライン/オフライン状態だけでなく、測定可能な劣化を生み出す |
| IPv4とIPv6のアトミックな変更 | 両方のアドレスファミリーを同じスケジュールに保つ |
| 動的WFPセッション | エンジンセッションが閉じるとフィルターと生成されたサブレイヤーを削除する |
| ネイティブC実装 | Go、.NET、サービスインストール、カスタムドライバーへの依存がない |
| 明示的なターゲットのみ | 製品の列挙、プロセスの推測、組み込みターゲットデータベースは行わない |
DutchOvenは新規のアウトバウンド接続の認可をゲートします。WFPがすでに認可した既存の接続は遡って 終了されません。中断のない長時間接続フローを検証する場合は、新しいカナリア接続を使用するか、独立して ターゲットに再接続を強制してください。
昇格したPowerShellウィンドウを開きます。
WFPを変更せずに、解決されたターゲットとタイミングを検証します:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --dry-run
デフォルトのブラウンアウトプロファイルを実行します:
.\dutchoven.exe --app 'C:\Path\To\Target.exe'
これが完全な最小呼び出しです。--app が唯一の必須フラグです。デフォルトプロファイルは、5秒周期ごとに1.5秒間ターゲットをブロックし、1分後に終了します。
早期に停止するには Ctrl+C を使用します。DutchOven は WFP セッションを閉じる前にアクティブなフィルタを削除します。プロセスが中断された場合、動的セッションがクリーンアップの最後の砦となります。
プロファイルには有用なスケジュールが組み込まれているため、オペレーターはすべてのタイミング値を指定する必要がありません。
| プロファイル | ブロック | パス | 周期 | 継続時間 | 想定用途 |
|---|---|---|---|---|---|
light | 0.5 s | 4.5 s | 5 s | 60 s | 低影響のリトライ観察 |
brownout | 1.5 s | 3.5 s | 5 s | 60 s | バランスの取れたデフォルト実験 |
heavy | 3.5 s | 1.5 s | 5 s | 60 s | キューおよび回復プレッシャーのテスト |
blackout | 5 s | 0 s | 5 s | 30 s | 短時間で範囲を限定した完全中断 |
プロファイルは1つのオプションフラグで選択します:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --profile heavy
dutchoven --app <absolute.exe> [--app <absolute.exe> ...] [options]
| フラグ | 必須 | 説明 |
|---|---|---|
--app <absolute.exe> | はい | 対象の実行ファイルパス。マルチプロセスアプリケーションの場合は繰り返し指定 |
--profile <name> | いいえ | light、brownout、heavy、または blackout |
--period-ms <ms> | いいえ | ブロック/パスの完全な周期を上書き |
--block-ms <ms> | いいえ | 各周期のブロック部分を上書き |
--duration-ms <ms> | いいえ | 制限された合計実行時間を上書き |
--warmup-ms <ms> | いいえ | 最初のブロック間隔の前にトラフィックを許可 |
--dry-run | いいえ | WFP を開かずに設定を検証して出力 |
--json | いいえ | 設定と状態遷移を JSON Lines として出力 |
--help | いいえ | コマンドのヘルプを表示 |
dutchoven version でビルドバージョンを出力します。
高度なタイミングフラグは、引数の順序に関係なく、選択されたプロファイルを上書きします:
.\dutchoven.exe `
--app 'C:\Path\To\Target.exe' `
--period-ms 8000 `
--block-ms 2000 `
--duration-ms 120000 `
--warmup-ms 5000
JSON Lines はテストハーネスと証拠収集を目的としています:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --profile heavy --json
タイミング制限はパーサーによって適用されます:
100–60000 ms1 ms から完全な期間まで900000 ms(15分)60000 msexplicit executable path
│
▼
WFP application ID
│
├── ALE_AUTH_CONNECT_V4 ──┐
└── ALE_AUTH_CONNECT_V6 ──┤── BLOCK / PASS schedule
│
└── dynamic WFP session cleanup
Windows のターゲットは Unicode として解決され、DutchOven が WFP にアプリケーション ID を問い合わせる前に長いパスへ正規化されます。これにより、ADMINI~1 のような 8.3 形式のパスエイリアスが、プロセスの長形式のイメージ ID に一致できないフィルターを暗黙に作成することを防ぎます。
コンソールは、実時間およびスケジュール相対のタイムスタンプとともに状態遷移を出力します:
Targets: 1
C:\Path\To\Target.exe
Schedule: block=1500ms pass=3500ms period=5000ms duration=60000ms warmup=0ms
Profile: brownout
Mode: brownout
BLOCK cycle=1 filters=2 wall_ms=1786973903811 elapsed_ms=0
PASS cycle=1 wall_ms=1786973908813 elapsed_ms=5000
...
CLEAN filters=0 session=closed cycles=12 wall_ms=1786973963812 elapsed_ms=60000
デフォルトの Linux ビルドでは、パースとドライラン動作を検証します。ライブ WFP ゲートには、 ネイティブ Windows クロスビルドが必要です。
make check
make release
make check はポータブルテストを実行し、Windows 成果物をクロスビルドし、BOF のインポート契約を検証します。make release は artifacts/v<version>/ 配下にストリップ済みのリリース成果物と SHA256SUMS を生成します。
主な出力:
| 成果物 | 用途 |
|---|---|
build/dutchoven | POSIX パーサーおよびドライランバイナリ |
build/dutchoven_tests | コアユニットテスト |
build-windows/dutchoven.exe | ネイティブ Windows WFP ゲート |
build-windows/dutchoven_tests.exe | ネイティブ Windows テストバイナリ |
build-windows/windows_canary.exe | ルーティングされた統合テスト用カナリア |
bof/dutchoven.x64.o | バージョン管理された x64 Beacon Object File |
artifacts/v<version>/ | ストリップ済みリリース EXE、BOF、およびチェックサム |
Windows 実行ファイルは Windows システムライブラリ fwpuclnt、rpcrt4、advapi32 のみにリンクします。
BOF は DutchOven を x64 Beacon 内でインライン実行される短い同期パルスとしてパッケージ化します。COFF オブジェクトをビルドし、バージョン管理された成果物を更新し、そのインポート契約を以下で検証します:
make bof
Cobalt StrikeのScript Managerでbof/dutchoven.cnaを読み込み、Beaconコンソールから呼び出します:
dutchoven "C:\Path\To\Target.exe"
dutchoven "C:\Path\To\Target.exe" heavy
デフォルトプロファイルは brownout です。プロファイルは単一の有界なブロック間隔にマッピングされます:
| プロファイル | パルス |
|---|---|
light | 0.5 秒 |
brownout | 1.5 秒 |
heavy | 3.5 秒 |
blackout | 5 秒 |
各呼び出しは動的 WFP セッションを開き、IPv4 と IPv6 の接続フィルタをアトミックにインストールし、 選択されたパルスを待機し、両方のフィルタを明示的に削除し、戻る前にセッションを閉じます。 明示的な削除が失敗した場合でも、動的セッションを閉じることがクリーンアップの最終手段として機能します。
BOF は Kernel32、Rpcrt4、Fwpuclnt に対して動的関数解決(Dynamic Function Resolution)を使用しており、C
ランタイムのインポートはありません。既存の絶対実行ファイルパスを 1 つ受け取り、昇格された Beacon を必要とし、
BOF をホストするプロセスのゲート処理を拒否します。インラインで実行されるため、スタンドアロンバイナリの
1 分間のマルチサイクルスケジューラを意図的に再現しません。
有用なレッドチームの結果には独立した証拠が必要です。フィルタ追加呼び出しの成功を、対象が意図した ブラウンアウトを経験した証拠として扱わないでください。
リポジトリには、無害な TCP カナリアの 2 つのコピーを使用してこれらのアサーションを自動化する Windows 統合ハーネスが含まれています。昇格された PowerShell セッションと到達可能な非ローカル TCP リスナーが必要です。ループバックトラフィックはルーティングされた WFP 検証の有効な代替にはなりません。
.\tests\windows_integration.ps1 `
-DutchOvenPath '.\build-windows\dutchoven.exe' `
-CanaryPath '.\build-windows\windows_canary.exe' `
-ServerAddress '192.0.2.10' `
-ServerPort 8443
ハーネスは、ベースライン接続性、対象を絞ったブロック、影響を受けないコントロール、正常な 復旧、動的セッションを通じた強制終了からの復旧、およびWFPの残留ゼロを証明する。
DutchOven 0.4.1 は、Elastic Defend 9.4.2を搭載したWindows Server 2022上で検証された: