Krok 2: Inštalácia a konfigurácia brány

Keď máte bránu a zariadenia nakonfigurované v SDA Console, nasledujúca fáza zahŕňa inštaláciu služby SDA Glue na zvolenom hardvéri brány. Tento inštalačný proces sa medzi systémami Linux a Windows líši, no oba prístupy vychádzajú z rovnakého základného princípu: stiahnutia a konfigurácie služby, ktorá nepretržite beží na pozadí a je pripravená na vyžiadanie vytvoriť zabezpečené tunely.

Inštalácia

Inštalačný proces sa skladá z dvoch hlavných fáz:

1. Nainštalujte SDA Glue a závislosti v cieľovom systéme.
2. Nakonfigurujte službu s jedinečnými prihlasovacími údajmi zo SDA Console, ktoré autentifikujú konkrétnu bránu.

Pred začatím inštalácie sa uistite, že máte v cieľovom systéme administrátorské oprávnenia. Inštalačný proces vyžaduje zvýšené oprávnenia na inštaláciu systémovej služby. V systéme Linux budete potrebovať prístup sudo. V systéme Windows budete musieť spustiť PowerShell ako administrátor.

varovanie

Inštalačný proces dokáže pracovať aj v proxy prostreniach, vyžaduje však ďalšie konfiguračné kroky, ktoré podrobne popíšeme v častiach špecifických pre jednotlivé platformy.

Linux

Ak chcete nainštalovať SDA Glue v systéme Linux s priamym prístupom na internet, vykonajte v termináli nasledujúci príkaz:

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

Tento príkaz využíva curl na bezpečné získanie inštalačného skriptu priamo z API endpointu SDA a presmeruje ho do bash na okamžité vykonanie. Prepínače -sSL zabezpečia, že prenos je tichý, zobrazí chyby, ak sa vyskytnú, a bezpečne nasleduje prípadné presmerovania.

Podrobnosti o inštalačnom procese v systéme Linux

Inštalácia v systéme Linux využíva automatizovaný shell skript, ktorý zvládne komplexný proces zostavenia a konfigurácie služby SDA Glue. Tento skript vykonáva niekoľko kritických úloh: nainštaluje potrebné runtime závislosti a nástroje na zostavenie, stiahne a skompiluje SoftEther VPN Client zo zabezpečeného repozitára SDA a nainštaluje SDA Glue ako službu systemd, ktorá sa bude automaticky spúšťať spolu s vašim systémom.

Prístup založený na kompilácii zaisťuje kompatibilitu s rôznymi distribúciami Linuxu a zároveň udržiava bezpečnosť tým, že sa zostavuje z overeného zdrojového kódu. Integrácia služby systemd znamená, že vaša brána sa automaticky restartuje, ak narazí na problémy, a začne fungovať okamžite po zavedení systému.

Ak si chcete inštalačný skript pred vykonaním preštudovať, môžete ho získať samostatne buď odstránením časti | bash - z príkazu, alebo priamym otvorením adresy https://api.eu1.sdaconsole.io/glue/v1/install.sh vo webovom prehliadači. Táto transparentnosť vám umožňuje presne pochopiť, čo inštalačný proces vo vašom systéme vykoná.

Linux s proxy

Ak váš systém Linux vyžaduje prístup na internet cez proxy server, musíte pred spustením inštalačného skriptu nastaviť príslušné premenné prostredia. Nastavte premenné prostredia http_proxy a https_proxy v aktuálnej bash session:

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 -

Nahraďte URL proxy skutočnými údajmi vášho proxy servera vrátane autentifikačných údajov, ak ich vaša sieťová konfigurácia vyžaduje.

Docker

Docker poskytuje alternatívnu metódu nasadenia, ktorá ponúka konzistentnosť medzi rôznymi hostiteľskými systémami a zjednodušenú správu prostredníctvom kontejnerizácie. Docker image SDA Glue je založený na Debiane a obsahuje všetky potrebné vopred nakonfigurované závislosti, čím odpadá potreba manuálnej kompilácie alebo správy závislostí.

Ak chcete nasadiť SDA Glue pomocou Dockeru, spustite nasledujúci príkaz s požadovanými sieťovými schopnosťami:

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

Tento príkaz vytvorí trvalý kontejner s názvom „glue“, ktorý sa automaticky restartuje, ak sa neočakávane zastaví. Pripojený volume zachová konfiguračné a autentifikačné údaje vašej brány medzi restartmi alebo aktualizáciami kontejnera.

Zároveň presmeruje port kontejnera 8080 na port hostiteľa 8081, na ktorom beží webový server Glue na nastavenie aplikácie. Následne k nemu môžete pristúpiť na http://localhost:8081/.

informácia

Pri spúšťaní viacerých kontejnerov SDA Glue na tom istom hostiteľovi zabezpečte, aby každý kontejner používal jedinečné názvy a pripojené volumes, aby sa predišlo konfliktom:

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

Komplexné pokyny na nasadenie v Dockeri vrátane pokročilých sieťových konfigurácií, krokov na riešenie problémov a najlepších postupov pre produkčné nasadenie nájdete v úplnej dokumentácii:

Kompletné podrobnosti o nasadení, príklady konfigurácie a pokyny na riešenie problémov.

Windows

Otvorte PowerShell ako administrátor tak, že vyhľadáte „PowerShell“ vo vyhľadávacom paneli Windows, kliknete pravým tlačidlom na výsledok a vyberiete „Spustiť ako správca“. Keď máte otvorenú PowerShell session so zvýšenými oprávneniami, vykonajte nasledujúci príkaz:

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

Tento PowerShell príkaz používa Invoke-WebRequest (skrátene iwr) na stiahnutie inštalačného skriptu a presmeruje ho do Invoke-Expression (skrátene iex) na okamžité vykonanie. Parameter -UseBasicParsing zaisťuje kompatibilitu s rôznymi verziami a konfiguráciami systému Windows.

Úspešná inštalácia SDA Glue pomocou PowerShellu

Podrobnosti o inštalačnom procese v systéme Windows

Inštalačný proces v systéme Windows používa PowerShell na stiahnutie a vykonanie inštalačného skriptu, ktorý nakonfiguruje váš systém pre konektivitu SDA. Na rozdiel od prístupu v Linuxe, kde sa softvér kompiluje zo zdrojového kódu, inštalátor pre Windows stiahne vopred zostavené binárne súbory OpenVPN Community Client a služby SDA Glue a potom zaregistruje SDA Glue ako službu Windows.

Integrácia služby Windows zabezpečuje, že SDA Glue sa spúšťa automaticky spolu s vašim systémom a automaticky sa restartuje, ak narazí na akékoľvek problémy. To poskytuje rovnaké výhody spoľahlivosti ako prístup systemd v Linuxe, ale využíva natívnu infrastruktúru správy služieb systému Windows.

Podobne ako pri prístupe v Linuxe si môžete inštalačný skript pred vykonaním preštudovať odstránením časti | iex alebo priamym otvorením adresy https://api.eu1.sdaconsole.io/glue/v1/install.ps1 vo webovom prehliadači.

Windows s proxy

Ak váš systém Windows funguje za proxy serverom, inštalačný proces vyžaduje dvojfázový prístup. Najprv nakonfigurujete nastavenia proxy a stiahnete inštalačný skript. Potom skript vykonáte s príslušnou konfiguráciou proxy.

Začnite nastavením PowerShell premenných pre konfiguráciu 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

