Pular para o conteúdo principal

Passo 2: Instalação e Configuração do Gateway

Com o seu Gateway e dispositivos configurados na SDA Console, a fase seguinte consiste em instalar o serviço SDA Glue no hardware de gateway escolhido. Este processo de instalação difere entre sistemas Linux e Windows, mas ambas as abordagens seguem o mesmo princípio fundamental: transferir e configurar um serviço que funciona continuamente em segundo plano, pronto para estabelecer túneis seguros a pedido.

Instalação​

O processo de instalação é composto por duas fases principais:

  1. Instalar o SDA Glue e as dependências no sistema de destino.
  2. Configurar o serviço com credenciais únicas da SDA Console, que autenticam um Gateway específico.

Antes de iniciar a instalação, certifique-se de que dispõe de privilégios administrativos no sistema de destino. O processo de instalação requer permissões elevadas para instalar o serviço de sistema. No Linux, necessitará de acesso sudo. No Windows, terá de executar o PowerShell como Administrador.

aviso

O processo de instalação pode acomodar ambientes com proxy, mas requer passos de configuração adicionais que detalharemos em cada secção específica de plataforma.

Linux​

Para instalar o SDA Glue num sistema Linux com acesso direto à Internet, execute o seguinte comando num terminal:

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

Este comando utiliza o curl para obter de forma segura o script de instalação diretamente do endpoint da API do SDA e encaminha-o para o bash para execução imediata. As flags -sSL garantem que a transferência é silenciosa, mostra erros caso ocorram e segue quaisquer redirecionamentos de forma segura.

Detalhes sobre o Processo de Instalação no Linux

A instalação no Linux utiliza um script de shell automatizado que trata do processo complexo de compilação e configuração do serviço SDA Glue. Este script executa várias tarefas críticas: instala as dependências de runtime e as ferramentas de compilação necessárias, transfere e compila o SoftEther VPN Client a partir do repositório seguro do SDA e instala o SDA Glue como um serviço systemd que arrancará automaticamente com o seu sistema.

A abordagem de compilação assegura a compatibilidade entre diferentes distribuições Linux, mantendo a segurança através da compilação a partir de código-fonte verificado. A integração com o serviço systemd significa que o seu gateway reiniciará automaticamente caso encontre problemas e começará a operar imediatamente quando o sistema arrancar.

Se preferir examinar o script de instalação antes de o executar, pode obtê-lo separadamente, removendo a parte | bash - do comando ou acedendo diretamente a https://api.eu1.sdaconsole.io/glue/v1/install.sh no seu navegador web. Esta transparência permite-lhe compreender exatamente o que o processo de instalação irá executar no seu sistema.

Linux com Proxy​

Quando o seu sistema Linux necessita de acesso à Internet através de um servidor proxy, deve configurar as variáveis de ambiente adequadas antes de executar o script de instalação. Defina as variáveis de ambiente http_proxy e https_proxy na sua sessão bash atual:

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 -

Substitua o URL do proxy pelos dados reais do seu servidor proxy, incluindo as credenciais de autenticação, caso sejam exigidas pela configuração da sua rede.

Docker​

O Docker oferece um método de implementação alternativo que proporciona consistência entre diferentes sistemas anfitriões e uma gestão simplificada através da contentorização. A imagem Docker do SDA Glue baseia-se em Debian e inclui todas as dependências necessárias pré-configuradas, eliminando a necessidade de compilação manual ou de gestão de dependências.

Para implementar o SDA Glue com Docker, execute o seguinte comando com as capacidades de rede necessárias:

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 cria um contentor persistente chamado "glue" que reiniciará automaticamente caso pare inesperadamente. A montagem de volume preserva a configuração e os dados de autenticação do seu gateway entre reinícios ou atualizações do contentor.

Encaminha também a porta 8080 do contentor para a porta 8081 do anfitrião, que executa o servidor web do Glue para configurar a aplicação. Pode então aceder-lhe através de http://localhost:8081/.

informação

Ao executar vários contentores SDA Glue no mesmo anfitrião, certifique-se de que cada contentor utiliza nomes e montagens de volume únicos, para evitar conflitos:

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

Para orientações abrangentes sobre implementação com Docker, incluindo configurações de rede avançadas, passos de resolução de problemas e boas práticas de implementação em produção, consulte a documentação completa:

Detalhes completos de implementação, exemplos de configuração e orientações para resolução de problemas.

Windows​

