IDAssist

Plugin de Ingeniería Inversa Impulsado por IA para IDA Pro

Acciones Automatizadas — Sugerencias de renombrado potenciadas por IA para funciones, variables y tipos. Revisa los cambios propuestos en una tabla con puntuaciones de confianza, luego aplica las acciones seleccionadas a la IDB.

Grafo de Conocimiento Semántico — Construye y explora un grafo de conocimiento de las funciones del binario, relaciones de llamadas, flujos de datos y características de seguridad. Incluye representación visual del grafo, búsqueda semántica y detección de comunidades.

Búsqueda de Documentos RAG — Sube documentos de referencia (.txt, .md, .rst, .pdf) y úsalos como contexto durante las consultas LLM. Soporta búsqueda híbrida texto+vector mediante indexación Whoosh.

Integración con SymGraph — Envía y recibe nombres de funciones, nombres de variables, tipos y datos del grafo hacia la plataforma colaborativa SymGraph. Incluye un asistente de varios pasos con resolución de conflictos para las descargas.

Gestión de Configuración — Configura múltiples proveedores LLM y MCP, gestiona credenciales de la API de SymGraph, personaliza el prompt del sistema y establece rutas de bases de datos.

Capacidades Avanzadas

Agente ReAct

La pestaña Query admite un modo de agente autónomo ReAct (Razonamiento + Actuación). Cuando está habilitado, el LLM planifica una estrategia de investigación, ejecuta herramientas para recopilar información, reflexiona sobre los hallazgos y sintetiza una respuesta completa, todo automáticamente a lo largo de múltiples rondas de razonamiento.

Pensamiento Extendido

Configura niveles de esfuerzo de razonamiento para controlar cuánto "piensa" el LLM antes de responder:

Integración MCP

IDAssist puede conectarse a servidores MCP externos para interacciones LLM aumentadas con herramientas, donde el modelo puede inspeccionar funciones mediante programación, leer desensamblado, consultar referencias cruzadas y modificar la IDB durante el razonamiento. Se admiten tanto servidores MCP basados en URL (SSE o Streamable HTTP) como servidores MCP basados en stdio iniciados desde un comando CLI local. IDAssist también proporciona herramientas internas integradas para llamadas a funciones sin necesidad de un servidor MCP externo.

Llamadas a Funciones

Los proveedores LLM con soporte para llamadas a herramientas pueden invocar funciones de análisis de IDA durante la conversación, permitiendo una investigación iterativa sin intervención manual.

Retroalimentación RLHF

Proporciona retroalimentación de pulgar arriba/abajo sobre explicaciones y respuestas a consultas. La retroalimentación se almacena localmente y puede usarse para mejorar la ingeniería de prompts y la selección de modelos.

Arquitectura

IDAssist sigue un patrón MVC (Modelo-Vista-Controlador):

• Vistas (src/views/) — Widgets de pestañas PySide6 que emiten señales al interactuar con el usuario
• Controladores (src/controllers/) — Conectan las señales de las vistas con las llamadas a servicios, gestionan el estado
• Servicios (src/services/) — Lógica de negocio, proveedores LLM, acceso a base de datos, análisis de grafos
• Herramientas Internas (src/services/internal_tools.py) — Definiciones de herramientas específicas de IDA para llamadas a funciones LLM
• Herramientas de Grafo (src/services/graphrag/graphrag_tools.py) — Herramientas de lectura/escritura de grafos semánticos para interacción LLM

Principios clave de diseño:

• Todas las llamadas a la API de IDA se ejecutan en el hilo principal mediante execute_on_main_thread()
• Las respuestas del LLM se transmiten de forma incremental a la interfaz de usuario
• Bases de datos SQLite locales para persistencia (no requiere base de datos externa)
• Registro de servicios singleton con inicialización segura para subprocesos

Inicio Rápido

1. Instala el plugin (recomendado — Administrador de Plugins de IDA):

   root@kitploit:~

   hcli plugin install idassist
   

   Esto instala automáticamente el plugin y sus dependencias de Python en el entorno de IDA.

2. O instala manualmente (desde el archivo comprimido de la versión):

   Descarga el zip de la última versión desde GitHub Releases y extráelo en tu directorio de plugins de IDA:

   Linux / macOS:

   root@kitploit:~

   unzip IDAssist-*.zip -d ~/.idapro/plugins/
   

   Windows: Extrae el zip en %APPDATA%\Hex-Rays\IDA Pro\plugins\.

   Luego instala las dependencias usando el Python incluido con IDA (no el Python de tu sistema):

   Linux / macOS:

   root@kitploit:~

   <IDA_INSTALL_DIR>/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssist/requirements.txt
   

   Windows:

   root@kitploit:~

   "<IDA_INSTALL_DIR>\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssist\requirements.txt"
   

   Reemplaza <IDA_INSTALL_DIR> con la ruta de instalación de IDA Pro (por ejemplo, /opt/idapro-9.0 o C:\Program Files\IDA Pro 9.0).

   Consejo: También puedes establecer la variable de entorno IDAUSR en un directorio personalizado que contenga un subdirectorio plugins/.

3. Abre IDAssist: Inicia IDA Pro, abre un binario y presiona Ctrl+Shift+A (o Editar > Plugins > IDAssist).

4. Configura un proveedor: Ve a la pestaña de Configuración, haz clic en Agregar bajo Proveedores LLM y configura tu proveedor preferido.

5. Analiza una función: Navega a cualquier función, haz clic en la pestaña Explain y presiona Explain Function.

Para instrucciones detalladas de configuración, consulta Primeros Pasos.

Configuración de Proveedores LLM

IDAssist soporta los siguientes tipos de proveedores:

Modelos Recomendados

Uso del Grafo Semántico

La pestaña Semantic Graph proporciona un grafo de conocimiento del binario:

1. ReIndex Binary — Extrae la estructura de funciones, el grafo de llamadas y las referencias cruzadas
2. Semantic Analysis — Genera resúmenes LLM para cada función
3. Security Analysis — Detecta patrones de vulnerabilidad y APIs relevantes para seguridad
4. Network Flow — Rastrea operaciones de red a través del grafo de llamadas
5. Community Detection — Agrupa funciones relacionadas en módulos

Explora el grafo a través de la List View (llamadores, llamados, aristas, banderas), Visual Graph (diagrama de nodos interactivo con expansión de N saltos) o Search (7 tipos de consulta que incluyen búsqueda semántica, funciones similares y contexto de llamadas).

Acciones del Menú Contextual

Haz clic derecho en cualquier vista de Desensamblado o Pseudocódigo para acceder a:

Requisitos

• IDA Pro 9.0+ con Python 3 y PySide6
• Descompilador Hex-Rays (recomendado para funciones de pseudocódigo)
• Paquetes de Python listados en requirements.txt

Documentación

• Índice de Documentación
• Primeros Pasos
• Referencias de Pestañas: Explain | Query | Actions | Semantic Graph | RAG | Settings
• Flujos de Trabajo: Explain | Query | Semantic Graph

Página Principal

https://symgraph.ai

Licencia

Consulta el archivo LICENSE para más detalles.