Paso 2: Instalación y configuración del gateway

Con su gateway y sus dispositivos configurados en la SDA Console, la siguiente fase consiste en instalar el servicio SDA Glue en el hardware de gateway que haya elegido. Este proceso de instalación difiere entre sistemas Linux y Windows, pero ambos enfoques siguen el mismo principio fundamental: descargar y configurar un servicio que se ejecuta continuamente en segundo plano, listo para establecer túneles seguros bajo demanda.

Instalación

El proceso de instalación consta de dos fases principales:

1. Instalar SDA Glue y sus dependencias en el sistema de destino.
2. Configurar el servicio con credenciales únicas de la SDA Console, que autentican un gateway concreto.

Antes de comenzar la instalación, asegúrese de disponer de privilegios administrativos en el sistema de destino. El proceso de instalación requiere permisos elevados para instalar el servicio del sistema. En Linux, necesitará acceso sudo. En Windows, deberá ejecutar PowerShell como administrador.

aviso

El proceso de instalación puede adaptarse a entornos con proxy, pero requiere pasos de configuración adicionales que detallaremos en cada sección específica de plataforma.

Linux

Para instalar SDA Glue en un sistema Linux con acceso directo a Internet, ejecute el siguiente comando en un terminal:

curl -sSL 'https://api.eu1.sdaconsole.io/glue/v1/install.sh' | bash -

Este comando utiliza curl para obtener de forma segura el script de instalación directamente desde el endpoint de la API de SDA y lo canaliza a bash para su ejecución inmediata. Los indicadores -sSL garantizan que la transferencia sea silenciosa, muestre los errores en caso de producirse y siga cualquier redirección de forma segura.

Detalles sobre el proceso de instalación en Linux

La instalación en Linux utiliza un script de shell automatizado que gestiona el complejo proceso de compilación y configuración del servicio SDA Glue. Este script realiza varias tareas críticas: instala las dependencias de tiempo de ejecución y las herramientas de compilación necesarias, descarga y compila el cliente SoftEther VPN desde el repositorio seguro de SDA e instala SDA Glue como servicio de systemd que se iniciará automáticamente con su sistema.

El enfoque de compilación garantiza la compatibilidad entre diferentes distribuciones de Linux, manteniendo la seguridad al compilar a partir de código fuente verificado. La integración con el servicio systemd significa que su gateway se reiniciará automáticamente si encuentra problemas y comenzará a funcionar de inmediato cuando arranque el sistema.

Si prefiere examinar el script de instalación antes de ejecutarlo, puede obtenerlo por separado eliminando la parte | bash - del comando o accediendo directamente a https://api.eu1.sdaconsole.io/glue/v1/install.sh en su navegador web. Esta transparencia le permite comprender exactamente qué hará el proceso de instalación en su sistema.

Linux con proxy

Cuando su sistema Linux requiera acceso a Internet a través de un servidor proxy, deberá configurar las variables de entorno adecuadas antes de ejecutar el script de instalación. Defina las variables de entorno http_proxy y https_proxy en su sesión actual de bash:

export http_proxy=http://username:password@proxy.company.com:8080
export https_proxy=http://username:password@proxy.company.com:8080
curl -sSL 'https://api.eu1.sdaconsole.io/glue/v1/install.sh' | bash -

Sustituya la URL del proxy por los datos reales de su servidor proxy, incluidas las credenciales de autenticación si su configuración de red lo requiere.

Docker

Docker ofrece un método de despliegue alternativo que proporciona coherencia entre distintos sistemas anfitriones y una gestión simplificada mediante la contenerización. La imagen Docker de SDA Glue se basa en Debian e incluye todas las dependencias necesarias preconfiguradas, lo que elimina la necesidad de compilación manual o de gestión de dependencias.

Para desplegar SDA Glue con Docker, ejecute el siguiente comando con las capacidades de red necesarias:

docker run -d \
  --name glue \
  --device=/dev/net/tun \
  --cap-add=NET_ADMIN \
  -v glue-data:/var/lib/sdaglue \
  --restart always \
  -p 8081:8080 \
  public.ecr.aws/t9c5s2d1/sdaglue:latest

