Frida Workbench para VSCode

Repositorio | Incidencias | Instalar

Este es un proyecto contribuido por la comunidad, no afiliado al equipo oficial de Frida. Es desarrollado y mantenido por @CodeColorist como una extensión de código abierto para Visual Studio Code que mejora la experiencia de escritura de scripts de Frida.

Documentación en chino

Requisitos previos

• Python >= 3.7
• Paquete de Python frida-tools

Dependencias opcionales

• libimobiledevice (para que el comando inetcat inicie un shell SSH)
• iTunes en Windows (para la conexión USB de iOS)

Si estás en Windows, necesitas mantener iTunes abierto para interactuar con dispositivos iOS mediante USB.

Instalar frida-tools

Debido a PEP0668, es posible que encuentres un error al ejecutar pip3 install frida-tools de forma global.

La forma recomendada es abrir una carpeta (espacio de trabajo) en VSCode y luego crear y activar un entorno virtual mediante la extensión de Python. En ese caso, la extensión usará tu entorno virtual de Python activo actual para cargar los comandos de frida.

Alternativamente, puedes usar un gestor de paquetes como pipx o UV para instalarlo en $PATH, manteniéndolo aislado.

Características

Lista de aplicaciones y procesos

Lista las aplicaciones y procesos en los dispositivos conectados en un panel lateral. Haz clic derecho para adjuntarte, adjuntarte con privilegios elevados para objetivos locales, iniciar (spawn), iniciar en modo suspendido, matar procesos o copiar la información del dispositivo/proceso al portapapeles. Admite dispositivos locales, USB y remotos. Las entradas de procesos locales incluyen metadatos de mejor esfuerzo, como la ruta del ejecutable, propietario, PID padre y argumentos cuando estén disponibles.

Paneles interactivos en tiempo de ejecución

Explorador de módulos y exportaciones

Explora los módulos nativos cargados y sus funciones exportadas de cualquier proceso adjunto. Filtra módulos por nombre, inspecciona la dirección base, el tamaño y la ruta, y selecciona exportaciones para generar hooks.

Explorador de clases y métodos

Explora las clases y métodos en tiempo de ejecución tanto para Java como para Objective-C. Filtra clases, alterna entre métodos propios y heredados, y selecciona métodos por lotes para generar hooks. También incluye inspección de protocolos de Objective-C para explorar y analizar protocolos.

Generar cabecera

Genera cabeceras de clase para ingeniería inversa:

• Objective-C — genera archivos de cabecera a partir de los metadatos de clase en tiempo de ejecución
• Java — genera stubs de clases descompiladas con sentencias de paquete e importación

Generación de hooks

Genera código de hooks de Frida desde los paneles de Módulos y Clases:

• Hooks nativos — Interceptor.attach() con callbacks onEnter / onLeave para funciones exportadas
• Hooks de Objective-C — hooks basados en clases y selectores con el uso adecuado del puente de ObjC
• Hooks de Java — hooks de Java.perform() / Java.use() con soporte para sobrecarga de métodos
• Hooks impulsados por IA — usa GitHub Copilot para inferir firmas de funciones nativas (tipos de parámetros, tipos de retorno) y generar un registro de argumentos con información de tipos

Autocompletado inteligente (LSP)

Autocompletados contextuales para scripts de Frida en JavaScript / TypeScript:

• ObjC.classes.<ClassName> — completa nombres de clases de Objective-C
• ObjC.classes.Foo['<method>'] — completa selectores de métodos
• ObjC.classes.Foo.method — completa selectores de métodos de clase
• Java.use('<ClassName>') — completa nombres de clases de Java
• Process.getModuleByName('<name>') — completa nombres de módulos cargados

El servidor de lenguaje depende del contexto del proceso objetivo. Necesitas crear un archivo de configuración .vscode/frida.json en tu espacio de trabajo. La forma más sencilla es hacer clic derecho en un proceso o aplicación en la barra lateral y seleccionar Set LSP Target, que genera el archivo automáticamente.

Configuración de .vscode/frida.json

El archivo especifica a qué dispositivo y objetivo debe adjuntarse el LSP. Requiere un campo device y exactamente uno de app, pid o process.

Adjuntar por identificador de aplicación (recomendado — inicia (spawn) o se adjunta a la aplicación):

{
    "device": "local",
    "app": "com.example.myapp"
}

Adjuntar por nombre de proceso:

{
    "device": "local",
    "process": "myprocess"
}

Adjuntar por PID (útil cuando varios procesos comparten el mismo nombre):

{
    "device": "local",
    "pid": 1234
}

El valor de device corresponde al ID de dispositivo de Frida: local para la máquina anfitriona, usb para un dispositivo conectado por USB, o una cadena host:port para dispositivos remotos.

El LSP observa este archivo para detectar cambios. Editarlo o recrearlo reinicia automáticamente el servidor de lenguaje con el nuevo objetivo.

Syslog

Transmite en tiempo real los registros de aplicación de los procesos adjuntos.

Andamiaje de proyectos

• Nuevo agente — crea un nuevo proyecto de agente de Frida con soporte para TypeScript
• Nuevo módulo C — crea un nuevo proyecto de módulo C de Frida
• Descargar typings — descarga las definiciones de tipos de Frida en TypeScript para el autocompletado

Configuración de depuración

Genera launch.json y tasks.json de VSCode para depurar scripts de Frida con puntos de interrupción.

Herramientas de Android

• Descargar e iniciar frida-server en el dispositivo Android (detección automática de arquitectura)
• Extraer APK del dispositivo (haz clic derecho en una aplicación Android para extraerlo)

Integración con herramientas externas

• Objection — Exploración móvil en tiempo de ejecución

Shell

Para dispositivos Android, Open Shell es un envoltorio para adb shell.

Para iOS proporciona un shell SSH en dispositivos con jailbreak. Puede ser necesario configurar credenciales.

Compatibilidad con dispositivos remotos

Conéctate a dispositivos Frida remotos mediante host:port directamente desde la barra lateral.

CHANGELOG

Contribuyentes