Servidores puente TCP JSON para IDA Pro y Ghidra que exponen descompilación, referencias cruzadas, símbolos, vtables, RTTI y parcheo de memoria a scripts externos y pipelines automatizados.
Servidores puente TCP JSON ligeros para IDA Pro y Ghidra que exponen flujos de trabajo de ingeniería inversa a través de un protocolo de socket simple.
Permite que herramientas externas, scripts de CLI, utilidades de Python y pipelines automatizados consulten descompilación, referencias cruzadas, símbolos, tablas virtuales, RTTI, estructuras y memoria de parcheo sin interacción manual con la GUI.
Cuando se trabaja en proyectos grandes de ingeniería inversa con varios binarios abiertos al mismo tiempo (por ejemplo, cliente de juego, lanzador, proxies DLL y stubs simultáneamente):
BASE_PORT = 5073 y sondea automáticamente puertos secuenciales (5073, 5074, 5075, 5076...) hasta encontrar uno disponible.En IDA Pro, el intérprete de Python permanece activo a través de múltiples ejecuciones de scripts:
ID_Server.py registra el manejador del servidor en ejecución en builtins._ida_bridge_prev.stop() en la instancia anterior y une su hilo (join(3.0)), liberando limpiamente el puerto antes de iniciar el nuevo servidor.Address already in use ni hilos huérfanos por volver a ejecutar el script.QUIT, STOP, EXIT o SHUTDOWN a través de la conexión. El servidor confirma con {"ok": true, "shutdown": true} y se cierra inmediatamente.ida_bridge_stop() directamente desde la CLI de Python de IDA, o simplemente cierra IDA (los hilos daemon salen automáticamente).is_cancelled() se comprueba cada 1s mediante el timeout del socket), o envía QUIT..idb / .i64) en IDA Pro.File -> Script file... / Alt+F7), ejecuta:
import ID_Server
127.0.0.1:5073 (o en el siguiente puerto disponible).ida_bridge_stop()
Window -> Script Manager), añade la carpeta que contiene Ghidra_Server.py o ejecútalo directamente en el intérprete de Python.127.0.0.1:5073 (o al siguiente puerto libre).Los comandos son cadenas de texto plano delimitadas por saltos de línea enviadas por TCP (127.0.0.1:<PORT>). El servidor responde con un objeto JSON (o texto delimitado por tabulaciones para los comandos heredados).
| Comando | Sintaxis | Descripción |
|---|---|---|
PING | PING | Comprobación de estado. Devuelve "pong". |
CURRENT | CURRENT | Devuelve la dirección actual del cursor, el nombre de la función, el tamaño, las instrucciones de ensamblador y el código descompilado. |
NAME | NAME <ea> | Devuelve el nombre del símbolo/función definido en <ea>. |
FUNC | FUNC <addr> | Devuelve los metadatos completos de la función, el punto de entrada, el tamaño, la firma, el ensamblador y la descompilación de Hex-Rays/Ghidra. |
DECOMP | DECOMP <addr> | Alias de FUNC. Descompila la función objetivo. |
DISASM | DISASM <ea> [n] | Devuelve las líneas de desensamblado de [n] instrucciones a partir de <ea> (por defecto: 40). |
FIND | FIND <substr> | Búsqueda sin distinción de mayúsculas y minúsculas en todos los símbolos y nombres de funciones que coincidan con <substr> (hasta 300 coincidencias). |
EXPORT | EXPORT [filename] | Exporta todos los símbolos no ficticios, nombres mangled y demangled a un archivo de texto (por defecto: ida_names.txt). |
HELP | HELP | Devuelve una lista JSON de todos los comandos disponibles que admite el servidor. |
QUIT | QUIT | Cierra correctamente la conexión del cliente y detiene el socket del servidor puente. |
| Comando | Sintaxis | Descripción |
|---|---|---|
XREF | XREF <addr> | Enumera todas las referencias cruzadas entrantes (llamadas de código, lecturas/escrituras de datos) dirigidas a <addr>. |
XFROM | XFROM <addr> | Enumera todas las referencias cruzadas salientes que se originan en <addr>. |
CALLERS | CALLERS <addr> | Filtra las referencias entrantes para devolver solo los puntos de llamada (incluidas las llamadas indirectas resueltas). |
READERS | READERS <addr> | Filtra las referencias entrantes para devolver solo las instrucciones que leen de <addr>. |
WRITERS | WRITERS <addr> | Filtra las referencias entrantes para devolver solo las instrucciones que escriben en <addr>. |
DECOMP_XREF | DECOMP_XREF <addr> | Descompila por lotes cada función llamante de <addr> en una sola solicitud. |
IMPORTXREF | IMPORTXREF <name> | Localiza todos los puntos de llamada en todo el binario para una API importada de Windows/C (p. ej., IMPORTXREF WSASendTo). |
TRACE | TRACE <addr> | Rastrea el flujo de ejecución y los bloques básicos que rodean a <addr>. |
| Comando | Sintaxis | Descripción |
|---|---|---|
READPTR | READPTR <addr> [count] | Lee la memoria como cadenas de punteros (32 o 64 bits) y clasifica cada destino (func, string, vtable). |
FINDPTR | FINDPTR <addr> | Examina los datos globales y las tablas para encontrar cualquier puntero que haga referencia a <addr> (encuentra vtables, tablas de despacho). |
STRUCT | STRUCT <addr> [n] | Vuelca heurísticamente la memoria contigua interpretando los campos como enteros, flotantes, punteros y cadenas. |
DEFSTRUCT | DEFSTRUCT <name> [size] | Crea una nueva estructura con nombre en la biblioteca de tipos de la base de datos. |
SETFIELD | SETFIELD <struct> <off> <type> [name] | Define o modifica un campo de estructura en <off> con <type> y un nombre de campo opcional. |
MKPTRS | MKPTRS <addr> [count] | Convierte bytes sin procesar de la base de datos en punteros tipados de forma masiva. |
NEARSTR | NEARSTR <addr> | Encuentra referencias a cadenas situadas cerca en secciones de código o datos dentro del rango. |
| Comando | Sintaxis | Descripción |
|---|---|---|
VTABLE | VTABLE <funcaddr> | Identifica qué tablas virtuales contienen <funcaddr>, incluidos los slots de métodos vecinos. |
VTDUMP | VTDUMP <addr> [count] | Volca una tabla virtual completa: resuelve cada slot a su nombre de método, desplazamiento e índice. |
RTTI | RTTI <addr|Name> | Recorre las estructuras RTTI de C++ de MSVC (TypeDescriptor -> CompleteObjectLocator -> vftable) para resolver jerarquías de clases y clases base. |
| Comando | Sintaxis | Descripción |
|---|---|---|
STR | STR <ascii> | Busca cadenas ASCII en todos los segmentos cargados. |
WSTR | WSTR <utf16> | Busca cadenas anchas UTF-16 en todos los segmentos cargados. |
BYTES | BYTES <hex> | Busca secuencias de bytes de opcode o datos sin procesar (p. ej. BYTES 55 8B EC 83 EC). |