HTML5 Gateways Management¶
De module HTML5 Gateways toont de HTML5 Gateways die op het platform zijn gedeclareerd en maakt het mogelijk die toe te voegen, te wijzigen of te verwijderen. Een HTML5 Gateway verzorgt het starten van resources die via de browser bereikbaar zijn (HTML5 RDP, HTML5 SSH enz.), op basis van een HTTP- of WebSocket-protocol.
Deze pagina is bedoeld voor een beheerder of een integrator die het park aan HTML5 Gateways en de pairing daarvan beheert. Een HTML5 Gateway aan een site toewijzen gebeurt vanuit de module Sites, niet vanuit deze module.
Verwante tutorial
Zie Een pairing-token aanmaken voor een Edge Gateway, waarvan het tabblad HTML5 Gateway de procedure en de verwachte vorm van de CN van het certificaat beschrijft.
Lijst met HTML5 Gateways¶
De module opent op een gepagineerde tabel met de gedeclareerde HTML5 Gateways.
| Kolom | Beschrijving |
|---|---|
| Name | Naam van de Edge Gateway, voorafgegaan door een pictogram dat de verbindingsstatus weergeeft (online, offline, wacht op pairing). |
| URL | Openbare URL die door de Edge Gateway wordt blootgesteld. |
| Description | Vrije beschrijving die bij het aanmaken is ingevoerd. |
| Sites | Sites waaraan de HTML5 Gateway is gekoppeld. |
| Protocol | Protocol dat door de Edge Gateway wordt gebruikt: HTTP of WebSocket. |
| Version | Versie van de Edge Gateway. Wanneer er een master- en een back-upinstantie bestaan, worden beide versies op twee regels weergegeven. |
Beschikbare acties in de werkbalk:
| Actie | Beschrijving |
|---|---|
| + (Add) | Opent het venster Add HTML5 Gateway. |
| Edit | Opent het venster Edit HTML5 Gateway voor de geselecteerde Edge Gateway. Wordt ook door een dubbelklik geactiveerd. |
| × (Delete) | Verwijdert de geselecteerde Edge Gateways na bevestiging. Meervoudige selectie is mogelijk. |
| Search | Filtert op een deel van de naam, 700 ms na de laatste toetsaanslag (of onmiddellijk met Enter). |
| Pagination | 15, 25 of 50 rijen per pagina. |
Een HTML5 Gateway toevoegen¶
Met de knop + opent u het venster Add HTML5 Gateway.
Algemene informatie¶
| Veld | Beschrijving |
|---|---|
| Name | Verplicht, maximaal 50 tekens. Toegestane tekens: letters zonder accent, cijfers, é, è, à, ô, â, haakjes, spatie, -, /, . en _. |
| URL | Verplicht. Openbare URL van de Edge Gateway, zoals die in het bestand commonParameters.conf ervan is geconfigureerd. |
| Description | Vrije tekst. |
| Protocol | Protocol dat wordt gebruikt om met de Edge Gateway te communiceren: HTTP (standaardwaarde) of WebSocket. |
Paring Token¶
Het selectievakje Create a pairing token toont de sectie Paring Token, die standaard verborgen is.
| Veld | Beschrijving |
|---|---|
| SSL certificate | Certificaat van de gateway dat moet worden geüpload. Een vervolgkeuzelijst bepaalt het verwachte formaat — pkcs12 (standaard) of pem — en de bestandskiezer aanvaardt dan alleen de bijbehorende extensie, .p12 of .pem. |
| Certificate or private key password | Wachtwoordzin van het certificaat, indien van toepassing. |
| Pairing key validity period | Datum en tijd waarna het token niet meer kan worden gebruikt. Standaard: vandaag + 7 dagen, opgemaakt als DD/MM/YYYY HH:MM. |
| IP authorized to use the token | Openbaar IP-adres waarvandaan de Edge Gateway mag pairen. Dit is het adres zoals de Mediation Controller het ziet: achter een NAT voert u het openbare adres in. |
De laatste twee velden worden door het certificaat vrijgegeven
Pairing key validity period en IP authorized to use the token blijven inactief zolang er geen geldig certificaatbestand is gekozen. Een bestand waarvan de extensie niet overeenkomt met het geselecteerde formaat laat ze dus inactief — totdat een conform bestand wordt geleverd.
Met de knop Validate wordt de Edge Gateway opgeslagen. Als het opslaan een pairing-token oplevert, opent er een venster Paring Token dat de sleutel weergeeft en aangeeft dat die moet worden gebruikt bij de installatie van de gateway. Het wordt gesloten met Close: de sleutel moet uit het venster worden gekopieerd.
Een HTML5 Gateway wijzigen¶
Selecteer een Edge Gateway in de lijst en klik op het pictogram Properties (of dubbelklik op de rij). Het venster Edit HTML5 Gateway is vooraf gevuld met de huidige configuratie.
De velden zijn dezelfde als bij het aanmaken, inclusief Name, dat bewerkbaar blijft. Daarnaast gelden de volgende regels:
- Pairing key validity period en IP authorized to use the token kunnen alleen worden gewijzigd bij een Edge Gateway die op pairing wacht;
- een veld Authentication Token, alleen-lezen, verschijnt op een Edge Gateway die op de pairing wacht.
Een HTML5 Gateway verwijderen¶
Selecteer een of meer Edge Gateways en klik op de knop ×. Er wordt om bevestiging gevraagd. Meervoudige selectie is mogelijk.
| Melding | Oorzaak |
|---|---|
| The following HTML5 gateway is currently being used: | De Edge Gateway is aan een of meer sites gekoppeld. Die moet worden ontkoppeld voordat die kan worden verwijderd. De betrokken namen volgen op de melding, en er bestaat een meervoudsvariant voor een meervoudige verwijdering. |
| Deletion failed for the following HTML5 gateway: | Het verwijderen is aan de kant van de Edge Gateway mislukt. De namen in fout volgen op de melding. |
Foutmeldingen bij het opslaan¶
| Melding | Oorzaak |
|---|---|
| This gateway already exists. | Een HTML5 Gateway draagt die naam al. |
| Invalid Name | De verzonden naam is door de server geweigerd. |
| The CN of the Edge Gateway certificate sent does not match the expected CN | Het certificaat draagt niet de verwachte CN. De melding geeft de gevonden CN en de verwachte CN. |
| Invalid certificate or private key password | De opgegeven wachtwoordzin opent het certificaat niet. |
| The given gateway is unreachable. | De Edge Gateway antwoordt niet; de bewerking wordt afgebroken. |
| Actions on HTML5 gateways have been disabled. | Het beheer van HTML5 Gateways is op het platform uitgeschakeld: geen enkele bewerking lukt. |