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 si effettua dal modulo Sites, non da questo.
Tutorial correlato
Vedere Creare un token di pairing per un Edge Gateway, 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'Edge Gateway, preceduto da un'icona che indica il suo stato di connessione (online, offline, in attesa di pairing). |
| URL | URL pubblico esposto dall'Edge Gateway. |
| Description | Descrizione libera immessa alla creazione. |
| Sites | Siti a cui è collegato l'HTML5 Gateway. |
| Protocol | Protocollo utilizzato dall'Edge Gateway: HTTP o WebSocket. |
| Version | Versione dell'Edge 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'Edge Gateway selezionato. Si attiva anche con un doppio clic. |
| × (elimina) | Elimina gli Edge 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'Edge 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'Edge 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'Edge 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 Edge 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 Edge Gateway in attesa di pairing;
- un campo Authentication Token, di sola lettura, compare su un Edge Gateway in attesa di pairing.
Eliminare un HTML5 Gateway¶
Selezionare uno o più Edge 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'Edge 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'Edge 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'Edge 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. |