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

# HTML5 Gateways Management

**HTML5 Gateways** -moduuli luettelee alustalla ilmoitetut HTML5 Gateway -palvelimet ja mahdollistaa niiden lisäämisen, muokkaamisen tai poistamisen. HTML5 Gateway huolehtii selaimen kautta saavutettavien resurssien käynnistämisestä (HTML5 RDP, HTML5 SSH jne.) HTTP- tai WebSocket-protokollan avulla.

Tämä sivu on tarkoitettu ylläpitäjälle tai integroijalle, joka hallitsee HTML5 Gateway -palvelinkantaa ja sen pairingia. HTML5 Gateway -palvelimen liittäminen [site-kohdeon](https://docs.cyberelements.io/bastion/4.6/fi/Usage/AdminConsoleReference/Sites/) tehdään **Sites** -moduulissa, ei tässä.

> **Aiheeseen liittyvä opas**
>
> Katso [Pairing-tokenin luonti Edge Gateway -palvelimelle](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), jonka **HTML5 Gateway** -välilehti kuvaa menettelyn ja sertifikaatin CN:n odotetun muodon.

---

## HTML5 Gateway -palvelinten luettelo

Moduuli avautuu sivutettuun taulukkoon määritellyistä HTML5 Gateway -palvelimista.

| Sarake | Kuvaus |
|---|---|
| **Name** | HTML5 Gateway -palvelimen nimi, jonka edessä on sen yhteystilaa kuvaava kuvake (verkossa, ei verkossa, odottaa pairingia). |
| **URL** | HTML5 Gateway -palvelimen tarjoama julkinen URL-osoite. |
| **Description** | Luonnin yhteydessä kirjoitettu vapaa kuvaus. |
| **Sites** | Site-kohteet, joihin HTML5 Gateway -palvelin on liitetty. |
| **Protocol** | HTML5 Gateway -palvelimen käyttämä protokolla: **HTTP** tai **WebSocket**. |
| **Version** | HTML5 Gateway -palvelimen versio. Kun on olemassa sekä master- että backup-instanssi, kummankin versio näytetään kahdella rivillä. |

Työkalupalkissa käytettävissä olevat toiminnot:

| Toiminto | Kuvaus |
|---|---|
| **+** (Lisää) | Avaa **Add HTML5 Gateway** -ikkunan. |
| **Edit** | Avaa **Edit HTML5 Gateway** -ikkunan valitulle HTML5 Gateway -palvelimelle. Käynnistyy myös kaksoisnapsautuksella. |
| **×** (Poista) | Poistaa valitut HTML5 Gateway -palvelimet vahvistuksen jälkeen. Monivalinta on tuettu. |
| **Search** | Suodattaa nimen osamerkkijonon perusteella 700 ms viimeisen näppäinpainalluksen jälkeen (tai heti `Enter` -näppäimellä). |
| **Pagination** | 15, 25 tai 50 riviä sivulla. |

---

## HTML5 Gateway -palvelimen lisääminen

**+**-painike avaa **Add HTML5 Gateway** -ikkunan.

### Yleiset tiedot

| Kenttä | Kuvaus |
|---|---|
| **Name** | Pakollinen, enintään 50 merkkiä. Sallitut merkit: aksentittomat kirjaimet, numerot, `é`, `è`, `à`, `ô`, `â`, sulkeet, välilyönti, `-`, `/`, `.` ja `_`. |
| **URL** | Pakollinen. Edge Gateway -palvelimen julkinen URL-osoite sellaisena kuin se on määritetty sen `commonParameters.conf` -tiedostossa. |
| **Description** | Vapaa teksti. |
| **Protocol** | Protokolla, jolla viestitään HTML5 Gateway -palvelimen kanssa: **HTTP** (oletusarvo) tai **WebSocket**. |

### Paring Token

**Create a pairing token** -valintaruutu tuo näkyviin **Paring Token** -osion, joka on oletuksena piilotettu.

| Kenttä | Kuvaus |
|---|---|
| **SSL certificate** | Ladattava gateway-sertifikaatti. Pudotusvalikko määrittää odotetun muodon — `pkcs12` (oletus) tai `pem` — ja tiedostonvalitsin hyväksyy tämän jälkeen vain vastaavan tiedostopäätteen, `.p12` tai `.pem`. |
| **Certificate or private key password** | Sertifikaatin salasanalause, jos sellainen on. |
| **Pairing key validity period** | Päivämäärä ja kellonaika, joiden jälkeen tokenia ei voi enää käyttää. Oletus: tänään + 7 päivää, muodossa `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Julkinen IP-osoite, josta HTML5 Gateway -palvelin saa suorittaa pairingin. Kyseessä on osoite sellaisena kuin Mediation Controller -palvelin sen näkee: NAT:n takana anna julkinen osoite. |

> **Sertifikaatti avaa kaksi viimeistä kenttää**
>
> **Pairing key validity period** ja **IP authorized to use the token** pysyvät **passiivisina** niin kauan kuin kelvollista sertifikaattitiedostoa ei ole valittu. Tiedosto, jonka pääte ei vastaa valittua muotoa, jättää ne siis passiivisiksi — kunnes vaatimusten mukainen tiedosto on annettu.

**Validate** -painike tallentaa HTML5 Gateway -palvelimen. Jos tallennus tuottaa pairing-tokenin, avautuu **Paring Token** -ikkuna, joka näyttää avaimen ja ilmoittaa, että se on **käytettävä gateway-palvelimen asennuksessa**. Se suljetaan **Close** -painikkeella: avain on kopioitava ikkunasta.

---

## HTML5 Gateway -palvelimen muokkaaminen

Valitse HTML5 Gateway -palvelin luettelosta ja napsauta **Properties** -kuvaketta (tai kaksoisnapsauta riviä). **Edit HTML5 Gateway** -ikkuna on valmiiksi täytetty nykyisellä määrityksellä.

Kentät ovat samat kuin luonnissa, mukaan lukien **Name**, joka on edelleen muokattavissa. Lisäksi sovelletaan seuraavia sääntöjä:

- **Pairing key validity period** ja **IP authorized to use the token** voi muuttaa vain HTML5 Gateway -palvelimella, joka **odottaa pairingia**;
- HTML5 Gateway -palvelimella, joka odottaa pairingia, näkyy vain luettava **Authentication Token** -kenttä.

---

## HTML5 Gateway -palvelimen poistaminen

Valitse yksi tai useampi HTML5 Gateway -palvelin ja napsauta **×** -painiketta. Vahvistusta pyydetään. Monivalinta on tuettu.

| Ilmoitus | Aiheuttaja |
|---|---|
| **The following HTML5 gateway is currently being used:** | HTML5 Gateway -palvelin on liitetty yhteen tai useampaan site-kohteeseen. Se on irrotettava ennen poistamista. Kyseiset nimet seuraavat ilmoitusta, ja monikkomuoto on olemassa usean kohteen poistoa varten. |
| **Deletion failed for the following HTML5 gateway:** | Poistaminen epäonnistui HTML5 Gateway -palvelimen puolella. Virheelliset nimet seuraavat ilmoitusta. |

---

## Virheilmoitukset tallennuksen yhteydessä

| Ilmoitus | Aiheuttaja |
|---|---|
| **This gateway already exists.** | HTML5 Gateway -palvelimella on jo tämä nimi. |
| **Invalid Name** | Palvelin hylkäsi lähetetyn nimen. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Sertifikaatissa ei ole odotettua CN:ää. Ilmoitus kertoo löydetyn ja odotetun CN:n. |
| **Invalid certificate or private key password** | Annettu salalause ei avaa sertifikaattia. |
| **The given gateway is unreachable.** | HTML5 Gateway -palvelin ei vastaa; toimenpide keskeytetään. |
| **Actions on HTML5 gateways have been disabled.** | HTML5 Gateway -palvelinten hallinta on poistettu käytöstä alustalla: mikään toimenpide ei onnistu. |
