Gateways Management¶

O módulo Gateways enumera os Edge Gateway (gateways não HTML5) declarados na plataforma e permite adicionar um, alterar a sua configuração (certificado, caminhos de armazenamento das gravações, pairing) ou removê-lo. Esta página destina-se a um administrador ou a um integrador que gere o parque de Edge Gateway, o seu pairing com o Mediation Controller e a recolha das gravações de vídeo e SSH.

Para poder ser utilizado numa sessão, um Edge Gateway tem de estar ligado a pelo menos um site. A adesão a um site é feita a partir do módulo Sites, não deste.

Tutoriais relacionados

Lista de Edge Gateway¶

O módulo abre numa grelha paginada dos Edge 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).
Description	Descrição livre introduzida na criação.
Sites	Sites a que o Edge Gateway está ligado.
Type	With recording se o Edge Gateway suportar a gravação de sessões, Basic caso contrário.
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 Gateway.
Edit	Abre a janela Edit 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.
Download recording certificate	Transfere o certificado da autoridade de gravação do Edge Gateway selecionado. Só está ativado se o Edge Gateway estiver em linha.
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 Edge Gateway¶

O botão + abre a janela Add 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 `_`.
Description	Texto livre.
FQDN	Nome completamente qualificado da máquina que aloja o Edge Gateway. Tem de corresponder ao CN do certificado do Edge Gateway, caso contrário o pairing é recusado (ver a secção Mensagens de erro ao guardar).
Archives	Caminho local onde o Edge Gateway arquiva as gravações de vídeo RDP. Pré-preenchido com `/var/lib/ipdiva/carerecord/archives`.
Archives SSH	Caminho local onde o Edge Gateway arquiva as gravações SSH. Pré-preenchido com `/var/ipdiva/care/sshrecord`.

Os três campos FQDN, Archives e Archives SSH dizem apenas respeito aos Edge Gateway com gravação: ficam ocultos num Edge Gateway que não a suporta.

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 do Edge Gateway, se aplicável.
Import a Careserver certificate	Quando assinalada, revela o certificado do servidor de gravação: os mesmos três elementos (formato, ficheiro, palavra-passe).
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 Edge Gateway¶

Selecione um Edge Gateway na lista e clique no ícone Properties (ou faça duplo clique na linha). A janela Edit Gateway é previamente preenchida com as definições atuais e com os dados do certificado associado.

Os campos são os mesmos que na criação, com as regras seguintes:

o Name continua editável;
FQDN, Archives e Archives SSH ficam ocultos se o Edge Gateway não suportar a gravação, e desativados enquanto não estiver em linha;
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.

Alterar os caminhos de arquivo

Alterar Archives ou Archives SSH torna as gravações anteriores inacessíveis a partir da consola. É pedida uma confirmação antes de a alteração ser aplicada, e uma falha do lado do Edge Gateway é indicada por An error occured during the update of storage paths.

Eliminar um Edge 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 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 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 Edge 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 do Edge Gateway não tem o CN esperado. A mensagem indica o CN encontrado e o esperado.
The CN of the Careserver certificate sent does not match the expected CN	O mesmo caso para o certificado do servidor de gravação.
Invalid certificate or private key password	A frase de acesso fornecida não abre o certificado.
Unable to contact the pairing system, please check its configuration	O serviço de pairing não respondeu.
The given gateway is unreachable.	O Edge Gateway não responde; a operação é abandonada.
The gateway management service is unreachable	O serviço que comanda os Edge Gateway não respondeu.