
Implementazione nativa in Delphi della funzionalità di PE-sieve con una libreria riutilizzabile, CLI e DLL compatibile con PE-sieve per l'integrazione con HollowsHunter.
NativeMirror è un'implementazione indipendente in Object Pascal delle funzionalità di PE-sieve, adattata da PE-sieve di hasherezade. Analizza la memoria dei processi, rileva codice modificato o iniettato ed esegue il dump dei file PE.
L'implementazione utilizza le API native di Delphi e NativePe come motore PE. Può essere usata direttamente come libreria Delphi, tramite la sua CLI oppure tramite un'interfaccia DLL compatibile con PE-sieve. Tutte e tre condividono lo stesso core dello scanner. L'obiettivo di compatibilità è il comportamento osservabile esternamente di PE-sieve 0.4.1.5; l'equivalenza comportamentale completa non è stata stabilita.
I confronti binari utilizzano PE-sieve 0.4.1.1 (pe-sieve64.exe per l'indagine su Delphi; il fixture HollowsHunter utilizza separatamente la DLL 0.4.1.1 inclusa). Il riferimento del codice sorgente di NativeMirror è 0.4.1.5.
Il vecchio codice di rilocazione della 0.4.1.1 interrompe l'elaborazione di un blocco in corrispondenza di una voce di padding, causando falsi rilevamenti di code-patch nei moduli Delphi analizzati. NativeMirror/NativePe saltano già correttamente il padding, allineandosi al riferimento più recente 0.4.1.5 su questo percorso. La correzione upstream si trova nella dipendenza libpeconv di PE-sieve: commit 610a3e8f204341557dc956b7caa203e08df8d874.
Vedi l'analisi della rilocazione per versioni, evidenze e limiti. Ciò stabilisce la differenza di rilocazione, non la parità completa dello scanner o della DLL con la 0.4.1.5; in quella indagine non è stato eseguito uno scanner 0.4.1.5 completo.
../NativePe, oppure modifica i percorsi di ricerca di Delphi.NativeMirrorScan.NativeAsm.dproj abilita USE_NATIVEASM. In sua assenza, NativeMirror utilizza il fallback Delphi/LDE. Modifica il percorso di ricerca di NativeASM in base alla tua installazione.py: richiesto per il passo post-build della DLL e per i test Python. Gli script utilizzano la libreria standard di Python.Alcune configurazioni di progetto contengono percorsi di dipendenze locali. Verifica i percorsi di ricerca prima di compilare su un'altra macchina.
Apri NativeMirror.groupproj in Delphi e seleziona il progetto, la piattaforma e la configurazione richiesti.
| Progetto | Output |
|---|---|
tools/NativeMirrorScan/NativeMirrorScan.dproj | NativeMirrorScan.exe |
tools/NativeMirrorDll/pe-sieve.dproj | pe-sieve.dll |
tests/ScannerIntegration/NativeMirrorTestTarget.dproj | Target di test Win64 |
tests/ScannerIntegration/NativeMirrorTestTarget32.dproj | Target di test Win32 |
tests/ScannerIntegration/NativeMirrorScannerTests.dproj | Test runner dello scanner Win64 |
tests/HollowsHunterIntegration/NativeMirrorHollowsHunterTests.dproj | Test runner HollowsHunter Win64 |
Compila la CLI e la DLL per Win32 e Win64 secondo necessità. Compila entrambi i target di test prima di eseguire i test di integrazione. Compila i test runner per Win64.
Gli output vanno in bin/<Platform>/<Config>. Gli esempi seguenti utilizzano Debug. Le unità del compilatore vanno in dcu/. Mantieni gli eseguibili fuori da tools/.
Esegui questi comandi dalla radice del progetto. Sostituisci 1234 con l'ID del processo da analizzare.
.\bin\Win64\Debug\NativeMirrorScan.exe /help
.\bin\Win64\Debug\NativeMirrorScan.exe /pid 1234
.\bin\Win64\Debug\NativeMirrorScan.exe /pid 1234 /json /quiet /ofilter 2
.\bin\Win64\Debug\NativeMirrorScan.exe /pid 1234 /dir output
/ofilter 2 disabilita l'output del dump. /dir output seleziona la directory di output per i report e i dump. Usa l'eseguibile Win32 in bin/Win32/Debug quando necessario. L'accesso al processo di destinazione dipende dai tuoi permessi di Windows.
Aggiungi src/ e le sue sottodirectory di unit, insieme a NativePe, al percorso di ricerca del tuo progetto. Chiama ScanAndDump con TNativeMirrorOptions. La libreria viene compilata nella tua applicazione; questo utilizzo non richiede né NativeMirrorScan.exe né pe-sieve.dll. Python è necessario solo per la build separata della DLL e per i test Python.
Questo esempio console analizza il PID 1234 e stampa il suo report come JSON:
program ScanExample;
{$APPTYPE CONSOLE}
uses
System.JSON,
NativeMirror.Core.Types,
NativeMirror.Core.Options,
NativeMirror.Core.Engine;
var
Options: TNativeMirrorOptions;
Report: TNativeMirrorReportEx;
Json: TJSONObject;
begin
Options := TNativeMirrorOptions.Default;
Options.Pid := 1234;
Options.Quiet := True;
Options.OutputFilter := nmOutNoDir;
Report := ScanAndDump(Options);
try
Json := Report.ToJson(Options.ResultsFilter, Options.JsonLevel);
try
Writeln(Json.ToJSON);
finally
Json.Free;
end;
finally
Report.Free;
end;
end.
Sostituisci il PID con il tuo target. nmOutNoDir disabilita i file di report e i dump. Ispeziona Report.ErrorReport per gli errori di scansione e Report.ScanReport per i risultati della scansione. Il chiamante è proprietario del report restituito e deve liberarlo.
Scarica pe-sieve32.exe e pe-sieve64.exe dalle release di PE-sieve. Gli script di confronto esistenti utilizzano gli eseguibili v0.4.1.1. Colloca entrambi in bin/Win64/Debug; gli script di test Win64 cercano lì il loro scanner di riferimento. L'eseguibile 32 è il riferimento Win32 originale, anche se è memorizzato insieme agli strumenti di test Win64.
Una configurazione Debug si presenta così:
bin/
Win64/Debug/
NativeMirrorScan.exe
pe-sieve.dll
pe-sieve.dll.exports.json
pe-sieve32.exe
pe-sieve64.exe
NativeMirrorTestTarget.exe
NativeMirrorScannerTests.exe
NativeMirrorHollowsHunterTests.exe
hollows_hunter.exe
Win32/Debug/
NativeMirrorScan.exe
pe-sieve.dll
pe-sieve.dll.exports.json
NativeMirrorTestTarget32.exe
NativeMirror produce la CLI, la DLL, i record di export, i target e i test runner. Gli eseguibili PE-sieve e HollowsHunter sono download separati. HollowsHunter è necessario solo per il suo test di integrazione o per l'uso manuale della DLL.
Scarica hollows_hunter64_dll.zip, v0.4.1.1 dalle release di HollowsHunter. Usa il pacchetto DLL. Con un'architettura host e un contratto API corrispondenti, la pe-sieve.dll finalizzata di NativeMirror sostituisce la DLL PE-sieve originale usata da HollowsHunter. L'eseguibile statico standalone non può utilizzare una DLL sostitutiva. Il test di integrazione fornito copre l'host DLL Win64 v0.4.1.1.