GFI-Produkthandbuch. Scripting-Handbuch

Transkript

1 GFI-Produkthandbuch 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.1 Zuletzt aktualisiert (Monat/Tag/Jahr): 9/9/2013

3 Inhaltsverzeichnis 1 Einführung Vorteile eines Script Debugger Funktionen des GFI LanGuard Script Debugger 6 2 Visual Basic Script (VBScript) 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 Erstellen von Skripten Ausführen von Skripten Debugging-Haltepunkte Einzelschrittfunktion Überwachen der in Variablen gespeicherten Werte Debugging unter alternativen Benutzersitzungen Übergeben von Parametern an ein Skript Hinzufügen einer neuen skriptbasierten Schwachstellenüberprüfung zum Scanner Schritt 1: Skript erstellen, das auf die Schwachstelle überprüft Schritt 2: Neue Schwachstelle zur Ausführung des Skripts erstellen 14 3 Python-Skripte Was ist die Skriptsprache Python? Erstellen einer neuen Schwachstellenprüfung mit Python-Skript-Tests Schritt 1: Erstellen des Skripts Schritt 2: Erstellen Sie die neue Schwachstellenprüfung In Python-Skripten verfügbare Application Programming Interfaces (APIs) Pywin Debugging von Python-Skripten Python-Bibliotheken und Wiederverwendung von Code Erstellen einer Bibliothek Verwenden von Bibliotheken 21 4 Scripting-Objekte Socket-Objekte OpenTcp OpenUdp Close Recv Send SendTo SetTimeout DnsLookup ReverseDnsLookup SNMP-Objekte Connect 31

4 4.2.2 Get GetNext Set Close File-Objekte Connect Open Close Read Write WriteLine Seek Löschen Size FileVersion ProductVersion Attribute Registrierungsobjekte Connect Read Write GetFirstValue GetNextValue GetFirstKey GetNextKey DeleteValue DeleteKey HTTP-Objekte Connect GetURL PostURL SendRequest AddHeader ClearRequestHeaders Verb HTTPVersion IP Port RawResponseHeaders Body ProxyUser ProxyPassword HttpUser HttpPassword ResponseHeaders HTTPHeaders-Objekte 62

5 4.6.1 HeaderValue HeaderName Count FTP-Objekte Connect GetCurrentDirectory SetCurrentDirectory CreateDirectory RemoveDirectory DeleteFiles GetFile PutFile RenameFile FindFirstFile FindNextFile GetFindFileName GetFindFileSize LastError Encode-Objekte Base64Encode 82 5 Allgemeine Funktionen Echo WriteToLog StatusBar AddListItem SetDescription 86 6 Verwenden von ActiveX-, COM- und OLE-Automatisierungsobjekten Informationen zu Automatisierungsobjekten für die Verwendung eines Automatisierungsobjekt-Skripts 88 7 Bibliotheken und Wiederverwendung von Code Bibliotheken erstellen Verwenden von Bibliotheken 90 8 Index 92

6 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 6

7 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 7

8 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) 8

9 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) 9

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 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) 10

11 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) 11

12 '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) 12

13 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) 13

14 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) 14

15 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) 15

16 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 16

17 * 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 17

18 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 18

19 # 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 22). # 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 19

20 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 20

21 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 21

22 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 22

23 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 23

24 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 24

25 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 25

