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

# HTML5 Gateways Management

Modulen **HTML5 Gateways** lister opp HTML5 Gateway-ene som er deklarert på plattformen, og gjør det mulig å legge til, redigere eller fjerne dem. En HTML5 Gateway håndterer starten av ressursene som er tilgjengelige via nettleseren (HTML5 RDP, HTML5 SSH osv.), og støtter seg på en HTTP- eller WebSocket-protokoll.

Denne siden retter seg mot en administrator eller en integrator som forvalter parken av HTML5 Gateways og pairingen deres. Tilordningen av en HTML5 Gateway til et [site](https://docs.cyberelements.io/bastion/4.6/no/Usage/AdminConsoleReference/Sites/) gjøres fra modulen **Sites**, ikke fra denne.

> **Tilhørende veiledning**
>
> Se [Opprette et pairing-token for en Edge Gateway](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), der fanen **HTML5 Gateway** beskriver prosedyren og den forventede formen på CN i sertifikatet.

---

## Liste over HTML5 Gateways

Modulen åpnes med en paginert tabell over de deklarerte HTML5 Gateways.

| Kolonne | Beskrivelse |
|---|---|
| **Name** | Navn på HTML5 Gateway, innledet av et ikon som gjenspeiler tilkoblingsstatusen (online, offline, venter på pairing). |
| **URL** | Offentlig URL som eksponeres av HTML5 Gateway. |
| **Description** | Fri beskrivelse som er skrevet inn ved opprettelsen. |
| **Sites** | Sitene HTML5 Gateway er tilknyttet. |
| **Protocol** | Protokollen som brukes av HTML5 Gateway: **HTTP** eller **WebSocket**. |
| **Version** | Versjonen av HTML5 Gateway. Når det finnes en master- og en backup-instans, vises begge versjonene på to linjer. |

Handlinger som er tilgjengelige i verktøyraden:

| Handling | Beskrivelse |
|---|---|
| **+** (Legg til) | Åpner vinduet **Add HTML5 Gateway**. |
| **Edit** | Åpner vinduet **Edit HTML5 Gateway** for den valgte HTML5 Gateway. Utløses også av et dobbeltklikk. |
| **×** (Slett) | Sletter de valgte HTML5 Gateways etter bekreftelse. Flervalg er mulig. |
| **Search** | Filtrerer på en delstreng av navnet, 700 ms etter siste tastetrykk (eller umiddelbart med `Enter`). |
| **Pagination** | 15, 25 eller 50 rader per side. |

---

## Legge til en HTML5 Gateway

Knappen **+** åpner vinduet **Add HTML5 Gateway**.

### Generell informasjon

| Felt | Beskrivelse |
|---|---|
| **Name** | Obligatorisk, høyst 50 tegn. Tillatte tegn: bokstaver uten aksent, siffer, `é`, `è`, `à`, `ô`, `â`, parenteser, mellomrom, `-`, `/`, `.` og `_`. |
| **URL** | Obligatorisk. Offentlig URL til Edge Gateway, slik den er konfigurert i filen `commonParameters.conf`. |
| **Description** | Fri tekst. |
| **Protocol** | Protokollen som brukes for å kommunisere med HTML5 Gateway: **HTTP** (standardverdi) eller **WebSocket**. |

### Paring Token

Avkrysningsboksen **Create a pairing token** viser delen **Paring Token**, som er skjult som standard.

| Felt | Beskrivelse |
|---|---|
| **SSL certificate** | Gateway-sertifikatet som skal lastes opp. En nedtrekksliste angir det forventede formatet — `pkcs12` (standard) eller `pem` — og filvelgeren godtar deretter bare den tilsvarende filendelsen, `.p12` eller `.pem`. |
| **Certificate or private key password** | Passfrasen til sertifikatet, der det er relevant. |
| **Pairing key validity period** | Dato og klokkeslett for når tokenet ikke lenger kan brukes. Standard: i dag + 7 dager, i formatet `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Offentlig IP-adresse som HTML5 Gateway har lov til å utføre pairing fra. Det er adressen slik Mediation Controller ser den: bak en NAT skriver du inn den offentlige adressen. |

> **De to siste feltene låses opp av sertifikatet**
>
> **Pairing key validity period** og **IP authorized to use the token** forblir **inaktive** så lenge det ikke er valgt en gyldig sertifikatfil. En fil med en filendelse som ikke svarer til det valgte formatet, lar dem derfor være inaktive — helt til det leveres en fil som samsvarer.

Knappen **Validate** lagrer HTML5 Gateway. Hvis lagringen gir et pairing-token, åpnes vinduet **Paring Token**, som viser nøkkelen og angir at den skal **brukes ved installasjon av gatewayen**. Det lukkes med **Close**: nøkkelen må kopieres fra vinduet.

---

## Endre en HTML5 Gateway

Velg en HTML5 Gateway i listen og klikk på ikonet **Properties** (eller dobbeltklikk på raden). Vinduet **Edit HTML5 Gateway** er forhåndsutfylt med den gjeldende konfigurasjonen.

Feltene er de samme som ved opprettelsen, inkludert **Name**, som fortsatt kan redigeres. I tillegg gjelder følgende regler:

- **Pairing key validity period** og **IP authorized to use the token** kan bare endres på en HTML5 Gateway som **venter på pairing**;
- et felt **Authentication Token**, skrivebeskyttet, vises på en HTML5 Gateway som venter på pairing.

---

## Slette en HTML5 Gateway

Velg én eller flere HTML5 Gateways og klikk på knappen **×**. Det kreves en bekreftelse. Flervalg er mulig.

| Melding | Årsak |
|---|---|
| **The following HTML5 gateway is currently being used:** | HTML5 Gateway er tilknyttet ett eller flere siter. Den må kobles fra før sletting. Navnene det gjelder, følger etter meldingen, og det finnes en flertallsvariant for en sletting av flere. |
| **Deletion failed for the following HTML5 gateway:** | Slettingen mislyktes på HTML5 Gateway-siden. Navnene med feil følger etter meldingen. |

---

## Feilmeldinger ved lagring

| Melding | Årsak |
|---|---|
| **This gateway already exists.** | En HTML5 Gateway bærer allerede dette navnet. |
| **Invalid Name** | Navnet som ble sendt inn, ble avvist av serveren. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Sertifikatet har ikke den forventede CN-en. Meldingen oppgir CN-en som ble funnet, og den som var forventet. |
| **Invalid certificate or private key password** | Passordfrasen som er oppgitt, åpner ikke sertifikatet. |
| **The given gateway is unreachable.** | HTML5 Gateway svarer ikke; operasjonen avbrytes. |
| **Actions on HTML5 gateways have been disabled.** | Forvaltningen av HTML5 Gateways er deaktivert på plattformen: ingen operasjon lykkes. |