Este comando crea un contenedor persistente denominado "glue" que se reiniciará automáticamente si se detiene de forma inesperada. El montaje de volumen conserva la configuración y los datos de autenticación de su gateway entre reinicios o actualizaciones del contenedor.

También reenvía el puerto 8080 del contenedor al puerto 8081 del host, que ejecuta el servidor web de Glue para configurar la aplicación. Podrá acceder a él en http://localhost:8081/.

información

Al ejecutar varios contenedores de SDA Glue en el mismo host, asegúrese de que cada contenedor utilice nombres y montajes de volumen únicos para evitar conflictos:

docker run -d --name glue-factory -v factory-data:/var/lib/sdaglue [...]

Para obtener una guía completa de despliegue con Docker, incluidas configuraciones de red avanzadas, pasos de resolución de problemas y buenas prácticas de despliegue en producción, consulte la documentación completa:

Detalles completos de despliegue, ejemplos de configuración y guía de resolución de problemas.

Windows

Abra PowerShell como administrador buscando "PowerShell" en la barra de búsqueda de Windows, haciendo clic con el botón derecho en el resultado y seleccionando "Ejecutar como administrador". Una vez que disponga de una sesión de PowerShell con privilegios elevados, ejecute el siguiente comando:

iwr -Uri 'https://api.eu1.sdaconsole.io/glue/v1/install.ps1' -UseBasicParsing | iex

Este comando de PowerShell utiliza Invoke-WebRequest (abreviado como iwr) para obtener el script de instalación y lo canaliza a Invoke-Expression (abreviado como iex) para su ejecución inmediata. El parámetro -UseBasicParsing garantiza la compatibilidad entre distintas versiones y configuraciones de Windows.

Instalación correcta de SDA Glue con PowerShell

Detalles sobre el proceso de instalación en Windows

El proceso de instalación en Windows utiliza PowerShell para descargar y ejecutar un script de instalación que configura su sistema para la conectividad con SDA. A diferencia del enfoque de Linux, que compila el software a partir del código fuente, el instalador de Windows descarga binarios precompilados del cliente OpenVPN Community y del servicio SDA Glue, y después registra SDA Glue como servicio de Windows.

La integración con los servicios de Windows garantiza que SDA Glue se inicie automáticamente con el sistema y se reinicie automáticamente si encuentra algún problema. Esto proporciona las mismas ventajas de fiabilidad que el enfoque de systemd en Linux, pero utilizando la infraestructura nativa de gestión de servicios de Windows.

Al igual que en Linux, puede examinar el script de instalación antes de ejecutarlo eliminando la parte | iex o accediendo directamente a https://api.eu1.sdaconsole.io/glue/v1/install.ps1 en su navegador web.

Windows con proxy

Cuando su sistema Windows funciona detrás de un servidor proxy, el proceso de instalación requiere un enfoque en dos etapas. En primer lugar, configurará los ajustes del proxy y descargará el script de instalación. A continuación, ejecutará el script con la configuración de proxy adecuada.

Comience definiendo las variables de PowerShell para la configuración del proxy:

# Configure your specific proxy details
$ProxyHost="proxy.company.com:8080"
$ProxyUser="your-username"

# Download the installation script through the proxy
iwr -Uri 'https://api.eu1.sdaconsole.io/glue/v1/install.ps1' -UseBasicParsing -OutFile .\glue-install.ps1 -Proxy http://$ProxyHost -ProxyCredential $ProxyUser

# Execute the script with proxy configuration
.\glue-install.ps1 -Proxy $ProxyHost -ProxyCredential $ProxyUser