26 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 Send Send wird verwendet, um über eine TCP-Verbindung Daten an den gegenwärtig geöffneten Socket zu senden. Send (data, [SizeInBytes]) Die Anzahl der tatsächlich gesendeten Bytes. Weitere Informationen Die Funktion Send kann nur mit einem geöffneten Socket-Objekt verwendet werden, das durch Herstellen einer TCP-Verbindung geöffnet wurde. Informationen zum Senden von Daten über UDP- Verbindungen finden Sie im Abschnitt zur Funktion SendTo weiter unten in diesem Dokument. Für die Funktion Send kann ein optionaler Parameter angegeben werden (SizeInBytes). Dieser Parameter legt fest, welcher Anteil des als Datenfeld übergebenen Puffers tatsächlich gesendet werden soll. Wenn dieser optionale Parameter nicht angegeben ist, wird die Größe automatisch berechnet. Dieses Skript zeigt die Standardseite eines lokal ausgeführten Webservers in HTML-Rohform an. Das Skript kann an jeden beliebigen Webserver angepasst werden, indem einfach der Wert der Variablen ip entsprechend geändert wird: Dim SocketObject As Object Dim ip As String Dim port As String Dim req As String Dim strresponse As String Ip = " " Port = "80" GFI LanGuard 4 Scripting-Objekte 26

27 req = "GET / HTTP/1.0" 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) req = CStr(req +cr +cr) Socket.SetTimeout 5000,5000 Set SocketObject = Socket.OpenTcp(Ip,Port) 'überprüfen, ob das Objekt erfolgreich zurückgegeben wurde If Not SocketObject is Nothing Then SocketObject.Send(CStr(req)) strresponse = SocketObject.Recv(1024) While Len(CStr(strResponse)) <> 0 echo(strresponse) StrResponse = SocketObject.Recv(1024) Wend echo(strresponse) SendTo SendTo wird verwendet, um über eine UDP-Verbindung Daten an den gegenwärtig geöffneten Socket zu senden. SendTo (ip, port, data, [SizeInBytes]) Die Anzahl der tatsächlich gesendeten Bytes. Weitere Informationen Die Funktion SendTo kann nur mit einem geöffneten Socket-Objekt verwendet werden, das durch Herstellen einer UDP-Verbindung geöffnet wurde. Informationen zum Senden von Daten über eine TCP-Verbindung finden Sie im Abschnitt zur Funktion Send weiter oben in diesem Dokument. Für die Funktion SendTo kann ein optionaler Parameter angegeben werden (SizeInBytes). Dieser Parameter legt fest, welcher Anteil des als Datenfeld übergebenen Puffers tatsächlich gesendet werden soll. Wenn dieser optionale Parameter nicht angegeben ist, wird die Größe automatisch berechnet. 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 GFI LanGuard 4 Scripting-Objekte 27

28 Dim port As String Dim rawdata As Variant Dim Response As Variant Ip = " " 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) 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 SetTimeout Der Standardwert für die Zeitüberschreitung beim Senden bzw. Empfangen von Daten beträgt 2 Sekunden. Mithilfe von SetTimeout kann ein anderer Wert für die Zeitüberschreitung festgelegt werden. Der Wert gilt sowohl für das Senden als auch für das Empfangen von Daten. SetTimeout(SendTimeout, RecieveTimeout) Keine Rückgabedaten. Weitere Informationen Der Wert für SetTimeout muss festgelegt werden, bevor das Objekt erstellt wird, das zum Senden und Empfangen verwendet wird. Der Parameter für die Zeitüberschreitung wird in Millisekunden übergeben. Wenn der Wert -1 übergeben wird, wird der gegenwärtig eingestellte Wert für die Zeitüberschreitung verwendet. 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: GFI LanGuard 4 Scripting-Objekte 28

29 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 DnsLookup DnsLookup dient zum Auflösen von Hostnamen in IP-Adressen. Diese Funktion wird hauptsächlich verwendet, um Verbindungen zu Servern herzustellen, deren IP-Adresse unbekannt ist. DnsLookup(hostname) String (IP-Adresse). Sehr einfacher DNS-Lookup und Reverse Lookup: Dim SocketObject As Object Dim ServerName As String Dim IP As String Dim ResolvedName As String 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) ServerName = "whois.networksolutions.com" echo("wird gesucht"+cr) Socket.SetTimeout 5000,5000 ip = socket.dnslookup(servername) echo(servername + "entspricht der IP-Adresse:"+cr ) GFI LanGuard 4 Scripting-Objekte 29

