Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- omnivista-scripting [2018/02/01 09:19] – benny-domroese
+++ omnivista-scripting [2024/06/09 10:29] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
 ====== OmniVista 2500 - CLI-Scripting mit JavaScript ======
-Der folgende Tech-Tipp soll die Möglichkeiten des Scripting Moduls des OmniVista2500 aufzeigen. Neben der Nutzung der bekannten AOS CLI Syntax, besteht die Möglichkeit Kommandos in JavaScript einzubinden, um so beispielsweise bedingte Konfigurationen durchzuführen (z.B. Learned Port Security nur auf Mobile Ports) oder komplexe Prüfungen der Konfiguration durchzuführen.
+Der folgende Tech-Tipp soll die Möglichkeiten des Scripting Moduls des OmniVista2500 aufzeigen. Neben der Nutzung der bekannten AOS CLI Syntax, besteht die Möglichkeit Kommandos in JavaScript einzubinden, um so beispielsweise bedingte Konfigurationen (z.B. Learned Port Security nur auf mobilen Ports) oder komplexe Prüfungen der Konfiguration durchzuführen.
-Das Modul kann zur Ausführung der Scripte neben den eingebauten System Variablen (z.B. GeräteTyp, IP-Adresse, MAC-Adresse) auch Benutzer Variablen zur Ausführung der Scripte heranziehen. Details zu den Möglichkeiten werden im OmniVista direkt unter dem Menüpunkt ?Help im CLI-Scripting Modul angeboten.
+Das Modul kann zur Ausführung der Scripte neben den eingebauten System-Variablen (z.B. GeräteTyp, IP-Adresse, MAC-Adresse) auch Benutzer-Variablen zur Ausführung der Scripte heranziehen. Details zu den Möglichkeiten werden im OmniVista direkt unter dem Menüpunkt ?Help im CLI-Scripting Modul angeboten.
 Folgend werden einige Beispiel Scripte kurz erklärt, die individuell angepasst werden können und den Konfigurationsaufwand in einigen Fällen bereits erheblich reduzieren können.
-:!: __Hinweis:__ Die folgende Scripte wurde mit OmniVsita 2500 4.2.1R01 Build 95 auf AOS 6.x Geräten (6450 und 6400) genutzt. Andere Geräte sowie AOS Versionen unterscheiden sich ggf. in der Syntax der Kommandos und in deren Ausgabe. Die Scripte müssen daher immer genau geprüft werden, bevor diese für einen flächendeckenden RollOut verwendet werden können.:!:
+:!: __Hinweis:__ Die folgende Scripte wurden mit OmniVista 2500 4.2.1R01 Build 95 auf AOS 6.x Geräten (6450 und 6400) genutzt. Andere Geräte sowie AOS Versionen unterscheiden sich ggf. in der Syntax der Kommandos und in deren Ausgabe. Die Scripte müssen daher immer genau geprüft werden, bevor diese für einen flächendeckenden Rollout verwendet werden können.:!:
 ===== Überprüfung der installierten FPGA Version =====
@@ Zeile 33: / Zeile 33: @@
 ===== Bedingte Konfiguration, z.B. Änderungen nur an mobilen Ports =====
-Das nächste Beispiel beinhaltet eine bedingte Konfiguration. Hier wird eine Liste der mobilen Ports angelegt, und für diese eine bestimmtes Kommando herangezogen. In diesem Fall "default vlan restore disable". Die Liste wird hier anhand eines regulären Ausdrucks und des Kommandos "show vlan port mobile" erzeugt. Anschließend wird mithilfe einer for-Schleife, für jedes Element in der Liste (jeder Port) ein Kommando ausgeführt.
+Das nächste Beispiel beinhaltet eine bedingte Konfiguration. Hier wird eine Liste der mobilen Ports angelegt, und diese für ein bestimmtes Kommando herangezogen. In diesem Fall "default vlan restore disable". Die Liste wird hier anhand eines regulären Ausdrucks und des Kommandos "show vlan port mobile" erzeugt. Anschließend wird mithilfe einer for-Schleife, für jedes Element in der Liste (jeder mobile Port) ein Kommando ausgeführt.
 <code>
 <js>
