Přeskočit obsah

Připojení serveru Edge Gateway pomocí mechanismu pairingu

Informace

Metoda připojení pomocí pairingu funguje pro server Edge Gateway stejně jako pro server HTML5 Gateway.

Předpoklady

Je vyžadován přístup přes SSH nebo z konzoly k serveru Edge Gateway s uživatelem root.

Aby byl pairing serveru Edge Gateway úspěšný, musí být na počítači nainstalován balíček ipdiva-gateway-setup. Všechna virtuální zařízení CyberElements Bastion (verze 4.6 nebo novější) tento balíček obsahují.
Pokud je úložiště Systancia správně nakonfigurováno, následující příkaz ověří přítomnost balíčku a v případě potřeby se jej pokusí nainstalovat:

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

Připojte se k serveru Edge Gateway přes SSH nebo v režimu konzoly s uživatelem root a spusťte příkaz obdobný následujícímu, abyste zahájili proces pairingu pro server Edge Gateway nebo 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

Zde jsou podrobnosti o jednotlivých možnostech:

  • -s: definuje název DNS serveru Mediation Controller; lze použít adresu IP, ale pravděpodobně to bude vyžadovat použití nezabezpečeného režimu.
  • -t: definuje token pairingu, který se má použít (vygenerování tokenu pairingu).
  • -k: aktivace nezabezpečeného režimu, ve kterém je zakázána kontrola platnosti webového certifikátu serveru Mediation Controller. Toto nastavení by se nemělo používat systematicky, ale pouze v kontextech, kde je to nutné a kde byla vyloučena přítomnost útočníka typu MITM (ověření webového certifikátu zajišťuje identitu kontaktovaného serveru).
  • -n: definice přípony názvu instance Edge Gateway na počítači; pokud není definována, použije se název hlavní instance, gateway nebo html5gateway. Zadávejte pouze název obsahující číslice, písmena nebo speciální znaky - či _. Při prvním připojení serveru Edge Gateway nebo HTML5 Gateway k serveru se doporučuje parametr -n nenastavovat.
  • --no-care: pairing se nepokusí nainstalovat certifikát služby nahrávání.
  • -v: aktivace podrobného režimu pro získání dalších informací o procesu pairingu.

Příklady

Pro instalaci první instance Edge Gateway na počítači by stačil následující pří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

Pokud je však přístup k serveru Mediation Controller možný pouze přes IP adresu, jejíž webový certifikát není vhodný, je nutné povolit nezabezpečený režim (nejlépe jej používejte, když připojení neprochází veřejnou sítí):

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

Pokud je již na počítači přítomna první instance Edge Gateway, bylo by nutné vytvořit novou instanci bez úpravy certifikátu služby nahrávání:

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

Předchozí příkaz vytvořením nové instance s názvem gateway-instance-2 (komponenty Edge Gateway automaticky získávají předponu gateway-, zatímco komponenty HTML5 Gateway předponu html5gateway-) vytvoří také nové adresáře pro:

  • Spravovat nastavení instance pomocí adresáře /etc/ipdiva/gateway-instance-2/.
  • Spouštět, zastavovat nebo restartovat instanci pomocí skriptů v adresáři /usr/local/ipdiva/gateway-instance-2/bin/.