Verbindungsvorlagen
Verbindungsvorlagen definieren in OpenVLE wiederverwendbare Einstellungen für Verbindungen.
Damit lassen sich Verbindungsparameter wie Protokoll, Port, Benutzername oder Passwort standardisiert hinterlegen, sodass Administratorinnen und Administratoren neue Verbindungen schnell und konsistent erstellen können.
Wo finde ich den Bereich?
Über das Hauptmenü: Verbindungen → Vorlagen
Alternativ erreichbar über: Über Virtuelle Maschinen, VM-Vorlagen oder Verbindungen verlinkt
Funktionen im Überblick
- Eine Verbindungsvorlage ist immer genau einer VM oder VM-Vorlage zugewiesen
- Anzeigen aller bestehenden Verbindungsvorlagen
- Erstellen neuer Vorlagen mit definierten Standardwerten für Protokolle (z. B. RDP, SSH)
- Löschen nicht mehr benötigter Vorlagen
Wichtige Felder im Überblick
| Feldname | Beschreibung |
|---|---|
Benutzername | Anmeldebenutzername, der vom Apache-Guacamole-Server zur Authentifizierung auf der VM verwendet wird. |
Label | Anzeigename der Verbindungsvorlage. Wird in Listen und Dialogen angezeigt und automatisch generiert. |
Passwort | Passwort des angegebenen Benutzerkontos. Wird vom Apache-Guacamole-Server verwendet, um die Verbindung herzustellen. Wird nicht erneut angezeigt. |
Port | Netzwerkport für die Verbindung. Standardmäßig **22** für SSH und **3389** für RDP. |
Protokoll | Kommunikationsprotokoll, das für die Verbindung verwendet wird. Unterstützte Werte sind **SSH** oder **RDP**. |
VM oder VM-Vorlage | Referenz auf die zugewiesene VM oder VM-Vorlage, für die diese Verbindungsvorlage gilt. |
Erstellen einer Verbindungsvorlage
- Öffne im Hauptmenü den Bereich Verbindungen → Vorlagen.
- Klicke auf Hinzufügen, um eine neue Verbindungsvorlage zu erstellen.
- Wähle das gewünschte Protokoll (z. B. RDP oder SSH) aus.
- Gib Standardparameter wie Port, Benutzername und Passwort an.
- Speichere die Vorlage.
- Verwende die Vorlage anschließend beim Erstellen neuer Verbindungen.
Verbindungsvorlagen können nicht bearbeitet, sondern nur neu erstellt werden.
Löschen einer Verbindungsvorlage
- Öffne im Hauptmenü den Bereich Verbindungen → Vorlagen.
- Suche die gewünschte Vorlage in der Liste.
- Klicke auf Löschen, oder öffne das Kontextmenü und wähle Löschen.
- Bestätige den Löschvorgang im angezeigten Dialog.
- Die Verbindungsvorlage wird daraufhin dauerhaft entfernt.
Verbindungsvorlagen können nur gelöscht werden, wenn keine Verbindungen mehr zu dieser Vorlage existieren.
Falls noch abhängige Verbindungen vorhanden sind, muss diese zunächst gelöscht werden, bevor die Vorlage entfernt werden kann.
Automatische Duplizierung
Beim Erstellen einer neuen VM werden alle Verbindungsvorlagen, die der verwendeten VM-Vorlage zugewiesen sind, automatisch dupliziert und der neu erstellten VM zugewiesen.
So können die neu erzeugten Verbindungsvorlagen verwendet werden, um Verbindungen zur VM herzustellen – entweder manuell oder im Rahmen einer Veranstaltung.
Beispiel oder Anwendungsfall
Eine Administratorin möchte sicherstellen, dass alle Schulungs-VMs mit denselben RDP-Einstellungen erstellt werden. Sie legt im Bereich Verbindungsvorlagen eine neue Vorlage an, wählt das Protokoll RDP und trägt die Anmeldeinformationen ein. Anschließend können auf Basis dieser Verbindungsvorlage neue Verbindungen erstellt werden, die an die entsprechenden Benutzer oder VMs gebunden sind.
Hinweise / Besonderheiten
- Verbindungsvorlagen können nicht bearbeitet, sondern nur neu erstellt werden.
- Vorlagen dienen der Vereinheitlichung und beschleunigen die Bereitstellung neuer VMs oder Benutzerverbindungen.
- Bestehende Verbindungen behalten ihre individuellen Einstellungen.
- Über die Liste der Verbindungsvorlagen kann nachvollzogen werden, welche VMs oder Verbindungen eine bestimmte Vorlage verwenden.
- Nur Administratorinnen und Administratoren oder Benutzer mit entsprechenden Berechtigungen dürfen Verbindungsvorlagen anlegen oder löschen.
Beziehungen zu anderen Objekten
Viele Objekte in OpenVLE stehen in Beziehung zu anderen Elementen innerhalb des Systems. Die folgende Übersicht zeigt, welche Verknüpfungen bestehen und ob diese bestimmte Automatisierungen auslösen.
| Objekt | Beschreibung | Automatisches Verhalten |
|---|---|---|
| Berechtigungen | Objektspezifische Berechtigungen können direkt am Objekt vergeben werden. | Automatisches Entfernen beim Löschen des Objekts. |
| Tags | Objekte können mit beliebig vielen Tags versehen werden, um sie zu kategorisieren oder zu filtern. | Automatisches Entfernen beim Löschen des Objekts. |
| VM / VM-Vorlage | Einer Verbindungsvorlage ist genau eine VM oder VM-Vorlage zugewiesen. | Beim Löschen der VM oder VM-Vorlage werden alle zugehörigen Verbindungsvorlagen und darauf basierende Verbindungen automatisch gelöscht. |
Erforderliche Berechtigungen
Die für Aktionen benötigten Berechtigungen k önnen über Rollen oder individuell vergeben werden. Fehlen Ihnen bestimmte Rechte, sind die entsprechenden Funktionen in der Benutzeroberfläche ausgeblendet oder deaktiviert.
| Aktion | Benötigte Berechtigung | Pfad | Weitere Informationen |
|---|---|---|---|
| Verbindungen anzeigen | guacamoles_read | / oder /<objectID> | |
| Verbindungen anlegen | guacamoles_create | / | |
| Verbindungen löschen | guacamoles_delete | / oder /<objectID> | |
| Verbindungsvorlagen anzeigen | guacamole_connection_profiles_read | / oder /<objectID> | |
| Verbindungsvorlagen anlegen | guacamole_connection_profiles_create | / | |
| Verbindungsvorlagen löschen | guacamole_connection_profiles_delete | / oder /<objectID> | |
| Virtuelle Maschinen anzeigen | vms_read | / oder /<objectID> | |
| VM-Vorlagen lesen | templates_read | / oder /<objectID> |
Beispiel:
/4a3bc312-d1af-4b3f-b222-f5e9cecbf007 – So erhält der Benutzer nur Zugriff auf dieses eine Objekt.Wird als Pfad / verwendet, gilt die Berechtigung global für alle Objekte dieses Typs.
Für *_create-Berechtigungen ist nur der globale Pfad / zulässig.