Abra o PowerShell como Administrador, procurando "PowerShell" na barra de pesquisa do Windows, clicando com o botão direito no resultado e selecionando "Executar como administrador". Assim que tiver uma sessão do PowerShell com privilégios elevados, execute o seguinte comando:

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

Este comando do PowerShell utiliza o Invoke-WebRequest (abreviado como iwr) para obter o script de instalação e encaminha-o para o Invoke-Expression (abreviado como iex) para execução imediata. O parâmetro -UseBasicParsing assegura a compatibilidade entre diferentes versões e configurações do Windows.

Instalação bem-sucedida do SDA Glue com o PowerShell

Detalhes sobre o Processo de Instalação no Windows

O processo de instalação no Windows utiliza o PowerShell para transferir e executar um script de instalação que configura o seu sistema para a conectividade SDA. Ao contrário da abordagem do Linux, que compila o software a partir do código-fonte, o instalador do Windows transfere binários pré-compilados do OpenVPN Community Client e do serviço SDA Glue, registando depois o SDA Glue como um Serviço do Windows.

A integração com os Serviços do Windows assegura que o SDA Glue arranca automaticamente com o sistema e reinicia automaticamente caso encontre problemas. Isto proporciona as mesmas vantagens de fiabilidade da abordagem systemd do Linux, mas utilizando a infraestrutura nativa de gestão de serviços do Windows.

À semelhança da abordagem do Linux, pode examinar o script de instalação antes de o executar, removendo a parte | iex ou acedendo diretamente a https://api.eu1.sdaconsole.io/glue/v1/install.ps1 no seu navegador web.

Windows com Proxy​

Quando o seu sistema Windows opera atrás de um servidor proxy, o processo de instalação requer uma abordagem em duas fases. Primeiro, configurará as definições de proxy e transferirá o script de instalação. Depois, executará o script com a configuração de proxy adequada.

Comece por definir as variáveis do PowerShell para a sua configuração de 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

