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

# HTML5 Gateways Management

Liostaíonn an modúl **HTML5 Gateways** na freastalaithe HTML5 Gateway atá fógartha ar an ardán agus ligeann sé duit iad a chur leis, a chur in eagar nó a bhaint. Láimhseálann freastalaí HTML5 Gateway seoladh na n-acmhainní atá inrochtana tríd an mbrabhsálaí (HTML5 RDP, HTML5 SSH, srl.), ag brath ar phrótacal HTTP nó WebSocket.

Tá an leathanach seo dírithe ar riarthóir nó ar chomhtháthóir a bhainistíonn cabhlach na gcomhpháirteanna HTML5 Gateway agus a bpéireáil. Is ón modúl **Sites** a shanntar comhpháirt HTML5 Gateway do [shuíomh](https://docs.cyberelements.io/bastion/4.6/ga/Usage/AdminConsoleReference/Sites/), ní ón modúl seo.

> **Rang teagaisc gaolmhar**
>
> Féach [Comhartha péireála a chruthú d'fhreastalaí Edge Gateway](https://docs.cyberelements.io/bastion/4.6/ga/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), a ndéanann a chluaisín **HTML5 Gateway** cur síos ar an nós imeachta agus ar an bhfoirm a bhfuiltear ag súil léi do CN an deimhnithe.

---

## Liosta na gcomhpháirteanna HTML5 Gateway

Osclaítear an modúl ar ghreille leathanaithe de na comhpháirteanna HTML5 Gateway cláraithe.

| Colún | Cur síos |
|---|---|
| **Name** | Ainm na comhpháirte HTML5 Gateway, agus roimhe deilbhín a léiríonn a staid cheangail (ar líne, as líne, ag fanacht le péireáil). |
| **URL** | An URL poiblí a nochtann an chomhpháirt HTML5 Gateway. |
| **Description** | Cur síos saor a iontráladh ag am an chruthaithe. |
| **Sites** | Na suíomhanna a bhfuil an chomhpháirt HTML5 Gateway ceangailte leo. |
| **Protocol** | An prótacal a úsáideann an chomhpháirt HTML5 Gateway: **HTTP** nó **WebSocket**. |
| **Version** | Leagan na comhpháirte HTML5 Gateway. Nuair atá cás máistir agus cás cúltaca ann, taispeántar an dá leagan ar dhá líne. |

Gníomhartha atá ar fáil sa bharra uirlisí:

| Gníomh | Cur síos |
|---|---|
| **+** (Cuir leis) | Osclaíonn sé an fhuinneog **Add HTML5 Gateway**. |
| **Edit** | Osclaíonn sé an fhuinneog **Edit HTML5 Gateway** don chomhpháirt HTML5 Gateway roghnaithe. Spreagtar é freisin le déchliceáil. |
| **×** (Scrios) | Scriosann sé na comhpháirteanna HTML5 Gateway roghnaithe tar éis duit é a dheimhniú. Tacaítear le roghnú iolrach. |
| **Search** | Scagann sé ar fhotheaghrán den ainm, 700 ms tar éis an bhuille eochrach dheireanaigh (nó láithreach le `Enter`). |
| **Pagination** | 15, 25 nó 50 ró in aghaidh an leathanaigh. |

---

## Cuir comhpháirt HTML5 Gateway leis

Osclaíonn an cnaipe **+** an fhuinneog **Add HTML5 Gateway**.

### Faisnéis ghinearálta

| Réimse | Cur síos |
|---|---|
| **Name** | Éigeantach, 50 carachtar ar a mhéad. Carachtair cheadaithe: litreacha gan aiceann, digití, `é`, `è`, `à`, `ô`, `â`, lúibíní, spás, `-`, `/`, `.` agus `_`. |
| **URL** | Éigeantach. An URL poiblí den chomhpháirt Edge Gateway, mar atá sé cumraithe ina comhad `commonParameters.conf`. |
| **Description** | Téacs saor. |
| **Protocol** | An prótacal a úsáidtear chun cumarsáid a dhéanamh leis an gcomhpháirt HTML5 Gateway: **HTTP** (luach réamhshocraithe) nó **WebSocket**. |

### Paring Token

Nochtann an ticbhosca **Create a pairing token** an rannán **Paring Token**, atá i bhfolach de réir réamhshocraithe.

| Réimse | Cur síos |
|---|---|
| **SSL certificate** | Deimhniú an gheata atá le huaslódáil. Socraíonn liosta anuas an fhormáid a bhfuiltear ag súil léi — `pkcs12` (réamhshocrú) nó `pem` — agus ní ghlacann roghnóir an chomhaid ach leis an iarmhír chomhfhreagrach ansin, `.p12` nó `.pem`. |
| **Certificate or private key password** | Pasfhrása an deimhnithe, más infheidhme. |
| **Pairing key validity period** | An dáta agus an t-am nach féidir an comhartha a úsáid ina dhiaidh. Réamhshocrú: inniu + 7 lá, san fhormáid `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | An seoladh IP poiblí óna bhfuil cead ag an bhfreastalaí HTML5 Gateway péireáil. Is é seo an seoladh mar a fheiceann an freastalaí Mediation Controller é: taobh thiar de NAT, iontráil an seoladh poiblí. |

> **Díghlasálann an deimhniú an dá réimse dheireanacha**
>
> Fanann **Pairing key validity period** agus **IP authorized to use the token** **neamhghníomhach** fad nach bhfuil comhad deimhnithe bailí roghnaithe. Dá bhrí sin, fágann comhad nach dtagann a iarmhír leis an bhformáid roghnaithe neamhghníomhach iad — go dtí go soláthraítear comhad comhlíontach.

Sábhálann an cnaipe **Validate** an freastalaí HTML5 Gateway. Má ghineann an sábháil comhartha péireála, osclaítear fuinneog **Paring Token**, a thaispeánann an eochair agus a deir go bhfuil sí **le húsáid nuair a bheidh an geata á shuiteáil**. Dúntar í le **Close**: ní mór an eochair a chóipeáil ón bhfuinneog.

---

## Cuir comhpháirt HTML5 Gateway in eagar

Roghnaigh comhpháirt HTML5 Gateway sa liosta agus cliceáil an deilbhín **Properties** (nó déchliceáil an ró). Tá an fhuinneog **Edit HTML5 Gateway** réamhlíonta leis an gcumraíocht reatha.

Is iad na réimsí céanna iad agus a bhí ag an gcruthú, an **Name** san áireamh, ar féidir é a chur in eagar i gcónaí. Bíonn feidhm ag na rialacha seo a leanas freisin:

- ní féidir **Pairing key validity period** agus **IP authorized to use the token** a athrú ach ar fhreastalaí HTML5 Gateway atá **ag fanacht le péireáil**;
- taispeántar réimse **Authentication Token**, inléite amháin, ar fhreastalaí HTML5 Gateway atá ag fanacht le péireáil.

---

## Scrios comhpháirt HTML5 Gateway

Roghnaigh comhpháirt HTML5 Gateway amháin nó níos mó agus cliceáil an cnaipe **×**. Iarrtar deimhniú. Tacaítear le roghnú iolrach.

| Teachtaireacht | Bunús |
|---|---|
| **The following HTML5 gateway is currently being used:** | Tá an chomhpháirt HTML5 Gateway ceangailte le suíomh amháin nó níos mó. Ní mór í a dhícheangal roimh an scriosadh. Tagann na hainmneacha lena mbaineann i ndiaidh na teachtaireachta, agus tá leagan iolra ann le haghaidh scriosadh iolrach. |
| **Deletion failed for the following HTML5 gateway:** | Theip ar an scriosadh ar thaobh na comhpháirte HTML5 Gateway. Tagann na hainmneacha a bhfuil earráid leo i ndiaidh na teachtaireachta. |

---

## Teachtaireachtaí earráide le linn sábhála

| Teachtaireacht | Bunús |
|---|---|
| **This gateway already exists.** | Tá an t-ainm sin ar chomhpháirt HTML5 Gateway eile cheana. |
| **Invalid Name** | Dhiúltaigh an freastalaí don ainm a cuireadh isteach. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Níl an CN a bhfuiltear ag súil leis ar an deimhniú. Tugann an teachtaireacht an CN a aimsíodh agus an ceann a bhfuiltear ag súil leis. |
| **Invalid certificate or private key password** | Ní osclaíonn an pasfhrása a tugadh an deimhniú. |
| **The given gateway is unreachable.** | Ní fhreagraíonn an chomhpháirt HTML5 Gateway; tréigtear an oibríocht. |
| **Actions on HTML5 gateways have been disabled.** | Tá bainistiú na gcomhpháirteanna HTML5 Gateway díchumasaithe ar an ardán: ní éiríonn le hoibríocht ar bith. |
