Preskočiť na obsah

Pripojenie komponentu Edge Gateway pomocou mechanizmu pairingu

Informácie

Metóda pripojenia cez pairing funguje pre Edge Gateway rovnako ako pre HTML5 Gateway.

Predpoklady

Vyžaduje sa prístup cez SSH alebo konzolu ku komponentu Edge Gateway s používateľom root.

Aby bol pairing komponentu Edge Gateway úspešný, na počítači musí byť nainštalovaný balík ipdiva-gateway-setup. Všetky virtuálne zariadenia CyberElements (verzia 4.6 alebo novšia) tento balík obsahujú.
Ak je úložisko Systancia správne nakonfigurované, nasledujúci príkaz skontroluje prítomnosť balíka a v prípade potreby sa ho pokúsi nainštalovať:

1
if dpkg -s ipdiva-gateway-setup &>/dev/null 2>&1; then echo -e "\033[0;32mipdiva-gateway-setup package already installed\033[0m"; else apt update && apt install -y ipdiva-gateway-setup; fi

Pripojte sa k serveru Edge Gateway cez SSH alebo v režime konzoly s používateľom root a spustite príkaz podobný nasledujúcemu, aby ste spustili proces pairingu pre Edge Gateway alebo HTML5 Gateway:

1
/usr/local/ipdiva/scripts/gateway-setup/pair_gateway.py -s <DNS_MEDIATION_CONTROLLER> -t <PAIRING_TOKEN> -k -n <INSTANCE_NAME> --no-care -v

Tu sú podrobnosti o jednotlivých možnostiach:

  • -s: definuje názov DNS servera Mediation Controller alebo tenanta CyberElements; možno použiť IP adresu, ale pravdepodobne si to vyžiada použitie nezabezpečeného režimu.
  • -t: definuje token pairingu, ktorý sa má použiť (generovanie tokenu pairingu).
  • -k: aktivácia nezabezpečeného režimu, v ktorom je kontrola platnosti webového certifikátu servera Mediation Controller zakázaná. Toto nastavenie by sa nemalo používať systematicky, iba v kontextoch, kde je to nevyhnutné a kde bola vylúčená prítomnosť útočníka typu MITM (overenie webového certifikátu zaručuje identitu kontaktovaného servera).
  • -n: definícia prípony názvu inštancie Edge Gateway na počítači; ak nie je definovaná, použije sa názov hlavnej inštancie, gateway alebo html5gateway. Zadajte iba názov obsahujúci číslice, písmená alebo špeciálne znaky - alebo _. Pri prvom pripojení komponentu Edge Gateway alebo HTML5 Gateway k serveru sa odporúča parameter -n nenastavovať.
  • --no-care: pairing sa nepokúsi nainštalovať certifikát služby nahrávania.
  • -v: aktivácia podrobného režimu na získanie ďalších informácií o procese pairingu.

Príklady

Na inštaláciu prvej inštancie Edge Gateway na počítači by stačil nasledujúci príkaz:

1
/usr/local/ipdiva/scripts/gateway-setup/pair_gateway.py -s mediation-controller.domain.local -t TCGX-091U-AIBW-EWF7-T7XW-1VLK-LPS8-2DWS

Ak je však prístup k serveru Mediation Controller možný iba cez IP adresu, ktorej webový certifikát nie je vhodný, je potrebné povoliť nezabezpečený režim (najlepšie ho používať, keď pripojenie neprechádza verejnou sieťou):

1
/usr/local/ipdiva/scripts/gateway-setup/pair_gateway.py -s 10.0.10.10 -t TCGX-091U-AIBW-EWF7-T7XW-1VLK-LPS8-2DWS -k

Ak je na počítači už prítomná prvá inštancia Edge Gateway, bolo by potrebné vytvoriť novú inštanciu bez úpravy certifikátu služby nahrávania:

1
/usr/local/ipdiva/scripts/gateway-setup/pair_gateway.py -s 10.0.10.10 -t TCGX-091U-AIBW-EWF7-T7XW-1VLK-LPS8-2DWS -k --no-care -n instance-2

Predchádzajúci príkaz vytvorením novej inštancie s názvom gateway-instance-2 (komponenty Edge Gateway automaticky dostávajú predponu gateway-, zatiaľ čo komponenty HTML5 Gateway predponu html5gateway-) vytvorí aj nové adresáre na:

  • Spravovanie nastavení inštancie pomocou adresára /etc/ipdiva/gateway-instance-2/.
  • Spustenie, zastavenie alebo reštartovanie inštancie pomocou skriptov v adresári /usr/local/ipdiva/gateway-instance-2/bin/.