Python-Skripte Weitere Informationen finden Sie im Kapitel zu Python-Scripting in diesem Handbuch. 1.1 Vorteile eines Script Debugger

Transkript

1 Scripting-Handbuch

2 Die Informationen in diesem Dokument dienen ausschließlich Informationszwecken und werden in der vorliegenden Form ohne (ausdrückliche oder stillschweigende) Haftung jeglicher Art bereitgestellt, insbesondere ohne Gewährleistung der Marktgängigkeit, der Eignung für einen bestimmten Zweck oder der Nichtverletzung von Rechten. GFI Software haftet nicht für etwaige Schäden, einschließlich Folgeschäden, die sich aus der Nutzung dieses Dokuments ergeben. Die Informationen stammen aus öffentlich zugänglichen Quellen. Trotz sorgfältiger Prüfung der Inhalte übernimmt GFI keine Haftung für die Vollständigkeit, Richtigkeit, Aktualität und Eignung der Daten. Des Weiteren ist GFI nicht für Druckfehler, veraltete Informationen und Fehler verantwortlich. GFI übernimmt keine Haftung (ausdrücklich oder stillschweigend) für die Richtigkeit oder Vollständigkeit der in diesem Dokument enthaltenen Informationen. Nehmen Sie mit uns Kontakt auf, wenn Ihnen in diesem Dokument Sachfehler auffallen. Wir werden Ihre Hinweise sobald wie möglich berücksichtigen. Alle hier aufgeführten Produkte und Firmennamen sind Marken der jeweiligen Eigentümer. GFI LanGuard unterliegt dem urheberrechtlichen Schutz von GFI SOFTWARE LTD GFI Software Ltd. Alle Rechte vorbehalten. Dokumentenversion: 11.3 Zuletzt aktualisiert (Monat/Tag/Jahr): 09/05/2014

3

4 1 Einführung GFI LanGuard ermöglicht Benutzern das Erstellen von eigenen Skripten, mit denen nach Schwachstellen gesucht werden kann. Skripte können plattformabhängig oder plattformunabhängig sein: Plattformabhängig (die Skripte werden auf dem gescannten Computer ausgeführt): UNIX Shell-Skripte werden per SSH ausgeführt Remote-Computer müssen auf UNIX basieren und Remote-Verbindungen über SSH zulassen Plattformunabhängig (die Skripte werden auf dem Computer ausgeführt, auf dem GFI LanGuard installiert ist): Visual Basic-Skripte In diesem Handbuch wird ausführlich erklärt, wie Sie benutzerdefinierte Skripte für Schwachstellenprüfungen in Visual Basic schreiben, debuggen und einrichten können. Python-Skripte Weitere Informationen finden Sie im Kapitel zu Python-Scripting in diesem Handbuch. Themen in diesem Kapitel: 1.1 Vorteile eines Script Debugger Funktionen des GFI LanGuard Script Debugger Vorteile eines Script Debugger Der Vorteil eines Editors besteht darin, dass Sie damit sicherer und schneller funktionierende Skripte erstellen und korrigieren können. Bei Verwendung eines Editors können Sie sicherstellen, dass das Skript funktioniert, bevor Sie es in einer Produktionsumgebung ausführen. GFI LanGuard Mit Script Debugger können Sie das Skript genau wie in einer Produktionsumgebung ausführen. Der GFI LanGuard Script Debugger verfügt über alle gebräuchlichen Funktionen einer integrierten Entwicklungsumgebung. Dazu gehören: Haltepunkte Einzelschritte Prozedurschritte Angabe spezifischer Parameter für richtiges Testen. Wichtig Es wird nicht empfohlen, das Skript ohne vorheriges Debugging in GFI LanGuard auszuführen. Wenn das Skript nicht funktionieren sollte, sind Sie nicht in der Lage herauszufinden, warum. Außerdem können durch fehlerhafte Programmierung Endlosschleifen entstehen, die den GFI LanGuard-Scanner zum Stillstand bringen. 1.2 Funktionen des GFI LanGuard Script Debugger Die nachfolgende Tabelle zeigt die wichtigsten Funktionen des GFI LanGuard Script Debugger: GFI LanGuard 1 Einführung 4

