
Implementación nativa en Delphi de la funcionalidad de PE-sieve con una biblioteca reutilizable, CLI y DLL compatible con PE-sieve para la integración con HollowsHunter.
NativeMirror es una implementación independiente en Object Pascal de la funcionalidad de PE-sieve, adaptada de PE-sieve de hasherezade. Escanea la memoria de procesos, detecta código modificado o inyectado y vuelca archivos PE.
La implementación utiliza APIs nativas de Delphi y NativePe como su motor PE. Puede usarse directamente como biblioteca Delphi, a través de su CLI o mediante una interfaz DLL compatible con PE-sieve. Las tres comparten el mismo núcleo del escáner. El objetivo de compatibilidad es el comportamiento observable externamente de PE-sieve 0.4.1.5; no se ha establecido una equivalencia de comportamiento completa.
Las comparaciones de binarios utilizan PE-sieve 0.4.1.1 (pe-sieve64.exe para la investigación de Delphi; el fixture de HollowsHunter utiliza por separado la DLL 0.4.1.1 incluida). La referencia de código fuente de NativeMirror es 0.4.1.5.
El antiguo código de reubicación de 0.4.1.1 detiene el procesamiento de un bloque en una entrada de relleno, lo que provoca hallazgos falsos de parches de código en los módulos Delphi investigados. NativeMirror/NativePe ya omiten el relleno correctamente, coincidiendo con la referencia más reciente 0.4.1.5 en esta ruta. La corrección upstream está en la dependencia libpeconv de PE-sieve: commit 610a3e8f204341557dc956b7caa203e08df8d874.
Consulte el análisis de reubicación para versiones, evidencia y limitaciones. Esto establece la diferencia de reubicación, no la paridad completa del escáner o de la DLL con 0.4.1.5; en esa investigación no se ejecutó un escáner completo de 0.4.1.5.
../NativePe, o ajuste las rutas de búsqueda de Delphi.NativeMirrorScan.NativeAsm.dproj habilita USE_NATIVEASM. Sin él, NativeMirror utiliza el fallback de Delphi/LDE. Ajuste la ruta de búsqueda de NativeASM a su instalación.py de Windows: requerido para el paso posterior a la compilación de la DLL y las pruebas de Python. Los scripts utilizan la biblioteca estándar de Python.Algunas configuraciones de proyecto contienen rutas de dependencias locales. Verifique las rutas de búsqueda antes de compilar en otra máquina.
Abra NativeMirror.groupproj en Delphi y seleccione el proyecto, la plataforma y la configuración requeridos.
| Proyecto | Salida |
|---|---|
tools/NativeMirrorScan/NativeMirrorScan.dproj | NativeMirrorScan.exe |
tools/NativeMirrorDll/pe-sieve.dproj | pe-sieve.dll |
tests/ScannerIntegration/NativeMirrorTestTarget.dproj | Objetivo de prueba Win64 |
tests/ScannerIntegration/NativeMirrorTestTarget32.dproj | Objetivo de prueba Win32 |
tests/ScannerIntegration/NativeMirrorScannerTests.dproj | Ejecutor de pruebas del escáner Win64 |
tests/HollowsHunterIntegration/NativeMirrorHollowsHunterTests.dproj | Ejecutor de pruebas de HollowsHunter Win64 |
Compile la CLI y la DLL para Win32 y Win64 según sea necesario. Compile ambos objetivos de prueba antes de ejecutar las pruebas de integración. Compile los ejecutores de pruebas para Win64.
Las salidas van a bin/<Platform>/<Config>. Los ejemplos a continuación utilizan Debug. Las unidades del compilador van a dcu/. Mantenga los ejecutables fuera de tools/.
Ejecute estos comandos desde la raíz del proyecto. Reemplace 1234 con el ID del proceso a escanear.
.\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 desactiva la salida de volcado. /dir output selecciona el directorio de salida para informes y volcados. Utilice el ejecutable Win32 en bin/Win32/Debug cuando sea necesario. El acceso al proceso objetivo depende de sus permisos de Windows.
Añada src/ y sus subdirectorios de unidades, junto con NativePe, a la ruta de búsqueda de su proyecto. Llame a ScanAndDump con TNativeMirrorOptions. La biblioteca se compila en su aplicación; este uso no requiere ni NativeMirrorScan.exe ni pe-sieve.dll. Python solo es necesario para la compilación separada de la DLL y las pruebas de Python.
Este ejemplo de consola escanea el PID 1234 e imprime su informe como 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.
Sustituya el PID por su objetivo. nmOutNoDir desactiva los archivos de informe y los volcados. Inspeccione Report.ErrorReport para los errores de escaneo y Report.ScanReport para los resultados del escaneo. El llamador es propietario del informe devuelto y debe liberarlo.
Descargue pe-sieve32.exe y pe-sieve64.exe desde las versiones de PE-sieve. Los scripts de comparación existentes utilizan los ejecutables de la v0.4.1.1. Coloque ambos en bin/Win64/Debug; los scripts de prueba de Win64 buscan allí su escáner de referencia. El ejecutable 32 es la referencia original de Win32, aunque se almacena junto a las herramientas de prueba de Win64.
Una configuración de Debug tiene este aspecto:
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, los registros de exportación, los targets y los ejecutores de pruebas. Los ejecutables de PE-sieve y HollowsHunter son descargas separadas. HollowsHunter solo es necesario para su prueba de integración o para el uso manual de la DLL.
Descarga hollows_hunter64_dll.zip, v0.4.1.1 desde las versiones de HollowsHunter. Usa el paquete de la DLL. Con una arquitectura de host y un contrato de API coincidentes, el pe-sieve.dll finalizado de NativeMirror reemplaza la DLL original de PE-sieve utilizada por HollowsHunter. El ejecutable estático independiente no puede usar una DLL de reemplazo. La prueba de integración incluida cubre el host de la DLL Win64 v0.4.1.1.