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

# 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](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/Sites/). A adesão a um site é feita a partir do módulo **Sites**, não deste.

> **Tutoriais relacionados**
>
> - [Criar um token de pairing para um Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Criar um Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pt/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## 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](#error-messages-on-saving)). |
| **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. |
