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

# HTML5 Gateways Management

Il-modulu **HTML5 Gateways** jelenka l-komponenti HTML5 Gateway iddikjarati fuq il-pjattaforma u jagħtik il-possibbiltà li żżidhom, teditjahom jew tneħħihom. Komponent HTML5 Gateway jieħu ħsieb it-tnedija tar-riżorsi li jintlaħqu permezz tal-browser (HTML5 RDP, HTML5 SSH, eċċ.), billi jserraħ fuq protokoll HTTP jew WebSocket.

Din il-paġna hija mmirata għal amministratur jew integratur li jimmaniġġja l-flotta ta’ komponenti HTML5 Gateway u l-pairing tagħhom. L-assenjazzjoni ta’ komponent HTML5 Gateway lil [sit](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/Sites/) issir mill-modulu **Sites**, mhux minn dan.

> **Gwida relatata**
>
> Ara [Oħloq token tal-pairing għal komponent Edge Gateway](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), li t-tab **HTML5 Gateway** tiegħu tispjega fid-dettall il-proċedura u l-forma mistennija tas-CN taċ-ċertifikat.

---

## Lista tal-komponenti HTML5 Gateway

Il-modulu jiftaħ fuq grilja paġnata tal-komponenti HTML5 Gateway iddikjarati.

| Kolonna | Deskrizzjoni |
|---|---|
| **Name** | L-isem tal-komponent HTML5 Gateway, preċedut minn ikona li turi l-istat tal-konnessjoni tiegħu (online, offline, jistenna l-pairing). |
| **URL** | L-URL pubbliku espost mill-komponent HTML5 Gateway. |
| **Description** | Deskrizzjoni libera mdaħħla mal-ħolqien. |
| **Sites** | Is-siti li magħhom huwa marbut il-komponent HTML5 Gateway. |
| **Protocol** | Il-protokoll użat mill-komponent HTML5 Gateway: **HTTP** jew **WebSocket**. |
| **Version** | Il-verżjoni tal-komponent HTML5 Gateway. Meta jeżistu istanza master u istanza ta’ riżerva, iż-żewġ verżjonijiet jintwerew fuq żewġ linji. |

Azzjonijiet disponibbli fl-istrixxa tal-għodod:

| Azzjoni | Deskrizzjoni |
|---|---|
| **+** (żid) | Jiftaħ it-tieqa **Add HTML5 Gateway**. |
| **Edit** | Jiftaħ it-tieqa **Edit HTML5 Gateway** għall-komponent HTML5 Gateway magħżul. Jitnieda wkoll b’klikk doppju. |
| **×** (ħassar) | Iħassar il-komponenti HTML5 Gateway magħżula wara konferma. L-għażla multipla hija appoġġjata. |
| **Search** | Jiffiltra fuq parti mill-isem, 700 ms wara l-aħħar tasta (jew immedjatament b’`Enter`). |
| **Paġnazzjoni** | 15, 25 jew 50 ringiela għal kull paġna. |

---

## Żid komponent HTML5 Gateway

Il-buttuna **+** tiftaħ it-tieqa **Add HTML5 Gateway**.

### Informazzjoni ġenerali

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Obbligatorju, 50 karattru l-aktar. Karattri permessi: ittri mingħajr aċċent, ċifri, `é`, `è`, `à`, `ô`, `â`, parentesi, spazju, `-`, `/`, `.` u `_`. |
| **URL** | Obbligatorju. L-URL pubbliku tal-komponent Edge Gateway, kif ikkonfigurat fil-fajl `commonParameters.conf` tiegħu. |
| **Description** | Test liberu. |
| **Protocol** | Il-protokoll użat biex jikkomunika mal-komponent HTML5 Gateway: **HTTP** (valur default) jew **WebSocket**. |

### Paring Token

Il-kaxxa ta’ selezzjoni **Create a pairing token** turi t-taqsima **Paring Token**, moħbija b’mod default.