5 Funktion Unterstützung für die Überwachung von Variablen Einzelschritt-/Prozedurschrittfunktion darstellung Ausführliche Fehlermeldungen Haltepunkte Ausführung/Debugging mit alternativen Anmeldeinformationen Beschreibung Echtzeitüberwachung der Werte der verwendeten Variablen Ermöglicht das zeilenweise Debugging Ihrer Skripte. Dabei können Sie mitverfolgen, was bei der Ausführung geschieht. Vereinfacht die Programmierung von Skripten sowie die Fehlersuche. Angabe des Fehlerstyps und der Stelle, an der der Fehler auftritt. Hilft beim Aufspüren von Fehlern, die durch Variablentypen verursacht werden. Der Debugger unterstützt Haltepunkte, mit deren Hilfe Sie an interessanten Stellen zur zeilenweisen Ausführung übergehen können. Dadurch können Sie das Skript während der Entwicklung und des Debugging mit unterschiedlichen Anmeldeinformationen testen und ausführen. GFI LanGuard 1 Einführung 5

6 2 Visual Basic Script (VBScript) Dieses Kapitel enthält Informationen zu VBScript und zum Erstellen von Skripten mithilfe des GFI LanGuard Script Debugger. Eine vollständige Sprachreferenz der von GFI LanGuard verwendeten Programmiersprache Visual Basic finden Sie hier: Themen in diesem Kapitel: 2.1 Wichtige Hinweise zu VBScript Von GFI LanGuard unterstützte VBScript-Funktionen Häufige Fehler und Fallstricke Tipps und Tricks Entwickeln von Skripten mit GFI LanGuard Script Debugger Hinzufügen einer neuen skriptbasierten Schwachstellenüberprüfung zum Scanner Wichtige Hinweise zu VBScript Jedes erstellte Skript muss eine Funktion mit der Bezeichnung Main enthalten. GFI LanGuard sucht nach dieser Funktion und beginnt an dieser Stelle mit der Ausführung, wenn das Skript ausgeführt wird. Die Funktion Main gibt einen booleschen Wert (true oder false) an das Scripting-Modul zurück. Die Zuweisung des s erfolgt durch Zuweisen des Ergebniswerts an eine Variable, die den gleichen Namen wie die Funktion trägt (: Wenn die Funktion die Bezeichnung MyFunction trägt, wird der mit MyFunction = true zugewiesen). Der wird grundsätzlich am Ende der Funktion zugewiesen. 'Text im Scanner-Aktivitätsfenster anzeigen echo Skript wurde erfolgreich gestartet" 'Ergebnis zurückgeben Main = true 2.2 Von GFI LanGuard unterstützte VBScript-Funktionen GFI LanGuard unterstützt sämtliche VBScript-Funktionen und Scripting-Methoden. Weitere Informationen finden Sie in den folgenden Ressourcen zu VBScript: GFI LanGuard 2 Visual Basic Script (VBScript) 6

7 2.3 Häufige Fehler und Fallstricke VBScript kennt zwei Arten von Variablen: Variablentyp Einfach Objekte Beschreibung Variablen sind echte Typen wie Integer, Boolean, String. Dies sind zusammengesetzte Elemente, deren Funktionen über die Schnittstelle von Automatisierungsobjekten bereitgestellt werden. Automatisierungsobjekttypen müssen als Objekte deklariert werden, bevor diesen Werte zugewiesen werden. Wichtig Es wird dringend empfohlen, allen deklarierten Variablen und/oder Objekten einen Wert zuzuweisen. 'zu verwendendes Objekt deklarieren Dim namestr As String 'der Variable einen Wert zuweisen namestr = "Dies ist eine Testzuweisung von Text" 'Ergebnis im Scanner-Aktivitätsfenster der Zuweisung anzeigen echo namestr 'Ergebnis zurückgeben Main = true Das folgende Skript enthält ein etwas komplexeres, bei dem die auf dem Zielcomputer installierten Dienste aufgelistet werden (localhost = ). Kopieren Sie den folgenden Text, fügen Sie ihn im Script Debugger ein, und führen Sie ihn aus (F5). Im Debug-Fenster wird eine Liste der auf dem lokalen Computer installierten Dienste angezeigt. Function main 'Erforderliche Objekte deklarieren Dim wmi As Object Dim objswbemobject As Object 'Benötigte andere Variablen deklarieren Dim strcomputer As String Dim cr As String strcomputer = " " 'Wagenrücklauf cr = Chr(13) + Chr(10) GFI LanGuard 2 Visual Basic Script (VBScript) 7

