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 é feita a partir do módulo Sites, não deste.
Tutorial relacionado
Consulte Criar um token de pairing para um Edge Gateway, 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 Edge 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 Edge Gateway. |
| Description | Descrição livre introduzida na criação. |
| Sites | Sites a que o HTML5 Gateway está ligado. |
| Protocol | Protocolo utilizado pelo Edge Gateway: HTTP ou WebSocket. |
| Version | Versão do Edge 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 Edge Gateway selecionado. Também é acionada por um duplo clique. |
| × (eliminar) | Elimina os Edge 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 Edge 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 Edge 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 Edge 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 Edge 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 Edge Gateway à espera de pairing;
- um campo Authentication Token, apenas de leitura, aparece num Edge Gateway em espera de pairing.
Eliminar um HTML5 Gateway¶
Selecione um ou mais Edge 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 Edge 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 Edge 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 Edge 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. |