Note a distinção importante na formatação do URL do proxy: o comando Invoke-WebRequest requer o esquema completo do URL (http://proxy.company.com:8080), ao passo que o script de instalação espera apenas o nome de anfitrião e a porta (proxy.company.com:8080).

Conforme indicam os registos na parte inferior, é necessário configurar o servidor Proxy no SDA Glue através da CLI

Autenticação e Início de Sessão​

Após instalar com êxito o software SDA Glue, deve autenticar o seu gateway físico junto dos serviços SDA Cloud. Este processo de autenticação utiliza credenciais únicas geradas pela SDA Console para o seu gateway específico. Estas credenciais consistem num identificador curto do gateway e numa palavra-passe de utilização única que é rodada periodicamente para maior segurança.

Comandos de configuração do gateway na SDA Console

Regresse à SDA Console e localize o segundo comando na caixa de diálogo de configuração do seu gateway. Este comando será semelhante aos exemplos seguintes:

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

A estrutura do comando inclui a flag -e eu1, que especifica o endpoint da região europeia, seguida do identificador único do seu gateway (por exemplo, G1ABCD) e da palavra-passe de utilização única (por exemplo, 123456). Estes valores são específicos do seu gateway e serão diferentes dos exemplos apresentados.

informação

A palavra-passe de utilização única é atualizada periodicamente por motivos de segurança. Se ocorrerem falhas de autenticação, regresse à SDA Console para obter a palavra-passe atual na caixa de diálogo de configuração do gateway.

Estado do Serviço​

Depois de concluir o processo de instalação e autenticação, verifique se o serviço SDA Glue está a funcionar corretamente no seu sistema.

Linux​

Verifique o estado do serviço utilizando comandos systemd:

sudo systemctl status sdaglue

Para monitorizar a saída de registos em tempo real e resolver eventuais problemas:

sudo journalctl -efu sdaglue -n 100

Docker​

Os registos do serviço podem ser obtidos dos contentores Docker com:

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

Windows​

Pode verificar o serviço através da aplicação Serviços do Windows. Procure "Serviços" na barra de pesquisa do Windows e localize "SDA Glue" na lista de serviços. O serviço deverá apresentar o estado "Em execução" com um tipo de arranque "Automático".

Visualização dos Serviços ativos no Windows

Os Serviços do Windows produzem Registos de Eventos, que podem ser consultados no Visualizador de Eventos, em Registos do Windows → Aplicação. Utilize a barra de pesquisa para abrir o Visualizador de Eventos.

Acesso aos registos do SDA Glue no Visualizador de Eventos

Configuração​

O SDA Glue permite-lhe modificar o seu comportamento para funcionar de forma otimizada no seu ambiente de rede específico. Estes ajustes de configuração asseguram uma conectividade fiável, independentemente das características particulares da sua rede industrial, quer se trate de servidores proxy, restrições de firewall ou protocolos de comunicação diferentes.

Utilizamos variáveis de ambiente para controlar o serviço. As alterações de configuração exigem o reinício do serviço para produzirem efeito. As variáveis de ambiente mantêm a mesma convenção de nomenclatura dos parâmetros de configuração, mas utilizam o prefixo GLUE e são separadas por underscores:

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

Ver os parâmetros de configuração atuais:

# 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

Obter parâmetros:

# Linux & Windows
sdaglue config list

# Docker
docker exec sdaglue config list

Reiniciar o serviço após alterações:

# Linux & Windows
sdaglue service restart

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

Protocolo de Transporte MQTT​

Uma das decisões de configuração mais importantes envolve a escolha da forma como o seu gateway comunica com os serviços SDA Cloud. O SDA Glue suporta dois protocolos de transporte, cada um concebido para ambientes de rede diferentes:

TransporteProtocoloPortaCaso de Utilização
MQTTSSL / TCP443Redes padrão com acesso direto à Internet
MQTT sobre WebSocketWebSocket Secure (TCP)443Redes com proxies transparentes ou inspeção SSL

Para transporte WebSocket:

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

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

Para transporte MQTT padrão:

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

# Docker
docker exec glue sdaglue config set --iot.transport mqtt
informação

Se o serviço já tiver sessão iniciada e estiver ligado, o novo protocolo de transporte só produzirá efeito após o próximo reinício do serviço.

Quando Utilizar o Transporte WebSocket

Proxies Transparentes: Algumas redes empresariais utilizam proxies transparentes que intercetam e analisam o tráfego de rede. Estes proxies podem interferir com ligações MQTT SSL padrão, mas normalmente permitem a passagem de ligações WebSocket sem problemas.

Firewalls Restritivas: Redes com inspeção profunda de pacotes ou filtragem rigorosa de protocolos podem bloquear o tráfego MQTT, permitindo simultaneamente ligações WebSocket, que se assemelham a tráfego web padrão.

Políticas de Rede Empresariais: Algumas organizações têm políticas que restringem protocolos não-HTTP, tornando o transporte WebSocket a escolha preferencial para efeitos de conformidade.

Servidor Proxy​

Quando a sua rede exige que todo o tráfego de Internet passe por um servidor proxy específico, o SDA Glue tem de ser configurado com os dados do proxy para estabelecer ligações com os serviços SDA Cloud. Isto é particularmente comum em ambientes empresariais onde o acesso direto à Internet é restringido por motivos de segurança.

Os endereços de proxy seguem o formato padrão: scheme://username:password@hostname:port

  • Esquema: Normalmente http:// ou https://
  • Utilizador/Palavra-passe: Credenciais de autenticação (se exigidas pelo seu proxy)
  • Nome de anfitrião: O endereço do servidor proxy
  • Porta: O número de porta do servidor proxy

Deve configurar as definições de proxy HTTP e HTTPS para assegurar a cobertura completa das necessidades de comunicação do SDA Glue.

informação

Se o seu servidor proxy não exigir autenticação, basta omitir o nome de utilizador e a palavra-passe:

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 Comuns​

Rede Empresarial com Proxy Transparente​

Problema: O gateway liga-se inicialmente, mas desliga-se frequentemente ou apresenta conectividade instável.

Solução: Mudar para o protocolo de transporte WebSocket.

Ambiente com Firewall Restritiva​

Problema: O gateway não consegue estabelecer a ligação inicial aos serviços SDA Cloud.

Solução: Configurar o transporte WebSocket e verificar se as ligações HTTPS de saída são permitidas na porta 443.

Servidor Proxy com Autenticação​

Problema: O gateway não consegue ligar-se através do proxy empresarial que exige autenticação.

Solução: Configurar ambas as definições de proxy com as credenciais de autenticação corretas e reiniciar o serviço.

Com estas opções de configuração devidamente definidas, o seu serviço SDA Glue adaptar-se-á ao seu ambiente de rede e manterá uma conectividade fiável aos serviços SDA Cloud, permitindo um acesso seguro aos seus dispositivos industriais.