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

# HTML5 Gateways Management

Модулът **HTML5 Gateways** изброява сървърите HTML5 Gateway, декларирани в платформата, и ви позволява да ги добавяте, редактирате или премахвате. Сървърът HTML5 Gateway обработва стартирането на ресурси, достъпни чрез браузъра (HTML5 RDP, HTML5 SSH и т.н.), като разчита на протокол HTTP или WebSocket.

Тази страница е предназначена за администратор или интегратор, който управлява парка от компоненти HTML5 Gateway и тяхното сдвояване. Присвояването на компонент HTML5 Gateway към [сайт](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/Sites/) се извършва от модула **Sites**, а не от този модул.

> **Свързан урок**
>
> Вижте [Създаване на маркер за сдвояване за Edge Gateway](https://docs.cyberelements.io/bastion/4.6/bg/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), чийто раздел **HTML5 Gateway** описва подробно процедурата и очаквания вид на CN на сертификата.

---

## Списък на компонентите HTML5 Gateway

Модулът се отваря с разделена на страници таблица на декларираните компоненти HTML5 Gateway.

| Колона | Описание |
|---|---|
| **Name** | Име на компонента HTML5 Gateway, предшествано от икона, която отразява състоянието на връзката му (онлайн, офлайн, в очакване на сдвояване). |
| **URL** | Публичен URL адрес, предоставен от компонента HTML5 Gateway. |
| **Description** | Свободно описание, въведено при създаването. |
| **Sites** | Сайтовете, с които е свързан компонентът HTML5 Gateway. |
| **Protocol** | Протокол, използван от компонента HTML5 Gateway: **HTTP** или **WebSocket**. |
| **Version** | Версия на компонента HTML5 Gateway. Когато съществуват основен и резервен екземпляр, двете версии се показват на два реда. |

Действия, налични в лентата с инструменти:

| Действие | Описание |
|---|---|
| **+** (Add) | Отваря прозореца **Add HTML5 Gateway**. |
| **Edit** | Отваря прозореца **Edit HTML5 Gateway** за избрания компонент HTML5 Gateway. Задейства се и с двукратно щракване. |
| **×** (Delete) | Изтрива избраните компоненти HTML5 Gateway след потвърждение. Поддържа се множествен избор. |
| **Search** | Филтрира по подниз от името 700 мс след последното натискане на клавиш (или незабавно с `Enter`). |
| **Pagination** | 15, 25 или 50 реда на страница. |

---

## Добавяне на компонент HTML5 Gateway

Бутонът **+** отваря прозореца **Add HTML5 Gateway**.

### Обща информация

| Поле | Описание |
|---|---|
| **Name** | Задължително, най-много 50 знака. Разрешени знаци: букви без диакритични знаци, цифри, `é`, `è`, `à`, `ô`, `â`, скоби, интервал, `-`, `/`, `.` и `_`. |
| **URL** | Задължително. Публичен URL адрес на компонента Edge Gateway, както е конфигуриран във файла му `commonParameters.conf`. |
| **Description** | Свободен текст. |
| **Protocol** | Протокол, използван за комуникация с компонента HTML5 Gateway: **HTTP** (стойност по подразбиране) или **WebSocket**. |

### Paring Token

Квадратчето за отметка **Create a pairing token** показва секцията **Paring Token**, която по подразбиране е скрита.

| Поле | Описание |
|---|---|
| **SSL certificate** | Сертификат на шлюза за качване. Падащ списък задава очаквания формат – `pkcs12` (по подразбиране) или `pem` – и след това селекторът на файлове приема само съответното разширение, `.p12` или `.pem`. |
| **Certificate or private key password** | Парола фраза на сертификата, ако е приложимо. |
| **Pairing key validity period** | Дата и час, след които маркерът вече не може да се използва. По подразбиране: днес + 7 дни, във формат `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Публичен IP адрес, от който на сървъра HTML5 Gateway е разрешено да извърши сдвояване. Това е адресът, както го вижда Mediation Controller: зад NAT въведете публичния адрес. |

> **Последните две полета се отключват от сертификата**
>
> **Pairing key validity period** и **IP authorized to use the token** остават **неактивни**, докато не бъде избран валиден файл със сертификат. Следователно файл, чието разширение не съответства на избрания формат, ги оставя неактивни – докато не бъде предоставен съответстващ файл.

Бутонът **Validate** записва сървъра HTML5 Gateway. Ако при записването се генерира маркер за сдвояване, се отваря прозорец **Paring Token**, който показва ключа и посочва, че той е **за използване при инсталирането на шлюза**. Прозорецът се затваря с **Close**: ключът трябва да бъде копиран от прозореца.

---

## Редактиране на компонент HTML5 Gateway

Изберете компонент HTML5 Gateway в списъка и щракнете върху иконата **Properties** (или щракнете двукратно върху реда). Прозорецът **Edit HTML5 Gateway** е предварително попълнен с текущата конфигурация.

Полетата са същите като при създаването, включително полето **Name**, което остава редактируемо. Освен това се прилагат следните правила:

- **Pairing key validity period** и **IP authorized to use the token** могат да се променят само при сървър HTML5 Gateway, който **чака сдвояване**;
- поле **Authentication Token**, само за четене, се показва при сървър HTML5 Gateway, който чака сдвояване.

---

## Изтриване на компонент HTML5 Gateway

Изберете един или няколко компонента HTML5 Gateway и щракнете върху бутона **×**. Изисква се потвърждение. Поддържа се множествен избор.

| Съобщение | Причина |
|---|---|
| **The following HTML5 gateway is currently being used:** | Компонентът HTML5 Gateway е свързан с един или няколко сайта. Той трябва да бъде откачен преди изтриването. Имената, за които става дума, следват съобщението, а при изтриване на няколко компонента съществува вариант в множествено число. |
| **Deletion failed for the following HTML5 gateway:** | Изтриването е неуспешно от страната на компонента HTML5 Gateway. Имената с грешка следват съобщението. |

---

## Съобщения за грешки при записване

| Съобщение | Причина |
|---|---|
| **This gateway already exists.** | Вече съществува компонент HTML5 Gateway с това име. |
| **Invalid Name** | Изпратеното име е отхвърлено от сървъра. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Сертификатът не съдържа очаквания CN. Съобщението посочва намерения и очаквания CN. |
| **Invalid certificate or private key password** | Предоставената парола фраза не отваря сертификата. |
| **The given gateway is unreachable.** | Компонентът HTML5 Gateway не отговаря; операцията се прекратява. |
| **Actions on HTML5 gateways have been disabled.** | Управлението на компонентите HTML5 Gateway е деактивирано на платформата: нито една операция не е успешна. |
