Siirry pääsisältöön

Vaihe 2: Yhdyskäytävän asennus ja konfigurointi

Kun yhdyskäytäväsi ja laitteesi on konfiguroitu SEW OrchestrationSuitessa, seuraava vaihe on SDA Glue -palvelun asentaminen valitsemallesi yhdyskäytävälaitteistolle. Asennusprosessi eroaa Linux- ja Windows-järjestelmien välillä, mutta molemmat lähestymistavat noudattavat samaa perusperiaatetta: ladataan ja konfiguroidaan palvelu, joka toimii jatkuvasti taustalla valmiina muodostamaan turvallisia tunneleita tarvittaessa.

Asennus​

Asennusprosessi koostuu kahdesta päävaiheesta:

  1. Asenna SDA Glue ja riippuvuudet kohdejärjestelmään.
  2. Konfiguroi palvelu SEW OrchestrationSuitesta saaduilla yksilöllisillä tunnistetiedoilla, jotka todentavat tietyn yhdyskäytävän.

Varmista ennen asennuksen aloittamista, että sinulla on hallinnolliset oikeudet kohdejärjestelmään. Asennusprosessi edellyttää korotettuja oikeuksia järjestelmäpalvelun asentamiseksi. Linuxissa tarvitset sudo-oikeudet. Windowsissa sinun on suoritettava PowerShell järjestelmänvalvojana.

varoitus

Asennusprosessi tukee välityspalvelinympäristöjä, mutta edellyttää lisäkonfigurointivaiheita, jotka käsitellään yksityiskohtaisesti kussakin alustakohtaisessa osiossa.

Linux​

Asenna SDA Glue Linux-järjestelmään, jolla on suora internetyhteys, suorittamalla seuraava komento päätteessä:

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

Tämä komento käyttää curlia asennusskriptin turvalliseen hakemiseen suoraan SEW:n API-päätepisteestä ja ohjaa sen bashille välittömään suorittamiseen. -sSL-liput varmistavat, että siirto on hiljainen, näyttää virheet niiden ilmetessä ja seuraa mahdollisia uudelleenohjauksia turvallisesti.

Tietoja Linux-asennusprosessista

Linux-asennus käyttää automatisoitua komentotulkkiskriptiä, joka hoitaa SDA Glue -palvelun rakentamisen ja konfiguroinnin monimutkaisen prosessin. Tämä skripti suorittaa useita kriittisiä tehtäviä: se asentaa tarvittavat suoritusaikaiset riippuvuudet ja käännöstyökalut, lataa ja kääntää SoftEther VPN Clientin SEW:n turvallisesta ohjelmistolähteestä sekä asentaa SDA Gluen systemd-palveluna, joka käynnistyy automaattisesti järjestelmän mukana.

Käännöslähestymistapa varmistaa yhteensopivuuden eri Linux-jakeluiden välillä ja säilyttää turvallisuuden rakentamalla varmennetusta lähdekoodista. systemd-palveluintegraatio tarkoittaa, että yhdyskäytävä käynnistyy automaattisesti uudelleen ongelmien ilmetessä ja alkaa toimia välittömästi järjestelmän käynnistyessä.

Jos haluat tarkastella asennusskriptiä ennen sen suorittamista, voit hakea sen erikseen poistamalla komennosta | bash - -osan tai avaamalla osoitteen https://api.eu1.sdaconsole.io/glue/v1/install.sh suoraan verkkoselaimessa. Tämä läpinäkyvyys antaa sinulle mahdollisuuden ymmärtää tarkalleen, mitä asennusprosessi järjestelmässäsi tekee.

Linux välityspalvelimen kanssa​

Kun Linux-järjestelmäsi tarvitsee internetyhteyden välityspalvelimen kautta, sinun on määritettävä asianmukaiset ympäristömuuttujat ennen asennusskriptin suorittamista. Aseta http_proxy- ja https_proxy-ympäristömuuttujat nykyisessä bash-istunnossasi:

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 -

Korvaa välityspalvelimen URL-osoite todellisilla välityspalvelimesi tiedoilla, mukaan lukien tunnistetiedot, jos verkkokonfiguraatiosi sitä vaatii.

Docker​