30 echo(ip +cr) ResolvedName = Socket.ReverseDnsLookup(ip) echo(cr) echo("ip-adresse "+ip+ "entspricht "+cr) echo(resolvedname+cr) ReverseDnsLookup ReverseDnsLookup dient zum Auflösen von IP-Adressen in Hostnamen. ReverseDnsLookup(IP) String, der den zurückgegebenen Hostnamen enthält. Sehr einfacher DNS-Lookup und Reverse Lookup: Dim SocketObject As Object Dim ServerName As String Dim IP As String Dim ResolvedName As String 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) ServerName = "whois.networksolutions.com" echo("wird gesucht"+cr) Socket.SetTimeout 5000,5000 ip = socket.dnslookup(servername) echo(servername + "entspricht der IP-Adresse:"+cr ) echo(ip +cr) ResolvedName = Socket.ReverseDnsLookup(ip) echo(cr) echo("ip-adresse "+ip+ "entspricht "+cr) echo(resolvedname+cr) GFI LanGuard 4 Scripting-Objekte 30

31 4.2 SNMP-Objekte Mithilfe des SNMP-Objekts können Benutzer eine SNMP-Verbindung herstellen, um Werte abzufragen und festzulegen. Außerdem können mit diesem Objekt Objektbezeichner (OID) aufgelistet werden. SNMP wird im Allgemeinen verwendet, um Systeminformationen zu einem Dienst oder einem Gerät abzurufen. Viele Geräte verfügen über einen integrierten SNMP-Server. Mit dem SNMP-Objekt können verschiedene Eigenschaften dieser Geräte abgefragt werden. Dadurch können mögliche Sicherheitslücken, Schwachstellen und Fehlkonfigurationen auf diesen Geräten erkannt werden. Dieser Abschnitt enthält Informationen zu den folgenden SNMP-Objekten: Connect Get GetNext Set Close Connect Connect wird verwendet, um eine Verbindung zu einem entfernten Server herzustellen und ein SNMP- Objekt für diese Verbindung zurückzugeben. Connect(ip, community_string) SNMP-Objekt. Sehr einfacher SNMP-Client, der den SysName eines Computers mit installiertem SNMP-Server abruft: Dim snmp1 As Object 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) Set snmp1 = SNMP.Connect(" ", "public") 'OID des sysname Val1 = " " 'OID des systems-objekts root = " " snmp1.get Val1 echo "Oid: '"+Val1 + "'"+cr echo "Wert: '"+snmp1.get(val1)+"'"+cr snmp1.close GFI LanGuard 4 Scripting-Objekte 31

32 4.2.2 Get Get dient zum Abruf des Strings, der zum angegebenen OID gehört. Get (oid) String. Sehr einfacher SNMP-Client, der den SysName eines Computers mit installiertem SNMP-Server abruft: Dim snmp1 As Object 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) Set snmp1 = SNMP.Connect(" ", "public") 'OID des sysname Val1 = " " 'OID des systems-objekts root = " " snmp1.get Val1 echo "Oid: '"+Val1 + "'"+cr echo "Wert: '"+snmp1.get(val1)+"'"+cr snmp1.close GetNext GetNext wird verwendet, um den nächsten String abzurufen, der zum angegebenen OID gehört. GetNext (oid) String. Sehr einfacher SNMP-Client, der alle Strings abruft, die zum System-Objekt eines Computers mit installiertem SNMP-Server gehören. Rohdaten wie die Betriebsdauer OID werden in Hundertstelsekunden angezeigt: Dim snmp1 As Object 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) GFI LanGuard 4 Scripting-Objekte 32

