← volver

Auditoría de red con Nmap NSE: crea tus propios scripts y automatízala

Por · · actualizado el · [Ciberseguridad] · lectura estimada: ~8 min

Introducción

Con Nmap ya en la rama 7.99, el escaneo de red sigue siendo la base de cualquier auditoría de seguridad seria. Pero Nmap es mucho más que un escáner de puertos: su motor NSE (Nmap Scripting Engine) permite ejecutar cientos de scripts en Lua durante el escaneo para detectar versiones vulnerables, configuraciones inseguras y servicios mal expuestos. Esta guía actualizada te muestra cómo usar los scripts más útiles, crear los tuyos propios y automatizar auditorías periódicas en 2026.

1. Fundamentos de NSE

1.1. ¿Qué es NSE?

NSE es un framework que ejecuta scripts escritos en Lua en distintas fases del escaneo. Cada script declara:

  • Metadatos: descripción, autor, licencia y categorías (safe, discovery, vuln, auth, brute, exploit, intrusive…).
  • Regla de ejecución: portrule, hostrule o postrule, que deciden cuándo se lanza el script.
  • Función action: la lógica principal del script.
  • Argumentos opcionales: configurables con --script-args.

1.2. Versiones actuales y ubicación de los scripts

Las distribuciones actuales incluyen Nmap 7.98/7.99 con más de 600 scripts oficiales en /usr/share/nmap/scripts/. Comprueba tu versión y actualiza la base de datos de scripts:

nmap --version
ls /usr/share/nmap/scripts | wc -l
sudo nmap --script-updatedb

Tus scripts personalizados pueden vivir en ese mismo directorio o en una carpeta propia que pases directamente con --script:

mkdir -p /opt/nse-custom
sudo nmap -p 22 --script /opt/nse-custom/mi-script.nse 192.168.1.10

1.3. Esqueleto comentado de un script .nse

Este es el punto de partida mínimo y funcional para crear tus propios scripts. Cópialo, guárdalo como mi-auditoria.nse y ejecútalo tal cual:

-- mi-auditoria.nse
-- Esqueleto comentado de script NSE: lee el banner de un servicio TCP
-- y lo devuelve en la salida del escaneo.

local shortport = require “shortport” — reglas de puerto listas para usar local stdnse = require “stdnse” — utilidades de formato de salida

— Metadatos obligatorios: descripcion, autor, licencia y categorias description = [[ Lee el banner de un servicio TCP y lo muestra en la salida. Ejemplo minimo y funcional para empezar a crear scripts NSE. ]]

author = “Tu Nombre tu@email.com” license = “Same as Nmap—See https://nmap.org/book/man-legal.html” — Categorias: “safe” (no intrusivo), “discovery”, “vuln”, “default”… categories = {“discovery”, “safe”}

— portrule: decide en que puertos se ejecuta el script. — shortport.port_or_service(puertos, servicio, protocolo, estado) portrule = shortport.port_or_service({21, 22, 25, 110, 143}, “ftp”, “tcp”, “open”)

— action: la logica principal. Recibe el host y el puerto ya detectados. action = function(host, port) — Crea un socket TCP gestionado por NSE local socket = nmap.new_socket() socket:set_timeout(5000) — tiempo maximo de espera: 5 segundos

— Intenta conectar al puerto del objetivo local ok, err = socket:connect(host.ip, port.number) if not ok then return stdnse.format_output(false, “No se pudo conectar: %s”, err) end

— Lee la primera linea que envia el servidor (el banner) local status, banner = socket:receive_lines(1) socket:close() — cierra siempre la conexion

if status and banner and banner:gsub(“%s+”, "") ~= "" then return stdnse.format_output(true, “Banner detectado: %s”, banner) end return stdnse.format_output(false, “El servicio no devolvio banner”) end

Ejecución del ejemplo:

sudo nmap -p 21,22,25 --script ./mi-auditoria.nse 192.168.1.10

Si el script no se carga, revisa la sintaxis Lua y vuelve a ejecutar nmap --script-updatedb; un simple error de sintaxis impide la carga de todo el lote.

2. Scripts populares que debes dominar

2.1. vulners: convierte versiones en CVEs

vulners toma cada servicio y versión detectados con -sV y los consulta contra la base de datos de vulners.com, devolviendo CVEs, puntuación CVSS y si existe exploit público. No viene incluido en Nmap: hay que instalarlo aparte.