8 'Hook für das wmi-objekt Set wmi = GetObject("winmgmts:\\" & strcomputer & "\root\cimv2") 'Überprüfen, ob Hook erfolgreich erstellt wurde If wmi is Nothing Then echo ("Fehler 1") 'Service-Instanz von wmi zurückliefern Set wmiinst=wmi.instancesof("win32_service") 'Überprüfen, ob Instanz verfügbar ist If wmiinst is Nothing Then echo ("Fehler 2") 'Alle Instanzen durchlaufen For Each objswbemobject In wmiinst echo("service-name= ") 'Services anzeigen echo(objswbemobject.displayname+cr) Next Hinweis Wenn Sie versuchen, ein Automatisierungsobjekt zu verwenden, ohne es zuvor zu deklarieren, schlägt die Kompilierung des Skripts fehl. Stellen Sie sich als den gleichen Code vor, jedoch ohne vollständige Deklaration der Objektvariable wmi. Wenn Sie versuchen, das Skript auszuführen, werden sofort eine Fehlermeldung und ein Hinweis auf die genaue Zeile angezeigt, in der der Fehler auftrat: Function main Dim wmi 'WARNING : missing as object Dim objswbemobject As Object 2.4 Tipps und Tricks Wenn Sie Fortschrittsinformationen im Scanner-Aktivitätsfenster anzeigen möchten (unteres Fenster des Scanners oder linkes Fenster des Script Debugger), können Sie den Befehl echo verwenden. 'Text im Scanner-Aktivitätsfenster anzeigen echo Skript wurde erfolgreich gestartet" 'Ergebnis zurückgeben Main = true GFI LanGuard 2 Visual Basic Script (VBScript) 8

9 2.5 Entwickeln von Skripten mit GFI LanGuard Script Debugger Dieser Abschnitt enthält Informationen zum Erstellen von VB-Skripten mithilfe des GFI LanGuard Script Debugger. Weitere Informationen finden Sie unter: Erstellen von VB-Skripten Ausführen von Skripten Debugging-Haltepunkte Einzelschrittfunktion Überwachen der in Variablen gespeicherten Werte Debugging unter alternativen Benutzersitzungen Übergeben von Parametern an ein Skript Erstellen von Skripten In diesem Abschnitt wird ein Skript erstellt. Das Skript überprüft, ob der Nachrichtendienst auf dem lokalen Computer ausgeführt wird oder nicht. Die Entwicklung des Skripts erfolgt mithilfe des Script Debugger, wobei gleichzeitig einige seiner Funktionen vorgestellt werden. Function main 'Erforderliche Objekte deklarieren Dim wmi As Object Dim objswbemobject As Object 'Benötigte andere Variablen deklarieren Dim strcomputer As String Dim cr As String strcomputer = " " 'Wagenrücklauf cr = Chr(13) + Chr(10) 'Hook für das wmi-objekt Set wmi = GetObject("winmgmts:\\" & strcomputer & "\root\cimv2") 'Überprüfen, ob Hook erfolgreich erstellt wurde If wmi is Nothing Then echo ("Fehler 1") 'Service-Instanz von wmi zurückliefern Set wmiinst=wmi.instancesof("win32_service") 'Überprüfen, ob Instanz verfügbar ist If wmiinst is Nothing Then echo ("Fehler 2") 'Alle Instanzen durchlaufen For Each objswbemobject In wmiinst If objswbemobject.displayname = "Messenger" Then echo("service-name= ") GFI LanGuard 2 Visual Basic Script (VBScript) 9

10 'Services anzeigen echo(objswbemobject.displayname+cr) echo("service-status= ") 'Status anzeigen Next echo(objswbemobject.state+cr) If objswbemobject.state = "Running" Then main = true If objswbemobject.state = "Running" Then main = true Ausführen von Skripten Drücken Sie zum Ausführen des Skripts F5, oder klicken Sie auf Fehlersuche > Los Debugging-Haltepunkte Einzelschrittfunktion Mithilfe des Script Debugger können Sie die Ausführung an einer bestimmten Stelle des Skripts stoppen. So können Sie zum einen Haltepunkt setzen, der ausgeführt wird, wenn die Variable mit dem Anzeigenamen des Dienstes den Wert Nachrichtendienst enthält. Im skript würden Sie zu Zeile 17 navigieren, ( echo("service Name= ") ) und den Haltepunkt (F9 drücken) direkt unter der IF-Anweisung setzen. Drücken Sie während der Ausführung F10 (Einzelschritt), um den restlichen Code Zeile für Zeile auszuführen Überwachen der in Variablen gespeicherten Werte Um die in Variablen enthaltenen Werte zu überwachen, müssen Sie eine Überwachung für die jeweilige Variable hinzufügen. So überwachen Sie den Inhalt einer Variable: 1. Erweitern Sie den Bereich Status unten. 2. Klicken Sie mit der rechten Maustaste auf die erste leere Zeile unter Variable. 3. Klicken Sie auf Überwachung hinzufügen, und geben Sie den Namen der zu überwachenden Variable ein. Wiederholen Sie diesen Schritt, um Überwachungen für weitere Variablen hinzuzufügen. 4. Wenn Sie eine Überwachung löschen möchten, klicken Sie mit der rechten Maustaste auf die Überwachung, und wählen Sie Überwachung löschen Debugging unter alternativen Benutzersitzungen So testen Sie das Skript mit alternativen Anmeldeinformationen: 1. Starten Sie den GFI LanGuard Script Debugger 2. Wählen Sie aus der Dropdown-Liste Mit den Eintrag Alternative Anmeldeinformationen aus. 3. Geben Sie in den Textfeldern einen Benutzernamen und ein Kennwort ein Übergeben von Parametern an ein Skript Der GFI LanGuard-Scanner übergibt bei der Ausführung von Skripten Parameter an die Skripte. e sind der Name und die IP-Adresse des Zielcomputers, der auf Schwachstellen geprüft werden soll. Beim Debuggen von Skripten möchten Sie Ihre Skripte unter Umständen mit verschiedenen Werttypen für diese Parameter testen. Unter Optionen > Parameter können Sie für diese Parameter alternative Werte festlegen. GFI LanGuard 2 Visual Basic Script (VBScript) 10

