Nmap eigenes Script
Grundsätzliches
Der Artikel ist aus dem englischen von Alexis Rodriguez übersetzt.
Nmap wird mit Hunderten von Skripten geliefert. Viele dieser Skripte werden tatsächlich ausgeführt, wenn Sie Nmap mit dem häufig verwendeten Flag -sC ausführen. Diese Skripte führen beispielsweise grundlegende HTTP-Aufzählungen durch, versuchen, eine Verbindung zu SMB-Freigaben herzustellen und diese aufzulisten, greifen auf Dienstbanner zu usw. Das Schreiben Ihrer eigenen NSE-Skripte kann jedoch äußerst nützlich sein. Hier ist zum Beispiel ein NSE-Skript, das Anwendungen in Ihrem Netzwerk entdeckt, die anfällig für den kürzlich offenbarten Exploit gegen die beliebte Log4J-Bibliothek sind, die immer noch in freier Wildbahn ausgenutzt wird. Lassen Sie uns ein wenig über die Struktur eines NSE-Skripts sprechen.
Aufbau eines NSE-Skripts
Die Struktur eines NSE-Skripts ist einfach. Es gibt fünf (5) Funktionen, nach denen die Nmap-Skript-Engine in einem NSE-Skript sucht, um sie auszuführen:
prerule()
wird einmal ausgeführt, bevor Hosts gescannt werden
hostrule(host)
wird ausgeführt, nachdem Hosts gescannt wurden
portrule(host, port)
wird ausgeführt, nachdem Hosts gescannt wurden ==postrule()==wird ausgeführt, nachdem alle Hosts gescannt wurden; Wird normalerweise zum Berichten/Parsen von Daten verwendet, die während des Scannens angesammelt wurden
action(host, port)
wird ausgeführt, wenn eine der Triggerfunktionen (oben aufgeführt) ausgelöst wird; entspricht der Hauptfunktion eines normalen Programms, das die gesamte Logik des Skripts enthält.
Ein NSE-Skript muss eine der oben definierten ausgelösten Funktionen enthalten, die bestimmt, ob die im Hauptteil der Aktionsfunktion angegebenen Anweisungen ausgeführt werden. Hier ist eine Vorlage, die alle Mindestanforderungen zum Schreiben eines NSE-Skripts enthält:
NSE-Skriptvorlage
Wie Sie sehen können, habe ich einige globale Variablen und einige Funktionen definiert und auch einige Kommentare eingefügt, die Sie normalerweise auch in einem NSE-Skript finden. Gehen wir einige der Komponenten durch, aus denen dieses Skript besteht.
Kommentare
Es gibt einige Standardkommentare, die in einem NSE-Skript zu finden sind. Diese Kommentare werden normalerweise oben im Skript definiert und enthalten drei Anweisungen:
@usage
was eine beispielhafte Verwendung des Skripts mit dem Nmap-CLI-Tool demonstriert
@output
was dem Benutzer eine schnelle Beispielausgabe des Skripts liefert
@args
informiert den Benutzer über die Argumente, die an das Skript übergeben werden können, um das Standardverhalten des Skripts zu ändern
Globale NSE-Variablen
So wie es Standardkommentare für NSE-Skripte gibt, gibt es auch eine Reihe globaler Variablen, die für jedes von Ihnen geschriebene NSE-Skript definiert werden sollten.
Die description Variable ist ein String (in Lua werden mehrzeilige Strings in [[]] eckigen Klammern definiert), der dem Benutzer eine detaillierte Beschreibung dessen liefert, was das Skript macht; Die author ariable ist eine Zeichenfolge oder ein Array, das den Autor des Skripts angibt. die licence Variable stellt die Lizenz bereit, mit der das Skript vertrieben wird; und die categorie Variable ist ein Array, das die Nmap-Kategorien definiert, zu denen das Skript gehört.
Beschreibungen
description = [[
This is the description for this NSE script.
]]
author = "John Wick"
license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
categories = {"safe", "discovery"}
Trigger- und Aktionsfunktionen
Wie bereits erwähnt, sucht die Nmap Scripting Engine nach fünf Funktionen im Hauptteil eines NSE-Skripts. In der oben bereitgestellten Vorlage habe ich die Funktionen hostrule, portrule und action verwendet, um das Verhalten des NSE-Skripts zu definieren. Alle Triggerfunktionen, prerule, hostrule, portrule oder postrule , geben einen booleschen Wert zurück – wenn einer der von diesen Funktionen zurückgegebenen Werte falsch ist, wird der in der acion Funktion definierte Code abhängig von der Phase des Scans nicht ausgeführt.
Hello World
Ein einfaches Hello World Skript
description = [[
Simple Hello World Script.
]]
---
-- @output
-- Hello World
author = "Thomas Will"
license = "Same as Nmap--See https://nmap.org/book/man-legal.html"
categories = {"nothing"}
function hostrule()
return true
end
function portrule()
return true
end
function action(host, port)
return("Hello World")
end
Ausgabe
- nmap -sn --script helloworld.nse 192.168.34.1
Starting Nmap 7.93 ( https://nmap.org ) at 2023-02-26 12:20 CET Nmap scan report for 192.168.34.1 Host is up (0.00036s latency).
Host script results: |_helloworld: Hello World
Nmap done: 1 IP address (1 host up) scanned in 0.26 secon
Ein Beispiel-NSE-Skript
Das folgende NSE-Skript ist ein einfaches Skript, das prüft, ob die Ziel-IP-Adresse privat ist, prüft, ob die Ports 80/tcp oder 443/tcp geöffnet sind oder ob ein Port einen Dienst ausführt, der über HTTP oder HTTPS läuft – sofern die Bedingungen erfüllt sind true , druckt der Code in der Aktionsfunktion den vom Server zurückgegebenen HTTP-Server-Header. **HINWEIS**: Ich habe keine Kommentare eingefügt, da dieses Skript zu Demonstrationszwecken dient, Ihre Nicht-Demo-Skripte sollten jedoch Kommentare enthalten!
---
-- @usage
--
-- @output
--
-- @args
--
---
local shortPort = require "shortport"
local ipOps = require "ipOps"
local http = require "http"
local stdNse = require "stdnse"
local b64 = require "base64"
description = [[
An example NSE script that simply makes an HTTP request to
any HTTP(S) ports it finds while echoing the request status line
to stdout
]]
author = {"Alexis Rodriguez"}
license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
categories = {
"safe"
}
function hostrule(host)
-- checks if IP address is local, if not,
-- script won't run
return ipOps.isPrivate(host)
end
function portrule()
-- returns a function that matches on ports, services, protocol, and state
return shortPort.port_or_service({80, 443}, {"http", "https"}, "tcp", "open")
end
function action(host, port)
-- debug logs
stdNse.debug(1, "IP::%s", host.ip)
stdNse.debug(1, "PORT::%s", port.number)
opts = {}
local resp = http.get(host, port, "/", opts)
return stdNse.format_output(
true, string.format("Server Header ==> %s", resp.header["server"])
)
end
http-server-header.nse
Das Skript laufen lassen
Sehen Sie sich den Quellcode auf meinem GitHub an. Speichern Sie das Skript als http-server-header.nse und führen Sie das Skript mit dem folgenden Befehl aus:
- nmap -Pn --script ./http-server-header.nse -d -p 80 scanme.nmap.org
nmap -Pn --script ./http-server-header.nse -d -p 80 scanme.nmap.org Starting Nmap 7.93 ( https://nmap.org ) at 2023-02-26 10:59 CET --------------- Timing report --------------- hostgroups: min 1, max 100000 rtt-timeouts: init 1000, min 100, max 10000 max-scan-delay: TCP 1000, UDP 1000, SCTP 1000 parallelism: min 0, max 0 max-retries: 10, host-timeout: 0 min-rate: 0, max-rate: 0 --------------------------------------------- NSE: Using Lua 5.3. NSE: Arguments from CLI: NSE: Loaded 1 scripts for scanning. NSE: Script Pre-scanning. NSE: Starting runlevel 1 (of 1) scan. Initiating NSE at 10:59 Completed NSE at 10:59, 0.00s elapsed mass_rdns: Using DNS server 127.0.0.53 Initiating Parallel DNS resolution of 1 host. at 10:59 mass_rdns: 0.15s 0/1 [#: 1, OK: 0, NX: 0, DR: 0, SF: 0, TR: 1] Completed Parallel DNS resolution of 1 host. at 11:00, 0.15s elapsed DNS resolution of 1 IPs took 0.15s. Mode: Async [#: 1, OK: 1, NX: 0, DR: 0, SF: 0, TR: 1, CN: 0] Initiating Connect Scan at 11:00 Scanning scanme.nmap.org (45.33.32.156) [1 port] Discovered open port 80/tcp on 45.33.32.156 Completed Connect Scan at 11:00, 0.18s elapsed (1 total ports) Overall sending rates: 5.56 packets / s. NSE: Script scanning 45.33.32.156. NSE: Starting runlevel 1 (of 1) scan. Initiating NSE at 11:00 NSE: Starting http-server-header against scanme.nmap.org (45.33.32.156:80). NSE: Finished http-server-header against scanme.nmap.org (45.33.32.156:80). Completed NSE at 11:00, 0.72s elapsed Nmap scan report for scanme.nmap.org (45.33.32.156) Host is up, received user-set (0.18s latency). Other addresses for scanme.nmap.org (not scanned): 2600:3c01::f03c:91ff:fe18:bb2f Scanned at 2023-02-26 11:00:00 CET for 0s PORT STATE SERVICE REASON 80/tcp open http syn-ack |_http-server-header: Apache/2.4.7 (Ubuntu) Final times for host: srtt: 179510 rttvar: 179510 to: 897550 NSE: Script Post-scanning. NSE: Starting runlevel 1 (of 1) scan. Initiating NSE at 11:00 Completed NSE at 11:00, 0.00s elapsed Read from /usr/bin/../share/nmap: nmap-services. Nmap done: 1 IP address (1 host up) scanned in 1.40 seconds
Aus dieser Ausgabe können wir sehen, dass Nmap das Skript erfolgreich geladen und ausgeführt hat und den Server-Header des HTTP-Servers wie erwartet anzeigt.
EOF
Wenn Sie diesen Artikel gerne gelesen haben, folgen Sie mir bitte auf Medium für weitere Artikel zu Cybersicherheit/Technologie und auf GitHub für weitere Programmierprojekte zur Cybersicherheit. Vielen Dank für Ihre Zeit!