33 Set snmp1 = SNMP.Connect(" ", "public") 'OID des sysname Val1 = " " 'OID des systems-objekts root = " " 'snmp1.get Val1 While Val1 <> ""' echo "Oid: '"+Val1 + "'"+cr echo "Wert: '"+snmp1.get(val1)+"'"+cr Val1 = snmp1.getnext(val1) If InStr(Val1, root) <> 1 Then Val1 ="" Wend snmp1.close Set Set dient zum Festlegen des Werts für einen angegebenen OID. Set (oid, String) True, wenn erfolgreich, sonst False. Sehr einfacher SNMP-Client, der die SysLocation eines Computers mit installiertem SNMP-Server auf Malta setzt. Beachten Sie, dass dieses Skript in jedem Fall fehlschlägt, weil auf die öffentliche Community nur lesender Zugriff möglich ist: Dim snmp1 As Object 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) Set snmp1 = SNMP.Connect(" ", "public") 'OID des sysname Val1 = " " root = " " 'OID des systems-objekts If snmp1.set(val1, "Malta") = true Then echo("wert erfolgreich festgelegt") Else echo("festlegen des Werts fehlgeschlagen") snmp1.close GFI LanGuard 4 Scripting-Objekte 33

34 4.2.5 Close Close dient zum Schließen offener SNMP-Sitzungen. Close Keine Rückgabedaten. Sehr einfacher SNMP-Client, der den SysName eines Computers mit installiertem SNMP-Server abruft: Dim snmp1 As Object 'Wagenrücklauf und Zeilenvorschub cr = Chr(13) + Chr(10) Set snmp1 = SNMP.Connect(" ", "public") 'OID des sysname Val1 = " " 'OID des systems-objekts root = " " snmp1.get Val1 echo "Oid: '"+Val1 + "'"+cr echo "Wert: '"+snmp1.get(val1)+"'"+cr snmp1.close 4.3 File-Objekte Mit dem File-Objekt können Benutzer Dateien sowohl remote als auch lokal öffnen und lesen bzw. schreiben. Dateien können in verschiedenen Modi geöffnet werden, vom Erstellen einer neuen Datei über das Öffnen einer vorhandenen Datei bis hin zum Öffnen einer Datei und dem Löschen ihres Inhalts. Dateien können außerdem zum Lesen, Schreiben oder im Abfragemodus geöffnet werden (in dem Sie lediglich die Größe und Attribute der Datei abrufen, jedoch nicht die Datei selbst lesen oder schreiben können). Neben den Schreib- und Lesevorgängen unterstützt das File-Objekt auch allgemeine Dateioperationen wie die Überprüfung der Dateigröße, Dateiattribute sowie die Änderung der Schreib-/Leseposition innerhalb der Datei. Dieser Abschnitt enthält Informationen zu den folgenden File-Objekten: Connect Open Close Read GFI LanGuard 4 Scripting-Objekte 34

35 Write WriteLine Seek Löschen Size FileVersion ProductVersion Attribute Connect Mit Connect können Sie eine Verbindung zu einem Computer (entweder lokal oder remote) herstellen, auf dem Sie Dateien öffnen möchten. Connect (IP-Adresse oder NetBIOS-Name) File-Objekt Dieses Skript öffnet eine Datei (test.txt) auf der lokalen Festplatte C und schreibt zwei Zeilen in die Datei: Dim textfile As Object Set textfile = File.Connect(" ") If textfile.open("c:\test.txt", GENERIC_WRITE, CREATE_ALWAYS) Then textfile.writeline("hallo, das ist eine Testdatei.") textfile.writeline("sie wurde mit einem GFI LanGuard-Skript erstellt.") textfile.close Open Opens öffnet eine Datei zum Schreiben bzw. Lesen. Open (Dateiname, Modus, Vorgang) GFI LanGuard 4 Scripting-Objekte 35

