Der Paket-Editor

Wenn Sie ein Paket unter Pakete öffnen (oder Bearbeiten auf seiner Katalogseite wählen), öffnet sich der Editor. Seine Seitenleiste ersetzt die der Anwendung:

Meine Pakete, um zurückzukehren, die Auswahl Paket (die Wahl eines anderen Pakets öffnet denselben Bereich in diesem) und der Speicherstatus: Gespeichert, Wird gespeichert…, Offline: Änderungen bleiben erhalten oder Noch nicht gespeichert: neuer Versuch;
die Bereiche, gegliedert wie das Tenant-Menü der Plattform: Übersicht, Knotenverwaltung (Hersteller, Modelle, Profile mit SNMP und CLI; die mit Demnächst gekennzeichneten Einträge kommen in einer späteren Version), dann Versionen;
Einstellungen ganz unten.

Gemeinsam bearbeiten, live

Im Editor gibt es keine Schaltfläche Speichern: Jede Änderung wird während der Eingabe gespeichert. Mehrere Bearbeiter können gleichzeitig am selben Paket arbeiten; ihre Änderungen erscheinen, während sie tippen, die Seitenleiste zeigt, wer gerade bearbeitet, und ein Feld, das jemand anderes bearbeitet, ist in dessen Farbe umrandet. Bricht Ihre Verbindung ab, bleiben Ihre Änderungen erhalten und werden gesendet, sobald sie wiederhergestellt ist.

Ihre Änderungen erreichen die Plattformen erst, wenn Sie eine Version veröffentlichen: Der Kopf jedes Bereichs zeigt Unveröffentlichte Änderungen, wenn sich der Inhalt von der letzten Version unterscheidet.

Listen und Elementseiten

Jeder Teil des Inhalts ist eine Tabelle mit einem Suchfeld: Hersteller, Modelle, SNMP-Profile, CLI-Profile und Profile. Wählen Sie Zeilen aus, um mehrere Elemente auf einmal zu entfernen. Die Schaltfläche Neu… oben fragt nach einem Namen (und einigen wesentlichen Angaben) und öffnet dann die Seite des neuen Elements, auf der alles Weitere Registerkarte für Registerkarte ausgefüllt wird.

Tabelle Modelle des Pakets MikroTik lab devices mit dem CRS326-24G-2S+, seinem Hersteller, seiner Steuertaste und seiner Beschreibung

Hersteller

Ein Hersteller ist ein Anbieter von Netzwerkgeräten, etwa MikroTik. Neuer Hersteller fragt nach seinem Namen. Seine Seite hat zwei Registerkarten, Allgemein und Modelle.

Feld	Inhalt
Name	Pflichtfeld.
Logo	PNG, SVG, JPEG oder WebP, höchstens 512 KB. Wird auch für seine Modelle angezeigt.
Website	`https://www.example.com`
Support-Website	`https://support.example.com`
Support-Kontakt	E-Mail-Adresse oder Telefonnummer: `support@example.com`
Beschreibung	Wird auf der Plattform beim Hersteller angezeigt.

Die Seite des Herstellers MikroTik mit Logo, Website, Support-Website, Support-Kontakt und Beschreibung

Ein Hersteller, der von Modellen verwendet wird, kann nicht entfernt werden: Weisen Sie ihnen einen anderen Hersteller zu oder entfernen Sie sie zuerst.

Modelle

Ein Modell ist ein Gerätetyp eines Herstellers des Pakets, etwa CRS326-24G-2S+. Neues Modell fragt nach seinem Namen und Hersteller (fügen Sie zuerst einen Hersteller hinzu: Jedes Modell gehört zu einem Hersteller). Seine Seite hat zwei Registerkarten:

Allgemein: Name, Hersteller (sein Logo ist das Logo des Modells), Beschreibung.
Verbindung: wie sich die Plattform verhält, sobald sie eine CLI-Sitzung auf dem Gerät geöffnet hat.

Feld	Inhalt
Steuertaste	Keine oder ein Steuerzeichen von Ctrl-A bis Ctrl-Z, das direkt nach dem Öffnen der Verbindung gesendet wird, vor dem Skript. Manche Switches warten an ihrem Banner auf Ctrl-Y.
Verbindungsskript	Zeilen, die nach dem Verbinden, nach der Steuertaste, einzeln eingegeben werden: typischerweise Befehle, die das Paging ausschalten. Höchstens 200 Zeilen und 10.000 Zeichen.

Registerkarte Verbindung des CRS326-24G-2S+ ohne Steuertaste und mit einem zweizeiligen Verbindungsskript

Beispiel eines Verbindungsskripts für einen Switch, der den privilegierten Modus und kein Paging braucht:

enable
terminal more disable

Bei einem anderen Hersteller könnte es ein einzelnes terminal length 0 sein.

SNMP-Profile

Wie Plattformen per SNMP mit den Geräten kommunizieren. Neues SNMP-Profil fragt nach seinem Namen und seiner Version (SNMPv1, SNMPv2c oder SNMPv3). Seine Seite hat zwei Registerkarten:

Allgemein: Name, Version, Port (leer: 161), Beschreibung.
Zugangsdaten: abhängig von der Version. Nicht zutreffende Felder werden ausgeblendet und geleert.

SNMPv1 / SNMPv2c
SNMPv3

Feld	Beispiel
Community	`public` (von SNMPv1 und v2c im Klartext gesendet)

