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

# HTML5 Gateways Management

Modul **HTML5 Gateways** zobrazuje zoznam serverov HTML5 Gateway deklarovaných na platforme a umožňuje ich pridávať, upravovať alebo odoberať. Server HTML5 Gateway zabezpečuje spúšťanie prostriedkov dostupných cez prehliadač (HTML5 RDP, HTML5 SSH atď.) a využíva pritom protokol HTTP alebo WebSocket.

Táto stránka je určená správcovi alebo integrátorovi, ktorý spravuje servery HTML5 Gateway a ich pairing. Priradenie servera HTML5 Gateway k [site](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/Sites/) sa vykonáva z modulu **Sites**, nie z tohto modulu.

> **Súvisiaci kurz**
>
> Pozrite si [Vytvorenie tokenu pairingu pre server Edge Gateway](https://docs.cyberelements.io/bastion/4.6/sk/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), ktorého karta **HTML5 Gateway** podrobne opisuje postup a očakávaný tvar CN certifikátu.

---

## Zoznam serverov HTML5 Gateway

Modul sa otvorí stránkovanou tabuľkou deklarovaných serverov HTML5 Gateway.

| Stĺpec | Popis |
|---|---|
| **Name** | Názov komponentu HTML5 Gateway, pred ktorým sa zobrazuje ikona znázorňujúca jeho stav pripojenia (online, offline, čaká na pairing). |
| **URL** | Verejná adresa URL, ktorú sprístupňuje komponent HTML5 Gateway. |
| **Description** | Voľný popis zadaný pri vytvorení. |
| **Sites** | Site, ku ktorým je server HTML5 Gateway pripojený. |
| **Protocol** | Protokol, ktorý používa komponent HTML5 Gateway: **HTTP** alebo **WebSocket**. |
| **Version** | Verzia komponentu HTML5 Gateway. Ak existuje hlavná a záložná inštancia, obe verzie sa zobrazia na dvoch riadkoch. |

Akcie dostupné na paneli s nástrojmi:

| Akcia | Popis |
|---|---|
| **+** (Add) | Otvorí okno **Add HTML5 Gateway**. |
| **Edit** | Otvorí okno **Edit HTML5 Gateway** pre vybratý komponent HTML5 Gateway. Spustí sa aj dvojitým kliknutím. |
| **×** (odstrániť) | Po potvrdení odstráni vybraté komponenty HTML5 Gateway. Podporuje sa viacnásobný výber. |
| **Search** | Filtruje podľa podreťazca názvu 700 ms po poslednom stlačení klávesu (alebo okamžite klávesom `Enter`). |
| **Pagination** | 15, 25 alebo 50 riadkov na stránku. |

---

## Pridanie servera HTML5 Gateway

Tlačidlo **+** otvorí okno **Add HTML5 Gateway**.

### Všeobecné informácie

| Pole | Popis |
|---|---|
| **Name** | Povinné, najviac 50 znakov. Povolené znaky: písmená bez diakritiky, číslice, `é`, `è`, `à`, `ô`, `â`, zátvorky, medzera, `-`, `/`, `.` a `_`. |
| **URL** | Povinné. Verejná adresa URL servera Edge Gateway, ako je nakonfigurovaná v jeho súbore `commonParameters.conf`. |
| **Description** | Voľný text. |
| **Protocol** | Protokol používaný na komunikáciu s komponentom HTML5 Gateway: **HTTP** (predvolená hodnota) alebo **WebSocket**. |

### Paring Token

Začiarkavacie políčko **Create a pairing token** zobrazí oddiel **Paring Token**, ktorý je predvolene skrytý.

| Pole | Popis |
|---|---|
| **SSL certificate** | Certifikát brány, ktorý sa má nahrať. Rozbaľovací zoznam určuje očakávaný formát — `pkcs12` (predvolene) alebo `pem` — a výber súboru potom prijme iba zodpovedajúcu príponu, `.p12` alebo `.pem`. |
| **Certificate or private key password** | Prístupová fráza certifikátu, ak sa používa. |
| **Pairing key validity period** | Dátum a čas, po ktorých token už nemožno použiť. Predvolená hodnota: dnes + 7 dní vo formáte `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Verejná IP adresa, z ktorej môže komponent HTML5 Gateway vykonať pairing. Ide o adresu, ako ju vidí služba Mediation Controller: ak sa komponent nachádza za NAT, zadajte verejnú adresu. |

> **Posledné dve polia odomkne certifikát**
>
> **Pairing key validity period** a **IP authorized to use the token** zostávajú **neaktívne**, kým nie je vybraný platný súbor certifikátu. Súbor, ktorého prípona nezodpovedá vybranému formátu, ich preto ponechá neaktívne — až kým nezadáte vyhovujúci súbor.

Tlačidlo **Validate** uloží komponent HTML5 Gateway. Ak sa pri uložení vygeneruje token pairingu, otvorí sa okno **Paring Token**, ktoré zobrazí kľúč a uvádza, že sa má **použiť pri inštalácii brány**. Zatvára sa tlačidlom **Close**: kľúč treba skopírovať z okna.

---

## Úprava servera HTML5 Gateway

Vyberte komponent HTML5 Gateway v zozname a kliknite na ikonu **Properties** (alebo dvakrát kliknite na riadok). Okno **Edit HTML5 Gateway** je vopred vyplnené aktuálnou konfiguráciou.

Polia sú rovnaké ako pri vytváraní vrátane poľa **Name**, ktoré zostáva upraviteľné. Navyše platia tieto pravidlá:

- **Pairing key validity period** a **IP authorized to use the token** možno zmeniť iba pri komponente HTML5 Gateway, ktorý **čaká na pairing**;
- pole **Authentication Token** iba na čítanie sa zobrazuje pri komponente HTML5 Gateway, ktorý čaká na pairing.

---

## Odstránenie servera HTML5 Gateway

Vyberte jeden alebo viac komponentov HTML5 Gateway a kliknite na tlačidlo **×**. Vyžaduje sa potvrdenie. Podporuje sa viacnásobný výber.

| Hlásenie | Príčina |
|---|---|
| **The following HTML5 gateway is currently being used:** | Komponent HTML5 Gateway je pripojený k jednému alebo viacerým site. Pred odstránením ho treba odpojiť. Za správou nasledujú príslušné názvy a pri odstraňovaní viacerých položiek existuje variant v množnom čísle. |
| **Deletion failed for the following HTML5 gateway:** | Odstránenie zlyhalo na strane komponentu HTML5 Gateway. Za správou nasledujú názvy s chybou. |

---

## Chybové hlásenia pri ukladaní

| Hlásenie | Príčina |
|---|---|
| **This gateway already exists.** | Server HTML5 Gateway s týmto názvom už existuje. |
| **Invalid Name** | Server odmietol odoslaný názov. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Certifikát nemá očakávané CN. Správa uvádza nájdené a očakávané CN. |
| **Invalid certificate or private key password** | Zadaná prístupová fráza neotvorí certifikát. |
| **The given gateway is unreachable.** | Komponent HTML5 Gateway neodpovedá; operácia sa preruší. |
| **Actions on HTML5 gateways have been disabled.** | Správa serverov HTML5 Gateway je na platforme zakázaná: žiadna operácia neuspeje. |
