Test di sicurezza web autonomo basato sull'evidenza per target controllati e autorizzati. Con laboratori riproducibili, tracce di audit, report e benchmarking XBEN.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7171/c6015851ea85c8a14cf1ecf4737ff05aaafe1413ed484c69d433e3700aa1c1b8.png" alt="Logo Ravage" width="360">
</p>
# Ravage
Ravage è una CLI evidence-first per valutare un'applicazione web in esecuzione
di cui sei proprietario o che sei esplicitamente autorizzato a testare. Combina
ricognizione deterministica e validazione con un ciclo di attacco opzionale guidato da modelli, mantenendo
scope, autenticazione, contabilità del traffico ed evidenze entro confini definiti dal codice.
Ravage è un'alpha di ricerca pre-1.0. Usa ambienti usa e getta e regole di
ingaggio scritte. I test di sicurezza possono modificare lo stato dell'applicazione; Ravage
non corregge i risultati né implementa fix.
[Avvio rapido](#avvio-rapido-locale-in-cinque-minuti) ·
[Autenticazione](#test-autenticati) ·
[Risultati](#comprendere-i-risultati) ·
[Funzionalità](#funzionalità) ·
[Documentazione](#documentazione)
## Requisiti
- Python 3.12
- Git
- macOS, Linux o WSL
- Docker solo per strumenti containerizzati, XBEN e test di integrazione
- Una chiave API del provider solo per i comandi guidati da modelli
La prima scansione normale non richiede chiave del modello, browser, daemon Docker o
scanner esterno.
## Installazione dal sorgente
~~~bash
git clone https://github.com/duriantaco/ravage.git
cd ravage
scripts/bootstrap.sh
source .venv/bin/activate
ravage doctor
~~~
Il bootstrap crea <code>.venv</code> e installa il workspace. Usa
<code>scripts/bootstrap.sh --dev</code> per le dipendenze di sviluppo,
<code>--browser</code> per il supporto browser, oppure
<code>--install-browser</code> per installare anche Chromium.
## Avvio rapido locale in cinque minuti
Avvia prima la tua applicazione. Questo esempio presuppone che sia in ascolto su
<code>http://127.0.0.1:3000</code>.
1. Crea un brief di ingaggio con scope definito e un file di ambiente privato:
~~~bash
ravage init http://127.0.0.1:3000 \
--brief ravage-brief.yaml \
--env-file .env.ravage \
--description "Valutazione autorizzata della mia app di sviluppo locale."
~~~
2. Rivedi <code>ravage-brief.yaml</code>. Controlla il target, le route in scope,
le esclusioni, il budget di richieste, il rate limit, gli obiettivi e i criteri di successo.
3. Esegui una scansione superficiale senza modello:
~~~bash
ravage doctor --workflow scan --brief ravage-brief.yaml
ravage scan ravage-brief.yaml --probe surface_map --report
~~~
Il comando stampa la directory di esecuzione. Copia quel percorso e usalo come
<code>RUN_DIR</code> nei comandi di ispezione qui sotto.
## Esegui l'agente guidato da modelli
Aggiungi una chiave di un provider supportato, ad esempio <code>OPENAI_API_KEY</code>, a
<code>.env.ravage</code>. Ravage legge questo file direttamente; non eseguirne il source nella shell.
~~~bash
ravage doctor --workflow attack --brief ravage-brief.yaml
ravage attack ravage-brief.yaml --allow-paid-models --report
~~~
<code>--allow-paid-models</code> è una conferma esplicita che l'esecuzione
può comportare costi del provider. La selezione dei modelli, i provider locali e i profili
riproducibili sono documentati in [Provider di modelli](https://github.com/duriantaco/ravage/blob/main/docs/model-providers.md).
## Test autenticati
Aggiungi un'identità di test dedicata al brief:
~~~bash
ravage auth add ravage-brief.yaml \
--identity user \
--type form \
--login /login \
--health /account \
--marker Logout \
--env-file .env.ravage
~~~
Compila i riferimenti ai segreti generati, verifica la sessione, poi attacca con
l'identità selezionata:
~~~bash
ravage auth check ravage-brief.yaml --identity user
ravage attack ravage-brief.yaml \
--identity user \
--allow-paid-models \
--report
~~~
Sono supportati il login tramite form, i bearer token e gli header statici fissi. Le credenziali
gestite restano all'interno del proprietario HTTP autenticato; i canali di processo, Python e
comando vengono bloccati quando viene selezionata un'identità. Vedi
[Autenticazione](https://github.com/duriantaco/ravage/blob/main/docs/authentication.md) per configurazione e limitazioni.
## Target remoti autorizzati
L'esecuzione remota è fail-closed e richiede un flag esplicito. Inizia con una
scansione superficiale a basso impatto:
~~~bash
ravage init https://staging.example.test \
--brief ravage-brief.yaml \
--env-file .env.ravage \
--description "Valutazione autorizzata della mia applicazione di staging."
ravage doctor --workflow scan \
--brief ravage-brief.yaml \
--authorized-remote-target
ravage scan ravage-brief.yaml \
--probe surface_map \
--authorized-remote-target \
--report
~~~
Per un'esecuzione remota guidata da modelli:
~~~bash
ravage attack ravage-brief.yaml \
--authorized-remote-target \
--allow-paid-models \
--report
~~~
Gli attacchi remoti autorizzati usano per impostazione predefinita la policy a basso rumore per l'intera esecuzione: solo
HTTP metered nativo, pacing sub-1-RPS, un tetto fisico alle richieste, caching e deduplicazione
conservativi di GET/HEAD, backoff adattivo, retry limitati e
circuit breaking. Il registro durevole sopravvive alla ripresa. I dettagli sono in
[Architettura](https://github.com/duriantaco/ravage/blob/main/docs/architecture.md).
## Comprendere i risultati
Ravage distingue osservazioni, risultati candidati e vulnerabilità
confermate. Un flag CTF è una possibile prova, non un requisito. Su
un'applicazione ordinaria, un'esecuzione può essere utile e riuscita senza trovare alcun
flag; le vulnerabilità confermate vengono comunque scritte nel report.
Una volta avviata un'esecuzione di attacco, il suo artefatto canonico privato leggibile dalla macchina è
<code>RUN_DIR/report.json</code>, incluse le esecuzioni incomplete.
<code>--report</code> scrive anche <code>RUN_DIR/report.md</code>.
~~~bash
ravage observe RUN_DIR
ravage audit verify RUN_DIR
ravage report RUN_DIR --brief ravage-brief.yaml
~~~
Per l'HTTP strutturato catturato dal grafo dell'agente:
~~~bash
ravage traffic list RUN_DIR
ravage traffic show RUN_DIR REQUEST_ID
~~~
Il report include riferimenti alle evidenze, qualità della contabilità delle richieste, stato di
completamento e il motivo per cui un'esecuzione incompleta si è fermata. Non trattare mai un'asserzione
del modello non validata come un risultato confermato.
## Funzionalità
| Funzionalità | Punto di ingresso | Note |
| --- | --- | --- |
| Ricognizione e probe deterministici | <code>ravage scan</code> | Nessun modello richiesto |
| Valutazione guidata da modelli | <code>ravage attack</code> | Vincolata da evidenze e scope |
| Autenticazione gestita | <code>ravage auth</code> | Form, bearer, header statico |
| Ispezione e replay del traffico | <code>ravage traffic</code> | Artefatti con scope |
| Skill di conoscenza | <code>ravage skills</code>, <code>ravage code-bug</code> | Consultive |
| Ispezione SATCOM passiva | <code>ravage satcom inspect</code> | Nessuna trasmissione |
| Valutazione XBEN | <code>ravage xben</code> | Harness di ricerca basato su Docker |
| Improvement Lab | <code>scripts/improvement_lab.py</code> | Archivio isolato |
Le skill di conoscenza possono guidare la prioritizzazione, ma non possono aggiungere strumenti, espandere lo scope
o confermare risultati. Inizia con:
~~~bash
ravage skills list builtin
ravage skills validate builtin
~~~
L'[Improvement Lab](https://github.com/duriantaco/ravage/blob/main/docs/improvement-lab.md) acquisisce la struttura di esecuzioni precedenti
sanitizzata, valuta patch candidate in workspace indipendenti, archivia le versioni
accettate e rifiutate e richiede evidenze di non-regressione corrispondenti prima della promozione.
È un sidecar: non muta il checkout del sorgente né
si promuove silenziosamente.
Gli artefatti orbitali e di pacchetto passivi possono essere ispezionati separatamente:
~~~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
~~~
Il supporto SATCOM è parsing e analisi passivi, non un trasmettitore radio o un
sistema di controllo di veicoli spaziali.
## Sviluppo
~~~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
~~~
I test di integrazione basati su Docker e i confronti XBEN congelati sono
gate di rilascio separati. Leggi [Benchmarking](https://github.com/duriantaco/ravage/blob/main/docs/benchmarking.md) prima di interpretare i
risultati dei casi; un flag fortunato non è evidenza di un miglioramento affidabile.
## Documentazione
- [Come usare Ravage](https://github.com/duriantaco/ravage/blob/main/docs/how-to-use.md)
- [Configurazione e risoluzione dei problemi](https://github.com/duriantaco/ravage/blob/main/docs/setup.md)
- [Autenticazione](https://github.com/duriantaco/ravage/blob/main/docs/authentication.md)
- [Architettura](https://github.com/duriantaco/ravage/blob/main/docs/architecture.md)
- [Skill](https://github.com/duriantaco/ravage/blob/main/docs/skills.md)
- [SATCOM passivo](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)
- [Policy di sicurezza](https://github.com/duriantaco/ravage/blob/main/SECURITY.md)
- [Contribuire](https://github.com/duriantaco/ravage/blob/main/CONTRIBUTING.md)
Usa <code>ravage --help</code> e <code>ravage COMMAND --help</code> per le
opzioni esatte nel tuo checkout.
## Licenza
Apache License 2.0. Vedi [LICENSE](https://github.com/duriantaco/ravage/blob/main/LICENSE), [DISCLAIMER](https://github.com/duriantaco/ravage/blob/main/DISCLAIMER.md) e
[SECURITY.md](https://github.com/duriantaco/ravage/blob/main/SECURITY.md).