Beweisführendes erstes autonomes Web-Sicherheitstesten für kontrollierte, autorisierte Ziele. Mit reproduzierbaren Laboren, Prüfpfaden, Berichten und XBEN-Benchmarking.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7171/c6015851ea85c8a14cf1ecf4737ff05aaafe1413ed484c69d433e3700aa1c1b8.png" alt="Ravage-Logo" width="360">
</p>
# Ravage
Ravage ist ein evidenzbasiertes CLI zur Bewertung einer laufenden Webanwendung, die dir gehört oder für die du ausdrücklich zur Durchführung von Tests autorisiert bist. Es kombiniert deterministische Aufklärung und Validierung mit einer optionalen modellgesteuerten Angriffsschleife und hält dabei Umfang, Authentifizierung, Traffic-Abrechnung und Beweise in code-eigenen Grenzen.
Ravage ist eine Forschungs-Alpha vor Version 1.0. Verwende Wegwerf-Umgebungen und eine schriftliche Rules of Engagement. Sicherheitstests können den Zustand der Anwendung verändern; Ravage behebt keine Befunde und stellt keine Fixes bereit.
[Quickstart](#fünf-minuten-lokaler-quickstart) ·
[Authentifizierung](#authentifiziertes-testen) ·
[Ergebnisse](#ergebnisse-verstehen) ·
[Funktionen](#funktionen) ·
[Dokumentation](#dokumentation)
## Anforderungen
- Python 3.12
- Git
- macOS, Linux oder WSL
- Docker nur für containerisierte Tools, XBEN und Integrationstests
- Ein Provider-API-Schlüssel nur für modellgesteuerte Befehle
Der normale erste Scan benötigt keinen Modellschlüssel, Browser, Docker-Daemon oder externen Scanner.
## Installation aus dem Quellcode
~~~bash
git clone https://github.com/duriantaco/ravage.git
cd ravage
scripts/bootstrap.sh
source .venv/bin/activate
ravage doctor
~~~
Das Bootstrap erstellt <code>.venv</code> und installiert den Workspace. Verwende
<code>scripts/bootstrap.sh --dev</code> für Entwicklungsabhängigkeiten,
<code>--browser</code> für Browserunterstützung oder
<code>--install-browser</code>, um zusätzlich Chromium zu installieren.
## Fünf-Minuten lokaler Quickstart
Starte zuerst deine Anwendung. Dieses Beispiel geht davon aus, dass sie auf
<code>http://127.0.0.1:3000</code> lauscht.
1. Erstelle einen abgegrenzten Engagement-Brief und eine private Umgebungsdatei:
~~~bash
ravage init http://127.0.0.1:3000 \
--brief ravage-brief.yaml \
--env-file .env.ravage \
--description "Autorisierte Bewertung meiner lokalen Entwicklungs-App."
~~~
2. Überprüfe <code>ravage-brief.yaml</code>. Prüfe das Ziel, die In-Scope-Routen,
Ausschlüsse, das Anfragebudget, die Ratenbegrenzung, die Ziele und die Erfolgskriterien.
3. Führe einen Oberflächenscan ohne Modell durch:
~~~bash
ravage doctor --workflow scan --brief ravage-brief.yaml
ravage scan ravage-brief.yaml --probe surface_map --report
~~~
Der Befehl gibt das Ausführungsverzeichnis aus. Kopiere diesen Pfad und verwende ihn als
<code>RUN_DIR</code> in den untenstehenden Inspektionsbefehlen.
## Den modellgesteuerten Agenten ausführen
Füge einen unterstützten Provider-Schlüssel, z. B. <code>OPENAI_API_KEY</code>, zu
<code>.env.ravage</code> hinzu. Ravage liest diese Datei direkt; verwende sie nicht als Shell-Source.
~~~bash
ravage doctor --workflow attack --brief ravage-brief.yaml
ravage attack ravage-brief.yaml --allow-paid-models --report
~~~
<code>--allow-paid-models</code> ist eine ausdrückliche Bestätigung, dass der Lauf
Providerkosten verursachen kann. Modellauswahl, lokale Provider und reproduzierbare
Profile sind in [Modell-Provider](https://github.com/duriantaco/ravage/blob/main/docs/model-providers.md) dokumentiert.
## Authentifiziertes Testen
Füge dem Brief eine dedizierte Testidentität hinzu:
~~~bash
ravage auth add ravage-brief.yaml \
--identity user \
--type form \
--login /login \
--health /account \
--marker Logout \
--env-file .env.ravage
~~~
Fülle die generierten Geheimnisreferenzen aus, verifiziere die Sitzung und greife dann mit der ausgewählten Identität an:
~~~bash
ravage auth check ravage-brief.yaml --identity user
ravage attack ravage-brief.yaml \
--identity user \
--allow-paid-models \
--report
~~~
Formular-Login, Bearer-Tokens und feste statische Header werden unterstützt. Verwaltete
Anmeldedaten bleiben innerhalb des authentifizierten HTTP-Owners; Prozess-, Python- und
Befehls-Lanes werden blockiert, wenn eine Identität ausgewählt ist. Siehe
[Authentifizierung](https://github.com/duriantaco/ravage/blob/main/docs/authentication.md) für Einrichtung und Einschränkungen.
## Autorisierte Remote-Ziele
Remote-Ausführung ist fail-closed und erfordert ein explizites Flag. Beginne mit einem
risikoarmen Oberflächenscan:
~~~bash
ravage init https://staging.example.test \
--brief ravage-brief.yaml \
--env-file .env.ravage \
--description "Autorisierte Bewertung meiner Staging-Anwendung."
ravage doctor --workflow scan \
--brief ravage-brief.yaml \
--authorized-remote-target
ravage scan ravage-brief.yaml \
--probe surface_map \
--authorized-remote-target \
--report
~~~
Für einen modellgesteuerten Remote-Lauf:
~~~bash
ravage attack ravage-brief.yaml \
--authorized-remote-target \
--allow-paid-models \
--report
~~~
Autorisierte Remote-Angriffe verwenden standardmäßig die Low-Noise-Richtlinie für den gesamten Lauf:
natives gemessenes HTTP, Pacing unter 1 RPS, eine Obergrenze für physische Anfragen,
konservatives GET/HEAD-Caching und Deduplizierung, adaptives Backoff, begrenzte Wiederholungen und
Circuit Breaking. Das dauerhafte Ledger übersteht Fortsetzungen. Details finden sich in
[Architektur](https://github.com/duriantaco/ravage/blob/main/docs/architecture.md).
## Ergebnisse verstehen
Ravage unterscheidet Beobachtungen, Kandidatenbefunde und bestätigte
Schwachstellen. Eine CTF-Flagge ist ein möglicher Beweis, keine Anforderung. Bei einer
gewöhnlichen Anwendung kann ein Lauf nützlich und erfolgreich sein, ohne eine Flagge zu finden;
bestätigte Schwachstellen werden trotzdem in den Bericht geschrieben.
Sobald ein Angriffslauf startet, ist sein kanonisches privates maschinenlesbares Artefakt
<code>RUN_DIR/report.json</code>, einschließlich unvollständiger Läufe.
<code>--report</code> schreibt außerdem <code>RUN_DIR/report.md</code>.
~~~bash
ravage observe RUN_DIR
ravage audit verify RUN_DIR
ravage report RUN_DIR --brief ravage-brief.yaml
~~~
Für strukturiertes HTTP, das vom Agentengraphen erfasst wurde:
~~~bash
ravage traffic list RUN_DIR
ravage traffic show RUN_DIR REQUEST_ID
~~~
Der Bericht enthält Beweisreferenzen, Qualität der Anfrageabrechnung, Abschlussstatus
und den Grund, warum ein unvollständiger Lauf gestoppt wurde. Behandle niemals eine unvalidierte
Modellbehauptung als bestätigten Befund.
## Funktionen
| Funktion | Einstiegspunkt | Hinweise |
| --- | --- | --- |
| Deterministische Aufklärung und Probes | <code>ravage scan</code> | Kein Modell erforderlich |
| Modellgesteuerte Bewertung | <code>ravage attack</code> | Beweisgesteuert und abgegrenzt |
| Verwaltete Authentifizierung | <code>ravage auth</code> | Formular, Bearer, statischer Header |
| Traffic-Inspektion und -Wiedergabe | <code>ravage traffic</code> | Abgegrenzte Artefakte |
| Wissens-Skills | <code>ravage skills</code>, <code>ravage code-bug</code> | Beratend |
| Passive SATCOM-Inspektion | <code>ravage satcom inspect</code> | Kein Senden |
| XBEN-Bewertung | <code>ravage xben</code> | Docker-basierte Forschungsumgebung |
| Improvement Lab | <code>scripts/improvement_lab.py</code> | Isoliertes Archiv |
Wissens-Skills können die Priorisierung leiten, aber keine Tools hinzufügen, den Umfang erweitern
oder Befunde bestätigen. Beginne mit:
~~~bash
ravage skills list builtin
ravage skills validate builtin
~~~
Das [Improvement Lab](https://github.com/duriantaco/ravage/blob/main/docs/improvement-lab.md) nimmt bereinigte Strukturen früherer Läufe auf,
bewertet Kandidaten-Patches in unabhängigen Workspaces, archiviert akzeptierte
und abgelehnte Versionen und erfordert übereinstimmende No-Regression-Beweise
vor der Promotion. Es ist ein Sidecar: Es verändert weder den Quellcode-Checkout noch
promotet es sich selbst stillschweigend.
Passive Orbital- und Paketartefakte können separat inspiziert werden:
~~~bash
ravage satcom inspect orbit.tle --format tle --output orbit-report.json
ravage satcom inspect capture.bin \
--format ccsds-space-packets \
--direction auto \
--output packet-report.json
~~~
SATCOM-Unterstützung ist passives Parsen und Analysieren, kein Funksender oder
Raumfahrzeug-Steuerungssystem.
## Entwicklung
~~~bash
scripts/bootstrap.sh --dev
source .venv/bin/activate
python -m pytest -m "not integration" -q
python -m ruff check --select E9,F .
python scripts/qa/check_docs.py
python scripts/qa/check_release.py
~~~
Docker-gestützte Integrationstests und eingefrorene XBEN-Vergleiche sind separate
Release-Gates. Lies [Benchmarking](https://github.com/duriantaco/ravage/blob/main/docs/benchmarking.md), bevor du Fallergebnisse
interpretierst; eine glückliche Flagge ist kein Beweis für eine zuverlässige Verbesserung.
## Dokumentation
- [So verwendest du Ravage](https://github.com/duriantaco/ravage/blob/main/docs/how-to-use.md)
- [Einrichtung und Fehlerbehebung](https://github.com/duriantaco/ravage/blob/main/docs/setup.md)
- [Authentifizierung](https://github.com/duriantaco/ravage/blob/main/docs/authentication.md)
- [Architektur](https://github.com/duriantaco/ravage/blob/main/docs/architecture.md)
- [Skills](https://github.com/duriantaco/ravage/blob/main/docs/skills.md)
- [Passives SATCOM](https://github.com/duriantaco/ravage/blob/main/docs/satcom.md)
- [Improvement Lab](https://github.com/duriantaco/ravage/blob/main/docs/improvement-lab.md)
- [Benchmarking](https://github.com/duriantaco/ravage/blob/main/docs/benchmarking.md)
- [Sicherheitsrichtlinie](https://github.com/duriantaco/ravage/blob/main/SECURITY.md)
- [Mitwirken](https://github.com/duriantaco/ravage/blob/main/CONTRIBUTING.md)
Verwende <code>ravage --help</code> und <code>ravage COMMAND --help</code> für die
genauen Optionen in deinem Checkout.
## Lizenz
Apache License 2.0. Siehe [LICENSE](https://github.com/duriantaco/ravage/blob/main/LICENSE), [DISCLAIMER](https://github.com/duriantaco/ravage/blob/main/DISCLAIMER.md) und
[SECURITY.md](https://github.com/duriantaco/ravage/blob/main/SECURITY.md).