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

# HTML5 Gateways Management

Modul **HTML5 Gateways** zobrazuje seznam serverů HTML5 Gateway deklarovaných na platformě a umožňuje je přidávat, upravovat nebo odebírat. Server HTML5 Gateway zajišťuje spouštění prostředků dostupných přes prohlížeč (HTML5 RDP, HTML5 SSH atd.) a opírá se přitom o protokol HTTP nebo WebSocket.

Tato stránka je určena správci nebo integrátorovi, který spravuje servery HTML5 Gateway a jejich pairing. Přiřazení serveru HTML5 Gateway k [site](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/Sites/) se provádí z modulu **Sites**, nikoli z tohoto modulu.

> **Související kurz**
>
> Viz [Vytvoření tokenu pairingu pro server Edge Gateway](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), jehož karta **HTML5 Gateway** podrobně popisuje postup a očekávaný tvar CN certifikátu.

---

## Seznam serverů HTML5 Gateway

Modul se otevře stránkovanou tabulkou deklarovaných serverů HTML5 Gateway.

| Sloupec | Popis |
|---|---|
| **Name** | Název serveru HTML5 Gateway, před kterým je ikona odrážející stav jeho připojení (online, offline, čekání na pairing). |
| **URL** | Veřejná adresa URL zveřejněná serverem HTML5 Gateway. |
| **Description** | Volný popis zadaný při vytvoření. |
| **Sites** | Site, ke kterým je server HTML5 Gateway přiřazen. |
| **Protocol** | Protokol používaný serverem HTML5 Gateway: **HTTP** nebo **WebSocket**. |
| **Version** | Verze serveru HTML5 Gateway. Pokud existuje hlavní a záložní instance, zobrazí se obě verze na dvou řádcích. |

Akce dostupné na panelu nástrojů:

| Akce | Popis |
|---|---|
| **+** (Add) | Otevře okno **Add HTML5 Gateway**. |
| **Edit** | Otevře okno **Edit HTML5 Gateway** pro vybraný server HTML5 Gateway. Spouští se také dvojitým kliknutím. |
| **×** (Delete) | Po potvrzení odstraní vybrané servery HTML5 Gateway. Vícenásobný výběr je podporován. |
| **Search** | Filtruje podle podřetězce názvu, 700 ms po posledním stisknutí klávesy (nebo okamžitě klávesou `Enter`). |
| **Pagination** | 15, 25 nebo 50 řádků na stránku. |

---

## Přidání serveru HTML5 Gateway

Tlačítko **+** otevře okno **Add HTML5 Gateway**.

### Obecné informace

| Pole | Popis |
|---|---|
| **Name** | Povinné, nejvýše 50 znaků. Povolené znaky: písmena bez diakritiky, číslice, `é`, `è`, `à`, `ô`, `â`, závorky, mezera, `-`, `/`, `.` a `_`. |
| **URL** | Povinné. Veřejná adresa URL serveru Edge Gateway, jak je nakonfigurována v jeho souboru `commonParameters.conf`. |
| **Description** | Volný text. |
| **Protocol** | Protokol používaný ke komunikaci se serverem HTML5 Gateway: **HTTP** (výchozí hodnota) nebo **WebSocket**. |

### Paring Token

Zaškrtávací políčko **Create a pairing token** zobrazí oddíl **Paring Token**, který je ve výchozím nastavení skrytý.

| Pole | Popis |
|---|---|
| **SSL certificate** | Certifikát brány, který se má nahrát. Rozevírací seznam určuje očekávaný formát — `pkcs12` (výchozí) nebo `pem` — a výběr souboru pak přijímá pouze odpovídající příponu, `.p12` nebo `.pem`. |
| **Certificate or private key password** | Přístupové heslo certifikátu, pokud existuje. |
| **Pairing key validity period** | Datum a čas, po kterých již token nelze použít. Výchozí hodnota: dnešek + 7 dní ve formátu `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Veřejná IP adresa, ze které smí server HTML5 Gateway provést pairing. Jde o adresu, jak ji vidí služba Mediation Controller: za NAT zadejte veřejnou adresu. |

> **Poslední dvě pole odemyká certifikát**
>
> **Pairing key validity period** a **IP authorized to use the token** zůstávají **neaktivní**, dokud není vybrán platný soubor certifikátu. Soubor, jehož přípona neodpovídá vybranému formátu, je tedy ponechá neaktivní — dokud není poskytnut vyhovující soubor.

Tlačítko **Validate** uloží server HTML5 Gateway. Pokud uložení vytvoří token pairingu, otevře se okno **Paring Token**, které zobrazí klíč a uvede, že je **určen k použití při instalaci brány**. Zavírá se tlačítkem **Close**: klíč je nutné z okna zkopírovat.

---

## Úprava serveru HTML5 Gateway

Vyberte server HTML5 Gateway v seznamu a klikněte na ikonu **Properties** (nebo na řádek dvakrát klikněte). Okno **Edit HTML5 Gateway** je předvyplněno aktuální konfigurací.

Pole jsou stejná jako při vytváření, včetně pole **Name**, které zůstává upravitelné. Navíc platí následující pravidla:

- **Pairing key validity period** a **IP authorized to use the token** lze změnit pouze u serveru HTML5 Gateway, který **čeká na pairing**;
- na serveru HTML5 Gateway, který čeká na pairing, se zobrazí pole **Authentication Token** jen pro čtení.

---

## Odstranění serveru HTML5 Gateway

Vyberte jeden nebo více serverů HTML5 Gateway a klikněte na tlačítko **×**. Vyžaduje se potvrzení. Vícenásobný výběr je podporován.

| Zpráva | Příčina |
|---|---|
| **The following HTML5 gateway is currently being used:** | Server HTML5 Gateway je přiřazen k jednomu nebo více site. Před odstraněním je nutné jej odpojit. Za zprávou následují dotčené názvy a pro hromadné odstranění existuje varianta v množném čísle. |
| **Deletion failed for the following HTML5 gateway:** | Odstranění na straně serveru HTML5 Gateway selhalo. Za zprávou následují názvy, u kterých došlo k chybě. |

---

## Chybové zprávy při ukládání

| Zpráva | Příčina |
|---|---|
| **This gateway already exists.** | Server HTML5 Gateway s tímto názvem již existuje. |
| **Invalid Name** | Server odeslaný název odmítl. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Certifikát nenese očekávaný CN. Zpráva uvádí nalezený a očekávaný CN. |
| **Invalid certificate or private key password** | Zadané přístupové heslo certifikát neotevře. |
| **The given gateway is unreachable.** | Server HTML5 Gateway neodpovídá; operace se přeruší. |
| **Actions on HTML5 gateways have been disabled.** | Správa serverů HTML5 Gateway je na platformě zakázána: žádná operace neuspěje. |
