> Source: https://docs.cyberelements.io/bastion/4.6/fr/Usage/AdminConsoleReference/HTML5Gateways/

# 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](https://docs.cyberelements.io/bastion/4.6/fr/Usage/AdminConsoleReference/Sites/) se fait depuis le module **Sites**, pas depuis ce module.

> **Tutoriel associé**
>
> Voir [Créer un jeton d'appairage pour une Edge Gateway](https://docs.cyberelements.io/bastion/4.6/fr/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), 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 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. |

---

## 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 HTML5 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 HTML5 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 HTML5 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 HTML5 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 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 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 HTML5 Gateway **en attente d'appairage** ;
- un champ **Jeton d'authentification**, en lecture seule, apparaît 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. |
| **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 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. |
