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

# Gateways Management

Il modulo **Gateways** elenca gli Edge Gateway (gateway non HTML5) dichiarati nella piattaforma e consente di aggiungerne uno, di modificarne la configurazione (certificato, percorsi di archiviazione delle registrazioni, pairing) o di rimuoverlo. Questa pagina è destinata a un amministratore o a un integratore che gestisce il parco di Edge Gateway, il loro pairing con il Mediation Controller e la raccolta delle registrazioni video e SSH.

Per poter essere utilizzato in una sessione, un Edge Gateway deve essere collegato ad almeno un [sito](https://docs.cyberelements.io/bastion/4.6/it/Usage/AdminConsoleReference/Sites/). L'inserimento in un sito si effettua dal modulo **Sites**, non da questo.

> **Tutorial correlati**
>
> - [Creare un token di pairing per un Edge Gateway](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Creare un Edge Gateway](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Elenco degli Edge Gateway

Il modulo si apre su una griglia paginata degli Edge 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). |
| **Description** | Descrizione libera immessa alla creazione. |
| **Sites** | Siti a cui è collegato l'Edge Gateway. |
| **Type** | **With recording** se l'Edge Gateway supporta la registrazione delle sessioni, **Basic** in caso contrario. |
| **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 Gateway**. |
| **Edit** | Apre la finestra **Edit Gateway** dell'Edge Gateway selezionato. Si attiva anche con un doppio clic. |
| **×** (elimina) | Elimina gli Edge Gateway selezionati previa conferma. È supportata la selezione multipla. |
| **Download recording certificate** | Scarica il certificato dell'autorità di registrazione dell'Edge Gateway selezionato. Abilitato solo se l'Edge Gateway è **online**. |
| **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 Edge Gateway

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

### Informazioni generali

| Campo | Descrizione |
|---|---|
| **Name** | Obbligatorio, 50 caratteri al massimo. Caratteri consentiti: lettere senza accento, cifre, `é`, `è`, `à`, `ô`, `â`, parentesi, spazio, `-`, `/`, `.` e `_`. |
| **Description** | Testo libero. |
| **FQDN** | Nome completamente qualificato della macchina che ospita l'Edge Gateway. Deve corrispondere al CN del certificato dell'Edge Gateway, altrimenti il pairing viene rifiutato (vedere la sezione [Messaggi di errore al salvataggio](#error-messages-on-saving)). |
| **Archives** | Percorso locale in cui l'Edge Gateway archivia le registrazioni video RDP. Precompilato con `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Percorso locale in cui l'Edge Gateway archivia le registrazioni SSH. Precompilato con `/var/ipdiva/care/sshrecord`. |

I tre campi **FQDN**, **Archives** e **Archives SSH** riguardano solo gli Edge Gateway con registrazione: sono nascosti su un Edge Gateway che non la supporta.

### 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 dell'Edge Gateway, se applicabile. |
| **Import a Careserver certificate** | Se selezionata, rivela il certificato del server di registrazione: gli stessi tre elementi (formato, file, password). |
| **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 Edge Gateway

Selezionare un Edge Gateway nell'elenco e fare clic sull'icona **Properties** (oppure fare doppio clic sulla riga). La finestra **Edit Gateway** è precompilata con le impostazioni correnti e con i dati del certificato collegato.

I campi sono gli stessi della creazione, con le regole seguenti:

- il **Name** resta modificabile;
- **FQDN**, **Archives** e **Archives SSH** sono nascosti se l'Edge Gateway non supporta la registrazione, e **disabilitati** finché non è online;
- **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.

> **Modificare i percorsi di archivio**
>
> La modifica di **Archives** o **Archives SSH** rende le registrazioni precedenti inaccessibili dalla console. Viene richiesta una conferma prima dell'applicazione della modifica, e un errore sul lato dell'Edge Gateway viene segnalato con **An error occured during the update of storage paths.**

---

## Eliminare un Edge Gateway

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

| Messaggio | Causa |
|---|---|
| **The following 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 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 Edge 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 dell'Edge Gateway non riporta il CN previsto. Il messaggio indica il CN trovato e quello previsto. |
| **The CN of the Careserver certificate sent does not match the expected CN** | Stesso caso per il certificato del server di registrazione. |
| **Invalid certificate or private key password** | La passphrase fornita non apre il certificato. |
| **Unable to contact the pairing system, please check its configuration** | Il servizio di pairing non ha risposto. |
| **The given gateway is unreachable.** | L'Edge Gateway non risponde; l'operazione viene abbandonata. |
| **The gateway management service is unreachable** | Il servizio che gestisce gli Edge Gateway non ha risposto. |