Tenga en cuenta la importante diferencia en el formato de la URL del proxy: el comando Invoke-WebRequest requiere el esquema completo de la URL (http://proxy.company.com:8080), mientras que el script de instalación espera únicamente el nombre de host y el puerto (proxy.company.com:8080).

Como indican los registros de la parte inferior, debemos configurar el servidor proxy en SDA Glue mediante la CLI

Autenticación e inicio de sesión

Tras instalar correctamente el software SDA Glue, debe autenticar su gateway físico con los servicios de SDA Cloud. Este proceso de autenticación utiliza credenciales únicas generadas por la SDA Console para su gateway concreto. Estas credenciales constan de un identificador corto de gateway y una contraseña de un solo uso que rota periódicamente para mayor seguridad.

Comandos de configuración del gateway desde la SDA Console

Vuelva a la SDA Console y localice el segundo comando en el cuadro de diálogo de configuración de su gateway. Este comando tendrá un aspecto similar a los siguientes ejemplos:

Linux

sudo sdaglue login -e eu1 G1ABCD 123456

Docker

docker exec glue sdaglue login -e eu1 G1ABCD 123456

Windows

sdaglue.exe login -e eu1 G1ABCD 123456

La estructura del comando incluye el indicador -e eu1, que especifica el endpoint de la región europea, seguido del identificador único de su gateway (como G1ABCD) y la contraseña de un solo uso (como 123456). Estos valores son específicos de su gateway y diferirán de los ejemplos mostrados.

información

La contraseña de un solo uso se actualiza periódicamente por motivos de seguridad. Si se producen fallos de autenticación, vuelva a la SDA Console para obtener la contraseña actual en el cuadro de diálogo de configuración del gateway.

Estado del servicio

Tras completar el proceso de instalación y autenticación, compruebe que el servicio SDA Glue se está ejecutando correctamente en su sistema.

Linux

Compruebe el estado del servicio mediante los comandos de systemd:

sudo systemctl status sdaglue

Para supervisar la salida de registros en vivo y resolver posibles problemas:

sudo journalctl -efu sdaglue -n 100

Docker

Los registros del servicio pueden obtenerse de los contenedores Docker con:

docker logs -n 100 --follow glue  # tracks the latest 100 logs from the service

Windows

Puede verificar el servicio mediante la aplicación Servicios de Windows. Busque "Servicios" en la barra de búsqueda de Windows y localice "SDA Glue" en la lista de servicios. El servicio debería aparecer como "En ejecución" con un tipo de inicio "Automático".

Visualización de los servicios activos en Windows

Los servicios de Windows generan registros de eventos, a los que se puede acceder en el Visor de eventos, en Registros de Windows → Aplicación. Utilice la barra de búsqueda para abrir el Visor de eventos.

Acceso a los registros de SDA Glue en el Visor de eventos

Configuración

SDA Glue le permite modificar su comportamiento para funcionar de forma óptima dentro de su entorno de red específico. Estos ajustes de configuración garantizan una conectividad fiable independientemente de las características particulares de su red industrial, ya se trate de servidores proxy, restricciones de cortafuegos o distintos protocolos de comunicación.

Utilizamos variables de entorno para controlar el servicio. Los cambios de configuración requieren un reinicio del servicio para surtir efecto. Las variables de entorno mantienen la misma convención de nomenclatura de los parámetros de configuración, pero utilizan el prefijo GLUE y se separan mediante guiones bajos:

log.level -> GLUE_LOG_LEVEL
webui.enabled -> GLUE_WEBUI_ENABLED

Ver los parámetros de configuración actuales:

# Linux & Windows
sdaglue config describe

# Docker
docker exec glue sdaglue config describe

Definir parámetros:

# Linux & Windows
sdaglue config set --log.level debug --webui.enabled true --webui.port 8080

# Docker
docker exec sdaglue config set --log.level debug --webui.enabled true --webui.port 8080

Obtener parámetros:

# Linux & Windows
sdaglue config list

# Docker
docker exec sdaglue config list

Reiniciar el servicio tras los cambios:

# Linux & Windows
sdaglue service restart

# Docker
docker exec glue sdaglue service restart # or
docker restart glue

Protocolo de transporte MQTT

Una de las decisiones de configuración más importantes consiste en elegir cómo se comunica su gateway con los servicios de SDA Cloud. SDA Glue admite dos protocolos de transporte, cada uno diseñado para entornos de red distintos:

Transporte	Protocolo	Puerto	Caso de uso
MQTT	SSL / TCP	443	Redes estándar con acceso directo a Internet
MQTT sobre WebSocket	WebSocket Secure (TCP)	443	Redes con proxies transparentes o inspección SSL

Para el transporte por WebSocket:

# Linux & Windows
sdaglue config set --iot.transport websocket

# Docker
docker exec glue sdaglue config set --iot.transport websocket

Para el transporte MQTT estándar:

# Linux & Windows
sdaglue config set --iot.transport mqtt

# Docker
docker exec glue sdaglue config set --iot.transport mqtt

información

Si el servicio ya ha iniciado sesión y está conectado, el nuevo protocolo de transporte solo surtirá efecto tras el siguiente reinicio del servicio.

Cuándo utilizar el transporte por WebSocket

Proxies transparentes: Algunas redes corporativas utilizan proxies transparentes que interceptan y analizan el tráfico de red. Estos proxies pueden interferir con las conexiones MQTT SSL estándar, pero normalmente permiten que las conexiones WebSocket pasen sin problemas.

Cortafuegos restrictivos: Las redes con inspección profunda de paquetes o filtrado estricto de protocolos pueden bloquear el tráfico MQTT y, en cambio, permitir las conexiones WebSocket, que se asemejan al tráfico web estándar.

Políticas de red corporativas: Algunas organizaciones aplican políticas que restringen los protocolos no HTTP, lo que convierte el transporte por WebSocket en la opción preferente para el cumplimiento normativo.

Servidor proxy

Cuando su red requiere que todo el tráfico de Internet circule a través de un servidor proxy específico, SDA Glue debe configurarse con los datos del proxy para establecer conexiones con los servicios de SDA Cloud. Esto es especialmente habitual en entornos corporativos en los que el acceso directo a Internet está restringido por motivos de seguridad.

Las direcciones de proxy siguen el formato estándar: scheme://username:password@hostname:port

• Esquema: normalmente http:// o https://
• Usuario/contraseña: credenciales de autenticación (si su proxy las requiere)
• Nombre de host: la dirección del servidor proxy
• Puerto: el número de puerto del servidor proxy

Debe configurar los ajustes de proxy tanto de HTTP como de HTTPS para cubrir por completo las necesidades de comunicación de SDA Glue.

información

Si su servidor proxy no requiere autenticación, basta con omitir el usuario y la contraseña:

proxy_server="http://proxy.company.com:8080"

Linux

proxy_server="http://username:password@proxy.company.com:8080"
sdaglue config set --proxy.http=$proxy_server --proxy.https=$proxy_server

# Restart the service to apply changes
sdaglue service restart

Docker

proxy_server="http://username:password@proxy.company.com:8080"
docker exec glue sdaglue config set --proxy.http=$proxy_server --proxy.https=$proxy_server

# Restart the container to apply changes
docker restart glue

Windows

$ProxyServer="http://username:password@proxy.company.com:8080"
sdaglue.exe config set --proxy.http=$ProxyServer --proxy.https=$ProxyServer

# Restart the service to apply changes
sdaglue.exe service restart

Problemas habituales

Red corporativa con proxy transparente

Problema: el gateway se conecta inicialmente, pero se desconecta con frecuencia o muestra una conectividad inestable.

Solución: cambiar al protocolo de transporte WebSocket.

Entorno con cortafuegos restrictivo

Problema: el gateway no puede establecer la conexión inicial con los servicios de SDA Cloud.

Solución: configurar el transporte por WebSocket y comprobar que se permiten las conexiones HTTPS salientes por el puerto 443.

Servidor proxy con autenticación

Problema: el gateway no puede conectarse a través del proxy corporativo que requiere autenticación.

Solución: configurar ambos ajustes de proxy con las credenciales de autenticación adecuadas y reiniciar el servicio.

Con estas opciones de configuración correctamente definidas, su servicio SDA Glue se adaptará a su entorno de red y mantendrá una conectividad fiable con los servicios de SDA Cloud, permitiendo un acceso seguro a sus dispositivos industriales.