HTML5 Gateways Management¶

Das Modul HTML5 Gateways listet die auf der Plattform deklarierten HTML5 Gateways auf und ermöglicht es, sie hinzuzufügen, zu bearbeiten oder zu entfernen. Ein HTML5 Gateway übernimmt den Start der über den Browser erreichbaren Ressourcen (HTML5 RDP, HTML5 SSH usw.) und stützt sich dabei auf ein HTTP- oder WebSocket-Protokoll.

Diese Seite richtet sich an einen Administrator oder einen Integrator, der den Bestand an HTML5 Gateways und deren Pairing verwaltet. Die Zuordnung eines HTML5 Gateway zu einer Site erfolgt über das Modul Sites, nicht über dieses.

Zugehöriges Tutorial

Siehe Ein Pairing-Token für ein Edge Gateway erstellen, dessen Registerkarte HTML5 Gateway das Verfahren und die erwartete Form des CN des Zertifikats beschreibt.

Liste der HTML5 Gateways¶

Das Modul öffnet sich mit einem paginierten Raster der deklarierten HTML5 Gateways.

Spalte	Beschreibung
Name	Name des Edge Gateway, dem ein Symbol vorangestellt ist, das ihren Verbindungsstatus widerspiegelt (online, offline, Pairing ausstehend).
URL	Vom Edge Gateway bereitgestellte öffentliche URL.
Description	Freie Beschreibung, die bei der Erstellung eingegeben wurde.
Sites	Sites, denen das HTML5 Gateway zugeordnet ist.
Protocol	Vom Edge Gateway verwendetes Protokoll: HTTP oder WebSocket.
Version	Version des Edge Gateway. Wenn eine Master- und eine Backup-Instanz vorhanden sind, werden beide Versionen in zwei Zeilen angezeigt.

In der Symbolleiste verfügbare Aktionen:

Aktion	Beschreibung
+ (Hinzufügen)	Öffnet das Fenster Add HTML5 Gateway.
Edit	Öffnet das Fenster Edit HTML5 Gateway für die ausgewählte Edge Gateway. Wird auch durch einen Doppelklick ausgelöst.
× (Löschen)	Löscht die ausgewählten Edge Gateways nach Bestätigung. Mehrfachauswahl ist möglich.
Search	Filtert nach einem Teilstring des Namens, 700 ms nach dem letzten Tastendruck (oder sofort mit `Enter`).
Pagination	15, 25 oder 50 Zeilen pro Seite.

Ein HTML5 Gateway hinzufügen¶

Die Schaltfläche + öffnet das Fenster Add HTML5 Gateway.

Allgemeine Informationen¶

Feld	Beschreibung
Name	Pflichtfeld, höchstens 50 Zeichen. Erlaubte Zeichen: Buchstaben ohne Akzent, Ziffern, `é`, `è`, `à`, `ô`, `â`, Klammern, Leerzeichen, `-`, `/`, `.` und `_`.
URL	Pflichtfeld. Öffentliche URL des Edge Gateway, so wie sie in ihrer Datei `commonParameters.conf` konfiguriert ist.
Description	Freier Text.
Protocol	Protokoll für die Kommunikation mit dem Edge Gateway: HTTP (Standardwert) oder WebSocket.

Paring Token¶

Das Kontrollkästchen Create a pairing token zeigt den standardmäßig ausgeblendeten Abschnitt Paring Token an.

Feld	Beschreibung
SSL certificate	Zertifikat des Gateway, das hochgeladen werden muss. Eine Dropdown-Liste legt das erwartete Format fest — `pkcs12` (Standard) oder `pem` — und die Dateiauswahl akzeptiert dann nur die entsprechende Erweiterung, `.p12` oder `.pem`.
Certificate or private key password	Passphrase des Zertifikats, sofern zutreffend.
Pairing key validity period	Datum und Uhrzeit, ab denen das Token nicht mehr verwendet werden kann. Standard: heute + 7 Tage, im Format `TT/MM/JJJJ HH:MM`.
IP authorized to use the token	Öffentliche IP-Adresse, von der aus das Edge Gateway das Pairing durchführen darf. Es handelt sich um die Adresse, wie der Mediation Controller sie sieht: hinter einem NAT geben Sie die öffentliche Adresse ein.

Die letzten beiden Felder werden durch das Zertifikat freigegeben

Pairing key validity period und IP authorized to use the token bleiben inaktiv, solange keine gültige Zertifikatsdatei ausgewählt wurde. Eine Datei, deren Erweiterung nicht dem gewählten Format entspricht, lässt sie daher inaktiv — bis eine konforme Datei bereitgestellt wird.

Die Schaltfläche Validate speichert das Edge Gateway. Erzeugt das Speichern ein Pairing-Token, öffnet sich ein Fenster Paring Token, das den Schlüssel anzeigt und angibt, dass er bei der Installation des Gateway zu verwenden ist. Es wird mit Close geschlossen: Der Schlüssel muss aus dem Fenster kopiert werden.

Ein HTML5 Gateway bearbeiten¶

Wählen Sie ein Edge Gateway in der Liste aus und klicken Sie auf das Symbol Properties (oder doppelklicken Sie auf die Zeile). Das Fenster Edit HTML5 Gateway ist mit der aktuellen Konfiguration vorbelegt.

Die Felder sind dieselben wie beim Erstellen, einschließlich Name, das bearbeitbar bleibt. Zusätzlich gelten die folgenden Regeln:

Pairing key validity period und IP authorized to use the token können nur bei einem Edge Gateway geändert werden, bei der das Pairing aussteht;
ein Feld Authentication Token, nur lesbar, erscheint bei einem Edge Gateway, das auf das Pairing wartet.

Ein HTML5 Gateway löschen¶

Wählen Sie eine oder mehrere Edge Gateways aus und klicken Sie auf die Schaltfläche ×. Es wird eine Bestätigung angefordert. Mehrfachauswahl ist möglich.

Meldung	Ursache
The following HTML5 gateway is currently being used:	Das Edge Gateway ist einer oder mehreren Sites zugeordnet. Es muss vor dem Löschen davon getrennt werden. Die betroffenen Namen folgen der Meldung, und für ein mehrfaches Löschen existiert eine Pluralvariante.
Deletion failed for the following HTML5 gateway:	Das Löschen ist auf Seiten des Edge Gateway fehlgeschlagen. Die fehlerhaften Namen folgen der Meldung.

Fehlermeldungen beim Speichern¶

Meldung	Ursache
This gateway already exists.	Es gibt bereits ein HTML5 Gateway mit diesem Namen.
Invalid Name	Der Server hat den übermittelten Namen abgewiesen.
The CN of the Edge Gateway certificate sent does not match the expected CN	Das Zertifikat trägt nicht den erwarteten CN. Die Meldung nennt den gefundenen und den erwarteten CN.
Invalid certificate or private key password	Die angegebene Passphrase öffnet das Zertifikat nicht.
The given gateway is unreachable.	Das Edge Gateway antwortet nicht; der Vorgang wird abgebrochen.
Actions on HTML5 gateways have been disabled.	Die Verwaltung der HTML5 Gateways ist auf der Plattform deaktiviert: kein Vorgang gelingt.