Docker tarjoaa vaihtoehtoisen käyttöönottotavan, joka takaa yhdenmukaisuuden eri isäntäjärjestelmien välillä ja yksinkertaistetun hallinnan kontitusta hyödyntämällä. SDA Glue -Docker-vedos perustuu Debianiin ja sisältää kaikki tarvittavat riippuvuudet valmiiksi konfiguroituina, joten manuaalista kääntämistä tai riippuvuuksien hallintaa ei tarvita.

Ota SDA Glue käyttöön Dockerilla suorittamalla seuraava komento tarvittavilla verkko-ominaisuuksilla:

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

Tämä komento luo pysyvän kontin nimeltä "glue", joka käynnistyy automaattisesti uudelleen, jos se pysähtyy odottamattomasti. Levyniteen liitos säilyttää yhdyskäytävän konfiguraation ja todennustiedot konttien uudelleenkäynnistyksien tai päivitysten välillä.

Se ohjaa myös kontin portin 8080 isännän porttiin 8081, jossa toimii Gluen verkkopalvelin sovelluksen käyttöönottoa varten. Voit tämän jälkeen käyttää sitä osoitteessa http://localhost:8081/.

tietoa

Kun samassa isännässä ajetaan useita SDA Glue -kontteja, varmista, että jokainen kontti käyttää yksilöllisiä nimiä ja levyniteiden liitoksia ristiriitojen välttämiseksi:

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

Kattavat ohjeet Docker-käyttöönottoon, mukaan lukien edistyneet verkkokonfiguraatiot, vianmääritysvaiheet ja tuotantokäyttöönoton parhaat käytännöt, löytyvät täydellisestä dokumentaatiosta:

Täydelliset käyttöönottotiedot, konfiguraatioesimerkit ja vianmääritysohjeet.

Windows​

Avaa PowerShell järjestelmänvalvojana etsimällä "PowerShell" Windowsin hakupalkista, napsauttamalla tulosta hiiren kakkospainikkeella ja valitsemalla "Suorita järjestelmänvalvojana". Kun sinulla on korotettu PowerShell-istunto, suorita seuraava komento:

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

Tämä PowerShell-komento käyttää Invoke-WebRequest-komentoa (lyhennettynä iwr) asennusskriptin hakemiseen ja ohjaa sen Invoke-Expression-komennolle (lyhennettynä iex) välitöntä suorittamista varten. -UseBasicParsing-parametri varmistaa yhteensopivuuden eri Windows-versioiden ja -konfiguraatioiden välillä.

SDA Gluen onnistunut asennus PowerShellillä

Tietoja Windows-asennusprosessista

Windows-asennusprosessi käyttää PowerShelliä asennusskriptin lataamiseen ja suorittamiseen, joka konfiguroi järjestelmän SEW-liitettävyyttä varten. Toisin kuin Linux-lähestymistapa, joka kääntää ohjelmiston lähdekoodista, Windows-asennusohjelma lataa esikäännetyt binaarit OpenVPN Community Clientista ja SDA Glue -palvelusta ja rekisteröi sitten SDA Gluen Windows-palveluna.

Windows-palveluintegraatio varmistaa, että SDA Glue käynnistyy automaattisesti järjestelmän mukana ja käynnistyy automaattisesti uudelleen, jos se kohtaa ongelmia. Tämä tarjoaa samat luotettavuushyödyt kuin Linuxin systemd-lähestymistapa, mutta käyttää Windowsin omaa palvelunhallintainfrastruktuuria.

Kuten Linuxissa, voit tarkastella asennusskriptiä ennen sen suorittamista poistamalla | iex -osan tai avaamalla osoitteen https://api.eu1.sdaconsole.io/glue/v1/install.ps1 suoraan verkkoselaimessa.

Windows välityspalvelimen kanssa​

Kun Windows-järjestelmäsi toimii välityspalvelimen takana, asennusprosessi edellyttää kaksivaiheista lähestymistapaa. Ensin konfiguroidaan välityspalvelinasetukset ja ladataan asennusskripti. Sen jälkeen skripti suoritetaan asianmukaisella välityspalvelinkonfiguraatiolla.

Aloita asettamalla PowerShell-muuttujat välityspalvelinkonfiguraatiollesi:

# 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

