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

# HTML5 Gateways Management

O módulo **HTML5 Gateways** enumera os HTML5 Gateway declarados na plataforma e permite adicioná-los, editá-los ou removê-los. Um HTML5 Gateway encarrega-se do lançamento dos recursos acessíveis através do browser (HTML5 RDP, HTML5 SSH, etc.), baseando-se num protocolo HTTP ou WebSocket.

Esta página destina-se a um administrador ou a um integrador que gira o parque de HTML5 Gateway e o respetivo pairing. A atribuição de um HTML5 Gateway a um [site](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/Sites/) é feita a partir do módulo **Sites**, não deste.

> **Tutorial relacionado**
>
> Consulte [Criar um token de pairing para um Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), cujo separador **HTML5 Gateway** detalha o procedimento e a forma esperada do CN do certificado.

---

## Lista de HTML5 Gateway

O módulo abre numa grelha paginada dos HTML5 Gateway declarados.

| Coluna | Descrição |
|---|---|
| **Name** | Nome do HTML5 Gateway, precedido de um ícone que reflete o seu estado de ligação (em linha, fora de linha, à espera de pairing). |
| **URL** | URL pública exposta pelo HTML5 Gateway. |
| **Description** | Descrição livre introduzida na criação. |
| **Sites** | Sites a que o HTML5 Gateway está ligado. |
| **Protocol** | Protocolo utilizado pelo HTML5 Gateway: **HTTP** ou **WebSocket**. |
| **Version** | Versão do HTML5 Gateway. Quando existem uma instância principal e uma de reserva, são apresentadas ambas as versões em duas linhas. |

Ações disponíveis na barra de ferramentas:

| Ação | Descrição |
|---|---|
| **+** (adicionar) | Abre a janela **Add HTML5 Gateway**. |
| **Edit** | Abre a janela **Edit HTML5 Gateway** do HTML5 Gateway selecionado. Também é acionada por um duplo clique. |
| **×** (eliminar) | Elimina os HTML5 Gateway selecionados após confirmação. É permitida a seleção múltipla. |
| **Search** | Filtra por uma subcadeia do nome, 700 ms após a última tecla premida (ou imediatamente com `Enter`). |
| **Pagination** | 15, 25 ou 50 linhas por página. |

---

## Adicionar um HTML5 Gateway

O botão **+** abre a janela **Add HTML5 Gateway**.

### Informações gerais

| Campo | Descrição |
|---|---|
| **Name** | Obrigatório, 50 caracteres no máximo. Caracteres permitidos: letras sem acento, algarismos, `é`, `è`, `à`, `ô`, `â`, parênteses, espaço, `-`, `/`, `.` e `_`. |
| **URL** | Obrigatório. URL pública do Edge Gateway, tal como está configurada no seu ficheiro `commonParameters.conf`. |
| **Description** | Texto livre. |
| **Protocol** | Protocolo utilizado para comunicar com o HTML5 Gateway: **HTTP** (valor predefinido) ou **WebSocket**. |

### Paring Token

A caixa de verificação **Create a pairing token** revela a secção **Paring Token**, oculta por predefinição.

| Campo | Descrição |
|---|---|
| **SSL certificate** | Certificado do gateway a carregar. Uma lista suspensa define o formato esperado — `pkcs12` (predefinido) ou `pem` — e o seletor de ficheiros só aceita então a extensão correspondente, `.p12` ou `.pem`. |
| **Certificate or private key password** | Frase-passe do certificado, se aplicável. |
| **Pairing key validity period** | Data e hora a partir das quais o token já não pode ser utilizado. Predefinição: hoje + 7 dias, com o formato `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Endereço IP público a partir do qual o HTML5 Gateway está autorizado a fazer o pairing. Trata-se do endereço tal como é visto pelo Mediation Controller: atrás de um NAT, introduza o endereço público. |

> **Os dois últimos campos são desbloqueados pelo certificado**
>
> **Pairing key validity period** e **IP authorized to use the token** permanecem **inativos** enquanto não tiver sido escolhido um ficheiro de certificado válido. Um ficheiro cuja extensão não corresponda ao formato selecionado deixa-os, por isso, inativos — até que seja fornecido um ficheiro conforme.

O botão **Validate** guarda o HTML5 Gateway. Se essa operação produzir um token de pairing, abre-se uma janela **Paring Token** que apresenta a chave e indica que deve ser **utilizada na instalação do gateway**. Fecha-se com **Close**: a chave tem de ser copiada da janela.

---

## Modificar um HTML5 Gateway

Selecione um HTML5 Gateway na lista e clique no ícone **Properties** (ou faça duplo clique na linha). A janela **Edit HTML5 Gateway** vem pré-preenchida com a configuração atual.

Os campos são os mesmos que na criação, incluindo o **Name**, que continua editável. Aplicam-se além disso as regras seguintes:

- **Pairing key validity period** e **IP authorized to use the token** só podem ser alterados num HTML5 Gateway **à espera de pairing**;
- um campo **Authentication Token**, apenas de leitura, aparece num HTML5 Gateway à espera de pairing.

---

## Eliminar um HTML5 Gateway

Selecione um ou mais HTML5 Gateway e clique no botão **×**. É pedida uma confirmação. É permitida a seleção múltipla.

| Mensagem | Causa |
|---|---|
| **The following HTML5 gateway is currently being used:** | O HTML5 Gateway está ligado a um ou mais sites. Tem de ser desligado antes da eliminação. Os nomes em causa vêm a seguir à mensagem, e existe uma variante no plural para uma eliminação múltipla. |
| **Deletion failed for the following HTML5 gateway:** | A eliminação falhou do lado do HTML5 Gateway. Os nomes com erro vêm a seguir à mensagem. |

---

## Mensagens de erro ao guardar

| Mensagem | Causa |
|---|---|
| **This gateway already exists.** | Já existe um HTML5 Gateway com esse nome. |
| **Invalid Name** | O servidor rejeitou o nome enviado. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | O certificado não tem o CN esperado. A mensagem indica o CN encontrado e o esperado. |
| **Invalid certificate or private key password** | A frase de acesso fornecida não abre o certificado. |
| **The given gateway is unreachable.** | O HTML5 Gateway não responde; a operação é abandonada. |
| **Actions on HTML5 gateways have been disabled.** | A gestão dos HTML5 Gateway está desativada na plataforma: nenhuma operação é bem-sucedida. |
