El directorio que contiene `nse_main.lua` es el que usa este nmap.

</details>

## Argumentos del script

| Argumento | Valor por defecto | Significado |
|---|---|---|
| `vulners.mincvss` | `0` | Oculta hallazgos puntuados por debajo de este valor. Los boletines sin puntuación y cualquier cosa con un exploit conocido se muestran sin importar el umbral |
| `vulners.paths` | las 939 rutas publicadas | Rutas para el barrido web: una lista Lua, una cadena que nombre un archivo con una ruta por línea, o `none` para desactivar el barrido. Un archivo que nombres y no pueda leerse detiene el barrido y lo indica, en lugar de recurrir a la lista publicada |
| `vulners.width` | `80` | Ancho de terminal para el que se diseña la tabla |
| `vulners.max_items` | `32` | Límite máximo de elementos facturados para todo el escaneo |
| `vulners.api_key` | - | Token de API. Con fugas: nmap copia su propia línea de comandos en `-oX` |
| `vulners.api_key_file` | - | Ruta absoluta a un archivo cuya primera línea es el token |
| `vulners.api_host` | `vulners.com` | Nombre de host de la API |
| `vulners.api_port` | `443` | Puerto en `api_host` |

Un nombre simple también funciona, así que `--script-args mincvss=7` es suficiente.

Los prefijos de argumentos 1.x - `vulners_enterprise.*` y
`http-vulners-regex.paths` - se aceptan durante una versión e imprimen un
aviso de obsolescencia.

## Dónde guardar la clave de API

En orden de preferencia:

1. `~/.nmap/vulners.key`, una línea, modo 600 - el instalador ofrece escribirla
2. `VULNERS_API_KEY` en el entorno
3. `--script-args vulners.api_key_file=/absolute/path`
4. `--script-args vulners.api_key=<token>`

La última es conveniente y tiene fugas: nmap copia su propia línea de comandos en cada
informe, así que el token termina en el atributo `args` de la salida `-oX` y en tu
historial de shell. El script en sí nunca escribe el token en ningún lugar, incluida su
salida de depuración - hay una prueba de regresión que lo confirma.

Un archivo de clave que nombres explícitamente y que no pueda leerse detiene la ejecución en lugar
de recurrir silenciosamente a otro - un operador que nombra un archivo quiere decir ese archivo - y
el informe indica qué archivo era. Una ruta mal escrita no puede parecer un escaneo limpio.

## De dónde provienen las huellas dactilares

El script no las lleva consigo. Descarga tres diccionarios una vez por escaneo,
antes de tocar el primer host:```
https://raw.githubusercontent.com/vulnersCom/nmap-vulners/catalog/
    index.json          what exists, at which serial
    fingerprints.json   721 product and version rules
    paths.json          939 paths the sweep requests
    probes.json         targeted version probes

Las respuestas se almacenan en caché para todo el escaneo, con clave por identidad, de modo que cien servidores idénticos cuestan una sola consulta. El enriquecimiento se almacena en caché por id de hallazgo, de modo que dos puertos web que ejecutan software superpuesto obtienen cada documento una sola vez.

## Salida legible por máquina

Todo lo que se imprime también está estructurado, por lo que `-oX` se puede analizar sin tocar el texto legible. El id del script, los dos niveles de tabla y las cinco claves originales de elementos no cambian respecto a 1.x, que es lo que leen DefectDojo, Faraday, nmap2csv y raven:```xml
<script id="vulners">
  <elem key="schema">2.0</elem>
  <elem key="mode">keyed</elem>
  <table key="cpe:/a:apache:http_server:2.4.7">
    <table>
      <elem key="id">CVE-2021-40438</elem>
      <elem key="type">cve</elem>
      <elem key="severity">CRITICAL</elem>
      <elem key="cvss">9.0</elem>
      <elem key="cvss_type">cvss3.1</elem>
      <elem key="is_exploit">false</elem>
      <elem key="exploit_known">true</elem>
      <elem key="kev">true</elem>
      <elem key="epss">0.99612</elem>
      <elem key="exploitation">active</elem>
      <elem key="title">Apache HTTP Server SSRF in mod_proxy</elem>
      <elem key="href">https://vulners.com/cve/CVE-2021-40438</elem>
      <elem key="source_href">https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2021-40438</elem>
    </table>
  </table>
</script>

