2. lépés: Az átjáró telepítése és konfigurálása

Miután az átjáróját és eszközeit konfigurálta a SEW OrchestrationSuite felületén, a következő fázis az SDA Glue szolgáltatás telepítése a kiválasztott átjáróhardverre. Ez a telepítési folyamat eltér a Linux és a Windows rendszerek esetében, de mindkét megközelítés ugyanazt az alapelvet követi: letölt és konfigurál egy szolgáltatást, amely folyamatosan fut a háttérben, és készen áll arra, hogy igény szerint biztonságos alagutakat hozzon létre.

Telepítés

A telepítési folyamat két fő fázisból áll:

1. Telepítse az SDA Glue-t és a függőségeket a célrendszerre.
2. Konfigurálja a szolgáltatást a SEW OrchestrationSuite egyedi hitelesítő adataival, amelyek egy adott átjárót hitelesítenek.

A telepítés megkezdése előtt győződjön meg arról, hogy rendszergazdai jogosultságokkal rendelkezik a célrendszeren. A telepítési folyamat emelt szintű jogosultságokat igényel a rendszerszolgáltatás telepítéséhez. Linux esetén sudo hozzáférésre lesz szüksége. Windows esetén a PowerShellt rendszergazdaként kell futtatnia.

vigyázat

A telepítési folyamat proxykörnyezetekben is használható, de további konfigurációs lépéseket igényel, amelyeket az egyes platformspecifikus szakaszokban részletezünk.

Linux

Az SDA Glue telepítéséhez közvetlen internet-hozzáféréssel rendelkező Linux rendszeren futtassa a következő parancsot egy terminálban:

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

Ez a parancs a curl segítségével biztonságosan lekéri a telepítőszkriptet közvetlenül a SEW API végpontjáról, és azonnali végrehajtás céljából a bash-nek továbbítja. A -sSL kapcsolók biztosítják, hogy az átvitel csendes legyen, hiba esetén megjelenítse a hibákat, és biztonságosan kövesse az esetleges átirányításokat.

Részletek a Linux telepítési folyamatáról

A Linux telepítés egy automatizált shell szkriptet használ, amely kezeli az SDA Glue szolgáltatás összeállításának és konfigurálásának összetett folyamatát. Ez a szkript több kritikus feladatot lát el: telepíti a szükséges futásidejű függőségeket és fordítóeszközöket, letölti és lefordítja a SoftEther VPN Clientet a SEW biztonságos tárolójából, valamint systemd szolgáltatásként telepíti az SDA Glue-t, amely automatikusan elindul a rendszerrel együtt.

A fordításon alapuló megközelítés biztosítja a kompatibilitást a különböző Linux disztribúciók között, miközben az ellenőrzött forráskódból való építés fenntartja a biztonságot. A systemd szolgáltatásintegráció azt jelenti, hogy az átjáró automatikusan újraindul, ha problémába ütközik, és azonnal megkezdi működését a rendszer indításakor.

Ha a végrehajtás előtt szeretné megvizsgálni a telepítőszkriptet, azt külön is lekérheti úgy, hogy eltávolítja a | bash - részt a parancsból, vagy közvetlenül megnyitja a https://api.eu1.sdaconsole.io/glue/v1/install.sh címet a webböngészőjében. Ez az átláthatóság lehetővé teszi, hogy pontosan megértse, mit fog végrehajtani a telepítési folyamat a rendszerén.

Linux proxyval

Ha a Linux rendszere proxykiszolgálón keresztül fér hozzá az internethez, a telepítőszkript futtatása előtt be kell állítania a megfelelő környezeti változókat. Állítsa be a http_proxy és https_proxy környezeti változókat az aktuális bash munkamenetben:

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 -

Cserélje ki a proxy URL-t a tényleges proxykiszolgáló adataira, beleértve a hitelesítési adatokat is, ha a hálózati konfigurációja megköveteli.

Docker

A Docker alternatív telepítési módszert kínál, amely konzisztenciát biztosít a különböző gazdarendszerek között, és egyszerűbb kezelést tesz lehetővé a konténerizáció révén. Az SDA Glue Docker-image Debian alapú, és minden szükséges függőséget előre konfigurálva tartalmaz, így nincs szükség manuális fordításra vagy függőségkezelésre.

