Nmap NSE: scripts en Lua para fingerprinting y auditoría sigilosa
Nmap dejó de ser una simple herramienta de escaneo de puertos hace más de una década. Con la llegada del Nmap Scripting Engine (NSE), la herramienta se transformó en una plataforma extensible donde cada prueba de red es un programa en Lua ejecutado contra el objetivo. Para un auditor serio, esto significa algo poderoso: la capacidad de moldear el tráfico a voluntad, capturar respuestas sutiles que un escaneo tradicional ignora y construir firmas personalizadas que ningún motor genérico detectaría igual.
Qué es NSE y por qué Lua
El NSE es un intérprete de Lua embebido dentro de Nmap. Cada script se ejecuta en el contexto de una conexión o de un host ya descubierto, y tiene acceso a una API rica: sockets crudos, manejo de paquetes, parsing de protocolos, acceso a la base de datos de puertos y una biblioteca de utilidades (stdnse, nmap, shortport, http, ssl). Lua fue elegido por su tamaño reducido, su velocidad de arranque y su facilidad para incrustarse en C. El resultado es un motor que arranca scripts en milisegundos sin inflar el binario de Nmap.
La clasificación de scripts se organiza por categorías: default, safe, intrusive, discovery, auth, vuln, brute, exploit, malware, version y external. Para auditoría sigilosa, las categorías relevantes son safe y discovery, porque no alteran el estado del servicio ni generan cargas que disparen alertas.
Anatomía de un script NSE
Todo script arranca con metadatos en comentarios especiales que Nmap interpreta. Estos campos controlan cuándo y cómo se ejecuta:
local nmap = require "nmap"
local shortport = require "shortport"
local stdnse = require "stdnse"
local string = require "string"
description = [[
Detecta la version exacta del banner HTTP y extrae el header Server
sin enviar peticiones adicionales al handshake.
]]
author = "auditor"
license = "Same as Nmap"
categories = {"safe", "discovery"}
portrule = shortport.http
El campo portrule es la puerta de entrada: define bajo qué condiciones se ejecuta el script. Las opciones típicas son shortport.http, shortport.ssl, o una función personalizada que examine host, port y protocol.
Reglas de host y de puerto
- hostrule: se ejecuta una vez por host, ideal para tareas como consultar DNS inverso o probar múltiples puertos de forma coordinada.
- portrule: se ejecuta por cada puerto que coincida con la condición.
- postrule: se ejecuta al final del escaneo, cuando todos los hosts han sido procesados. Perfecto para generar reportes consolidados.
Fingerprinting fino con control del handshake
El fingerprinting clásico de Nmap se basa en respuestas TCP/IP del stack. Pero el fingerprinting de aplicación requiere ver cómo responde el servicio ante entradas específicas. Un script NSE puede enviar bytes exactos y medir la respuesta:
action = function(host, port)
local sock = nmap.new_socket()
sock:set_timeout(3000)
local status, err = sock:connect(host.ip, port.number)
if not status then return nil end
sock:send("HEAD / HTTP/1.0\r\nHost: " .. host.targetname .. "\r\n\r\n")
local response = stdnse.get_script_args("http.server")
local data = sock:receive_buf("\r\n\r\n", false)
sock:close()
local server = string.match(data, "Server: ([^\r\n]+)")
if server then
return "Servidor detectado: " .. server
end
return "Sin header Server"
end
La clave del fingerprinting preciso está en no confiar en un solo campo. Un atacante o un WAF puede falsificar el header Server. Por eso un buen script combina: orden de headers, capitalización, presencia o ausencia de ciertos campos, tiempos de respuesta y comportamiento ante métodos inusuales como OPTIONS o TRACE.
Auditoría sigilosa: reduciendo la huella
El sigilo en Nmap no es solo cuestión de -T0 o --scan-delay. Los scripts NSE pueden diseñarse para minimizar su firma. Algunas técnicas concretas:
Reutilizar conexiones existentes
Cuando se lanza un escaneo con -sV, Nmap ya ha establecido conexiones y recopilado banners. Un script puede leer esos datos desde nmap.registry en lugar de abrir un socket nuevo. Esto elimina paquetes adicionales y reduce drásticamente la probabilidad de detección.
local port_version = nmap.get_port_state(host, port)
if port.version and port.version.name then
return "Version cacheada: " .. port.version.name
end
Aleatorización de temporización
Un patrón de paquetes regular es una firma. Insertar jitter en los envíos ayuda:
local delay = math.random(200, 1200)
stdnse.sleep(delay / 1000)
Evitar payloads identificables
Los IDS modernos inspeccionan contenido. En lugar de enviar cadenas conocidas como Nmap NSE o user-agents por defecto, un script puede construir payloads que imiten tráfico legítimo:
local ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
sock:send("GET / HTTP/1.1\r\nHost: " .. host.ip ..
"\r\nUser-Agent: " .. ua .. "\r\nConnection: close\r\n\r\n")
Otra práctica es usar set_timeout cortos y cerrar conexiones abruptamente cuando el servicio no responde como se espera, evitando reintentos que generen ruido.
Casos de uso reales
- Detección de servidores web detrás de balanceadores: enviar peticiones con
Hostalternativos y comparar respuestas para mapear backends internos. - Identificación de paneles de administración: comprobar rutas comunes con un solo script que itera sobre un diccionario y reporta códigos 200.
- Verificación de cabeceras de seguridad: extraer
Strict-Transport-Security,Content-Security-PolicyyX-Frame-Optionsen una sola pasada. - Fingerprinting de servicios TLS: usar la librería
sslpara negociar versiones específicas y registrar qué cifrados acepta el servidor.
Ejecución y depuración
Para probar un script durante el desarrollo:
nmap -p 80,443 --script ./mi-script.nse --script-trace 192.168.1.10
El flag --script-trace imprime cada operación de socket, algo esencial cuando un script falla silenciosamente. Para depurar dentro del propio Lua, stdnse.debug(1, "mensaje") se activa con -d o --script-args=verbosity=2.
Conclusiones
El NSE convierte a Nmap en una plataforma de auditoría a medida. Escribir scripts en Lua permite adaptar cada prueba al objetivo, reducir la huella en la red y obtener información que las firmas genéricas pasan por alto. La combinación de fingerprinting preciso con técnicas de sigilo no es solo una cuestión técnica: es una filosofía de auditoría donde cada paquete tiene una justificación y cada respuesta se interpreta con contexto. Dominar NSE es, hoy, una de las habilidades más rentables para cualquier profesional de ciberseguridad ofensiva.