11 Um in einem Skript auf diese Parameter zuzugreifen, müssen Sie eine Spezialfunktion von GFI LanGuard mit der Bezeichnung GetParameter aufrufen und dieser Funktion den Namen des gewünschten Parameters übergeben. : Function main 'Erforderliche Objekte deklarieren Dim wmi As Object Dim objswbemobject As Object 'Benötigte andere Variablen deklarieren Dim strcomputer As String Dim cr As String strcomputer = " " 'Wagenrücklauf cr = Chr(13) + Chr(10) 'Hook für das wmi-objekt Set wmi = GetObject("winmgmts:\\" & strcomputer & "\root\cimv2") 'Überprüfen, ob Hook erfolgreich erstellt wurde If wmi is Nothing Then echo ("Fehler 1") 'Service-Instanz von wmi zurückliefern Set wmiinst=wmi.instancesof("win32_service") 'Überprüfen, ob Instanz verfügbar ist If wmiinst is Nothing Then echo ("Fehler 2") 'Alle Instanzen durchlaufen For Each objswbemobject In wmiinst echo("service-name= ") 'Services anzeigen echo(objswbemobject.displayname+cr) Next 2.6 Hinzufügen einer neuen skriptbasierten Schwachstellenüberprüfung zum Scanner Im folgenden wird erläutert, wie eine neue Schwachstellenüberprüfung erstellt und ein Skript ausgeführt wird, um einen Test auf die neue Schwachstelle hin durchzuführen. Das Skript zeigt im Scanner-Aktivitätsfenster die Meldung Skript erfolgreich ausgeführt an und informiert GFI LanGuard darüber, dass eine Schwachstelle erkannt wurde und der Administrator benachrichtigt werden sollte. Dazu sind folgende Schritte erforderlich: Schritt 1 Skript erstellen, das auf die Schwachstelle überprüft (siehe vorherigen Abschnitt) Schritt 2 Neue Schwachstelle zur Ausführung des Skripts erstellen GFI LanGuard 2 Visual Basic Script (VBScript) 11

12 2.6.1 Schritt 1: Skript erstellen, das auf die Schwachstelle überprüft 1. Öffnen Sie den GFI LanGuard Script Debugger unter Start > Programme > GFI LanGuard 2012 > GFI LanGuard Script Debugger. 2. Klicken Sie auf Datei > Neu. 3. Fügen Sie im Debugger folgenden Text ein: echo Skript wurde erfolgreich gestartet" Main = true 4. Speichern Sie die Datei in einem Verzeichnis Ihrer Wahl, zum unter c:\meinskript.vbs Schritt 2: Neue Schwachstelle zur Ausführung des Skripts erstellen 1. Starten Sie die GFI LanGuardStart > Programme > GFI LanGuard 2014> GFI LanGuard Klicken Sie auf die Hauptoptionsschaltfläche, und wählen Sie Konfiguration > Scan-Profil-Editor. Sie können auch die Tasten STRG + P drücken, um den Scan-Profil-Editor zu starten. 3. Klicken Sie unter Allgemeine Aufgaben auf Neues Scan-Profil, oder wählen Sie ein vorhandenes Scan-Profil aus, das Sie bearbeiten möchten. 4. Geben Sie einen Profilnamen und optional eine Beschreibung des Profils ein. 5. (Optional) Klicken Sie auf Alle Einstellungen von einem vorhandenen Profil kopieren, und wählen Sie im Dropdown-Menü Profil ein vorhandenes Scan-Profil aus, das Sie duplizieren möchten. 6. Klicken Sie auf OK. Hinweis Das neue Scan-Profil wird im Bereich Profile auf der linken Seite hinzugefügt. 7. Wählen Sie das neue Scan-Profil aus, und klicken Sie im rechten Bereich auf Hinzufügen. Dadurch wird der Dialog Schwachstelle hinzufügen geöffnet. 8. Geben Sie auf der Registerkarte Allgemein allgemeine Angaben wie Name und Typ der neuen Schwachstelle ein. 9. Klicken Sie auf die Registerkarte Bedingungen > Hinzufügen. 10. Wählen Sie den Prüfungstyp Unabhängige Prüfungen > VB Script-Test. Klicken Sie auf Weiter. 11. Geben Sie den Speicherort für das Skript an (: <ProductDataDir>\Scripts\neueschwachstelle.vbs). Klicken Sie auf Weiter. 12. Wählen Sie das Attribut, für das Sie eine Bedingung festlegen möchten, den gewünschten Operator und den Wert der Skriptausführung. Hinweis Für jedes Skript werden im Abschnitt Beschreibung die unterstützten Werte angezeigt. 13. Klicken Sie auf Fertig stellen. GFI LanGuard 2 Visual Basic Script (VBScript) 12