Az SDA Glue Docker segítségével történő telepítéséhez futtassa a következő parancsot a szükséges hálózati jogosultságokkal:

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

Ez a parancs létrehoz egy „glue” nevű állandó konténert, amely automatikusan újraindul, ha váratlanul leáll. A csatolt kötet megőrzi az átjáró konfigurációját és hitelesítési adatait a konténer újraindításai vagy frissítései között.

Emellett a 8080-as konténerportot a 8081-es gazdaportra továbbítja, amelyen az alkalmazás beállítására szolgáló Glue webkiszolgáló fut. Ezt követően a http://localhost:8081/ címen érheti el.

információ

Ha több SDA Glue konténert futtat ugyanazon a gazdagépen, ügyeljen arra, hogy minden konténer egyedi nevet és kötetcsatolást használjon a konfliktusok elkerülése érdekében:

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

Az átfogó Docker-telepítési útmutatóért, beleértve a haladó hálózati konfigurációkat, a hibaelhárítási lépéseket és az éles környezetben történő telepítés bevált gyakorlatait, tekintse meg a teljes dokumentációt:

Teljes telepítési részletek, konfigurációs példák és hibaelhárítási útmutató.

Windows

Nyissa meg a PowerShellt rendszergazdaként: keressen rá a „PowerShell” kifejezésre a Windows keresősávjában, kattintson jobb gombbal az eredményre, és válassza a „Futtatás rendszergazdaként” lehetőséget. Miután emelt szintű PowerShell munkamenettel rendelkezik, futtassa a következő parancsot:

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

Ez a PowerShell-parancs az Invoke-WebRequest (rövidítve iwr) segítségével tölti le a telepítőszkriptet, majd azt az Invoke-Expression (rövidítve iex) parancsnak továbbítja azonnali végrehajtásra. A -UseBasicParsing paraméter biztosítja a kompatibilitást a különböző Windows-verziók és konfigurációk között.

Az SDA Glue sikeres telepítése PowerShell segítségével

Részletek a Windows telepítési folyamatáról

A Windows telepítési folyamata PowerShellt használ egy olyan telepítőszkript letöltésére és végrehajtására, amely konfigurálja a rendszert a SEW-kapcsolathoz. A Linux megközelítéssel ellentétben, amely forrásból fordítja a szoftvert, a Windows telepítő előre lefordított binárisokat tölt le az OpenVPN Community Clientből és az SDA Glue szolgáltatásból, majd Windows-szolgáltatásként regisztrálja az SDA Glue-t.

A Windows-szolgáltatásként való integráció biztosítja, hogy az SDA Glue automatikusan elinduljon a rendszerrel, és automatikusan újrainduljon, ha bármilyen problémába ütközik. Ez ugyanazokat a megbízhatósági előnyöket nyújtja, mint a Linux systemd megközelítése, de a Windows natív szolgáltatáskezelési infrastruktúráját használja.

A Linux megközelítéshez hasonlóan a telepítőszkriptet a végrehajtás előtt megvizsgálhatja a | iex rész eltávolításával, vagy a https://api.eu1.sdaconsole.io/glue/v1/install.ps1 cím közvetlen megnyitásával a webböngészőjében.

Windows proxyval

Ha a Windows rendszere proxykiszolgáló mögött működik, a telepítési folyamat kétlépcsős megközelítést igényel. Először konfigurálja a proxybeállításokat, és letölti a telepítőszkriptet. Ezután végrehajtja a szkriptet a megfelelő proxykonfigurációval.

Kezdje a PowerShell-változók beállításával a proxykonfigurációhoz:

# 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