36 True, falls der Vorgang erfolgreich ausgeführt wird, ansonsten False. Weitere Informationen Modus: 0 Datei wird im Abfragemodus geöffnet. Sie können die Attribute abrufen, jedoch nicht auf die Datei selbst zugreifen. GENERIC_READ Datei zum Lesen öffnen GENERIC_WRITE Datei zum Schreiben öffnen Vorgang CREATE_NEW Neue Datei erstellen Der Vorgang schlägt fehl, falls die angegebenen Datei bereits vorhanden ist. CREATE_ALWAYS Neue Datei erstellen Wenn die Datei bereits vorhanden ist, wird sie überschrieben. OPEN_EXISTING Datei öffnen Der Vorgang schlägt fehl, wenn die Datei nicht vorhanden ist. OPEN_ALWAYS Datei öffnen, falls vorhanden Wenn die Datei nicht vorhanden ist, wird sie neu erstellt. TRUNCATE_EXISTING Datei öffnen Nach dem Öffnen wird die Datei auf eine Größe von 0 Byte gekürzt. Dieses Skript öffnet eine Datei (test.txt) auf der lokalen Festplatte C und schreibt zwei Zeilen in die Datei: Dim textfile As Object Set textfile = File.Connect(" ") If textfile.open("c:\test.txt", GENERIC_WRITE, CREATE_ALWAYS) Then textfile.writeline("hallo, das ist eine Testdatei.") textfile.writeline("sie wurde mit einem GFI LanGuard-Skript erstellt.") textfile.close Close Mit Close können Sie eine Instanz einer geöffneten Datei schließen. Close Keine Rückgabedaten. GFI LanGuard 4 Scripting-Objekte 36

37 Dieses Skript öffnet eine Datei (test.txt) auf der lokalen Festplatte C und schreibt zwei Zeilen in die Datei: Dim textfile As Object Set textfile = File.Connect(" ") If textfile.open("c:\test.txt", GENERIC_WRITE, CREATE_ALWAYS) Then textfile.writeline("hallo, das ist eine Testdatei.") textfile.writeline("sie wurde mit einem GFI LanGuard-Skript erstellt.") textfile.close Read Mit Read können Sie einen String der Länge (x) aus einer Datei auslesen. Read(number_of_bytes, [DataType]) String. Weitere Informationen DatenTyp ist ein optionaler Parameter. Wenn Sie den Datentyp nicht angeben, wird dieser automatisch vom System ermittelt. 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 ignoriert. Diese Option ist optimal, wenn Sie wissen, dass der Puffer eine Mischung aus reinem Text und Sonderzeichen enthält, Sie aber nur den reinen Text benötigen. Das folgende Skript zeigt den Inhalt der Datei hosts an: Dim textfile As Object Set textfile = File.Connect(" ") If textfile.open("c:\windows\system32\drivers\etc\hosts", GENERIC_ READ, Open_Existing) Then echo(textfile.read(1024,1)) textfile.close GFI LanGuard 4 Scripting-Objekte 37

38 4.3.5 Write Mit Write können Sie einen String in eine Datei schreiben, ohne am Ende des Strings CRLF (Wagenrücklauf und Zeilenvorschub) anzuhängen. Write(string, [number_of_bytes]) Keine Rückgabedaten. Weitere Informationen anzahl_bytes ist ein optionaler Parameter. Wenn Sie diesen auslassen, wird der Wert der Größe des übergebenen Strings entsprechend berechnet. Dieses Skript öffnet eine Datei (test.txt) auf der lokalen Festplatte C und schreibt zwei Zeilen in die Datei: Dim textfile As Object Set textfile = File.Connect(" ") If textfile.open("c:\test.txt", GENERIC_WRITE, CREATE_ALWAYS) Then textfile.writeline("hallo, das ist eine Testdatei.") textfile.writeline("sie wurde mit einem GFI LanGuard-Skript erstellt.") textfile.close WriteLine Mit WriteLine können Sie einen String in eine Datei schreiben, wobei am Ende des Strings CRLF (Wagenrücklauf und Zeilenvorschub) angehängt wird. WriteLine(string) Boolescher Wert: True (ungleich Null) bei Erfolg, ansonsten False (Null) Dieses Skript öffnet eine Datei (test.txt) auf der lokalen Festplatte C und schreibt zwei Zeilen in die Datei: Dim textfile As Object GFI LanGuard 4 Scripting-Objekte 38