# Instalacion (el script no se incluye en Nmap por defecto)
sudo git clone https://github.com/vulnersCom/nmap-vulners /opt/nmap-vulners
sudo cp /opt/nmap-vulners/vulners.nse /usr/share/nmap/scripts/
sudo nmap --script-updatedb

Uso basico: requiere -sV y conexion a internet

sudo nmap -sV —script vulners 192.168.1.10

Solo vulnerabilidades con CVSS igual o superior a 7.0

sudo nmap -sV —script vulners —script-args mincvss=7.0 192.168.1.10

En la salida, las entradas marcadas con *EXPLOIT* indican que existe una prueba de concepto pública: son tu prioridad número uno en el triaje.

2.2. http-enum: enumera lo que el servidor web expone

http-enum prueba rutas y ficheros conocidos (/admin/, /backup/, /.git/, copias de configuración…) contra los puertos web detectados. Combínalo con otros scripts HTTP para una primera pasada rápida:

sudo nmap -p 80,443 --script http-enum 192.168.1.10

Barrido web mas completo en una sola pasada

sudo nmap -p 80,443 —script http-enum,http-security-headers,http-methods,http-title 192.168.1.10

http-security-headers es especialmente útil en auditorías: revela cabeceras de seguridad ausentes como Content-Security-Policy o Strict-Transport-Security.

2.3. smb-*: radiografía de Windows y Samba

La familia smb-* es imprescindible en redes con equipos Windows. Empieza por la configuración y sigue con las vulnerabilidades:

# Protocolos SMB soportados y nivel de firma exigido
sudo nmap -p 445 --script smb-protocols,smb-security-mode,smb2-security-mode 192.168.1.10

Barrido de vulnerabilidades SMB conocidas (incluye EternalBlue)

sudo nmap -p 445 —script “smb-vuln*” 192.168.1.10

Metodos de autenticacion SSH (util en el mismo barrido de hardening)

sudo nmap -p 22 —script ssh-auth-methods 192.168.1.10

Algunos scripts SMB aceptan credenciales para una enumeración más profunda mediante --script-args smbusername=...,smbpassword=....

3. Personaliza tus scripts con argumentos

Un script reutilizable acepta parámetros con --script-args. Este ejemplo comprueba una lista de rutas web configurable sin tocar el código:

-- http-rutas.nse
local shortport = require "shortport"
local stdnse = require "stdnse"

description = [[ Comprueba si una lista de rutas web (configurable por argumento) devuelve HTTP 200 en el servidor objetivo. ]]

author = “Tu Nombre tu@email.com” license = “Same as Nmap—See https://nmap.org/book/man-legal.html” categories = {“discovery”, “safe”}

portrule = shortport.http

action = function(host, port) — Lee el argumento o usa un valor por defecto local rutas = stdnse.get_script_args(“http-rutas.paths”) or “/admin,/backup,/.git” if type(rutas) == “string” then rutas = stdnse.strsplit(”,”, rutas) end

local expuestas = {} for _, r in ipairs(rutas) do local sock = nmap.new_socket() sock:set_timeout(3000) local ok = sock:connect(host.ip, port.number) if ok then sock:send(string.format(“HEAD %s HTTP/1.0\r\nHost: %s\r\n\r\n”, r, host.ip)) local status, resp = sock:receive_lines(1) if status and resp and resp:match(“^HTTP/%d%.%d 200”) then table.insert(expuestas, r) end end sock:close() end

if #expuestas > 0 then return stdnse.format_output(true, “Rutas expuestas: %s”, table.concat(expuestas, ”, ”)) end return stdnse.format_output(false, “Ninguna ruta sensible expuesta”) end

sudo nmap -p 80 --script ./http-rutas.nse \
  --script-args 'http-rutas.paths=/admin,/login,/api,/server-status' 192.168.1.10

4. Automatiza la auditoría con un systemd timer

En sistemas modernos, systemd timers han sustituido a cron para tareas programadas: ofrecen registro integrado con journalctl, reintentos y ejecución compensatoria si el equipo estuvo apagado. Crea un script de auditoría:

#!/bin/bash
# /usr/local/bin/nmap-audit.sh - Auditoria NSE programada
set -euo pipefail

TARGETS=“/etc/nmap-audit/targets.txt” # una IP o red por linea OUTDIR=“/var/log/nmap-audit” FECHA=$(date +%Y%m%d)

mkdir -p “$OUTDIR”

nmap -sV -T4 —open
—script vulners,http-enum,smb-vuln-ms17-010,ssh-auth-methods
-iL “$TARGETS”
-oX “$OUTDIR/auditoria-$FECHA.xml”