Huomioi tärkeä ero välityspalvelimen URL-osoitteen muotoilussa: Invoke-WebRequest-komento edellyttää täydellistä URL-skeemaa (http://proxy.company.com:8080), kun taas asennusskripti odottaa pelkkää isäntänimeä ja porttia (proxy.company.com:8080).

Kuten alareunan lokit osoittavat, välityspalvelin on konfiguroitava SDA Glueen CLI:n avulla

Todennus ja kirjautuminen​

Kun SDA Glue -ohjelmisto on asennettu onnistuneesti, fyysinen yhdyskäytäväsi on todennettava SEW Cloud -palveluihin. Tämä todennusprosessi käyttää SEW OrchestrationSuiten kyseiselle yhdyskäytävälle luomia yksilöllisiä tunnistetietoja. Nämä tunnistetiedot koostuvat lyhyestä yhdyskäytävätunnisteesta ja kertakäyttöisestä salasanasta, joka vaihtuu säännöllisesti turvallisuuden parantamiseksi.

Yhdyskäytävän käyttöönottokomennot SEW OrchestrationSuitesta

Palaa SEW OrchestrationSuiteen ja etsi toinen komento yhdyskäytäväsi käyttöönottoikkunasta. Komento näyttää samankaltaiselta kuin seuraavat esimerkit:

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

Komentorakenne sisältää -e eu1 -lipun, joka määrittää Euroopan alueen päätepisteen, sekä sen jälkeen yhdyskäytäväsi yksilöllisen tunnisteen (kuten G1ABCD) ja kertakäyttöisen salasanan (kuten 123456). Nämä arvot ovat yhdyskäytäväsi omat ja poikkeavat esimerkeissä esitetyistä.

tietoa

Kertakäyttöinen salasana päivittyy säännöllisesti turvallisuussyistä. Jos todennus ei onnistu, palaa SEW OrchestrationSuiteen hakemaan voimassa oleva salasana yhdyskäytävän käyttöönottoikkunasta.

Palvelun tila​

Kun asennus- ja todennusprosessi on suoritettu, varmista, että SDA Glue -palvelu toimii järjestelmässäsi oikein.

Linux​

Tarkista palvelun tila systemd-komennoilla:

sudo systemctl status sdaglue

Lokitulosteen reaaliaikaiseen seurantaan ja ongelmien vianmääritykseen:

sudo journalctl -efu sdaglue -n 100

Docker​

Palvelun lokit voidaan hakea Docker-konteista komennolla:

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

Windows​

Voit tarkistaa palvelun Windowsin Palvelut-sovelluksesta. Etsi "Palvelut" Windowsin hakupalkista ja etsi "SDA Glue" palveluluettelosta. Palvelun tilana pitäisi näkyä "Käynnissä" ja käynnistystyyppinä "Automaattinen".

Aktiivisten palveluiden tarkastelu Windowsissa

Windows-palvelut tuottavat tapahtumalokeja, joita voi tarkastella Tapahtumienvalvonnassa kohdassa Windows-lokit → Sovellus. Käytä hakupalkkia Tapahtumienvalvonnan avaamiseen.

SDA Gluen lokien tarkastelu Tapahtumienvalvonnassa

Konfigurointi​

SDA Gluen toimintaa voi muokata niin, että se toimii optimaalisesti omassa verkkoympäristössäsi. Nämä konfigurointimuutokset varmistavat luotettavan liitettävyyden riippumatta teollisuusverkkosi erityispiirteistä, olipa kyse välityspalvelimista, palomuurirajoituksista tai eri tietoliikenneprotokollista.

Palvelua ohjataan ympäristömuuttujien avulla. Konfiguraatiomuutokset edellyttävät palvelun uudelleenkäynnistystä tullakseen voimaan. Ympäristömuuttujat noudattavat samaa konfiguraatioparametrien nimeämiskäytäntöä, mutta käyttävät GLUE-etuliitettä ja alaviivoja erottimina:

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

Nykyisten konfiguraatioparametrien tarkastelu:

# Linux & Windows
sdaglue config describe

# Docker
docker exec glue sdaglue config describe

Parametrien asettaminen:

# 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

Parametrien hakeminen:

# Linux & Windows
sdaglue config list

# Docker
docker exec sdaglue config list

Palvelun uudelleenkäynnistys muutosten jälkeen:

# Linux & Windows
sdaglue service restart

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

MQTT-siirtoprotokolla​

Yksi tärkeimmistä konfigurointipäätöksistä koskee sitä, miten yhdyskäytävä kommunikoi SEW Cloud -palveluiden kanssa. SDA Glue tukee kahta siirtoprotokollaa, jotka on suunniteltu erilaisiin verkkoympäristöihin:

SiirtotapaProtokollaPorttiKäyttötapaus
MQTTSSL / TCP443Vakioverkot, joissa on suora internetyhteys
MQTT WebSocketin yliWebSocket Secure (TCP)443Verkot, joissa on läpinäkyviä välityspalvelimia tai SSL-tarkastus

WebSocket-siirtotapa:

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

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

Vakiomuotoinen MQTT-siirtotapa:

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

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

Jos palvelu on jo kirjautunut sisään ja yhdistetty, uusi siirtoprotokolla tulee voimaan vasta seuraavan palvelun uudelleenkäynnistyksen jälkeen.

Milloin WebSocket-siirtotapaa kannattaa käyttää

Läpinäkyvät välityspalvelimet: Jotkin yritysverkot käyttävät läpinäkyviä välityspalvelimia, jotka sieppaavat ja analysoivat verkkoliikennettä. Nämä välityspalvelimet voivat häiritä vakiomuotoisia MQTT SSL -yhteyksiä, mutta yleensä päästävät WebSocket-yhteydet läpi ongelmitta.

Rajoittavat palomuurit: Verkot, joissa käytetään syvää pakettitarkastusta tai tiukkaa protokollasuodatusta, voivat estää MQTT-liikenteen mutta sallia WebSocket-yhteydet, jotka vaikuttavat tavalliselta verkkoliikenteeltä.

Yritysverkkojen käytännöt: Joissakin organisaatioissa on käytäntöjä, jotka rajoittavat muita kuin HTTP-protokollia, mikä tekee WebSocket-siirtotavasta suositellun valinnan vaatimustenmukaisuuden kannalta.

Välityspalvelin​

Kun verkkosi vaatii kaiken internetliikenteen kulkevan tietyn välityspalvelimen kautta, SDA Glue on konfiguroitava välityspalvelimen tiedoilla yhteyksien muodostamiseksi SEW Cloud -palveluihin. Tämä on erityisen yleistä yritysympäristöissä, joissa suora internetyhteys on rajoitettu turvallisuussyistä.

Välityspalvelinosoitteet noudattavat vakiomuotoa: scheme://username:password@hostname:port

  • Skeema: Yleensä http:// tai https://
  • Käyttäjätunnus/salasana: Tunnistetiedot (jos välityspalvelin niitä vaatii)
  • Isäntänimi: Välityspalvelimen osoite
  • Portti: Välityspalvelimen porttinumero

Sinun on konfiguroitava sekä HTTP- että HTTPS-välityspalvelinasetukset, jotta SDA Gluen kaikki tietoliikennetarpeet katetaan.

tietoa

Jos välityspalvelimesi ei vaadi todennusta, jätä käyttäjätunnus ja salasana yksinkertaisesti pois:

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

Yleisiä ongelmia​

Yritysverkko läpinäkyvällä välityspalvelimella​

Ongelma: Yhdyskäytävä yhdistää aluksi, mutta katkaisee yhteyden usein tai yhteys on epävakaa.

Ratkaisu: Vaihda WebSocket-siirtoprotokollaan.

Rajoittava palomuuriympäristö​

Ongelma: Yhdyskäytävä ei pysty muodostamaan ensimmäistä yhteyttä SEW Cloud -palveluihin.

Ratkaisu: Konfiguroi WebSocket-siirtotapa ja varmista, että lähtevät HTTPS-yhteydet on sallittu portissa 443.

Todennusta vaativa välityspalvelin​

Ongelma: Yhdyskäytävä ei pysty muodostamaan yhteyttä todennusta vaativan yritysvälityspalvelimen kautta.

Ratkaisu: Konfiguroi molemmat välityspalvelinasetukset asianmukaisilla tunnistetiedoilla ja käynnistä palvelu uudelleen.

Kun nämä konfiguraatiovalinnat on asetettu oikein, SDA Glue -palvelu sopeutuu verkkoympäristöösi ja ylläpitää luotettavaa yhteyttä SEW Cloud -palveluihin, mikä mahdollistaa turvallisen pääsyn teollisuuslaitteisiisi.