Unimap

Escanea solo una vez por dirección IP y reduce los tiempos de escaneo con Nmap para grandes cantidades de datos. Unimap es una abreviatura de "Unique Nmap Scan". La herramienta puede ejecutarse en Linux, OSX, Windows o Android (Termux) sin problemas.

¿Por qué?

Si tienes planes de ejecutar un Nmap a toda una organización, debes considerar que seguramente decenas, cientos o incluso miles de subdominios apuntarán a la misma dirección IP y llegará un punto en el que será casi imposible continuar escaneando. Además, tu IP podría terminar bloqueada debido a múltiples escaneos a la misma dirección de host remoto, entre otras cosas.

¿Cómo?

Unimap utiliza su propia tecnología para resolver inicialmente las direcciones IP de todos los subdominios. Una vez que este proceso finaliza, crea un vector con las direcciones IP únicas y lanza un escaneo paralelo con Nmap según el número de hilos que el usuario haya configurado. Al mismo tiempo, analiza los datos de los archivos creados con Nmap para averiguar qué información corresponde a cada IP. Finalmente, Unimap relaciona la información de cada una de las IPs asociadas con los subdominios. Así, por ejemplo, si tienes 50 subdominios que apuntan a la misma IP, solo harás un escaneo de Nmap pero tendrás todos los datos asociados con cada uno de los subdominios al mismo tiempo; en un escaneo grande, esto ahorra días o semanas.

Instalación

Desde el código fuente

Necesitas tener Rust (1.88 o más reciente) y Nmap instalados en tu computadora, luego ejecuta:

1. git clone https://github.com/Edu4rdSHL/unimap.git && cd unimap
# Alternativamente puedes descargar una versión desde https://github.com/Edu4rdSHL/unimap/releases/latest
# extraerla y continuar con el siguiente paso.
2. cargo build --release
# Ahora el binario está en ./target/release/unimap
# El siguiente comando solo funciona en Linux y MacOS. Los usuarios de Windows necesitan especificar la ruta de destino en la variable de entorno
3. cp ./target/release/unimap /usr/local/bin
# Ahora puedes usar el comando `unimap` desde cualquier lugar.

Soporte para Docker

La imagen edu4rdshl/unimap se publica para linux/amd64 y linux/arm64 en cada versión, bajo latest y la versión de lanzamiento:

docker pull edu4rdshl/unimap:latest
docker run --rm edu4rdshl/unimap:latest -t hackerone.com --fast-scan
# Conserva los archivos CSV y XML de Nmap: monta un directorio en /opt/unimap
docker run --rm -v "$(pwd):/opt/unimap" edu4rdshl/unimap:latest -f targets.txt --fast-scan -u results.csv

Consulta docker/README.md para construir la imagen tú mismo.

Usando binarios precompilados

Descarga la última versión para tu sistema operativo y úsala.

Usando los paquetes AUR. (Arch Linux)

unimap se puede instalar desde los paquetes AUR disponibles usando un ayudante de AUR. Por ejemplo,

$ paru -S unimap

Si lo prefieres, puedes clonar los paquetes AUR y luego compilarlos con makepkg. Por ejemplo,

git clone https://aur.archlinux.org/unimap.git && cd unimap && makepkg -si

Uso

Unimap requiere privilegios de root/administrador para lanzar el Escaneo TCP SYN (Stealth) de Nmap; lo usamos por razones de precisión y rendimiento. Si estás en Linux o basado en Linux, simplemente usa un shell de root o ejecuta la herramienta con sudo; en Windows puedes abrir un Símbolo del sistema (CMD) como Administrador y ejecutar la herramienta como de costumbre.

Ejemplos

1. unimap -f targets.txt -u log.csv realiza un escaneo completo y escribe la salida en log.csv.
2. unimap -f targets.txt --fast-scan -o realiza un escaneo rápido y guarda el archivo de registro en la carpeta logs/.
3. sudo unimap -f targets.txt --ports "1-1000" --min-rate 5000 escanea los puertos del 1 al 1000 realizando detección de servicio y versión (si quieres un escaneo rápido usa la bandera --fast-scan) con un min-rate de 5000.

Consideraciones

• Unimap está preconfigurado para ejecutarse en redes más rápidas (VPS en la nube); si ejecutas un escaneo en una red doméstica que no tiene demasiada capacidad, terminarás desconectado debido a la limitación de la red.
• Lo anterior no significa que no puedas usar Unimap desde tu casa, solo ajusta el número de --threads y --min-rate (siendo este último el más importante).
• No envolvemos Nmap de ninguna manera ni escaneamos puertos por nuestra cuenta; usamos las opciones correctas de Nmap para obtener el máximo rendimiento. Nmap es increíble y es el escáner de puertos más rápido que existe actualmente.
• Analizamos los datos de salida de Nmap y te damos una salida más comprensible, al mismo tiempo que evitamos escanear la misma IP varias veces; ese es nuestro objetivo principal.

Desarrollo

Ejecuta las pruebas unitarias y de integración (no se necesitan red, root ni Nmap):

cargo test

Ejecuta una verificación corta de extremo a extremo que construye la imagen de Docker y lanza escaneos reales contra scanme.nmap.org (necesita Docker y acceso a internet):

scripts/container-test.sh

¿Encontraste un error?

Abre un issue.