Všimnite si dôležitý rozdiel vo formátovaní URL proxy: príkaz Invoke-WebRequest vyžaduje úplnú schému URL (http://proxy.company.com:8080), zatiaľ čo inštalačný skript očakáva iba názov hostiteľa a port (proxy.company.com:8080).

Ako uvádzajú logy v spodnej časti, musíme proxy server v SDA Glue nakonfigurovať pomocou CLI

Autentifikácia a prihlásenie

Po úspešnej inštalácii softvéru SDA Glue musíte svoju fyzickú bránu autentifikovať v službách SDA Cloud. Tento autentifikačný proces využíva jedinečné prihlasovacie údaje vygenerované SDA Console pre vašu konkrétnu bránu. Tieto údaje sa skladajú z krátkeho identifikátora brány a jednorazového hesla, ktoré sa pre zvýšenie bezpečnosti periodicky obmieňa.

Príkazy na nastavenie brány zo SDA Console

Vráťte sa do SDA Console a nájdite druhý príkaz v dialógu nastavenia vašej brány. Tento príkaz bude vyzerať podobne ako nasledujúce príklady:

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

Štruktúra príkazu obsahuje prepínač -e eu1, ktorý určuje endpoint európskeho regiónu, za ktorým nasleduje jedinečný identifikátor vašej brány (napríklad G1ABCD) a jednorazové heslo (napríklad 123456). Tieto hodnoty sú špecifické pre vašu bránu a budú sa líšiť od uvedených príkladov.

informácia

Jednorazové heslo sa z bezpečnostných dôvodov periodicky obnovuje. Ak sa vyskytnú chyby autentifikácie, vráťte sa do SDA Console a získajte aktuálne heslo z dialógu nastavenia brány.

Stav služby

Po dokončení inštalácie a autentifikácie overte, že služba SDA Glue vo vašom systéme beží správne.

Linux

Skontrolujte stav služby pomocou príkazov systemd:

sudo systemctl status sdaglue

Na sledovanie živého výstupu logov a riešenie prípadných problémov:

sudo journalctl -efu sdaglue -n 100

Docker

Logy služby je možné získať z Docker kontejnerov pomocou:

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

Windows

Službu môžete overiť prostredníctvom aplikácie Služby systému Windows. Vyhľadajte „Services“ vo vyhľadávacom paneli Windows a v zozname služieb nájdite „SDA Glue“. Služba by sa mala zobrazovať ako „Running“ s typom spustenia „Automatic“.

Zobrazenie aktívnych služieb v systéme Windows

Služby Windows vytvárajú protokoly udalostí (Event Logs), ktoré sú dostupné v aplikácii Event Viewer v časti Windows Logs → Application. Event Viewer otvoríte pomocou vyhľadávacieho panela.

Prístup k logom SDA Glue v aplikácii Event Viewer

Konfigurácia

SDA Glue vám umožňuje upraviť svoje správanie tak, aby optimálne fungovalo vo vašom konkrétnom sieťovom prostredí. Tieto konfiguračné úpravy zabezpečujú spoľahlivú konektivitu bez ohľadu na jedinečné charakteristiky vašej priemyselnej siete, či už máte do činenia s proxy servermi, obmedzeniami firewallu alebo odlišnými komunikačnými protokolmi.

Na riadenie služby používame premenné prostredia. Aby sa zmeny konfigurácie uplatnili, je potrebný restart služby. Premenné prostredia zachovávajú rovnakú konvenciu pomenovania konfiguračných parametrov, používajú však predponu GLUE a sú oddelené podčiarkovníkmi:

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

Zobrazenie aktuálnych konfiguračných parametrov:

# Linux & Windows
sdaglue config describe

# Docker
docker exec glue sdaglue config describe

Nastavenie parametrov:

# 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

Získanie parametrov:

# Linux & Windows
sdaglue config list

# Docker
docker exec sdaglue config list

Restart služby po zmenách:

# Linux & Windows
sdaglue service restart

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

Transportný protokol MQTT

Jedným z najdôležitejších konfiguračných rozhodnutí je výber spôsobu, akým vaša brána komunikuje so službami SDA Cloud. SDA Glue podporuje dva transportné protokoly, z ktorých každý je určený pre odlišné sieťové prostredia:

Transport	Protokol	Port	Prípad použitia
MQTT	SSL / TCP	443	Štandardné siete s priamym prístupom na internet
MQTT cez WebSocket	WebSocket Secure (TCP)	443	Siete s transparentnými proxy alebo SSL inšpekciou

Pre transport WebSocket:

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

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

Pre štandardný transport MQTT:

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

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

informácia

Ak je služba už prihlásená a pripojená, nový transportný protokol sa uplatní až po nasledujúcom restarte služby.

Kedy použiť transport WebSocket

Transparentné proxy: Niektoré firemné siete používajú transparentné proxy, ktoré zachytávajú a analyzujú sieťovú prevádzku. Tieto proxy môžu narúšať štandardné MQTT SSL pripojenia, ale typicky umožňujú bezproblémový prechod WebSocket pripojení.

Restriktívne firewally: Siete s hĺbkovou inšpekciou paketov alebo striktnou filtráciou protokolov môžu blokovať prevádzku MQTT, pričom povoľujú WebSocket pripojenia, ktoré sa javia podobne ako štandardná webová prevádzka.

Firemné sieťové politiky: Niektoré organizácie majú politiky, ktoré obmedzujú protokoly odlišné od HTTP, čím sa transport WebSocket stáva preferovanou voľbou z hľadiska súladu.

Proxy server

Ak vaša sieť vyžaduje, aby všetka internetová prevádzka prechádzala cez konkrétny proxy server, SDA Glue musí byť nakonfigurované s údajmi proxy, aby mohlo vytvoriť pripojenie k službám SDA Cloud. To je bežné najmä vo firemných prostrediach, kde je priamy prístup na internet z bezpečnostných dôvodov obmedzený.

Adresy proxy majú štandardný formát: scheme://username:password@hostname:port

• Scheme: Obvykle http:// alebo https://
• Username/Password: Autentifikačné údaje (ak ich vaše proxy vyžaduje)
• Hostname: Adresa proxy servera
• Port: Číslo portu proxy servera

Musíte nakonfigurovať nastavenia proxy pre HTTP aj HTTPS, aby ste zabezpečili úplné pokrytie komunikačných potrieb SDA Glue.

informácia

Ak váš proxy server nevyžaduje autentifikáciu, jednoducho vynechajte používateľské meno a heslo:

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

Bežné problémy

Firemná sieť s transparentným proxy

Problém: Brána sa najprv pripojí, ale často sa odpája alebo vykazuje nestabilnú konektivitu.

Riešenie: Prepnite na transportný protokol WebSocket.

Prostredie s restriktívnym firewallom

Problém: Brána nemôže vytvoriť počiatočné pripojenie k službám SDA Cloud.

Riešenie: Nakonfigurujte transport WebSocket a overte, že odchádzajúce HTTPS pripojenia sú povolené na porte 443.

Proxy server s autentifikáciou

Problém: Brána sa nemôže pripojiť cez firemné proxy vyžadujúce autentifikáciu.

Riešenie: Nakonfigurujte obe nastavenia proxy so správnymi autentifikačnými údajmi a restartujte službu.

Po správnom nastavení týchto konfiguračných možností sa služba SDA Glue prispôsobí vášmu sieťovému prostrediu a bude udržiavať spoľahlivú konektivitu so službami SDA Cloud, čím umožní bezpečný prístup k vašim priemyselným zariadeniam.