Feld	Beispiel
Benutzername	`snmpadmin` (der SNMPv3-Benutzer)
Sicherheitsstufe	Authentifizierung und Verschlüsselung (authPriv); außerdem noAuthNoPriv und authNoPriv
Authentifizierungsprotokoll	SHA-256 (auch MD5, SHA-1, SHA-224, SHA-384, SHA-512 angeboten; die Plattform zeigt MD5 und SHA-1 als MD-5 und SHA an)
Authentifizierungspasswort	`s3cr3t-example`, mindestens 8 Zeichen
Verschlüsselungsprotokoll	AES-128 (auch DES, AES-192, AES-256 angeboten)
Verschlüsselungspasswort	`s3cr3t-example`, mindestens 8 Zeichen
Kontextname	Optional

Registerkarte Zugangsdaten des Profils Campus SNMPv3 (authPriv) mit dem Warnhinweis, dem Benutzernamen, der Sicherheitsstufe, den Protokollen und maskierten Passwörtern

CLI-Profile

Wie Plattformen eine Befehlszeilensitzung öffnen. Neues CLI-Profil fragt nach seinem Namen und seinem Protokoll (SSH oder Telnet). Registerkarten:

Allgemein: Name, Protokoll, Port (leer: 22 für SSH, 23 für Telnet), Beschreibung.
Zugangsdaten: Benutzername (optional: Telnet kann sich auch nur mit einem Passwort anmelden), Authentifizierungsmethode (Passwort oder Privater Schlüssel), Passwort, Enable-Passwort (optional, für den privilegierten Modus).

Ein privater Schlüssel ist nie Teil eines Pakets: Mit Privater Schlüssel werden der Schlüssel und seine Passphrase auf jeder Plattform hinterlegt.

Registerkarte Zugangsdaten des Profils Campus SSH mit dem Warnhinweis, dem Benutzernamen netops und maskierten Passwörtern

Ein SNMP- oder CLI-Profil, das von Profilen verwendet wird, kann nicht entfernt werden: Weisen Sie ihnen ein anderes zu oder entfernen Sie sie zuerst.

Profile

Ein Profil ist ein fertiger Zugang zu einer Geräteart unter einem Namen: ein SNMP-Profil, ein CLI-Profil oder beide, dazu alle weiteren Anmeldungen und Werte, die das Gerät braucht. Auf der Plattform erscheint es unter Geräteverwaltung › Profile.

Neues Profil fragt nach seinem Namen (etwa Campus access switch), seinem SNMP-Profil und seinem CLI-Profil (wählen Sie mindestens eines; legen Sie sie zuerst unter SNMP und CLI an). Seine Seite hat drei Registerkarten: Allgemein, Weitere Zugangsdaten und Eigene Variablen.

Tabelle Profile mit Campus access switch und Campus legacy switch, ihren SNMP- und CLI-Profilen und der Anzahl ihrer Zugangsdaten und Variablen

Weitere Zugangsdaten

Weitere Anmeldungen am Gerät neben seinen SNMP- und CLI-Profilen: seine Weboberfläche, seine API… Neue Zugangsdaten öffnet ein Fenster mit Name (etwa Web UI oder REST API), Benutzername und Passwort. Bis zu 20 pro Profil, jeweils mit eindeutigem Namen. Die Tabelle zeigt Gespeichert anstelle eines Passworts.

Eigene Variablen

Freie Werte für alles andere: Adressen, Ports, API-Pfade, Token. Neue Variable öffnet ein Fenster:

Feld	Regel
Name	Buchstaben, Ziffern und `_`, nicht mit einer Ziffer beginnend, eindeutig im Profil: `api_url`
Wert	Freier Text, darf leer sein: `https://192.0.2.10:8443/rest`
Geheim	Wenn eingeschaltet, wird der Wert hier verborgen und auf den Plattformen verschlüsselt.
Beschreibung	Optional, eine Zeile.

Bis zu 50 pro Profil. Der Wert wird so verwendet, wie er geschrieben ist, und jeder Tenant einer Plattform kann einen eigenen Wert festlegen: siehe Zusätzliche Zugangsdaten und benutzerdefinierte Variablen.

Fenster Variable bearbeiten für syslog_server mit dem Wert 192.0.2.10 und seiner Beschreibung

Beispiel: ein einsatzbereites Profil

Das auf diesen Seiten verwendete Paket Campus switching profiles liefert zwei Profile. Das erste, Campus access switch, kombiniert:

Teil	Inhalt
SNMP-Profil	Campus SNMPv3 (authPriv): SNMPv3, Port 161, Benutzer `campus-monitor`, SHA-256 und AES-128
CLI-Profil	Campus SSH: SSH, Port 22, Benutzer `netops`, ein Passwort und ein Enable-Passwort
Weitere Zugangsdaten	Web UI: `admin` / `s3cr3t-example`
Eigene Variablen	`syslog_server` = `192.0.2.10` (der Syslog-Collector des Campus)

Das zweite, Campus legacy switch, kombiniert Campus SNMP v2c (Community public) mit Campus Telnet console. Eine Plattform, die das Paket installiert, erhält diese Profile einsatzbereit; jeder Tenant ersetzt dann die Beispielwerte durch seine eigenen.

Geheimnisse in Paketen

Auf den Plattformen werden diese Werte verschlüsselt gespeichert, und jeder Tenant kann eigene Werte anstelle dieser festlegen. Die Katalogseite eines Pakets nennt Zugangsdaten und Variablen, zeigt aber nie ihre Werte.

Fehler im Inhalt

Wenn etwas nicht übernommen werden kann (ein Modell ohne Hersteller, ein Port außerhalb von 1–65535, ein SNMPv3-Passwort unter 8 Zeichen, ein doppelter Name…), wird das Feld mit dem Grund markiert, und die Registerkarte oder Zeile zeigt ein Warnsymbol. Beheben Sie es vor dem Veröffentlichen.