270 casos de unidades ejecutados dentro de nmap contra las librerías NSE reales; 64 casos de extremo a extremo
ejecutan el binario real de nmap contra un servidor web local y una API Vulners simulada
que aplica lo mismo que aplica la real; la compuerta de higiene mantiene secretos,
salida de escaneo y desorden del editor fuera del árbol y rechaza una lectura global
que NSE convertiría en un resultado perdido; y los últimos cuatro contienen los datos y
las herramientas que los publican: la forma del catálogo, el contrato XML que lee cada
importador, el traductor de patrones y la compuerta que decide que una reconstrucción
es segura de publicar. El último mantiene todo el repositorio conforme a los
[Estándares de Código de Nmap](https://secwiki.org/w/Nmap/Code_Standards), que
`HACKING` nombra como la autoridad para un script que quiera vivir en el árbol de
nmap: sin tabuladores, sin espacios finales, líneas de menos de 80 columnas, sin punto y coma,
documentación NSEdoc privada que abre con `--;`, PEP 8 para el Python.
`python3 tests/e2e/run_e2e.py --live` añade comprobaciones contra el servicio real.
Consulta [CONTRIBUTING.md](https://github.com/vulnerscom/nmap-vulners/blob/master/CONTRIBUTING.md).

## FAQ

**¿Explota algo?** No. Lee banners y páginas y consulta una
base de datos: no envía ningún payload ni prueba ninguna credencial. Está categorizado
`discovery, intrusive, vuln, external` en lugar de `safe`, por una razón: el
barrido de rutas solicita 939 rutas de un puerto web, y la definición de `safe` de nmap
excluye scripts que usan grandes cantidades de ancho de banda. El propio `http-enum` de nmap
solicita 2 204 y lleva la misma etiqueta. Tu `-T` define la velocidad a la que salen
y nunca cuántas, y `--script-args vulners.paths=none` desactiva el barrido por completo.

**¿Funciona sin una clave de API?** Sí, completamente. Sin una, usa el endpoint
gratuito, que devuelve las mismas vulnerabilidades para un CPE que el de pago. Una
clave añade detalle por hallazgo y puede nombrar software que la ruta gratuita no puede.

**¿Por qué `-sC` dejó de encontrar software web?** Porque `vulners` ya no está en la
categoría `default` de nmap, y tampoco lo está el barrido de huellas que solía
vivir en `http-vulners-regex.nse`. Enviar la identidad del software de un objetivo a
un tercero debería ser algo que pidieras: ejecuta `--script vulners`.

**¿Por qué una vulnerabilidad muestra `cvss2.0` mientras otra muestra `cvss3.1`?** La
etiqueta nombra la escala en la que está la puntuación. Vulners devuelve la que haya
publicado la fuente; una puntuación v2 de 9.3 no es una puntuación v3 de 9.3.

**¿Por qué se muestra una entrada con puntuación baja cuando configuro `mincvss`?** Porque
tiene un exploit conocido, o porque la fuente nunca la puntuó. Ambas son deliberadas.

**El informe dice que el catálogo no pudo descargarse.** Entonces el reconocimiento web
no se ejecutó y todo lo demás sí: el software que el propio nmap nombró
aún se consultó. Se dice en voz alta por esa razón: una capacidad que no se
ejecutó se lee como una capacidad que no encontró nada. Las dos causas tienen
redacción separada: "no pudo descargarse" es la red, y "respondió, pero
uno de sus diccionarios no pudo leerse" es el espejo al que lo apuntaste.

**No encontró nada en un host que sé que es vulnerable.** Ejecuta con `-d2`: registra
cada identidad sobre la que preguntó. Normalmente nmap nombró el servicio pero no su
versión, y no hay versión que consultar.

## Licencia

Los scripts tienen la misma licencia que el propio Nmap: consulta [LICENSE](https://github.com/vulnerscom/nmap-vulners/blob/master/LICENSE) para la
Nmap Public Source License, y
[nmap.org/npsl](https://nmap.org/npsl/) para saber qué significa.

Los datos de vulnerabilidades provienen de [Vulners](https://vulners.com) y están sujetos a
sus términos.

## Relacionado

* [vulners.com](https://vulners.com) - la base de datos detrás de estos scripts
* [vulnersCom/api](https://github.com/vulnersCom/api) - el cliente Python
* [vulnersCom/burp-vulners-scanner](https://github.com/vulnersCom/burp-vulners-scanner) - los mismos datos dentro de Burp Suite
* [nmap.org/book/nse.html](https://nmap.org/book/nse.html) - cómo funcionan los scripts NSE

---

<div align="center">

Mantenido por el Equipo Vulners &lt;[email protected]&gt;

`#nmap` `#nse` `#vulnerability-scanner` `#cve` `#cvss` `#cpe` `#vulners`
`#security-tools` `#pentest` `#infosec` `#network-scanner` `#exploit-database`
`#lua` `#vulnerability-detection` `#security-automation`

</div>