@@ Zeile 67: / Zeile 67: @@
 Folgender Code kann genutzt werden, um das Vorhandensein diverser Konfigurationen zu prüfen.
 Dafür werden 2 Funktionen definiert, die folgende Parameter erhalten:
   *  Einen regulären Ausdruck nach dem gesucht wird.
   *  Ein Kommando in dessen Ausgabe der Ausdruck erwartet wird.
@@ Zeile 145: / Zeile 146: @@
 Das folgende Script überprüft, ob die AAA Konfiguration auf allen Ports gleich ist oder sich die Konfiguration auf einzelnen Ports unterscheidet.
-Anhand eines Regulären Ausdrucks wird hier mithilfe des Kommandos "show vlan port mobile" eine Liste (Array) mit allen 802.1x Ports erstellt. Anschließend wird mit "show configuration snapshot aaa" die komplette AAA Konfiguration eingelesen und mit einem Regulären Ausdruck so modifiziert, dass diese zwischen den Ports vergleichbar ist.
+Anhand eines Regulären Ausdrucks wird hier mithilfe des Kommandos "show vlan port mobile" eine Liste (Array) mit allen 802.1x Ports erstellt. Anschließend wird mit "show configuration snapshot aaa" die komplette AAA Konfiguration eingelesen und mit einem regulären Ausdruck so modifiziert, dass diese zwischen den Ports vergleichbar ist.
 Aus:
@@ Zeile 156: / Zeile 157: @@
 </code>
-Diese Konfiguration wird nun mit dem jeweilig nächsten Port verglichen und auf Differenzen untersucht (z.B. Port 1/2 mit Port 1/3).Dieser Vorgang wird für alle 802.1x Ports ausgeführt, die in der Liste "ListOf8021xPorts" aufgeführt sind. Sollten Unterschiede auftreten, so sind diese anschliessend im Audit Log (siehe Screenshot) zu finden.
+Diese Konfiguration wird nun mit dem jeweilig nächsten Port verglichen und auf Differenzen untersucht (z.B. Port 1/2 mit Port 1/3). Dieser Vorgang wird für alle 802.1x Ports ausgeführt, die in der Liste "ListOf8021xPorts" aufgeführt sind. Sollten Unterschiede auftreten, so sind diese anschließend im Audit Log (siehe Screenshot) zu finden.
-Anbei der JavaScript Code für diese Funtion.
+Anbei der JavaScript Code für diese Funktion.
 <code>
@@ Zeile 212: / Zeile 213: @@
 </code>
 Anbei ein Screenshot der Ausgabe, die Hinweise auf unterschiedliche Konfigurationen bietet.
