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

# HTML5 Gateways Management

Il modulo **HTML5 Gateways** elenca gli HTML5 Gateway dichiarati nella piattaforma e consente di aggiungerli, modificarli o rimuoverli. Un HTML5 Gateway si occupa dell'avvio delle risorse accessibili tramite il browser (HTML5 RDP, HTML5 SSH, ecc.), basandosi su un protocollo HTTP o WebSocket.

Questa pagina è destinata a un amministratore o a un integratore che gestisce il parco di HTML5 Gateway e il loro pairing. L'assegnazione di un HTML5 Gateway a un [sito](https://docs.cyberelements.io/bastion/4.6/it/Usage/AdminConsoleReference/Sites/) si effettua dal modulo **Sites**, non da questo.

> **Tutorial correlato**
>
> Vedere [Creare un token di pairing per un Edge Gateway](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), la cui scheda **HTML5 Gateway** descrive in dettaglio la procedura e la forma prevista del CN del certificato.

---

## Elenco degli HTML5 Gateway

Il modulo si apre su una griglia paginata degli HTML5 Gateway dichiarati.

| Colonna | Descrizione |
|---|---|
| **Name** | Nome dell'HTML5 Gateway, preceduto da un'icona che indica il suo stato di connessione (online, offline, in attesa di pairing). |
| **URL** | URL pubblico esposto dall'HTML5 Gateway. |
| **Description** | Descrizione libera immessa alla creazione. |
| **Sites** | Siti a cui è collegato l'HTML5 Gateway. |
| **Protocol** | Protocollo utilizzato dall'HTML5 Gateway: **HTTP** o **WebSocket**. |
| **Version** | Versione dell'HTML5 Gateway. Quando esistono un'istanza master e una di backup, vengono visualizzate entrambe le versioni su due righe. |

Azioni disponibili nella barra degli strumenti:

| Azione | Descrizione |
|---|---|
| **+** (aggiungi) | Apre la finestra **Add HTML5 Gateway**. |
| **Edit** | Apre la finestra **Edit HTML5 Gateway** dell'HTML5 Gateway selezionato. Si attiva anche con un doppio clic. |
| **×** (elimina) | Elimina gli HTML5 Gateway selezionati previa conferma. È supportata la selezione multipla. |
| **Search** | Filtra per sottostringa del nome, 700 ms dopo l'ultima digitazione (o immediatamente con `Enter`). |
| **Paginazione** | 15, 25 o 50 righe per pagina. |

---

## Aggiungere un HTML5 Gateway

Il pulsante **+** apre la finestra **Add HTML5 Gateway**.

### Informazioni generali

| Campo | Descrizione |
|---|---|
| **Name** | Obbligatorio, 50 caratteri al massimo. Caratteri consentiti: lettere senza accento, cifre, `é`, `è`, `à`, `ô`, `â`, parentesi, spazio, `-`, `/`, `.` e `_`. |
| **URL** | Obbligatorio. URL pubblico dell'Edge Gateway, così come è configurato nel suo file `commonParameters.conf`. |
| **Description** | Testo libero. |
| **Protocol** | Protocollo utilizzato per comunicare con l'HTML5 Gateway: **HTTP** (valore predefinito) o **WebSocket**. |

### Paring Token

La casella **Create a pairing token** rivela la sezione **Paring Token**, nascosta per impostazione predefinita.

| Campo | Descrizione |
|---|---|
| **SSL certificate** | Certificato del gateway da caricare. Un elenco a discesa definisce il formato previsto — `pkcs12` (predefinito) o `pem` — e il selettore di file accetta allora solo l'estensione corrispondente, `.p12` o `.pem`. |
| **Certificate or private key password** | Passphrase del certificato, se applicabile. |
| **Pairing key validity period** | Data e ora oltre le quali il token non può più essere utilizzato. Valore predefinito: oggi + 7 giorni, nel formato `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Indirizzo IP pubblico da cui l'HTML5 Gateway è autorizzato a effettuare il pairing. Si tratta dell'indirizzo così come lo vede il Mediation Controller: dietro un NAT, immettere l'indirizzo pubblico. |

> **Gli ultimi due campi vengono sbloccati dal certificato**
>
> **Pairing key validity period** e **IP authorized to use the token** restano **inattivi** finché non è stato scelto un file di certificato valido. Un file la cui estensione non corrisponde al formato selezionato li lascia pertanto inattivi — fino a quando non viene fornito un file conforme.

Il pulsante **Validate** salva l'HTML5 Gateway. Se il salvataggio produce un pairing token, si apre una finestra **Paring Token** che visualizza la chiave e indica che è **da utilizzare durante l'installazione del gateway**. Si chiude con **Close**: la chiave deve essere copiata dalla finestra.

---

## Modificare un HTML5 Gateway

Selezionare un HTML5 Gateway nell'elenco e fare clic sull'icona **Properties** (oppure fare doppio clic sulla riga). La finestra **Edit HTML5 Gateway** è precompilata con la configurazione corrente.

I campi sono gli stessi della creazione, compreso **Name**, che resta modificabile. Si applicano inoltre le regole seguenti:

- **Pairing key validity period** e **IP authorized to use the token** possono essere modificati solo su un HTML5 Gateway **in attesa di pairing**;
- un campo **Authentication Token**, di sola lettura, compare su un HTML5 Gateway in attesa di pairing.

---

## Eliminare un HTML5 Gateway

Selezionare uno o più HTML5 Gateway e fare clic sul pulsante **×**. Viene richiesta una conferma. È supportata la selezione multipla.

| Messaggio | Causa |
|---|---|
| **The following HTML5 gateway is currently being used:** | L'HTML5 Gateway è collegato a uno o più siti. Deve essere scollegato prima dell'eliminazione. I nomi interessati seguono il messaggio ed esiste una variante al plurale per un'eliminazione multipla. |
| **Deletion failed for the following HTML5 gateway:** | L'eliminazione è fallita sul lato dell'HTML5 Gateway. I nomi in errore seguono il messaggio. |

---

## Messaggi di errore al salvataggio

| Messaggio | Causa |
|---|---|
| **This gateway already exists.** | Esiste già un HTML5 Gateway con questo nome. |
| **Invalid Name** | Il nome inviato è stato rifiutato dal server. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Il certificato non riporta il CN previsto. Il messaggio indica il CN trovato e quello previsto. |
| **Invalid certificate or private key password** | La passphrase fornita non apre il certificato. |
| **The given gateway is unreachable.** | L'HTML5 Gateway non risponde; l'operazione viene abbandonata. |
| **Actions on HTML5 gateways have been disabled.** | La gestione degli HTML5 Gateway è disabilitata sulla piattaforma: nessuna operazione riesce. |
