Das Verzeichnis, das `nse_main.lua` enthält, ist das, das dieser nmap verwendet.

</details>

## Skriptargumente

| Argument | Standard | Bedeutung |
|---|---|---|
| `vulners.mincvss` | `0` | Blendet Ergebnisse aus, die unter diesem Wert liegen. Nicht bewertete Bulletins und alles mit einem bekannten Exploit werden unabhängig vom Schwellenwert angezeigt |
| `vulners.paths` | die veröffentlichten 939 Pfade | Pfade für den Websuchlauf: eine Lua-Liste, eine Zeichenkette, die eine Datei mit einem Pfad pro Zeile benennt, oder `none`, um den Suchlauf zu deaktivieren. Eine von Ihnen benannte Datei, die nicht gelesen werden kann, stoppt den Suchlauf und meldet dies, anstatt auf die veröffentlichte Liste zurückzufallen |
| `vulners.width` | `80` | Terminalbreite, für die die Tabelle ausgelegt ist |
| `vulners.max_items` | `32` | Obergrenze für abgerechnete Elemente für den gesamten Scan |
| `vulners.api_key` | - | API-Token. Undicht: nmap kopiert seine eigene Befehlszeile in `-oX` |
| `vulners.api_key_file` | - | Absoluter Pfad zu einer Datei, deren erste Zeile das Token ist |
| `vulners.api_host` | `vulners.com` | Hostname der API |
| `vulners.api_port` | `443` | Port auf `api_host` |

Ein bloßer Name funktioniert ebenfalls, also reicht `--script-args mincvss=7`.

Die 1.x-Argumentpräfixe - `vulners_enterprise.*` und
`http-vulners-regex.paths` - werden für eine Version akzeptiert und geben einen
Hinweis auf die Veraltung aus.

## Wo der API-Schlüssel aufbewahrt werden sollte

In der Reihenfolge der Bevorzugung:

1. `~/.nmap/vulners.key`, eine Zeile, Modus 600 - der Installer bietet an, ihn zu schreiben
2. `VULNERS_API_KEY` in der Umgebung
3. `--script-args vulners.api_key_file=/absoluter/pfad`
4. `--script-args vulners.api_key=<token>`

Die letzte Option ist bequem und undicht: nmap kopiert seine eigene Befehlszeile in jeden
Bericht, sodass das Token im `args`-Attribut der `-oX`-Ausgabe und in Ihrem
Shell-Verlauf landet. Das Skript selbst schreibt das Token nie irgendwohin, einschließlich seiner
Debug-Ausgabe - es gibt einen Regressionstest, der dies bestätigt.

Eine Schlüsseldatei, die Sie explizit benennen und die nicht gelesen werden kann, stoppt den Lauf, anstatt
still auf einen Fallback zurückzugreifen - ein Operator, der eine Datei benennt, meint diese Datei - und
der Bericht sagt, um welche Datei es sich handelte. Ein falsch geschriebener Pfad kann nicht wie ein sauberer
Scan aussehen.

## Woher die Fingerabdrücke stammen