13 Die Schwachstellenüberprüfung wird hinzugefügt und in die Liste der Schwachstellen aufgenommen, die beim nächsten Scan eines Computers überprüft werden. Scannen Sie zum Testen einfach Ihren lokalen Computer ( ). Im Scanergebnis wird unter dem Knoten Schwachstellen im Bereich Diverses ein Warnhinweis zu einer Schwachstelle angezeigt. GFI LanGuard 2 Visual Basic Script (VBScript) 13

14 3 Python-Skripte In diesem Kapitel erhalten Sie die erforderlichen Informationen zur Erstellung und Ausführung von Python-Skripten. Ab Version 9.0 unterstützt GFI LanGuard Python-basierte Schwachstellenprüfungen. Diese Prüfungen finden Sie unter Unabhängige Prüfungen. Themen in diesem Kapitel: 3.1 Was ist die Skriptsprache Python? Erstellen einer neuen Schwachstellenprüfung mit Python-Skript-Tests In Python-Skripten verfügbare Application Programming Interfaces (APIs) Debugging von Python-Skripten Python-Bibliotheken und Wiederverwendung von Code Was ist die Skriptsprache Python? Python ist eine interpretierte Programmiersprache, die 1990 von Guido van Rossum entwickelt wurde. In Python erfolgt die Typisierung dynamisch und die Speicherverwaltung automatisch. Beachten Sie: In Python wird der Verlauf von Codeblöcken nicht durch Satzzeichen oder Schlüsselwörter, sondern durch die Einrückung gekennzeichnet. für eine Fakultätsfunktion in Python: def factorial(x): if x == 0: else: return 1 return x * factorial(x-1) 3.2 Erstellen einer neuen Schwachstellenprüfung mit Python-Skript-Tests Zum Erstellen eines neuen Python-Skript-Tests müssen Sie: Schritt 1: Erstellen des Skripts Schritt 2: Die neue Schwachstellenprüfung erstellen Schritt 1: Erstellen des Skripts 1. Starten Sie GFI LanGuard Script Debugger über Start > Programme > GFI LanGuard2014 > GFI LanGuard Script Debugger. 2. Klicken Sie auf Datei > Neu. 3. Kopieren Sie das folgende Skript, und fügen Sie es in den Script Debugger ein: #PythonSuccessfullCheck.py """ Einzelheiten dazu finden Sie in der Datei <ProductDataDir>\Scripts\lpy.py """ def main(): """Return values: GFI LanGuard 3 Python-Skripte 14

