Skip to content
KitploitKITPLOIT
HerramientasExploitsBlog
Log in
Enviar
HerramientasExploitsBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

FeedsContactoPrivacidad© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
Winstrument — Winstrument es un marco de scripts modulares para ayudar a instrumentar software de Windows usando Frida para ingeniería inversa y análisis de superficie de ataque. | Kitploit
Herramientas/GitHubGitHub/nccgroup/winstrument
Análisis de VulnerabilidadesAnálisis Dinámico de Código (DAST)Ingeniería InversaAnálisis de Binarios
GitHubnccgroup/winstrument

Winstrument

Winstrument es un marco de scripts modulares para ayudar a instrumentar software de Windows usando Frida para ingeniería inversa y análisis de superficie de ataque.

Ver Repositorio
68945hace 6 añosRevisado por Kitploit
Compartir

Winstrument

Winstrument es un framework de scripts modulares para ayudar a instrumentar software de Windows usando Frida para ingeniería inversa y análisis de superficie de ataque.

Contenido

  • Instalación
  • Uso
  • Estructura del Proyecto
  • Módulos
  • CLI
  • Solución de problemas
  • Derechos de autor

Instalación

Este proyecto soporta Python 3.7. Asumiendo que ya tienes Python y pip instalados, simplemente:

pip install winstrument

y luego para ejecutar el programa, ejecuta:

winstrument

Ten en cuenta que la herramienta actualmente es experimental, y puede a veces congelarse o tener otros problemas de estabilidad.

En algunos casos, como una instalación limpia de Windows 10, puedes encontrarte con un error SSL en pip al instalar Frida. Si esto ocurre, consulta Solución de problemas más abajo.

Uso

Para ejecutar el REPL de winstrument, simplemente ejecuta winstrument. Aquí tienes un ejemplo rápido de instrumentación de notepad.exe con el módulo registry. Para información completa sobre los comandos CLI disponibles, consulta la sección CLI más abajo.

PS C:\winstrument> winstrument
> set target C:\Windows\System32\notepad.exe
> use registry
> run
Spawned 1144
instrumented process with pid: 1144 and path: C:\Windows\System32\notepad.exe

<User closes notepad from GUI>

detached from 1144 for reason process-terminated
> show registry
module    time               target                           function          hkey                subkey                                                                       value
--------  -----------------  -------------------------------  ----------------  ------------------  ---------------------------------------------------------------------------  ---------------------------------
registry  2019-08-19 07:03:07  C:\Windows\System32\notepad.exe  RegGetValueW      0x2f4               SOFTWARE\Microsoft\Windows\CurrentVersion\Themes\Personalize                 AppsUseLightTheme
<...>

En el ejemplo anterior, el usuario indica el proceso objetivo, en este caso notepad.exe. Luego indica que quiere usar el módulo registry, que enumera las llamadas al sistema relacionadas con el registro realizadas por el programa. Cuando el proceso finaliza (el usuario cierra Notepad), la salida almacenada se puede ver usando show registry.

Estructura del Proyecto

El archivo principal de Python winstrument.py inicializa el dispositivo Frida y lanza una instancia del proceso objetivo. cmdline.py proporciona una interfaz de línea de comandos usando cmd2. Este es el principal punto de entrada del script cuando Winstrument se ejecuta directamente desde la línea de comandos. Los comandos están documentados más abajo.

Luego itera a través de cada módulo habilitado, lo instancia y llama al método load_scripts() de ese módulo para instrumentar el proceso. Finalmente, llama a get_output() y on_finish() para cada módulo cuando se desvincula del objetivo.

Los módulos están contenidos en archivos .py en el directorio modules/. Un módulo consiste en una subclase de base_module.BaseInstrumentation que define el código a inyectar, el manejo de mensajes para ese código inyectado y la salida. Las APIs de los módulos se definen más adelante en la sección "Módulos" más abajo.

Cada módulo almacena metadatos como su descripción en modules/metadata.toml. La sección debe tener como encabezado el nombre del módulo (sin distinguir mayúsculas de minúsculas). Por ejemplo, aquí está la sección correspondiente al módulo dlls:

[DLLS]
description = """Hooks LoadLibrary-family system calls and outputs DLL loads where part of the search path might be
writable by the current user or a low-privileged user group."""

