Compatibilità di Burp Suite e segnalazione errori

Questa estensione è rivolta alla versione più recente di Burp Suite. È stata testata l'ultima volta con la versione pro 2026.4.3, la release stabile più recente al momento della stesura di questa documentazione. È compatibile anche con la community edition. La versione minima supportata è Burp Suite 2024.2, poiché è la prima release che richiede Java 21.

Tutte le modifiche vengono rilasciate dal branch main. Consulta CHANGES.md per lo storico delle modifiche di ogni release.

Utilizziamo attivamente questa estensione e occasionalmente osserviamo potenziali errori, soprattutto quando Burp Suite aggiorna le sue funzionalità principali o la sua interfaccia. Essendo un progetto open-source, facciamo molto affidamento sul feedback della community per miglioramenti e correzioni di bug. Se incontri problemi, ti preghiamo di segnalarli nella nostra pagina delle issue. Inoltre, se apprezzi il nostro lavoro, considera la possibilità di sostenere questo progetto.

Utilizzo dell'estensione legacy

Nella versione più recente di questa estensione, come indicato sopra, è supportata solo la versione più recente di Burp Suite. Per versioni precedenti di Burp Suite, puoi usare la versione legacy dell'estensione o fare riferimento al repository originale. Le versioni precedenti di questa estensione possono essere scaricate dal branch legacy (senza supporto):

• Release del branch Legacy-Extension
• Release del repository originale

Informazioni su questo repository

Continuazione del progetto Burp Suite Sharpener, originariamente rilasciato come open source da MDSec su mdsecresearch/BurpSuiteSharpener.

Suggerire nuove funzionalità

Il piano è aggiungere funzionalità mancanti semplici ma efficaci a questa singola estensione per rendere la vita del tester più facile, come un compagno indispensabile quando si usa Burp Suite (non possiamo Burp senza di essa!).

Sentiti libero di inviare le tue richieste di nuove funzionalità usando FR: nel titolo nelle issue.

Sarebbe utile elencare anche eventuali estensioni disponibili note che potrebbero aver già implementato le funzionalità suggerite. Forse le funzionalità migliori possono essere importate da diverse estensioni open-source, così da ridurre l'onere di aggiungere estensioni diverse.

Scorciatoie da tastiera

Tutte le scorciatoie di Sharpener possono essere visualizzate e modificate all'interno di Burp: usa il menu in alto Sharpener > Keyboard Shortcuts, oppure la voce Keyboard Shortcuts in fondo al menu contestuale di una scheda Repeater/Intruder. Le modifiche vengono validate (i tasti rapidi predefiniti di Burp, come Ctrl+R, non possono essere occupati) e applicate immediatamente.

Ogni azione configurabile ha UNA scorciatoia. Nella finestra di dialogo la imposti facendo clic sulla cella e premendo la combinazione di tasti (senza digitare). Una scorciatoia funziona ovunque in Burp, anche mentre si digita nell'editor, quindi richiede Ctrl, Alt o un tasto funzione. Se premi un tasto già in uso, la finestra di dialogo offre di spostarlo.

Scorciatoie configurabili per le schede di Repeater e Intruder (predefinite):

Tasti fissi dell'intestazione delle schede (sempre attivi quando un titolo di scheda ha il focus, non modificabili):

Questi tasti semplici agiscono solo quando un'intestazione di scheda ha il focus, quindi non disturbano mai l'editor. Fai clic su un titolo di scheda (o usa un salto tramite scorciatoia) per mettere a fuoco l'intestazione, poi usa le frecce per spostarti tra le schede e Down per scendere nell'editor delle richieste per modificarlo. Usa Alt+Up (o fai clic) per tornare alla scheda. Dopo un salto da tastiera iniziato dall'intestazione, il focus rimane sull'intestazione, quindi premendo più volte una freccia continui a navigare.

Note:

• Ctrl+C e Ctrl+V non sono assegnati per impostazione predefinita, quindi un incolla non può mai rinominare una scheda per errore. Per copiare e incollare i titoli si usano Ctrl+Shift+C e Ctrl+Shift+V, e un titolo incollato può essere ripristinato dal menu della scheda, sotto Previous Titles.

Scorciatoia predefinita per la finestra principale di Burp:

Azioni fisse del mouse sulle schede di Repeater e Intruder (non configurabili):

Suggerimenti per l'uso

• Dopo aver impostato uno stile su una sotto-scheda, impostare lo stesso titolo su un'altra sotto-scheda ne copierà lo stile
• Alt + qualsiasi clic del mouse funziona sulle parti vuote delle schede che non contengono testo
• Usa l'opzione Debug in Global Settings se segnali un bug o se vuoi vedere cosa sta succedendo
• Controlla il repository GitHub dell'estensione invece del BApp Store per gli ultimi aggiornamenti
• Icone di esempio sono disponibili nelle directory burpicon-sample/ e hacker-sample-icons/

Contributi

Le pull request sono benvenute. Alcune regole mantengono funzionante la pipeline di rilascio automatica:

• Tutte le modifiche passano attraverso pull request verso il branch main (i push diretti sono bloccati).
• Compila con ./gradlew jar (richiede JDK 21). La suite di test deve passare: ./gradlew build la esegue in modalità headless.
• Il comportamento nuovo o modificato deve essere coperto da casi di test in src/test/java. L'estensione non può essere eseguita al di fuori di Burp Suite, quindi i test usano interfacce Montoya mockate e componenti Swing semplici.
• Le release vengono create automaticamente quando viene unita una pull request che incrementa la versione. Per creare una release:
  • Incrementa version in src/main/resources/extension.properties. Deve rimanere parsabile come numero (ad esempio 4.7), perché il controllo degli aggiornamenti lo confronta numericamente.
  • Aggiungi una sezione corrispondente in cima a CHANGES.md con il formato esatto di intestazione ## Version X.Y (YYYY-MM-DD). La CI copia quella sezione nelle note di rilascio di GitHub.

Ringraziamenti

• Corey Arthur CoreyD97 per Burp-Montoya-Utilities. Una piccola parte di esso (le classi delle preferenze) è ora mantenuta all'interno di questo repository sotto libs/thirdparty/; il resto della libreria non è più incluso. Consulta il file NOTICE.
• Bruno Demarche (per l'ispirazione iniziale per l'hacking di Swing)

Non esitare a segnalare bug, suggerire funzionalità o inviare pull request.

Licenza

Copyright (C) 2021-2026 Soroush Dalili (@irsdl).

Rilasciata sotto la GNU Affero General Public License v3.0 con termini aggiuntivi ai sensi della sezione 7 della licenza: le copie e le versioni modificate devono mantenere gli avvisi di copyright e l'attribuzione "Developed by Soroush Dalili (@irsdl)". Consulta i file LICENSE e NOTICE.