Define el servicio /etc/systemd/system/nmap-audit.service:

[Unit]
Description=Auditoria de red con Nmap NSE
After=network-online.target
Wants=network-online.target

[Service] Type=oneshot ExecStart=/usr/local/bin/nmap-audit.sh

Y el temporizador /etc/systemd/system/nmap-audit.timer para ejecutarlo cada día a las 03:30:

[Unit]
Description=Ejecuta la auditoria Nmap NSE cada dia a las 03:30

[Timer] OnCalendar=--* 03:30:00 Persistent=true

[Install] WantedBy=timers.target

sudo chmod +x /usr/local/bin/nmap-audit.sh
sudo systemctl daemon-reload
sudo systemctl enable --now nmap-audit.timer
systemctl list-timers --all | grep nmap-audit
journalctl -u nmap-audit.service --since today

Con Persistent=true, si el servidor estuvo apagado a las 03:30, la auditoría se ejecuta en cuanto vuelve a arrancar: no pierdes el barrido del día.

5. Salida XML y procesado de resultados

La opción -oX genera un XML estructurado, ideal para procesar los hallazgos con un script en lugar de leer la salida a mano. Este ejemplo en Python resume los puertos abiertos y los resultados de vulners y http-enum:

#!/usr/bin/env python3
"""Resume puertos abiertos y hallazgos NSE de un XML de Nmap."""
import sys
import xml.etree.ElementTree as ET

tree = ET.parse(sys.argv[1])

for host in tree.getroot().iter(“host”): addr = host.find(“address[@addrtype=‘ipv4’]”) ip = addr.get(“addr”) if addr is not None else ”?” print(f”== {ip} ==”) for port in host.iter(“port”): if port.find(“state”).get(“state”) != “open”: continue service = port.find(“service”) nombre = service.get(“name”, ”?”) if service is not None else ”?” print(f” {ip}:{port.get(‘portid’)}/tcp abierto ({nombre})”) for script in port.iter(“script”): if script.get(“id”) in (“vulners”, “http-enum”): print(f” -> {script.get(‘id’)}:”) for linea in (script.get(“output”) or "").splitlines()[:6]: print(f” {linea.strip()}”)

python3 resumen-nmap.py /var/log/nmap-audit/auditoria-20261003.xml

Si prefieres un informe HTML rápido sin programar, -oA genera los tres formatos a la vez (normal, XML y grepeable), y xsltproc convierte el XML a HTML con la hoja de estilos que trae el propio Nmap.

6. Troubleshooting y errores comunes

6.1. El script no se carga

  • Sintaxis Lua: cualquier error impide la carga. Tras corregirlo, ejecuta sudo nmap --script-updatedb.
  • Permisos: el fichero .nse debe ser legible por el usuario que lanza Nmap.
  • Ruta: usa rutas absolutas en --script o coloca el script en /usr/share/nmap/scripts/.

6.2. Sin privilegios no hay escaneo SYN

  • -sS requiere root; sin privilegios Nmap recurre a -sT (más lento y ruidoso). Lanza las auditorías programadas como root o con la capability CAP_NET_RAW.

6.3. Timeouts y falsos negativos

  • Aumenta el timeout del socket en el script (socket:set_timeout(10000)) en redes con latencia.
  • vulners necesita salida a internet: sin ella devuelve resultados vacíos. En redes aisladas usa scripts vuln locales o vulscan con bases de datos offline.
  • Ante un IDS/IPS, baja el ritmo con -T2 para no saturar ni ser bloqueado a mitad del barrido.

Nota legal

Audita únicamente redes de tu propiedad o aquellas para las que dispongas de autorización explícita y por escrito. Escanear sistemas ajenos sin permiso puede constituir un delito en muchas jurisdicciones, incluso cuando el escaneo sea «solo» de reconocimiento. Cuando dudes, pide el permiso antes de lanzar Nmap.

Conclusión

El motor NSE convierte a Nmap en una plataforma de auditoría programable: con scripts como vulners, http-enum o la familia smb-* cubres la detección de vulnerabilidades conocidas, y con tus propios scripts en Lua cubres las comprobaciones específicas de tu infraestructura. Automatiza el barrido con un systemd timer, guarda siempre la salida en XML (-oX) y procésala de forma estructurada. Así pasas de auditorías puntuales a una vigilancia continua, sin sobrecarga operativa y con resultados comparables día tras día.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal