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 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, 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 Edge 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 Edge 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 Edge Gateway: HTTP o WebSocket. |
| 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 HTML5 Gateway. |
| Edit | Abre la ventana Edit HTML5 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. |
| 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 Edge 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 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 HTML5 Gateway¶
Seleccione una Edge 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 Edge Gateway en espera de emparejamiento;
- un campo Authentication Token, de solo lectura, aparece en una Edge Gateway en espera de emparejamiento.
Eliminar una HTML5 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 HTML5 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 HTML5 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 HTML5 Gateway con ese nombre. |
| Invalid Name | El servidor ha rechazado el nombre enviado. |
| The given gateway is unreachable. | La Edge 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. |