Vegye figyelembe a proxy URL formátumának fontos különbségét: az Invoke-WebRequest parancs a teljes URL-sémát igényli (http://proxy.company.com:8080), míg a telepítőszkript csak a gazdagépnevet és a portot várja (proxy.company.com:8080).

Ahogy az alul látható naplók jelzik, a proxykiszolgálót az SDA Glue-ban a parancssori felület (CLI) segítségével kell konfigurálnunk

Hitelesítés és bejelentkezés

Az SDA Glue szoftver sikeres telepítése után hitelesítenie kell fizikai átjáróját a SEW Cloud szolgáltatásaiban. Ez a hitelesítési folyamat a SEW OrchestrationSuite által az adott átjáróhoz generált egyedi hitelesítő adatokat használja. Ezek a hitelesítő adatok egy rövid átjáróazonosítóból és egy egyszer használatos jelszóból állnak, amely a fokozott biztonság érdekében rendszeresen cserélődik.

Átjáró-beállítási parancsok a SEW OrchestrationSuite felületén

Térjen vissza a SEW OrchestrationSuite felületére, és keresse meg a második parancsot az átjáró beállítási párbeszédpaneljén. Ez a parancs a következő példákhoz hasonlóan néz ki:

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 parancs szerkezete tartalmazza az -e eu1 kapcsolót, amely az európai régió végpontját adja meg, ezt követi az átjáró egyedi azonosítója (például G1ABCD) és az egyszer használatos jelszó (például 123456). Ezek az értékek az adott átjáróra vonatkoznak, és eltérnek a bemutatott példáktól.

információ

Az egyszer használatos jelszó biztonsági okokból rendszeresen frissül. Ha hitelesítési hibába ütközik, térjen vissza a SEW OrchestrationSuite felületére, és kérje le az aktuális jelszót az átjáró beállítási párbeszédpaneljéről.

Szolgáltatás állapota

A telepítési és hitelesítési folyamat befejezése után ellenőrizze, hogy az SDA Glue szolgáltatás megfelelően fut-e a rendszerén.

Linux

Ellenőrizze a szolgáltatás állapotát a systemd parancsokkal:

sudo systemctl status sdaglue

Az élő naplókimenet nyomon követéséhez és a problémák elhárításához:

sudo journalctl -efu sdaglue -n 100

Docker

A szolgáltatás naplói a Docker-konténerekből az alábbi paranccsal kérhetők le:

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

Windows

A szolgáltatást a Windows Szolgáltatások alkalmazásán keresztül ellenőrizheti. Keressen rá a „Szolgáltatások” kifejezésre a Windows keresősávjában, és keresse meg az „SDA Glue” elemet a szolgáltatáslistában. A szolgáltatásnak „Fut” állapotúnak kell lennie, „Automatikus” indítási típussal.

Az aktív szolgáltatások megjelenítése Windowson

A Windows-szolgáltatások eseménynaplókat hoznak létre, amelyek az Eseménynapló alkalmazásban érhetők el, a Windows-naplók → Alkalmazás útvonalon. Az Eseménynapló megnyitásához használja a keresősávot.

Az SDA Glue naplóinak elérése az Eseménynaplóban

Konfiguráció

Az SDA Glue lehetővé teszi a viselkedésének módosítását, hogy optimálisan működjön az adott hálózati környezetben. Ezek a konfigurációs beállítások megbízható kapcsolatot biztosítanak az ipari hálózat egyedi jellemzőitől függetlenül, legyen szó proxykiszolgálókról, tűzfalkorlátozásokról vagy eltérő kommunikációs protokollokról.

A szolgáltatás vezérlésére környezeti változókat használunk. A konfigurációs módosítások érvénybe lépéséhez a szolgáltatás újraindítása szükséges. A környezeti változók ugyanazt a konfigurációsparaméter-elnevezési konvenciót követik, de a GLUE előtagot használják, és aláhúzásjelekkel vannak elválasztva:

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

Az aktuális konfigurációs paraméterek megtekintése:

# Linux & Windows
sdaglue config describe

# Docker
docker exec glue sdaglue config describe

Paraméterek beállítása:

# 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

Paraméterek lekérdezése:

# Linux & Windows
sdaglue config list

# Docker
docker exec sdaglue config list

A szolgáltatás újraindítása a módosítások után:

# Linux & Windows
sdaglue service restart

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

MQTT átviteli protokoll

Az egyik legfontosabb konfigurációs döntés annak megválasztása, hogy az átjáró hogyan kommunikáljon a SEW Cloud szolgáltatásaival. Az SDA Glue két átviteli protokollt támogat, amelyek mindegyike eltérő hálózati környezetekhez készült:

Átvitel	Protokoll	Port	Felhasználási eset
MQTT	SSL / TCP	443	Szabványos hálózatok közvetlen internet-hozzáféréssel
MQTT WebSocketen keresztül	WebSocket Secure (TCP)	443	Átlátszó proxyval vagy SSL-ellenőrzéssel rendelkező hálózatok

WebSocket átvitel esetén:

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

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

Szabványos MQTT átvitel esetén:

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

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

információ

Ha a szolgáltatás már bejelentkezett és csatlakozott, az új átviteli protokoll csak a szolgáltatás következő újraindítása után lép érvénybe.

Mikor érdemes WebSocket átvitelt használni

Átlátszó proxyk: Egyes vállalati hálózatok átlátszó proxykat használnak, amelyek elfogják és elemzik a hálózati forgalmat. Ezek a proxyk zavarhatják a szabványos MQTT SSL-kapcsolatokat, de a WebSocket-kapcsolatokat általában probléma nélkül átengedik.

Korlátozó tűzfalak: A mélycsomag-vizsgálatot vagy szigorú protokollszűrést alkalmazó hálózatok blokkolhatják az MQTT-forgalmat, miközben engedélyezik a WebSocket-kapcsolatokat, amelyek hasonlóak a szokásos webes forgalomhoz.

Vállalati hálózati szabályzatok: Egyes szervezetek olyan szabályzatokkal rendelkeznek, amelyek korlátozzák a nem HTTP protokollokat, így a WebSocket átvitel a megfelelőség szempontjából előnyösebb választás.

Proxykiszolgáló

Ha a hálózata megköveteli, hogy minden internetes forgalom egy adott proxykiszolgálón keresztül haladjon, az SDA Glue-t a proxy adataival kell konfigurálni a SEW Cloud szolgáltatásaival való kapcsolat létrehozásához. Ez különösen gyakori olyan vállalati környezetekben, ahol a közvetlen internet-hozzáférés biztonsági okokból korlátozott.

A proxycímek a szabványos formátumot követik: scheme://username:password@hostname:port

• Séma: Általában http:// vagy https://
• Felhasználónév/jelszó: Hitelesítési adatok (ha a proxy megköveteli)
• Gazdagépnév: A proxykiszolgáló címe
• Port: A proxykiszolgáló portszáma

Mind a HTTP, mind a HTTPS proxybeállításokat konfigurálnia kell az SDA Glue kommunikációs igényeinek teljes lefedéséhez.

információ

Ha a proxykiszolgálója nem igényel hitelesítést, egyszerűen hagyja el a felhasználónevet és a jelszót:

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

Gyakori problémák

Vállalati hálózat átlátszó proxyval

Probléma: Az átjáró kezdetben csatlakozik, de gyakran lekapcsolódik, vagy instabil kapcsolatot mutat.

Megoldás: Váltson WebSocket átviteli protokollra.

Korlátozó tűzfalkörnyezet

Probléma: Az átjáró nem tud kezdeti kapcsolatot létesíteni a SEW Cloud szolgáltatásaival.

Megoldás: Konfigurálja a WebSocket átvitelt, és ellenőrizze, hogy a kimenő HTTPS-kapcsolatok engedélyezettek-e a 443-as porton.

Hitelesítést igénylő proxykiszolgáló

Probléma: Az átjáró nem tud csatlakozni a hitelesítést igénylő vállalati proxyn keresztül.

Megoldás: Konfigurálja mindkét proxybeállítást a megfelelő hitelesítési adatokkal, és indítsa újra a szolgáltatást.

Ha ezek a konfigurációs beállítások megfelelően vannak megadva, az SDA Glue szolgáltatás alkalmazkodik a hálózati környezetéhez, és megbízható kapcsolatot tart fenn a SEW Cloud szolgáltatásaival, lehetővé téve az ipari eszközeinek biztonságos elérését.