15 * 0 - false, failed * 1 - true, success""" result = 0 #Hier steht Ihr Code result = 1 return(result) 4. Speichern Sie das Skript am gewünschten Speicherort Schritt 2: Erstellen Sie die neue Schwachstellenprüfung. 1. Starten Sie die GFI LanGuardStart > Programme > GFI LanGuard 2014> GFI LanGuard Klicken Sie auf die Hauptoptionsschaltfläche, und wählen Sie Konfiguration > Scan-Profil-Editor. Sie können auch die Tasten STRG + P drücken, um den Scan-Profil-Editor zu starten. 3. Klicken Sie unter Allgemeine Aufgaben auf Neues Scan-Profil, oder wählen Sie ein vorhandenes Scan-Profil aus, das Sie bearbeiten möchten. 4. Klicken Sie im Scan-Profil-Editor auf Optionen zur Schwachstellenbewertung > Schwachstellen. 5. Erweitern Sie in der Schwachstellentypenliste Schwachstellen, und wählen Sie Diverse. Klicken Sie auf Hinzufügen. Dadurch wird der Dialog Schwachstelle hinzufügen geöffnet. 6. Geben Sie auf der Registerkarte Allgemein allgemeine Informationen wie Name, Typ und Beschreibung der neuen Schwachstelle ein. 7. Klicken Sie auf die Registerkarte Bedingungen > Hinzufügen. 8. Wählen Sie Unabhängige Prüfungen > Unabhängiger Python-Skript-Test. Klicken Sie auf Weiter. 9. Geben Sie den Speicherort für das Skript an (: <ProductDataDir>\Scripts\neueschwachstelle.vbs). (Laden Sie das erstellte Skript aus Schritt 1: Skript erstellen, das auf die Schwachstelle überprüft). 10. Wählen Sie im Dropdown-Menü die Anzahl der Objekte, die die Bedingung erfüllen müssen, damit die Prüfung TRUE ergibt. Klicken Sie auf Weiter. 11. Geben Sie im Eingabefeld Wert den Wert ein, den das Python-Skript zurückgeben soll, wenn die Schwachstelle erkannt wird. Hinweis Für jedes Skript werden im Abschnitt Beschreibung die unterstützten Werte angezeigt. 12. Klicken Sie auf Fertig stellen. 3.3 In Python-Skripten verfügbare Application Programming Interfaces (APIs) GFI LanGuard integriert einen Großteil der standardmäßigen Python-Implementation (auch als CPython bekannt, erhältlich unter Derzeit verwenden wir Python in der Version 2.5. Daher funktionieren die meisten vorhandenen Python-Skripte mit geringfügigen Anpassungen auch in GFI LanGuard. Die wichtigste Anpassung besteht darin, dass Skripte eine Funktion main()enthalten müssen, die entweder 1 oder 0 zurückliefert. GFI LanGuard 3 Python-Skripte 15

16 Alle Python-Skripte, die von Sicherheitsscannermodulen verwendet werden (Schwachstellenprüfungen und Informationen über Sicherheitsanwendungen), haben Zugriff auf die folgenden globalen Variablen: ComputerIP ComputerName LNSSDir localprogramfilespath localwindowspath localsystem32path User Kennwort ComputerIP = ' ' ComputerName = 'WXPSandbox" LNSSDir = 'C:\\Programme\\GFI\\LanGuard 2011\\' localprogramfilespath = 'C:\\Programme' localwindowspath = 'C:\\WINDOWS' localsystem32path = 'C:\\WINDOWS\\system32' User = '' Password = '' Über diese globalen Variablen können Sie auf den Namen oder die IP-Adresse des gescannten Computers sowie auf die Anmeldeinformationen zugreifen, die Sie für die Verbindung mit dem gescannten Computer benötigen. Die globalen GFI LanGuard-Funktionen stehen in Python-Skripten als Methoden des GlobalFunctions- Objekts zur Verfügung. D. H.: # Verwendung globaler Funktionen. def main(): """Return values: * 0 - false, failed * 1 - true, success""" result = 0 # Text anzeigen GlobalFunctions.echo("Hallo!") # Übergebenen Text in Protokolldatei schreiben GlobalFunctions.writetolog("Python-Skript gestartet.") # Übergebenen Text in der Statusleiste anzeigen GlobalFunctions.statusbar("Hallo StatusBar!") GFI LanGuard 3 Python-Skripte 16

17 # Fügt für den zweiten Parameter einen untergeordneten Knoten in die aktuelle Schwachstelle ein GlobalFunctions.addlistitem("", "Beschreibung der Schwachstelle.") # Beschreibung der aktuellen Schwachstelle ändern GlobalFunctions.setdescription("Liste der installierten Modems") GlobalFunctions.writetolog("Python-Skript beendet.") result = 1 return(result) GFI LanGuard bietet auch eine COM-Client-API für Python-Skripte in Form von pywin32. Hinweis Alle GFI LanGuard-COM-Scripting-Bibliotheken stehen via win32com.client für Python- Skripte zur Verfügung. Weitere Informationen finden Sie unter Scripting-Objekte (page 20). # DNS-Lookup mit dem LanGuard-COM-Objekt GlbObj.Socket def main(): """Return values: * 0 - false, failed * 1 - true, success""" result = 0 import win32com.client socket = win32com.client.dispatch("glbobj.socket.1") print(socket.dnslookup('gfi.com')) result = Pywin32 return(result) # Hallo Welt für Pywin32 def main(): """Return values: * 0 - false, failed * 1 - true, success""" result = 0 import win32com.client strcomputer = "." objwmiservice = win32com.client.dispatch ("WbemScripting.SWbemLocator") GFI LanGuard 3 Python-Skripte 17

18 objswbemservices = objwmiservice.connectserver (strcomputer,"root\cimv2") colitems = objswbemservices.execquery("select * from Win32_ PhysicalMemory") for objitem in colitems: print("kapazität: %s\n" % objitem.capacity) result = 1 return(result) Hinweis Zusätzliche Dokumentation zu Pywin32 finden Sie unter: Debugging von Python-Skripten GFI LanGuard Script Debugger bietet keine Unterstützung für das Debugging von Python-Skripten. Beliebige Python-IDEs, Debugger oder Kommandozeileninterpreter, auf denen Python-Skripte mit den derzeit unterstützten Python 2.5- und pywin32-distributionen für Windows ausgeführt werden können, unterstützen Sie beim Schreiben funktionierender Python-Skripte für GFI LanGuard. Hier einige Python-IDEs bzw. Interpreter, die gut zum Bearbeiten und Debuggen von Python-Skripten geeignet sind: PythonWin Winpdb SPE IDE Python Editor IDLE und der standardmäßig in der Python-Distribution enthaltene Python-Interpreter Python-Skripte können in einer GFI LanGuard-ähnlichen Umgebung ausgeführt werden, indem Sie die Skripte mit der Datei lpy.pyaus dem Verzeichnis Scripts von GFI LanGuard ausführen: C:\ProgramData\GFI\LanGuard11\Scripts <Python25Folder>\python.exe "<ProductDataDir>\Scripts\lpy.py" <NameOfPythonScriptFileToTest> 3.5 Python-Bibliotheken und Wiederverwendung von Code Python bietet die Möglichkeit, Bibliotheken mit häufig in Skripten verwendeten Funktionen zu erstellen. Solche Bibliotheken fassen häufig verwendete Funktionen zusammen und können von beliebig vielen Skripten verwendet werden. Dieser Abschnitt enthält folgende Informationen: Erstellen einer Bibliothek Verwenden von Bibliotheken GFI LanGuard 3 Python-Skripte 18

19 3.5.1 Erstellen einer Bibliothek Erstellen Sie eine Python-Skriptdatei, in der Python-Funktionen oder -Objekte definiert werden. Kopieren Sie die Datei nach <Hauptverzeichnis von LanGuard>\Library, zum : C:\Programme\GFI\LanGuard 11 Agent datei für eine Bibliothek """ Hallo Welt -Python-Bibliothek Kopieren Sie diese Datei nach <Hauptverzeichnis von LanGuard>\Library. """ def EchoString(text): """Gibt den übergebenen Text aus.""" GlobalFunctions.echo(text) print(text) Verwenden von Bibliotheken Damit Sie eine zuvor erstellte Python-Bibliothek verwenden können, müssen Sie diese dem standardmäßigen Importmechanismus von Python entsprechend importieren. mit der obigen Bibliothek """ LibraryTester.py Benötigt EchoLibrary.py im Verzeichnis <Installationsverzeichnis von LanGuard>\Library """ def main(): """Return values: * 0 - false, failed * 1 - true, success""" result = 0 from EchoLibrary import EchoString EchoString("Schwachstellenprüfung erfolgreich ausgeführt.") result = 1 return(result) GFI LanGuard 3 Python-Skripte 19

20 4 Scripting-Objekte Dieses Kapitel enthält Informationen zu verschiedenen Funktionen und Objekten, die vom GFI LanGuard Script Debugger unterstützt werden und die Sie in Ihren Skripten verwenden können. Themen in diesem Kapitel: 4.1 Socket-Objekte SNMP-Objekte File-Objekte Registrierungsobjekte HTTP-Objekte HTTPHeaders-Objekte FTP-Objekte Encode-Objekte Socket-Objekte Das Socket-Objekt wird zur Kommunikation mit TCP-Servern und UDP-Sockets verwendet. Es unterstützt verschiedene Funktionen, zum eine konfigurierbare Zeitüberschreitung, DNS- Auflösung und Rückwärts-DNS-Auflösung. Darüber hinaus beherrscht das Socket-Objekt beim Senden und Empfangen den Umgang mit verschiedenen Datentypen. Es kann sowohl Strings als auch rohe Binärdaten verarbeiten. Strings werden als normale String-Variablen und Binärdaten als Arrays von Bytes verarbeitet. Für die Empfangsfunktion (als Recv bezeichnet) kann ein Parameter angegeben werden, der festlegt, welcher Datentyp zurückgegeben werden soll. Auf diese Weise kann der Benutzer angeben, ob er Daten als String oder in binärer Form empfangen möchte. Dieser Abschnitt enthält Informationen zu den folgenden Socket-Objekten: OpenTcp OpenUdp Close Recv Send SendTo SetTimeout DnsLookup ReverseDnsLookup OpenTcp OpenTcp wird verwendet, um eine Verbindung zu einem entfernten Server über TCP herzustellen. OpenTcp(ip, port) GFI LanGuard 4 Scripting-Objekte 20

21 Socket-Objekt. Dieses Skript zeigt das Banner eines FTP-Servers, der lokal ausgeführt wird. Durch Einsetzen eines anderen Wertes für die Variable ip funktioniert es mit jedem beliebigen FTP-Server: Dim SocketObject As Object Dim ip As String Dim port As String Dim strresponse As String Ip = " " Port = "21" Socket.SetTimeout 5000,5000 Set SocketObject = Socket.OpenTcp(Ip,Port) If Not SocketObject is Nothing Then 'überprüfen, ob das Objekt erfolgreich zurückgegeben wurde strresponse = SocketObject.Recv(1024) echo(strresponse) SocketObject.Close OpenUdp OpenUdp wird verwendet, um eine Verbindung zu einem entfernten Server über UDP herzustellen. OpenUdp() Socket-Objekt. Dieses Skript stellt eine Verbindung zu einem in der Variable IP angegebenen DNS-Server her, führt eine Abfrage nach durch und zeigt anschließend das Ergebnis an: Dim SocketObject As Object Dim ip As String Dim port As String Dim rawdata As Variant Dim Response As Variant Ip = " " GFI LanGuard 4 Scripting-Objekte 21

22 Port = "53" strrequest=" rawdata = Array(0,3,1,0,0,1,0,0,0,0,0,0,3,&H77, &H77, &H77, &H03, &H67, &H66, &H69, &H03, &H63, &H6F,&H6D, 0,0,1,0,1) '^^^^^^^^^^ 'Dieser Teil ist der Paketheader unserer Anfrage, er enthält Daten wie zum Flags '^^^^^^^^^^ Dies ist die Anfrage selbst, beachten Sie, dass '.' nicht durch &H2E, sondern durch &H03 dargestellt werden '^^^^^^^^^^ 'Dies ist der Endheader unseres Pakets Set SocketObject = Socket.OpenUdp() If Not SocketObject is Nothing Then 'überprüfen, ob das Objekt erfolgreich zurückgegeben wurde SocketObject.SendTo IP,port,rawdata Response = SocketObject.Recv(1024) For a = UBound(response)-3 To UBound(response) echo(response(a)) If a <> UBound(response) Then echo(".") Next a SocketObject.Close Close Close dient zum Schließen eines zuvor zugewiesenen Socket-Objekts. Close Keine Rückgabedaten. Dieses Skript zeigt das Banner eines FTP-Servers, der lokal ausgeführt wird. Durch Einsetzen eines anderen Wertes für die Variable ip funktioniert es mit jedem beliebigen FTP-Server: Dim SocketObject As Object Dim ip As String GFI LanGuard 4 Scripting-Objekte 22

23 Dim port As String Dim strresponse As String Ip = " " Port = "21" Socket.SetTimeout 5000,5000 Set SocketObject = Socket.OpenTcp(Ip,Port) If Not SocketObject is Nothing Then 'überprüfen, ob das Objekt erfolgreich zurückgegeben wurde strresponse = SocketObject.Recv(1024) echo(strresponse) SocketObject.Close Recv Recv dient zum Abrufen der Daten eines Sockets (wird sowohl für TCP- als auch für UDP- Übertragungen verwendet). Recv(SizeInBytes, [DataType]) Weitere Informationen Der Parameter SizeInBytes gibt an, wie groß der zurückgegebene Teil des Puffers ist. Mithilfe des optionalen Parameters DataType kann das Format festgelegt werden, in dem der Puffer zurückgegeben werden soll. Wenn kein Datentyp angegeben ist, wird der Puffer analysiert, und es wird automatisch ein geeigneter Datentyp festgelegt. Folgende Werte können für den Parameter DatenTyp angegeben werden: 0 Puffer als Array von Bytes zurückgeben (ideal für Rohdaten) 1 Puffer als String zurückgeben (ideal, wenn Sie wissen, dass der Puffer aus Rohtext besteht) 2 Puffer als String zurückgeben, nicht druckbare Zeichen werden in. umgewandelt Optimal, wenn Sie wissen, dass der Puffer eine Mischung aus reinem Text und Sonderzeichen enthält, Sie aber nur den reinen Text benötigen. String oder ein Array von Bytes. Dieses Skript zeigt das Banner eines FTP-Servers, der lokal ausgeführt wird. Durch Einsetzen eines anderen Wertes für die Variable ip funktioniert es mit jedem beliebigen FTP-Server: Dim SocketObject As Object Dim ip As String Dim port As String GFI LanGuard 4 Scripting-Objekte 23