
Anwendungsspezifische Windows-Netzwerk-Brownouts in nativem C und BOF-Form
Anwendungsbezogene Windows-Netzwerk-Brownouts für deterministische Red-Team-Validierung.
Natives C • Windows Filtering Platform • IPv4 + IPv6 • Dynamische Bereinigung
Den begleitenden Blogbeitrag lesen →
Schnellstart • Profile • CLI • Funktionsweise • Build • BOF • Validierung
[!CAUTION] Nur kontrollierte Umgebungen. Führe DutchOven nur auf Systemen aus, die dir gehören oder für deren Bewertung du ausdrücklich autorisiert bist. Es ändert die aktive Windows-Netzwerkrichtlinie und erfordert ein erhöhtes Administrator-Token. Lies SECURITY.md vor der Verwendung.
DutchOven ist ein bewusst kleines Windows-Red-Team-Primitiv, das explizite ausführbare Pfade hinter ein deterministisches Netzwerk-Gate stellt. Während jeder Periode werden passende Anwendungen für ein begrenztes Intervall blockiert und für die restliche Zeit durchgelassen.
Das Ergebnis ist ein wiederholbarer Brownout, kein Dienststopp und keine dauerhafte Firewall-Regel. Es schafft eine kontrollierte Möglichkeit, Retry-Logik, Pufferung, Zustandsübergänge, verzögerte Zustellung und Wiederherstellungsverhalten zu messen, während ein Prozess am Leben bleibt.
| Designentscheidung | Nutzen für den Operator |
|---|---|
| Anwendungsbezogene WFP-Filter | Beschränkt das Experiment auf vom Operator angegebene Pfade |
| Zeitgesteuerter Block-/Durchlass-Zyklus | Erzeugt messbare Verschlechterung statt nur Online-/Offline-Zuständen |
| Atomare IPv4- und IPv6-Änderungen | Hält beide Adressfamilien im selben Zeitplan |
| Dynamische WFP-Sitzung | Entfernt Filter und die generierte Unterschicht beim Schließen der Engine-Sitzung |
| Native C-Implementierung | Keine Abhängigkeit von Go, .NET, Dienstinstallation oder eigenem Treiber |
| Nur explizite Ziele | Keine Produkterkennung, Prozess-Raterei oder eingebettete Zieldatenbank |
DutchOven steuert die Autorisierung neuer ausgehender Verbindungen. Eine bestehende Verbindung, die WFP bereits autorisiert hat, wird nicht nachträglich beendet; verwende eine frische Canary-Verbindung oder erzwinge unabhängig ein erneutes Verbinden des Ziels, wenn ein ununterbrochener langlebiger Flow validiert wird.
Öffne ein erhöhtes PowerShell-Fenster.
Validiere das aufgelöste Ziel und das Timing, ohne WFP zu ändern:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --dry-run
Führen Sie das Standard-Brownout-Profil aus:
.\dutchoven.exe --app 'C:\Path\To\Target.exe'
Das ist der vollständige minimale Aufruf. --app ist das einzige erforderliche Flag. Das Standardprofil blockiert das Ziel 1,5 Sekunden in jedem 5-Sekunden-Zeitraum und beendet sich nach einer Minute.
Verwenden Sie Ctrl+C, um vorzeitig zu stoppen. DutchOven entfernt aktive Filter, bevor es seine WFP-Sitzung schließt; die dynamische Sitzung ist die Bereinigungsabsicherung, falls der Prozess unterbrochen wird.
Profile enthalten nützliche Zeitpläne, sodass Betreiber nicht jeden Zeitwert einzeln angeben müssen.
| Profil | Blockierung | Freigabe | Periode | Dauer | Verwendungszweck |
|---|---|---|---|---|---|
light | 0,5 s | 4,5 s | 5 s | 60 s | Beobachtung von Wiederholungsversuchen mit geringer Auswirkung |
brownout | 1,5 s | 3,5 s | 5 s | 60 s | Ausgewogenes Standardexperiment |
heavy | 3,5 s | 1,5 s | 5 s | 60 s | Test von Warteschlangen- und Wiederherstellungsdruck |
blackout | 5 s | 0 s | 5 s | 30 s | Kurze, begrenzte vollständige Unterbrechung |
Wählen Sie ein Profil mit einem optionalen Flag:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --profile heavy
dutchoven --app <absolute.exe> [--app <absolute.exe> ...] [options]
| Flag | Erforderlich | Beschreibung |
|---|---|---|
--app <absolute.exe> | Ja | Pfad zur Ziel-Executable; für Multiprozess-Anwendungen wiederholen |
--profile <name> | Nein | light, brownout, heavy oder blackout |
--period-ms <ms> | Nein | Überschreibt die vollständige Block-/Pass-Periode |
--block-ms <ms> | Nein | Überschreibt den blockierten Anteil jeder Periode |
--duration-ms <ms> | Nein | Überschreibt die begrenzte Gesamtlaufzeit |
--warmup-ms <ms> | Nein | Erlaubt Traffic vor dem ersten Blockintervall |
--dry-run | Nein | Validiert und gibt die Konfiguration aus, ohne WFP zu öffnen |
--json | Nein | Gibt Konfiguration und Zustandsübergänge als JSON Lines aus |
--help | Nein | Gibt die Befehlshilfe aus |
Geben Sie die Build-Version mit dutchoven version aus.
Erweiterte Timing-Flags überschreiben das ausgewählte Profil unabhängig von der Reihenfolge der Argumente:
.\dutchoven.exe `
--app 'C:\Path\To\Target.exe' `
--period-ms 8000 `
--block-ms 2000 `
--duration-ms 120000 `
--warmup-ms 5000
JSON Lines sind für Test-Harnesses und die Beweissammlung gedacht:
.\dutchoven.exe --app 'C:\Path\To\Target.exe' --profile heavy --json
Zeitlimits werden durch den Parser erzwungen:
100–60000 ms1 ms bis zur vollständigen Periode900000 ms (15 Minuten)60000 msexplicit executable path
│
▼
WFP application ID
│
├── ALE_AUTH_CONNECT_V4 ──┐
└── ALE_AUTH_CONNECT_V6 ──┤── BLOCK / PASS schedule
│
└── dynamic WFP session cleanup
Windows-Ziele werden als Unicode aufgelöst und vor der Anfrage von DutchOven an WFP
für eine Anwendungsidentität zu ihrem langen Pfad kanonisiert. Dies verhindert, dass ein 8.3-Pfadalias wie ADMINI~1 stillschweigend
einen Filter erstellt, der nicht mit der langformatigen Image-Identität des Prozesses übereinstimmen kann.
Die Konsole gibt Zustandsübergänge mit Wanduhr- und zeitplanrelativen Zeitstempeln aus:
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
Der Standard-Linux-Build testet Parsing- und Dry-Run-Verhalten. Das Live-WFP-Gate erfordert den nativen Windows-Cross-Build.
make check
make release
make check führt die portablen Tests aus, erstellt die Windows-Artefakte im Cross-Build und überprüft den BOF-Importvertrag. make release erzeugt gestrippte Release-Artefakte und SHA256SUMS unter artifacts/v<version>/.
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.