-{{ :ovscripting:check8021xportconfigscreenshot.gif?600 |}}
+{{ :ovscripting:check8021xportconfigscreenshot.gif|}}
+===== UNP´s anhand von Vorlagen erstellen =====
+Der nächste Code erstellt ein UNP anhand einer Vorlage (eines vorhandenen UNP). Sofern das UNP bereits existiert, oder die "Vorlage" fehlt, wird das Script beendet und eine ERROR Message im Audit kreiert.
+<code>
+<js>
+/*@@Script for creating a UNP with usage of an existing "template". Use on your own risk! Benjamin Domroese, Januar 2018@@*/
+cli.sendCmd("show aaa user-network-profile ");
+var response_1 = cli.lastResponse();
+var pattern_unp_embedded = /unp\-embedded/g;/*RegeEx to lookup for the "template"-UNP*/
+var pattern_unp_secu = /unp\-secu/g;/*RegEx Pattern to check for the UNP that should be created*/
+if (pattern_unp_secu.test(response_1)==true)
+{
+	cli.trace("UNP Secu already exists");
+}/*if*/
+else if (pattern_unp_embedded.test(response_1)==true)
+{
+	var pattern_unp_embedded_vlan = /unp\-embedded\s+(\d{1,4})/g;/*RegEx that only captures the VLAN ID (used for the create command)*/
+	var vlan_for_unp_secu = pattern_unp_embedded_vlan.exec(response_1);
+	cli.sendCmd("aaa user-network-profile name unp-secu vlan " + vlan_for_unp_secu[1] + " hic disable");
+	cli.trace("UNP Secu was created");
+}/*else if*/
+else
+{
+	cli.errorLog("Profile UNP-Embedded not found for use as template!");
+}/*else*/
+</js>
+</code>
+===== Überprüfung ob alle Ports per 802.1x gesichert sind =====
+Das nächste Beispiel benötigt bei der Ausführung die Eingabe von **User Variablen**. Im "Send Script Wizard" werden hier unter Punkt 4 "Define User Variables" abgefragt. Das Script prüft die Anzahl der Verfügbaren Ports des Systems, subtrahiert die erwarteten Non-802.1x Ports (z.B. Uplink Ports) sowie die 802.1x Ports und gibt im Log File an, ob die Anzahl der 802.1x Ports den Erwartungen entspricht.
+Die Anzahl der Ports habe ich in diesem Beispiel per "show interfaces status" berechnet. Dabei werden mithilfe der Funktion "unique" doppelte Einträge gelöscht (z.B. Hybrid Ports die doppelt angezeigt werden).
+Die Anzahl der 802.1x Ports wird erneut mit "show vlan port mobile" berechnet. Im Audit werden schlussendlich die Ergebnisse angezeigt. Diese beinhalten die Anzahl der Ports des Systems, die erwarteten 802.1x und Uplink Ports sowie (wenn vorhanden) die Anzahl ungeschützter Ports.
+<code>
+<js>
+/*@@Script for checking if all Ports are configured as 8021x. Use on your own risk! Benjamin Domroese, Januar 2018@@*/
+/*@@Dont forget to enter the number of expected Uplinks as uservariable in the CLI Module. This Script checks for unsecured Ports@@*/
+function unique(array)/* In case there are duplicate entries i.e. for hybrid ports */
+{
+	array.sort();
+	for (i=0;i<array.length;i++)
+		if (a[i]==a[i+1])
+		{
+			a.splice(i,1);
+		}/*if*/
+    return array.length;
+}/* function for removing duplicates */
+/* Check the number of available Ports on the System */
+cli.sendCmd("show interfaces status");
+var response_1 = cli.lastResponse();
+var pattern_1 = /\d{1,2}\/\d{1,2}/g; /*RegeEx that only stores the Port i.e. 1/7*/
+var a = response_1.match(pattern_1);
+var nr_of_ports_available = unique(a); /*Create a Array with the Ports. This is created with var "a" passed to the function for cleaning duplicates. It returns the lenght of the array (the number of ports) */
+/* Check the number of 8021x Ports */
+cli.sendCmd("show vlan port mobile");
+var response_2 = cli.lastResponse();
+var pattern_2 = /on-8021x/g;
+var b = response_2.match(pattern_2);
+if (b != null)/* Check if there is no 8021x */
+{
+    var nr_of_ports_8021x = b.length;
+}/* if */
+else
+{
+    var nr_of_ports_8021x = 0;
+}/*else*
+/* Check if there are more unsecured Ports than expected and return unsecured Ports to logfile */
+if (nr_of_ports_8021x + parseInt("$ExpectedUplinks") == nr_of_ports_available)
+{
+	cli.trace("Everything Secure on " + "$IP_ADDRESS" + ". Number of available Ports is: " + nr_of_ports_available + " and number of 8021x and Uplink Ports is: " + (nr_of_ports_8021x + parseInt("$ExpectedUplinks")));
+}/* if */
+else if (nr_of_ports_8021x + parseInt("$ExpectedUplinks") > nr_of_ports_available)
+{
+	cli.errorLog("Please check UserVariables for expected Uplink! More Ports detected than possible");
+}/*else*/
+else
+{
+	var nr_of_ports_without_8021x = nr_of_ports_available - (nr_of_ports_8021x + parseInt("$ExpectedUplinks"));
+	cli.errorLog("Warning for " + "$IP_ADDRESS" + "! There are " + nr_of_ports_without_8021x + " Ports without 8021x! Number of available Ports is: " + nr_of_ports_available + " and number of 8021x and Uplink Ports is: " + (nr_of_ports_8021x + parseInt("$ExpectedUplinks")));
+}/*else*/
+</js>
+</code>