| Qasam | Deskrizzjoni |
|---|---|
| **SSL certificate** | Ċertifikat tal-gateway li għandu jittella’. Lista drop-down tistabbilixxi l-format mistenni — `pkcs12` (default) jew `pem` — u s-selettur tal-fajls imbagħad jaċċetta biss l-estensjoni korrispondenti, `.p12` jew `.pem`. |
| **Certificate or private key password** | Frażi ta’ aċċess taċ-ċertifikat, fejn applikabbli. |
| **Pairing key validity period** | Id-data u l-ħin li warajhom it-token ma jkunx jista’ jintuża aktar. Default: illum + 7 ijiem, fil-format `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Indirizz IP pubbliku li minnu l-komponent HTML5 Gateway jista’ jagħmel il-pairing. Dan huwa l-indirizz kif jarah il-komponent Mediation Controller: wara NAT, daħħal l-indirizz pubbliku. |

> **L-aħħar żewġ oqsma jiġu żblukkati miċ-ċertifikat**
>
> **Pairing key validity period** u **IP authorized to use the token** jibqgħu **inattivi** sakemm ma jkunx intgħażel fajl ta’ ċertifikat validu. Għalhekk, fajl li l-estensjoni tiegħu ma taqbilx mal-format magħżul iħallihom inattivi — sakemm jiġi pprovdut fajl konformi.

Il-buttuna **Validate** tissejvja l-komponent HTML5 Gateway. Jekk is-salvataġġ jipproduċi token tal-pairing, tinfetaħ tieqa **Paring Token**, li turi ċ-ċavetta u tindika li hija **biex tintuża meta jiġi installat il-gateway**. Tingħalaq bil-buttuna **Close**: iċ-ċavetta trid tiġi kkupjata mit-tieqa.

---

## Editja komponent HTML5 Gateway

Agħżel komponent HTML5 Gateway fil-lista u kklikkja l-ikona **Properties** (jew agħmel klikk doppju fuq ir-ringiela). It-tieqa **Edit HTML5 Gateway** tkun mimlija minn qabel bil-konfigurazzjoni attwali.

L-oqsma huma l-istess bħal fil-ħolqien, inkluż il-qasam **Name**, li jibqa’ editjabbli. Barra minn hekk, japplikaw ir-regoli li ġejjin:

- **Pairing key validity period** u **IP authorized to use the token** jistgħu jinbidlu biss fuq komponent HTML5 Gateway **li qed jistenna l-pairing**;
- qasam **Authentication Token**, li jinqara biss, jidher fuq komponent HTML5 Gateway li qed jistenna l-pairing.

---

## Ħassar komponent HTML5 Gateway

Agħżel komponent HTML5 Gateway wieħed jew aktar u kklikkja l-buttuna **×**. Tintalab konferma. L-għażla multipla hija appoġġjata.

| Messaġġ | Kawża |
|---|---|
| **The following HTML5 gateway is currently being used:** | Il-komponent HTML5 Gateway huwa marbut ma’ sit wieħed jew aktar. Irid jiġi mneħħi minnhom qabel it-tħassir. L-ismijiet ikkonċernati jiġu wara l-messaġġ, u jeżisti varjant fil-plural għal tħassir multiplu. |
| **Deletion failed for the following HTML5 gateway:** | It-tħassir falla min-naħa tal-komponent HTML5 Gateway. L-ismijiet bl-iżball jiġu wara l-messaġġ. |

---

## Messaġġi ta’ żball mas-salvataġġ

| Messaġġ | Kawża |
|---|---|
| **This gateway already exists.** | Diġà jeżisti komponent HTML5 Gateway b’dak l-isem. |
| **Invalid Name** | L-isem sottomess ġie rrifjutat mis-server. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Iċ-ċertifikat ma fihx is-CN mistenni. Il-messaġġ jagħti s-CN misjub u dak mistenni. |
| **Invalid certificate or private key password** | Il-frażi ta’ aċċess ipprovduta ma tiftaħx iċ-ċertifikat. |
| **The given gateway is unreachable.** | Il-komponent HTML5 Gateway ma jwiġibx; l-operazzjoni tiġi abbandunata. |
| **Actions on HTML5 gateways have been disabled.** | Il-ġestjoni tal-komponenti HTML5 Gateway hija diżattivata fuq il-pjattaforma: l-ebda operazzjoni ma tirnexxi. |
