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

# HTML5 Gateways Management

El módulo **HTML5 Gateways** enumera las HTML5 Gateways declaradas en la plataforma y permite añadirlas, modificarlas o retirarlas. Una HTML5 Gateway se encarga del inicio de los recursos accesibles a través del navegador (HTML5 RDP, HTML5 SSH, etcétera), basándose en un protocolo HTTP o WebSocket.

Esta página está destinada a un administrador o un integrador que gestione el parque de HTML5 Gateways y su emparejamiento. La asignación de una HTML5 Gateway a un [sitio](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/Sites/) se realiza desde el módulo **Sites**, no desde este.

> **Tutorial relacionado**
>
> Véase [Creación de un token de emparejamiento para una Edge Gateway](https://docs.cyberelements.io/bastion/4.6/es/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/), cuya pestaña **HTML5 Gateway** detalla el procedimiento y la forma esperada del CN del certificado.

---

## Lista de HTML5 Gateways

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

| Columna | Descripción |
|---|---|
| **Name** | Nombre de la HTML5 Gateway, precedido de un icono que refleja su estado de conexión (en línea, fuera de línea, en espera de emparejamiento). |
| **URL** | URL pública expuesta por la HTML5 Gateway. |
| **Description** | Descripción libre introducida en la creación. |
| **Sites** | Sitios a los que está vinculada la HTML5 Gateway. |
| **Protocol** | Protocolo utilizado por la HTML5 Gateway: **HTTP** o **WebSocket**. |
| **Version** | Versión de la HTML5 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 HTML5 Gateway**. |
| **Edit** | Abre la ventana **Edit HTML5 Gateway** de la HTML5 Gateway seleccionada. También se activa con un doble clic. |
| **×** (eliminar) | Elimina las HTML5 Gateways seleccionadas tras confirmación. Se admite la selección múltiple. |
| **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 HTML5 Gateway

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

### Información general

| Campo | Descripción |
|---|---|
| **Name** | Obligatorio, 50 caracteres como máximo. Caracteres permitidos: letras sin acento, cifras, `é`, `è`, `à`, `ô`, `â`, paréntesis, espacio, `-`, `/`, `.` y `_`. |
| **URL** | Obligatorio. URL pública de la Edge Gateway, tal y como está configurada en su fichero `commonParameters.conf`. |
| **Description** | Texto libre. |
| **Protocol** | Protocolo utilizado para comunicarse con la HTML5 Gateway: **HTTP** (valor predeterminado) o **WebSocket**. |

### 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, en su caso. |
| **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 HTML5 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 HTML5 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 HTML5 Gateway

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

Los campos son los mismos que en la creación, incluido **Name**, que sigue siendo modificable. Se aplican además las reglas siguientes:

- **Pairing key validity period** e **IP authorized to use the token** solo pueden modificarse en una HTML5 Gateway **en espera de emparejamiento**;
- un campo **Authentication Token**, de solo lectura, aparece en una HTML5 Gateway en espera de emparejamiento.

---

## Eliminar una HTML5 Gateway

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

| Mensaje | Causa |
|---|---|
| **The following HTML5 gateway is currently being used:** | La HTML5 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 HTML5 gateway:** | La eliminación ha fallado en la HTML5 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 HTML5 Gateway con ese nombre. |
| **Invalid Name** | El servidor ha rechazado el nombre enviado. |
| **The given gateway is unreachable.** | La HTML5 Gateway no responde; la operación se abandona. |
| **Actions on HTML5 gateways have been disabled.** | La gestión de las HTML5 Gateways está desactivada en la plataforma: ninguna operación se completa. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | El certificado no lleva el CN esperado. El mensaje indica el CN encontrado y el esperado. |
| **Invalid certificate or private key password** | La frase de contraseña proporcionada no abre el certificado. |
