Che cosa fa Ghidra Script Manager
Script Manager è l’area integrata di Ghidra per cercare e avviare gli script. È utile quando la stessa ispezione o pulizia ricorre in più progetti: elencare funzioni, rinominare simboli in modo coerente, esportare dati selezionati, aggiungere commenti o raccogliere prove per un report. Il risultato resta una normale azione di analisi Ghidra e va verificato in CodeBrowser, Listing o Decompiler.
Uno script non sostituisce la comprensione del binario. Trattalo come un piccolo esperimento verificabile: definisci il progetto, fai la modifica minima, conserva una copia se l’operazione scrive e annota che cosa è cambiato. Il tutorial Ghidra per principianti copre l’analisi statica; questa pagina si concentra sull’automazione dentro quel flusso.
Analizza solo file e sistemi che sei autorizzato a esaminare. Script Manager può modificare rapidamente un progetto: prova prima su una copia.
- Trovare gli script inclusi in Ghidra o salvati nelle directory degli script.
- Aprire uno script, controllare linguaggio e import ed eseguirlo sul programma attivo.
- Usare modello del programma e console per una modifica piccola e ripetibile.
- Separare l’automazione di Script Manager dall’automazione CPython nativa con PyGhidra.
Aprire Script Manager e trovare uno script
Apri un progetto e avvia Script Manager dai menu degli strumenti di Ghidra. La posizione esatta può cambiare leggermente in base allo strumento e alla release, ma l’area offre un elenco di script, filtri o ricerca, un editor e comandi per eseguire o aggiornare l’elenco. Se uno script appena copiato non compare, aggiorna prima la lista.
Inizia con uno script di sola lettura o di report. Leggi commenti iniziali e import prima di premere Run. L’intestazione dovrebbe indicare se servono un programma aperto, una selezione, la funzione corrente o un processore specifico.
- 1
Aprire un progetto di pratica
Crea un progetto non condiviso e importa un binario che puoi analizzare. Conserva invariati file originale e copia del progetto.
File > New Project > Non-Shared Project - 2
Avviare Script Manager
Apri l’area di scripting dai menu degli strumenti e restringi l’elenco con filtro o ricerca.
Window > Script Manager - 3
Controllare prima dell’esecuzione
Verifica linguaggio, contesto richiesto, import, destinazione dell’output ed eventuali modifiche a simboli, commenti, tipi o memoria.
Leggere intestazione e import - 4
Eseguire e verificare
Esegui una volta su un obiettivo piccolo, leggi la console e controlla lo stato in Listing o Decompiler.
Run > Run Script
Scrivere un primo script piccolo e con un limite chiaro
Il primo script dovrebbe rispondere a una sola domanda: contare funzioni, stampare nomi con un prefisso, elencare stringhe definite o riportare la selezione corrente. Non combinare analisi, rinomina, esportazione e pulizia al primo tentativo. Uno script ristretto è più facile da controllare e rilanciare.
Usa il modello di programma esposto da Ghidra agli script invece di leggere la UI visibile. Chiedi al programma funzioni, simboli, riferimenti, istruzioni o blocchi di memoria e invia un risultato breve alla console. Consulta la referenza dell’API GhidraScript per i metodi attuali; un esempio vecchio di un forum potrebbe non essere compatibile.
Quando lo script modifica il programma, rendi il cambiamento evidente nell’output. Stampa i conteggi prima e dopo, l’indirizzo o il nome del simbolo e fermati davanti a uno stato imprevisto. In questo modo anche un’esecuzione ripetuta resta verificabile.
leggere contesto -> ispezionare un oggetto -> stampare risultato -> non modificare -> ripeteretarget: practice.bin | ambito: programma corrente | scritture: nessuna | risultato: 12 funzioni
Java, Python e il confine di Ghidra 12.1.3
Le ricerche mescolano scripting Ghidra, script Ghidra e Python per Ghidra, ma non descrivono sempre lo stesso runtime. Script Manager è il punto di ingresso nell’applicazione. Gli script Java sono la scelta più chiara per automazioni riutilizzabili con le API Java di Ghidra. Python dipende da come è stato avviato il processo Ghidra e dall’integrazione installata.
Per l’automazione CPython nativa fuori dalla finestra integrata, usa la guida all’installazione di PyGhidra. PyGhidra collega un processo CPython esterno all’API di Ghidra, mentre uno script di Script Manager gira nel contesto dell’applicazione.
Identifica prima dove gira lo script: Script Manager integrato, processo Ghidra avviato con PyGhidra oppure processo CPython esterno. Poi scegli documentazione e diagnosi adatte.
| Esigenza | Usa prima | Perché |
|---|---|---|
| Una piccola azione in un progetto aperto | Script Manager | Feedback rapido e contesto visibile |
| Automazione Java riutilizzabile | Script Java | Segue il modello API nativo |
| Flusso CPython nativo | PyGhidra | Pensato per un processo Python esterno |
| Batch grande e ripetibile | Script con log | Ingressi, uscite ed errori restano verificabili |
Modelli utili di Script Manager nei progetti reali
Uno script utile ha spesso quattro parti: stabilire il contesto, selezionare pochi oggetti, eseguire un’operazione e spiegare il risultato. Il contesto può essere programma, posizione, selezione o funzione corrente. La selezione deve essere esplicita: filtro per nome, intervallo di indirizzi, blocco di memoria, proprietà della funzione o riferimenti.
Struttura l’output in modo da confrontare due esecuzioni. Un riepilogo di una riga aiuta, ma una riga per elemento con indirizzo o nome simbolo facilita il debug. Per script lenti, prova prima una funzione o un blocco e stampa un indicatore di avanzamento.
- Leggere programma e posizione correnti prima di chiedere lo stato globale.
- Preferire iterazioni o selezioni limitate a scansioni senza limite.
- Verificare indirizzi, simboli e tipi nel Listing come prove.
- Separare la scoperta in sola lettura dalle operazioni di scrittura.
- Salvare una copia prima di rinominare, cambiare tipi o aggiungere commenti in massa.
contesto -> selezione -> operazione -> prova -> piano di ripristinoRisolvere i problemi comuni dello scripting Ghidra
Quando uno script fallisce, cattura prima il messaggio esatto e il contesto del runtime. Annota versione di Ghidra, sistema operativo, linguaggio, programma aperto, selezione e modalità di avvio del processo. Questa nota evita di applicare una correzione PyGhidra a un problema di Script Manager.
Controlla anche il caso minimo che riproduce l’errore. Un problema legato a un processore, a una funzione danneggiata o a una selezione vuota richiede spesso un controllo dei limiti, non una riscrittura completa.
Salva testo completo, file o copia minima riproducibile e versione dello script. Non pubblicare binari sconosciuti o dati sensibili dell’analisi in un issue pubblico.
| Sintomo | Controllare prima | Azione successiva sicura |
|---|---|---|
| Lo script non appare | Aggiornamento, percorso, estensione e directory | Ricaricare l’elenco e aprire direttamente il file se possibile |
| Python non disponibile | Avvio di Ghidra e configurazione PyGhidra | Usare Java o seguire il flusso PyGhidra |
| Manca programma o selezione | Strumento, progetto, programma e selezione attivi | Aprire il programma e provare una sola funzione |
| L’output sembra errato | Architettura, indirizzi, Listing e tipi | Verificare l’ipotesi in CodeBrowser prima di cambiare script |
Una routine di scripting sicura e ripetibile
Per un’attività una tantum basta una routine breve. Per un team o un’indagine ripetuta, registra input, risultato atteso, revisione dello script, versione di Ghidra e modifiche al progetto. La guida al Decompiler aiuta a verificare il risultato; la guida all’installazione separa applicazione, JDK, progetti e copie.
Inizia con output in sola lettura, confrontalo con Listing e abilita le modifiche solo dopo. Conserva conteggi prima/dopo e un piano di ripristino o una copia. Se lo script diventa un sistema con input esterni e dipendenza CPython, valuta PyGhidra o un harness dedicato.
- 1
Preparare
Blocca la versione di Ghidra, apri una copia del progetto e definisci l’ambito.
versione + input + ambito - 2
Osservare
Esegui uno script di sola lettura e conserva un piccolo campione con indirizzi.
prima solo lettura - 3
Cambiare
Fai una modifica controllata, stampa il conteggio e verifica il risultato nelle viste di analisi.
una operazione + prova - 4
Conservare
Salva script, note, output e copia del progetto per confrontare o annullare l’esecuzione.
script + log + copia
Domande su Ghidra Script Manager
Che cos’è Ghidra Script Manager?
È l’area integrata di Ghidra per scoprire, modificare ed eseguire script sul progetto o programma attivo. È adatta a piccole automazioni verificabili e non è un processo CPython esterno.
Posso usare Python in Script Manager?
La disponibilità di Python dipende dal runtime e dall’avvio di Ghidra. Se Python non è disponibile, usa Java per l’automazione interna o la guida PyGhidra per un flusso CPython.
Lo scripting Ghidra è uguale a PyGhidra?
No. Script Manager gira dentro Ghidra, mentre PyGhidra collega un processo CPython nativo all’API Ghidra. Installazione e diagnosi sono diverse.
Perché il mio script non compare nell’elenco?
Aggiorna l’elenco e controlla estensione, directory degli script e filtri. Verifica anche che intestazione e import siano compatibili con la versione attuale.
Il primo script dovrebbe modificare un progetto?
È meglio iniziare con un report di sola lettura. Dopo aver verificato l’output in Listing o Decompiler, prova una modifica controllata su una copia con conteggio e piano di ripristino.