Gestion des passerelles HTML5¶

Le module Passerelles HTML5 recense les HTML5 Gateways déclarées sur la plateforme 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.

Tutoriel associé

Voir Créer un jeton d'appairage pour une Edge Gateway, dont l'onglet HTML5 Gateway détaille la procédure et la forme attendue du CN du certificat.

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 Edge 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 Edge Gateway.
Description	Description libre saisie à la création.
Sites	Sites auxquels la HTML5 Gateway est rattachée.
Protocole	Protocole utilisé par la Edge Gateway : HTTP ou WebSocket.
Version	Version de la Edge 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 Edge Gateway sélectionnée. Également déclenché par double-clic.
× (Supprimer)	Supprime la ou les Edge 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.

Ajouter une HTML5 Gateway¶

Le bouton + ouvre la fenêtre Ajout de passerelle HTML5.

Informations générales¶

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 Edge Gateway : HTTP (valeur par défaut) ou WebSocket.

Jeton d'appairage¶

La case Créer un jeton d'appairage fait apparaître la section Jeton d'appairage, masquée par défaut.

Champ	Description
Certificat passerelle	Certificat de la Edge Gateway à téléverser. Une liste déroulante fixe le format attendu — `pkcs12` (par défaut) ou `pem` — et le sélecteur de fichier n'accepte alors que l'extension correspondante, `.p12` ou `.pem`.
Mot de passe du certificat ou de la clé privée	Passphrase du certificat, le cas échéant.
Durée de validité de la clé d'appairage	Date et heure au-delà desquelles le jeton n'est plus utilisable. Par défaut : aujourd'hui + 7 jours, au format `JJ/MM/AAAA HH:MM`.
IP autorisée à utiliser le jeton	Adresse IP publique depuis laquelle la Edge Gateway est autorisée à s'appairer. C'est l'adresse vue par le Mediation Controller : en présence d'un NAT, renseigner l'adresse publique.

Les deux derniers champs s'activent avec le certificat

Durée de validité de la clé d'appairage et IP autorisée à utiliser le jeton restent inactifs tant qu'aucun fichier de certificat valide n'a été choisi. Un fichier dont l'extension ne correspond pas au format sélectionné les laisse donc inactifs — et ce jusqu'à ce qu'un fichier conforme soit fourni.

Le bouton Valider enregistre la Edge Gateway. Si l'enregistrement produit un jeton d'appairage, une fenêtre Jeton d'appairage s'ouvre, affiche la clé et rappelle qu'elle est à utiliser lors de l'installation de la passerelle. Elle se referme avec Fermer : la clé est à recopier depuis la fenêtre.

Modifier une HTML5 Gateway¶

Sélectionner une Edge 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 ajoutent les règles suivantes :

Durée de validité de la clé d'appairage et IP autorisée à utiliser le jeton ne sont modifiables que sur une Edge Gateway en attente d'appairage ;
un champ Jeton d'authentification, en lecture seule, apparaît sur une Edge Gateway en attente d'appairage.

Supprimer une HTML5 Gateway¶

Sélectionner une ou plusieurs Edge 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 Edge 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é Edge 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.
Le CN du certificat Edge Gateway envoyé ne correspond pas au CN attendu	Le certificat ne porte pas le CN attendu. Le message donne le CN trouvé et le CN attendu.
Mot de passe du certificat ou de la clé privée invalide.	La passphrase fournie ne permet pas d'ouvrir le certificat.
La passerelle indiquée est injoignable.	La Edge 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.