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

# HTML5 Gateways Management

**HTML5 Gateways** moodul loetleb platvormil deklareeritud HTML5 Gateway serverid ja võimaldab neid lisada, redigeerida või eemaldada. HTML5 Gateway server tegeleb brauseri kaudu kättesaadavate ressursside käivitamisega (HTML5 RDP, HTML5 SSH jne), tuginedes HTTP- või WebSocket-protokollile.

See lehekülg on mõeldud administraatorile või integraatorile, kes haldab HTML5 Gateway komponentide parki ja nende pairingut. HTML5 Gateway komponendi määramine [site'ile](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/Sites/) tehakse moodulist **Sites**, mitte sellest.

> **Seotud õpetus**
>
> Vaadake juhendit [Pairingu tokeni loomine Edge Gateway serverile](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), mille vahekaart **HTML5 Gateway** kirjeldab protseduuri ja sertifikaadi CN-i oodatavat kuju.

---

## HTML5 Gateway komponentide loend

Moodul avaneb deklareeritud HTML5 Gateway komponentide lehekülgedeks jaotatud tabeliga.

| Veerg | Kirjeldus |
|---|---|
| **Name** | HTML5 Gateway komponendi nimi, mille ees on selle ühenduse olekut kajastav ikoon (võrgus, võrgust väljas, ootab pairingut). |
| **URL** | HTML5 Gateway komponendi avaldatud avalik URL. |
| **Description** | Loomisel sisestatud vaba kirjeldus. |
| **Sites** | Site'id, millega HTML5 Gateway komponent on seotud. |
| **Protocol** | HTML5 Gateway komponendi kasutatav protokoll: **HTTP** või **WebSocket**. |
| **Version** | HTML5 Gateway komponendi versioon. Kui olemas on nii põhi- kui ka varueksemplar, kuvatakse mõlemad versioonid kahel real. |

Tööriistaribal saadaolevad toimingud:

| Toiming | Kirjeldus |
|---|---|
| **+** (lisa) | Avab akna **Add HTML5 Gateway**. |
| **Edit** | Avab valitud HTML5 Gateway komponendi jaoks akna **Edit HTML5 Gateway**. Käivitub ka topeltklõpsuga. |
| **×** (kustuta) | Kustutab pärast kinnitamist valitud HTML5 Gateway komponendid. Mitme üksuse valimine on toetatud. |
| **Search** | Filtreerib nime alamstringi järgi 700 ms pärast viimast klahvivajutust (või kohe klahviga `Enter`). |
| **Pagination** | 15, 25 või 50 rida lehel. |

---

## HTML5 Gateway komponendi lisamine

Nupp **+** avab akna **Add HTML5 Gateway**.

### Üldteave

| Väli | Kirjeldus |
|---|---|
| **Name** | Kohustuslik, kuni 50 märki. Lubatud märgid: rõhumärgita tähed, numbrid, `é`, `è`, `à`, `ô`, `â`, sulud, tühik, `-`, `/`, `.` ja `_`. |
| **URL** | Kohustuslik. Edge Gateway komponendi avalik URL, nagu see on konfigureeritud selle failis `commonParameters.conf`. |
| **Description** | Vaba tekst. |
| **Protocol** | Protokoll, mille kaudu HTML5 Gateway komponendiga suheldakse: **HTTP** (vaikeväärtus) või **WebSocket**. |

### Paring Token

Märkeruut **Create a pairing token** toob nähtavale vaikimisi peidetud jaotise **Paring Token**.

| Väli | Kirjeldus |
|---|---|
| **SSL certificate** | Üleslaaditav lüüsi sertifikaat. Ripploend määrab oodatava vormingu — `pkcs12` (vaikimisi) või `pem` — ja failivalija aktsepteerib seejärel ainult vastavat laiendit, `.p12` või `.pem`. |
| **Certificate or private key password** | Sertifikaadi paroolifraas, kui see on olemas. |
| **Pairing key validity period** | Kuupäev ja kellaaeg, pärast mida tokenit enam kasutada ei saa. Vaikimisi: täna + 7 päeva, vormingus `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Avalik IP-aadress, millelt HTML5 Gateway serveril on lubatud pairingut teha. See on aadress, nagu Mediation Controller server seda näeb: NAT-i taga sisestage avalik aadress. |

> **Kaks viimast välja avatakse sertifikaadiga**
>
> **Pairing key validity period** ja **IP authorized to use the token** jäävad **mitteaktiivseks** seni, kuni pole valitud kehtivat sertifikaadifaili. Fail, mille laiend ei vasta valitud vormingule, jätab need seega mitteaktiivseks — kuni esitatakse nõuetele vastav fail.

Nupp **Validate** salvestab HTML5 Gateway serveri. Kui salvestamisel luuakse pairingu token, avaneb aken **Paring Token**, mis kuvab võtme ja teatab, et seda tuleb **kasutada lüüsi installimisel**. Aken suletakse nupuga **Close**: võti tuleb aknast kopeerida.

---

## HTML5 Gateway komponendi muutmine

Valige loendist HTML5 Gateway komponent ja klõpsake ikooni **Properties** (või topeltklõpsake rida). Aken **Edit HTML5 Gateway** on eeltäidetud praeguse konfiguratsiooniga.

Väljad on samad mis loomisel, sh väli **Name**, mis jääb redigeeritavaks. Lisaks kehtivad järgmised reeglid:

- **Pairing key validity period** ja **IP authorized to use the token** saab muuta ainult HTML5 Gateway serveris, mis **ootab pairingut**;
- pairingut ootavas HTML5 Gateway serveris kuvatakse kirjutuskaitstud väli **Authentication Token**.

---

## HTML5 Gateway komponendi kustutamine

Valige üks või mitu HTML5 Gateway komponenti ja klõpsake nuppu **×**. Küsitakse kinnitust. Mitme üksuse valimine on toetatud.

| Teade | Põhjus |
|---|---|
| **The following HTML5 gateway is currently being used:** | HTML5 Gateway komponent on seotud ühe või mitme site'iga. See tuleb enne kustutamist lahti siduda. Asjaomased nimed järgnevad teatele ja mitme üksuse kustutamise jaoks on olemas mitmuse variant. |
| **Deletion failed for the following HTML5 gateway:** | Kustutamine nurjus HTML5 Gateway komponendi poolel. Tõrkega nimed järgnevad teatele. |

---

## Tõrketeated salvestamisel

| Teade | Põhjus |
|---|---|
| **This gateway already exists.** | Selle nimega HTML5 Gateway komponent on juba olemas. |
| **Invalid Name** | Server lükkas esitatud nime tagasi. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Sertifikaadil pole oodatavat CN-i. Teade näitab leitud ja oodatava CN-i. |
| **Invalid certificate or private key password** | Esitatud paroolifraas ei ava sertifikaati. |
| **The given gateway is unreachable.** | HTML5 Gateway komponent ei vasta; toimingust loobutakse. |
| **Actions on HTML5 gateways have been disabled.** | HTML5 Gateway komponentide haldus on platvormil välja lülitatud: ükski toiming ei õnnestu. |
