Gestion des passerelles HTML5¶

Le module Passerelles HTML5 recense les HTML5 Gateways déclarées sur le tenant et permet de les ajouter, modifier ou supprimer. Une HTML5 Gateway prend en charge le lancement des ressources accessibles via le navigateur (HTML5 RDP, HTML5 SSH, etc.), en reposant sur un protocole HTTP ou WebSocket.

Cette page s'adresse à un administrateur ou à un intégrateur qui gère le parc des HTML5 Gateways et leur appairage. L'affectation d'une HTML5 Gateway à un site se fait depuis le module Sites, pas depuis ce module.

Liste des HTML5 Gateways¶

Le module s'ouvre sur une grille paginée des HTML5 Gateways déclarées.

Colonne	Description
Nom	Nom de la HTML5 Gateway, précédé d'une icône qui reflète son état de connexion (en ligne, hors ligne, en attente d'appairage).
URL	URL publique exposée par la HTML5 Gateway.
Description	Description libre saisie à la création.
Sites	Sites auxquels la HTML5 Gateway est rattachée.
Protocole	Protocole utilisé par la HTML5 Gateway : HTTP ou WebSocket.
Version	Version de la HTML5 Gateway. Lorsqu'une instance maître et une instance de secours existent, les deux versions sont affichées sur deux lignes.

Actions disponibles dans la barre d'outils :

Action	Description
+ (Ajouter)	Ouvre la fenêtre Ajout de passerelle HTML5.
Modifier	Ouvre la fenêtre Edition de passerelle HTML5 pour la HTML5 Gateway sélectionnée. Également déclenché par double-clic.
× (Supprimer)	Supprime la ou les HTML5 Gateways sélectionnées après confirmation. Prise en charge de la multi-sélection.
Recherche	Filtre par sous-chaîne du nom, 700 ms après la dernière frappe (ou immédiatement avec `Entrée`).
Pagination	15, 25 ou 50 lignes par page.

HTML5 Gateway par défaut du tenant

La HTML5 Gateway fournie par défaut avec le tenant — son nom est dérivé de celui du tenant — ne peut être ni modifiée ni supprimée : les actions Modifier et × sont grisées lorsqu'elle est sélectionnée, et le double-clic reste sans effet.

Ajouter une HTML5 Gateway¶

Le bouton + ouvre la fenêtre Ajout de passerelle HTML5, qui ne demande que quatre informations.

Champ	Description
Nom	Obligatoire, 50 caractères au plus. Caractères autorisés : lettres non accentuées, chiffres, `é`, `è`, `à`, `ô`, `â`, parenthèses, espace, `-`, `/`, `.` et `_`.
URL	Obligatoire. URL publique de la Edge Gateway, telle que configurée dans son fichier `commonParameters.conf`.
Description	Texte libre.
Protocole	Protocole d'échange avec la HTML5 Gateway : HTTP (valeur par défaut) ou WebSocket.

Pas de section d'appairage à renseigner

Aucun certificat ni paramètre de jeton n'est demandé : la case Créer un jeton d'appairage n'est pas proposée et la section correspondante n'est pas exposée. La clé d'appairage est fournie par la plateforme.

Le bouton Valider enregistre la HTML5 Gateway. La console lance ensuite un guide pas à pas d'appairage de la nouvelle HTML5 Gateway.

Modifier une HTML5 Gateway¶

Sélectionner une HTML5 Gateway dans la liste puis cliquer sur l'icône Propriétés (ou double-cliquer sur la ligne). La fenêtre Edition de passerelle HTML5 est pré-remplie avec la configuration courante.

Les champs sont les mêmes qu'à la création, Nom compris, qui reste modifiable. S'y ajoute un champ Jeton d'authentification, en lecture seule, qui n'apparaît que sur une HTML5 Gateway en attente d'appairage.

Supprimer une HTML5 Gateway¶

Sélectionner une ou plusieurs HTML5 Gateways puis cliquer sur le bouton ×. Une confirmation est demandée. La multi-sélection est prise en charge.

Message	Cause
Cette passerelle HTML5 est en cours d'utilisation :	La HTML5 Gateway est rattachée à un ou plusieurs sites. Il faut l'en dissocier avant de la supprimer. Les noms concernés suivent le message, et une variante au pluriel existe pour une suppression multiple.
Une passerelle HTML5 n'a pas pu être supprimée :	La suppression a échoué côté HTML5 Gateway. Les noms en erreur suivent le message.

Messages d'erreur à l'enregistrement¶

Message	Cause
Cette passerelle existe déjà.	Une HTML5 Gateway porte déjà ce nom.
Nom invalide	Le nom soumis a été refusé par le serveur.
La passerelle indiquée est injoignable.	La HTML5 Gateway ne répond pas ; l'opération est abandonnée.
Les actions sur les passerelles HTML5 ont été désactivées.	La gestion des HTML5 Gateways est désactivée sur la plateforme : aucune opération n'aboutit.