El programa almacena la configuración en settings.toml en %APPDATA%/winstrument. Como la mayoría, si no todos, los módulos inyectarán Javascript en el proceso objetivo, el directorio modules/js/ contiene fragmentos de Javascript de Frida que son cargados e inyectados por los módulos. Estos archivos deben tener el mismo nombre que el módulo, es decir, el módulo dlls.py usaría JS de js/dlls.js.

Módulos

Como se describió anteriormente, cada módulo subclasifica BaseInstrumentation de base_module.py.

Cada módulo debe definir su nombre (el nombre de los archivos python y js sin la extensión) como un atributo de clase estático llamado modulename. Los módulos pueden usar o sobrescribir los siguientes métodos de BaseInstrumentation:

  • __init__(self,*args,**kwargs) - Además de cualquier código de inicialización específico del módulo, este constructor debe llamar a super().__init__(*args,**kwargs).
  • load_script(self) - Este método generalmente no debería necesitar ser sobrescrito, ya que la implementación en BaseInstrumentation debería ser suficiente para la mayoría de los casos de uso. Para enganchar eventos de Frida, sobrescribe register_callbacks() en su lugar. load_script debería usarse para cargar el archivo javascript a instrumentar, llamar a session.create_script de Frida, añadir los callbacks deseados y luego llamar al método load() del objeto script para instrumentar.
  • register_callbacks(self) - Llamado por BaseInstrumentation.load_script antes de cargar el script en el proceso objetivo. Se usa para registrar eventos como _session.on('message'), etc. La versión de BaseInstrumentation añade un hook para on_message por defecto.
  • write_message(message) toma un mensaje tipo JSON como un dict, lo escribe en la base de datos sqlite y lo guarda para ser emitido más tarde.
  • post_load(self) Llamado por BaseInstrumentation.load_script después de que el script se cargue dentro del proceso objetivo. Esto podría usarse, por ejemplo, para llamar a métodos rpc exportados por el script.
  • get_output(self) - Llamado por el script principal cuando el objetivo se desvincula. Este método debería devolver una lista, donde cada entrada es un objeto MoudleMessage (de data/module_message.py). Generalmente no necesita ser sobrescrito.
  • on_message(self,message,data) - Callback para manejar el evento message de frida, que se dispara con send en el JS inyectado.
  • on_finish(self) - Callback llamado por el script principal cuando el objetivo se desvincula. Realiza aquí cualquier operación de limpieza necesaria.

CLI

El shell de Winstrument proporciona los siguientes comandos:

  • list - Muestra todos los módulos disponibles y cargados.
  • load <modulename>/use <modulename> - Habilita el módulo con el nombre dado.
  • unload <modulename> - Deshabilita el módulo con el nombre dado.
  • set [setting [value]] - Sin argumentos, muestra todos los ajustes y sus valores. Con un argumento, muestra el valor de setting. Con dos argumentos, establece setting a value. Los ajustes persisten entre múltiples ejecuciones.
  • show [modulename [format]] - Muestra la entrada almacenada de modulename en el format especificado. Ejecútalo sin argumentos para ver una lista de formateadores.
  • info <modulename> - Imprime una descripción del módulo con el nombre dado.
  • run - Inicia la instrumentación.
  • q/quit/exit - Sale de la CLI (obviamente).

Solución de problemas

Descargar herramienta

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 El kit de herramientas OSINT definitivo: grafo de investigación, puntuación de confianza, familias de alias, mapa, línea de tiempo e informes. 49 módulos, más de 400 sitios, sin necesidad de claves API.

    591
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Aplicación de Ejecución con un Solo Toque GhostLock (CVE-2026-43499)

    481
  • 3

    ARTEX

    baarai/artex

    Plataforma de pruebas de penetración autónoma multiagente basada en LLM con agentes planificadores/trabajadores, grafos de activos y de exploración, registro de tráfico MITM y reevaluación de vulnerabilidades.

    389
  • 4

    redforge

    cybersecurity91/redforge

    Kit de herramientas de red team del lado del navegador con 102 herramientas offline para reconocimiento, generación de payloads, ataques de credenciales, criptografía, codificación y elaboración de informes de compromiso.

    332
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    El sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.

    255
  • 6

    antifox

    antifox-ai/antifox

    Plataforma de pruebas de penetración autónoma con múltiples agentes de IA que ejecuta reconocimiento, descubrimiento de superficie de ataque, validación de explotación y entrega de informes respaldados por evidencia.

    247

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →