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

# HTML5 Gateways Management

Modulul **HTML5 Gateways** enumeră HTML5 Gateway-urile declarate pe platformă și permite adăugarea, modificarea sau retragerea lor. Un HTML5 Gateway se ocupă de lansarea resurselor accesibile prin browser (HTML5 RDP, HTML5 SSH etc.), bazându-se pe un protocol HTTP sau WebSocket.

Această pagină este destinată unui administrator sau unui integrator care gestionează parcul de servere HTML5 Gateway și pairingul acestora. Atribuirea unui server HTML5 Gateway unui [site](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/Sites/) se face din modulul **Sites**, nu din acesta.

> **Tutorial asociat**
>
> Consultați [Crearea unui token de pairing pentru un Edge Gateway](https://docs.cyberelements.io/bastion/4.6/ro/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), al cărui tab **HTML5 Gateway** detaliază procedura și forma așteptată a CN-ului certificatului.

---

## Lista serverelor HTML5 Gateway

Modulul se deschide pe un tabel paginat al serverelor HTML5 Gateway declarate.

| Coloană | Descriere |
|---|---|
| **Name** | Numele serverului HTML5 Gateway, precedat de o pictogramă care reflectă starea conexiunii sale (online, offline, în așteptarea pairingului). |
| **URL** | URL-ul public expus de serverul HTML5 Gateway. |
| **Description** | Descriere liberă introdusă la creare. |
| **Sites** | Site-urile cu care este asociat serverul HTML5 Gateway. |
| **Protocol** | Protocolul utilizat de serverul HTML5 Gateway: **HTTP** sau **WebSocket**. |
| **Version** | Versiunea serverului HTML5 Gateway. Când există o instanță principală și una de rezervă, ambele versiuni sunt afișate pe două linii. |

Acțiuni disponibile în bara de instrumente:

| Acțiune | Descriere |
|---|---|
| **+** (Adăugare) | Deschide fereastra **Add HTML5 Gateway**. |
| **Edit** | Deschide fereastra **Edit HTML5 Gateway** pentru serverul HTML5 Gateway selectat. Se declanșează și printr-un dublu clic. |
| **×** (Ștergere) | Șterge serverele HTML5 Gateway selectate, după confirmare. Selecția multiplă este acceptată. |
| **Search** | Filtrează după un subșir al numelui, la 700 ms după ultima apăsare de tastă (sau imediat cu `Enter`). |
| **Pagination** | 15, 25 sau 50 de rânduri pe pagină. |

---

## Adăugarea unui server HTML5 Gateway

Butonul **+** deschide fereastra **Add HTML5 Gateway**.

### Informații generale

| Câmp | Descriere |
|---|---|
| **Name** | Obligatoriu, cel mult 50 de caractere. Caractere permise: litere neaccentuate, cifre, `é`, `è`, `à`, `ô`, `â`, paranteze, spațiu, `-`, `/`, `.` și `_`. |
| **URL** | Obligatoriu. URL-ul public al serverului Edge Gateway, așa cum este configurat în fișierul său `commonParameters.conf`. |
| **Description** | Text liber. |
| **Protocol** | Protocolul utilizat pentru comunicarea cu serverul HTML5 Gateway: **HTTP** (valoare implicită) sau **WebSocket**. |

### Paring Token

Caseta **Create a pairing token** dezvăluie secțiunea **Paring Token**, ascunsă în mod implicit.

| Câmp | Descriere |
|---|---|
| **SSL certificate** | Certificatul gateway-ului care trebuie încărcat. O listă derulantă definește formatul așteptat — `pkcs12` (implicit) sau `pem` — iar selectorul de fișiere acceptă apoi numai extensia corespunzătoare, `.p12` sau `.pem`. |
| **Certificate or private key password** | Fraza de trecere a certificatului, dacă este cazul. |
| **Pairing key validity period** | Data și ora de la care tokenul nu mai poate fi utilizat. Implicit: astăzi + 7 zile, în formatul `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Adresa IP publică de pe care serverul HTML5 Gateway este autorizat să efectueze pairingul. Este adresa așa cum o vede Mediation Controller: în spatele unui NAT, introduceți adresa publică. |

> **Ultimele două câmpuri sunt deblocate de certificat**
>
> **Pairing key validity period** și **IP authorized to use the token** rămân **inactive** cât timp nu a fost ales un fișier de certificat valid. Prin urmare, un fișier a cărui extensie nu corespunde formatului selectat le lasă inactive — până la furnizarea unui fișier conform.

Butonul **Validate** salvează HTML5 Gateway. Dacă salvarea produce un token de pairing, se deschide o fereastră **Paring Token**, care afișează cheia și precizează că aceasta trebuie **utilizată la instalarea gateway-ului**. Se închide cu **Close**: cheia trebuie copiată din fereastră.

---

## Modificarea unui server HTML5 Gateway

Selectați un server HTML5 Gateway din listă și faceți clic pe pictograma **Properties** (sau dublu clic pe rând). Fereastra **Edit HTML5 Gateway** este precompletată cu configurarea curentă.

Câmpurile sunt aceleași ca la creare, inclusiv **Name**, care rămâne editabil. În plus, se aplică următoarele reguli:

- **Pairing key validity period** și **IP authorized to use the token** pot fi modificate numai pe un server HTML5 Gateway **în așteptarea pairingului**;
- un câmp **Authentication Token**, numai pentru citire, apare pe un HTML5 Gateway în așteptarea pairingului.

---

## Ștergerea unui server HTML5 Gateway

Selectați unul sau mai multe servere HTML5 Gateway și faceți clic pe butonul **×**. Se solicită o confirmare. Selecția multiplă este acceptată.

| Mesaj | Cauză |
|---|---|
| **The following HTML5 gateway is currently being used:** | Serverul HTML5 Gateway este asociat cu unul sau mai multe site-uri. Trebuie disociat înainte de ștergere. Numele vizate urmează după mesaj, iar pentru o ștergere multiplă există o variantă la plural. |
| **Deletion failed for the following HTML5 gateway:** | Ștergerea a eșuat pe serverul HTML5 Gateway. Numele cu eroare urmează după mesaj. |

---

## Mesaje de eroare la salvare

| Mesaj | Cauză |
|---|---|
| **This gateway already exists.** | Un server HTML5 Gateway poartă deja acest nume. |
| **Invalid Name** | Numele trimis a fost respins de server. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Certificatul nu are CN-ul așteptat. Mesajul indică CN-ul găsit și cel așteptat. |
| **Invalid certificate or private key password** | Fraza de acces furnizată nu deschide certificatul. |
| **The given gateway is unreachable.** | Serverul HTML5 Gateway nu răspunde; operațiunea este abandonată. |
| **Actions on HTML5 gateways have been disabled.** | Gestionarea serverelor HTML5 Gateway este dezactivată pe platformă: nicio operațiune nu reușește. |
