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

# Gateways Management

El módulo **Gateways** enumera las Edge Gateways (gateways no HTML5) declaradas en la plataforma y permite añadir una, cambiar su configuración (certificado, rutas de almacenamiento de las grabaciones, emparejamiento) o retirarla. Esta página está destinada a un administrador o un integrador que gestione el parque de Edge Gateways, su emparejamiento con el Mediation Controller y la recogida de las grabaciones de vídeo y SSH.

Para poder utilizarse en una sesión, una Edge Gateway debe estar vinculada a al menos un [sitio](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/Sites/). La incorporación a un sitio se realiza desde el módulo **Sites**, no desde este.

> **Tutoriales relacionados**
>
> - [Creación de un token de emparejamiento para una Edge Gateway](https://docs.cyberelements.io/bastion/4.6/es/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Crear una Edge Gateway](https://docs.cyberelements.io/bastion/4.6/es/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Lista de Edge Gateways

El módulo se abre en una cuadrícula paginada de las Edge Gateways declaradas.

| Columna | Descripción |
|---|---|
| **Name** | Nombre de la Edge Gateway, precedido de un icono que refleja su estado de conexión (en línea, fuera de línea, en espera de emparejamiento). |
| **Description** | Descripción libre introducida en la creación. |
| **Sites** | Sitios a los que está vinculada la Edge Gateway. |
| **Type** | **With recording** si la Edge Gateway admite la grabación de sesiones, **Basic** en caso contrario. |
| **Version** | Versión de la Edge Gateway. Cuando existen una instancia maestra y una de respaldo, se muestran ambas versiones en dos líneas. |

Acciones disponibles en la barra de herramientas:

| Acción | Descripción |
|---|---|
| **+** (añadir) | Abre la ventana **Add Gateway**. |
| **Edit** | Abre la ventana **Edit Gateway** de la Edge Gateway seleccionada. También se activa con un doble clic. |
| **×** (eliminar) | Elimina las Edge Gateways seleccionadas tras confirmación. Se admite la selección múltiple. |
| **Download recording certificate** | Descarga el certificado de la autoridad de grabación de la Edge Gateway seleccionada. Solo está activado si la Edge Gateway está **en línea**. |
| **Search** | Filtra por una subcadena del nombre, 700 ms después de la última pulsación de tecla (o inmediatamente con `Enter`). |
| **Pagination** | 15, 25 o 50 filas por página. |

---

## Añadir una Edge Gateway

El botón **+** abre la ventana **Add Gateway**.

### Información general

| Campo | Descripción |
|---|---|
| **Name** | Obligatorio, 50 caracteres como máximo. Caracteres permitidos: letras sin acento, cifras, `é`, `è`, `à`, `ô`, `â`, paréntesis, espacio, `-`, `/`, `.` y `_`. |
| **Description** | Texto libre. |
| **FQDN** | Nombre completamente cualificado de la máquina que aloja la Edge Gateway. Debe coincidir con el CN del certificado de la Edge Gateway; de lo contrario, el emparejamiento se rechaza (véase la sección 5). |
| **Archives** | Ruta local en la que la Edge Gateway archiva las grabaciones de vídeo RDP. Precargada con `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Ruta local en la que la Edge Gateway archiva las grabaciones SSH. Precargada con `/var/ipdiva/care/sshrecord`. |

Los tres campos **FQDN**, **Archives** y **Archives SSH** solo conciernen a las Edge Gateways con grabación: quedan ocultos en una Edge Gateway que no la admite.

### Paring Token

La casilla **Create a pairing token** revela la sección **Paring Token**, oculta de forma predeterminada.

| Campo | Descripción |
|---|---|
| **SSL certificate** | Certificado de la gateway que debe cargarse. Una lista desplegable define el formato esperado — `pkcs12` (predeterminado) o `pem` — y el selector de ficheros solo acepta entonces la extensión correspondiente, `.p12` o `.pem`. |
| **Certificate or private key password** | Frase de contraseña del certificado de la Edge Gateway, en su caso. |
| **Import a Careserver certificate** | Al marcarla, revela el certificado del servidor de grabación: los mismos tres elementos (formato, fichero, contraseña). |
| **Pairing key validity period** | Fecha y hora a partir de las cuales el token ya no puede utilizarse. Predeterminado: hoy + 7 días, con el formato `DD/MM/AAAA HH:MM`. |
| **IP authorized to use the token** | Dirección IP pública desde la que la Edge Gateway está autorizada a emparejarse. Se trata de la dirección tal y como la ve el Mediation Controller: detrás de un NAT, introduzca la dirección pública. |

> **Los dos últimos campos los desbloquea el certificado**
>
> **Pairing key validity period** e **IP authorized to use the token** permanecen **inactivos** mientras no se haya elegido un fichero de certificado válido. Un fichero cuya extensión no corresponda al formato seleccionado los deja por tanto inactivos — hasta que se proporcione un fichero conforme.

El botón **Validate** guarda la Edge Gateway. Si el guardado produce un token de emparejamiento, se abre una ventana **Paring Token** que muestra la clave e indica que debe **utilizarse al instalar la gateway**. Se cierra con **Close**: la clave debe copiarse desde la ventana.

---

## Modificar una Edge Gateway

Seleccione una Edge Gateway en la lista y pulse el icono **Properties** (o haga doble clic en la fila). La ventana **Edit Gateway** viene precargada con la configuración actual y con los datos del certificado vinculado.

Los campos son los mismos que en la creación, con las reglas siguientes:

- **FQDN**, **Archives** y **Archives SSH** quedan ocultos si la Edge Gateway no admite la grabación, y **desactivados** mientras no esté en línea;
- el **Name** sigue siendo modificable;
- **Pairing key validity period** e **IP authorized to use the token** solo pueden modificarse en una Edge Gateway **en espera de emparejamiento**;
- un campo **Authentication Token**, de solo lectura, aparece en una Edge Gateway en espera de emparejamiento.

> **Cambiar las rutas de archivo**
>
> Cambiar **Archives** o **Archives SSH** hace que las grabaciones anteriores queden inaccesibles desde la consola. Se solicita una confirmación antes de aplicar el cambio, y un fallo en la Edge Gateway se indica mediante **An error occured during the update of storage paths.**

---

## Eliminar una Edge Gateway

Seleccione una o varias Edge Gateways y pulse el botón **×**. Se solicita una confirmación. Se admite la selección múltiple.

| Mensaje | Causa |
|---|---|
| **The following gateway is currently being used:** | La Edge Gateway está vinculada a uno o varios sitios. Debe desvincularse antes de eliminarla. Los nombres afectados vienen a continuación del mensaje, y existe una variante en plural para una eliminación múltiple. |
| **Deletion failed for the following gateway:** | La eliminación ha fallado en la Edge Gateway. Los nombres con error vienen a continuación del mensaje. |

---

## Mensajes de error al guardar

| Mensaje | Causa |
|---|---|
| **This gateway already exists.** | Ya hay una Edge Gateway con ese nombre. |
| **Invalid Name** | El servidor ha rechazado el nombre enviado. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | El certificado de la Edge Gateway no lleva el CN esperado. El mensaje indica el CN encontrado y el esperado. |
| **The CN of the Careserver certificate sent does not match the expected CN** | El mismo caso para el certificado del servidor de grabación. |
| **Invalid certificate or private key password** | La frase de contraseña proporcionada no abre el certificado. |
| **Unable to contact the pairing system, please check its configuration** | El servicio de emparejamiento no ha respondido. |
| **The given gateway is unreachable.** | La Edge Gateway no responde; la operación se abandona. |
| **The gateway management service is unreachable** | El servicio que dirige las Edge Gateways no ha respondido. |
