evil-winrm-py es una herramienta basada en Python para ejecutar comandos en máquinas Windows remotas utilizando el protocolo WinRM (Windows Remote Management). Proporciona un shell interactivo con características mejoradas como carga/descarga de archivos con progreso y verificación de checksum, autocompletado con tabulador de rutas locales/remotas y cmdlets de PowerShell, carga y ejecución de scripts de PowerShell, ejecución en memoria de DLLs y EXEs, historial de comandos y salida coloreada. También puede ejecutarse como servidor MCP, exponiendo sesiones WinRM como herramientas para clientes compatibles con MCP. Soporta varios métodos de autenticación incluyendo NTLM, Pass-the-Hash, Certificado y Kerberos. ir a instalación

[!NOTE] Esta herramienta está diseñada estrictamente para uso educativo, ético y pruebas de penetración autorizadas. Asegúrate siempre de contar con autorización explícita antes de acceder a cualquier sistema. El acceso no autorizado o el uso indebido de esta herramienta es tanto ilegal como poco ético.

Motivación

El evil-winrm original está escrito en Ruby, lo que puede ser un obstáculo para algunos usuarios. Reescribirlo en Python lo hace más accesible y fácil de usar, además de permitirnos aprovechar el rico ecosistema de Python para añadir características y flexibilidad.

También quería aprender más sobre winrm y sus interioridades, así que este proyecto también me servirá como experiencia de aprendizaje.

Características

• Ejecutar comandos en máquinas Windows remotas mediante un shell interactivo.
• Descargar archivos desde el host remoto a la máquina local.
• Subir archivos desde la máquina local al host remoto.
• Barra de progreso para transferencias de archivos con estimación de velocidad y tiempo.
• Transferencia de archivos estable y fiable, incluyendo soporte para archivos grandes con verificación de checksum MD5.
• Autocompletado de rutas de archivos locales y remotas (incluso aquellas con espacios) con el tabulador Tab.
• Autocompletado de cmdlets/helpers de PowerShell con el tabulador Tab.
• Cargar funciones de PowerShell desde scripts locales en el shell interactivo.
• Ejecutar scripts de PowerShell locales en el host remoto.
• Cargar DLLs locales (en memoria) como módulos de PowerShell en el host remoto.
• Subir y ejecutar EXEs locales (en memoria) en el host remoto.
• Listar los servicios en ejecución (excepto servicios del sistema) en el host remoto.
• Modo servidor MCP opcional para exponer login/execute/logout de WinRM como herramientas para clientes MCP, con soporte para múltiples sesiones concurrentes. 🆕
• Habilitar logging y depuración para una mejor trazabilidad.
• Navegar por el historial de comandos usando las teclas de flecha arriba/abajo.
• Mostrar salida coloreada para mejorar la legibilidad.
• Ligero y basado en Python para facilitar su uso.
• Soporte de Keyboard Interrupt (Ctrl+C / Ctrl+D) para terminar comandos de larga duración de forma controlada.

Incluye soporte para:

• Autenticación NTLM.
• Autenticación Pass-the-Hash.
• Autenticación por certificado.
• Autenticación Kerberos con prefijo SPN personalizado y opciones de nombre de host.
• SSL para asegurar la comunicación con el host remoto.
• URIs WSMan personalizadas.
• user agent personalizado para el cliente WinRM.
• conexión a configuraciones de sesión de Just Enough Administration (JEA). 🆕

La documentación detallada se encuentra en el directorio docs.

Instalación

Instalación de los requisitos previos de Kerberos en Linux

sudo apt install gcc python3-dev libkrb5-dev krb5-pkinit
# Optional: krb5-user

Instalar evil-winrm-py

Puedes usar uv/pipx en lugar de pip para instalar evil-winrm-py. uv/pipx es una herramienta para instalar y ejecutar aplicaciones Python en entornos aislados, lo que ayuda a prevenir conflictos de dependencias al mantener las dependencias de la herramienta separadas de los paquetes Python de tu sistema.

Consulta la Guía de Instalación para más detalles.

pip install evil-winrm-py
# for optional dependencies use any one of the following commands:
pip install evil-winrm-py[kerberos] # for kerberos support on Linux
pip install evil-winrm-py[mcp] # for mcp support
pip install evil-winrm-py[kerberos,mcp] # to install both optional dependencies

# Note: building gssapi and krb5 packages may take some time, so be patient.

o si quieres instalar con el último commit de la rama main puedes hacerlo clonando el repositorio e instalándolo con pip/uv/pipx:

git clone https://github.com/adityatelange/evil-winrm-py
cd evil-winrm-py
pip install .
# or use: pip install .[kerberos,mcp] to install both optional dependencies

Actualizar

pip install --upgrade evil-winrm-py

Desinstalar

pip uninstall evil-winrm-py

Disponibilidad en distribuciones Unix

Para las distribuciones mencionadas anteriormente, puedes instalar evil-winrm-py directamente desde sus gestores de paquetes. Gracias a los mantenedores de paquetes por empaquetar y mantener evil-winrm-py en sus respectivas distribuciones.

Uso

Los detalles sobre cómo usar evil-winrm-py se encuentran en la Guía de Uso.

usage: evil-winrm-py [-h] [-i IP] [-u USER] [-p PASSWORD] [-H HASH] [-c CONFIGURATION_NAME]
                     [--priv-key-pem PRIV_KEY_PEM] [--cert-pem CERT_PEM] [--uri URI] [--ua UA]
                     [--port PORT] [--spn-prefix SPN_PREFIX] [--spn-hostname SPN_HOSTNAME] [-k]
                     [--no-pass] [--ssl] [--log] [--debug] [--no-colors] [--version] [--mcp]
                     [--mcp-port MCP_PORT] [--mcp-host MCP_HOST]