Das Skript führt sie nicht mit sich. Es lädt drei Wörterbücher einmal pro Scan herunter,
bevor der erste Host berührt wird:```
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

Antworten werden für den gesamten Scan zwischengespeichert, jeweils pro Identität, sodass hundert
identische Server nur eine Abfrage kosten. Die Anreicherung wird pro Befund-ID zwischengespeichert, sodass zwei
Web-Ports mit überlappender Software jedes Dokument nur einmal abrufen.

## Maschinenlesbare Ausgabe

Alles, was ausgegeben wird, ist auch strukturiert, sodass `-oX` geparst werden kann, ohne den
menschlich lesbaren Text anzufassen. Die Skript-ID, die beiden Tabellenebenen und die fünf ursprünglichen
Element-Schlüssel sind gegenüber 1.x unverändert, was DefectDojo, Faraday,
nmap2csv und raven lesen:```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 Einheiten-Fälle laufen innerhalb von nmap gegen die echten NSE-Bibliotheken; 64 End-to-End-Fälle treiben die echte nmap-Binärdatei gegen einen lokalen Webserver und eine Stellvertreter-Vulners-API, die das durchsetzt, was die echte durchsetzt; das Hygiene-Gate hält Geheimnisse, Scan-Ausgaben und Editor-Unrat aus dem Baum und verweigert ein globales Lesen, das NSE in ein verlorenes Ergebnis verwandeln würde; und die letzten vier halten die Daten und die Werkzeuge, die sie veröffentlichen – die Form des Katalogs, den XML-Vertrag, den jeder Importeur liest, den Muster-Übersetzer und das Gate, das entscheidet, dass ein Rebuild sicher zu veröffentlichen ist. Das letzte hält das gesamte Repository an
[Nmaps eigene Code-Standards](https://secwiki.org/w/Nmap/Code_Standards), die
`HACKING` als die Autorität für ein Skript nennt, das im nmap-Baum leben will:
keine Tabs, kein nachgestelltes Leerzeichen, Zeilen unter 80 Spalten, keine Semikolons,
privates NSEdoc, das mit `--;` beginnt, PEP 8 für das Python.
`python3 tests/e2e/run_e2e.py --live` fügt Prüfungen gegen den echten Dienst hinzu.
Siehe [CONTRIBUTING.md](https://github.com/vulnerscom/nmap-vulners/blob/master/CONTRIBUTING.md).

## FAQ

**Exploitiert es etwas?** Nein. Es liest Banner und Seiten und fragt eine
Datenbank – es sendet kein Payload und versucht keine Anmeldedaten. Es ist als
`discovery, intrusive, vuln, external` statt `safe` kategorisiert, aus einem Grund:
der Pfad-Sweep fordert 939 Pfade eines Web-Ports an, und nmaps Definition von `safe`
schließt Skripte aus, die große Mengen an Bandbreite nutzen. nmaps eigenes `http-enum`
fordert 2 204 an und trägt dasselbe Label. Ihr `-T` bestimmt, wie schnell diese
hinausgehen, und nie, wie viele, und `--script-args vulners.paths=none` schaltet den
Sweep ganz ab.

**Funktioniert es ohne API-Schlüssel?** Ja, vollständig. Ohne einen nutzt es den
kostenlosen Endpunkt, der für ein CPE dieselben Schwachstellen zurückgibt wie der
bezahlte. Ein Schlüssel fügt Details pro Fund hinzu und kann Software benennen, die
der kostenlose Pfad nicht kann.

**Warum hat `-sC` aufgehört, Web-Software zu finden?** Weil `vulners` nicht mehr in
nmaps `default`-Kategorie ist, und ebenso wenig der Fingerprint-Sweep, der früher in
`http-vulners-regex.nse` lebte. Das Senden der Identität der Software eines Ziels an
einen Dritten sollte etwas sein, das Sie angefordert haben: führen Sie `--script vulners` aus.

**Warum zeigt eine Schwachstelle `cvss2.0`, während eine andere `cvss3.1` zeigt?** Das
Label benennt die Skala, auf der der Score liegt. Vulners gibt zurück, was auch immer
die Quelle veröffentlicht hat; ein v2-Score von 9.3 ist kein v3-Score von 9.3.

**Warum wird ein Eintrag mit niedrigem Score angezeigt, wenn ich `mincvss` setze?** Weil
er einen bekannten Exploit hat, oder weil die Quelle ihn nie bewertet hat. Beides ist
beabsichtigt.

**Der Bericht sagt, der Katalog konnte nicht heruntergeladen werden.** Dann lief das
Web-Fingerprinting nicht und alles andere schon: die Software, die nmap selbst benannt
hat, wurde trotzdem nachgeschlagen. Es wird aus diesem Grund laut gesagt – eine
Fähigkeit, die nicht lief, liest sich wie eine Fähigkeit, die nichts fand. Die zwei
Ursachen haben getrennte Formulierungen: „konnte nicht heruntergeladen werden“ ist das
Netzwerk, und „antwortete, aber eines seiner Wörterbücher konnte nicht gelesen werden“
ist der Spiegel, auf den Sie es gerichtet haben.

**Es fand nichts auf einem Host, von dem ich weiß, dass er verwundbar ist.** Führen Sie
mit `-d2` aus: es protokolliert jede Identität, nach der es gefragt hat. Normalerweise
benannte nmap den Dienst, aber nicht seine Version, und es gibt keine Version zum
Nachschlagen.

## Lizenz

Die Skripte sind genauso lizenziert wie Nmap selbst – siehe [LICENSE](https://github.com/vulnerscom/nmap-vulners/blob/master/LICENSE) für die
Nmap Public Source License, und
[nmap.org/npsl](https://nmap.org/npsl/) für das, was sie bedeutet.

Schwachstellendaten stammen von [Vulners](https://vulners.com) und unterliegen
deren Bedingungen.

## Verwandt

* [vulners.com](https://vulners.com) – die Datenbank hinter diesen Skripten
* [vulnersCom/api](https://github.com/vulnersCom/api) – der Python-Client
* [vulnersCom/burp-vulners-scanner](https://github.com/vulnersCom/burp-vulners-scanner) – dieselben Daten in Burp Suite
* [nmap.org/book/nse.html](https://nmap.org/book/nse.html) – wie NSE-Skripte funktionieren

---

<div align="center">

Gepflegt vom Vulners-Team &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>