Instalace serveru Edge Gateway¶

Poznámka

Připomínáme, že přepnutí na root je na počítačích s Debianem nutné provést následujícím příkazem:

su -

Stažení zrcadla a potřebných nástrojů¶

Zrcadlo CyberElements Cleanroom 4.6 a podpisový klíč úložiště Systancia lze stáhnout z tohoto odkazu (vyžaduje vytvoření zákaznického účtu): Systancia Marketplace

Kromě zrcadla a klíče budou pro proces upgradu potřeba nástroje třetích stran:

Klient SSH (ve Windows můžete použít PuTTY)
Klient SCP (ve Windows lze použít nástroje WinSCP nebo FileZilla)

Pomocí klienta SSH se vzdáleně připojte ke svému serveru.

Pomocí klienta SCP přeneste soubory na vzdálený počítač.

Příprava instalace¶

Konfigurace sítě¶

Důrazně se doporučuje definovat pro server Edge Gateway statickou síťovou adresu. Za tímto účelem nejprve zjistěte název síťového rozhraní svého počítače a jeho adresu MAC. Spusťte následující příkaz jako root:

ip -br link | grep -ve "^lo"

Tento příkaz zobrazí název síťového rozhraní, jeho stav, jeho adresu MAC a nastavení rozhraní.

Příklad

Po provedení příkazu se zobrazí následující výstup:

ens192           UP             00:50:56:a1:56:9f <BROADCAST,MULTICAST,UP,LOWER_UP>

Název síťového rozhraní je ens192 a jeho adresa MAC je 00:50:56:a1:56:9f.

Po zjištění názvu síťového rozhraní a adresy MAC je nyní možné upravit síťovou konfiguraci počítače.
Upravte soubor /etc/network/interfaces podle následující šablony:

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports INTERFACE_NAME
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw MAC_ADDRESS
    address IP_GW
    netmask NETMASK
    gateway NETWORK_GATEWAY
    dns-nameservers IP_DNS_1 IP_DNS_2
    dns-search DNS_SUFFIX

Kde:

INTERFACE_NAME je nutné nahradit dříve zjištěným názvem síťového rozhraní.
MAC_ADDRESS je nutné nahradit dříve zjištěnou adresou MAC.
IP_GW je nutné nahradit IP adresou serveru.
NETMASK je nutné nahradit maskou sítě přidruženou k IP adrese.
NETWORK_GATEWAY je nutné nahradit výchozí síťovou bránou.
IP_DNS je nutné nahradit IP adresou serveru DNS. Pokud je třeba nakonfigurovat více serverů (maximálně 3), oddělte je mezerou.
DNS_SUFFIX je nutné nahradit příponou DNS, která se má použít. Pokud není třeba zadávat žádnou příponu, odstraňte tento řádek.

Příklad

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports ens192
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw 00:50:56:a1:56:9f
    address 172.16.10.10
    netmask 255.255.255.0
    gateway 172.16.10.254
    dns-nameservers 172.16.11.2 172.16.11.3
    dns-search domain.local

Před použitím konfigurace zbývá provést ještě tři kroky.

Prvním je instalace balíčků resolvconf a bridge-utils, aby bylo možné použít konfiguraci DNS zadanou v předchozím souboru a používat rozhraní br0:

apt install -y resolvconf bridge-utils

Druhým je kontrola konfigurace souboru /etc/hosts s ohledem na primární IP adresu počítače (IP_GW).
Za tímto účelem upravte soubor /etc/hosts a ověřte, že druhý řádek má následující formát:

2	`IP_GW FQDN MACHINE_NAME`

Příklad

Pokud se počítač jmenuje EDGE-GATEWAY, nepatří do žádné domény a jeho IP adresa IP_GW je 172.16.10.10, soubor se doplní takto:

2	`172.16.10.10 EDGE-GATEWAY`

Pokud počítač patří do domény DOMAIN.LOCAL, soubor se doplní takto:

2	`172.16.10.10 EDGE-GATEWAY.DOMAIN.LOCAL EDGE-GATEWAY`

Pozor!

Nesprávná konfigurace souboru může způsobit chybu při instalaci balíčku collectd.

Zbývá jen restartovat server:

reboot

Konfigurace správce balíčků APT¶

Pomocí klienta SCP nahrajte soubory stažené ze Systancia Marketplace do adresáře /tmp/ na serveru:

systancia.gpg
cleanroom-4.6.1-build33.1096.D12-full.tgz

Přihlaste se k serveru jako root a poté spusťte následující příkazy, které rozbalí úložiště Systancia, nakonfigurují jeho použití v APT a ověří ho.

mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/
mkdir -p /opt/systancia/repository/
tar xvzf /tmp/cleanroom-4.6*.tgz -C /opt/systancia/repository/
echo "deb file:///opt/systancia/repository/ bookworm ipdiva" > /etc/apt/sources.list.d/systancia.list
apt update

Důrazně doporučujeme zakázat instalaci nepotřebných balíčků při spouštění příkazů apt. Za tímto účelem spusťte následující příkaz:

echo -e 'APT::Install-Recommends false;\nAPT::Install-Suggests false;' > /etc/apt/apt.conf.d/99norecommends

Instalace serveru Edge Gateway pro CyberElements Bastion¶

Instalace základních komponent¶

Spusťte instalaci komponent následujícím příkazem jako root:

apt install -y ipdiva-base

Po stažení všech závislostí se otevře okno s výzvou k výběru typu serveru. Vyberte gateway:

Co dělat v případě chyby?

Pokud jsou v zadaných údajích chyby, pokračujte v instalaci balíčku ipdiva-base a poté server znovu nakonfigurujte následujícím příkazem:

1	`dpkg-reconfigure ipdiva-base`

Instalace komponent Edge Gateway¶

Poté spusťte instalaci komponent specifických pro Edge Gateway následujícím příkazem:

apt install -y ipdiva-safe-gateway ipdiva-gateway-setup

Komponenty serveru Edge Gateway jsou nyní nainstalovány. Zbývá jen restartovat počítač, aby se nově nainstalované komponenty mohly inicializovat:

reboot

Instalace komponent HTML5 Gateway¶

Následujícím příkazem spusťte instalaci komponent HTML5 Gateway na serveru Edge Gateway:

apt install -y ipdiva-html5gateway ipdiva-html5-webapp ipdiva-guacamole-server1

Následujícími příkazovými řádky povolte a nakonfigurujte funkce přenosu souborů a virtuální tiskárny:

apt install -y ghostscript
echo -e "printer=cyberelements HTML5 Printer\nprinterDriver=MS Publisher Imagesetter" > /etc/guacamole/printer-config
mkdir /home/systanciahtml5share

Konfigurace¶

Konfigurace před připojením komponenty HTML5 Gateway¶

Aby aplikace HTML5 fungovaly, je nutné nakonfigurovat další nastavení na serveru Mediation Controller. Přihlaste se k serveru Mediation Controller jako root.

Vytvořte nebo upravte soubor /etc/ipdiva/httpd/commonParameters.extra.conf a přidejte do něj část odpovídající následující ukázce:

<Location /URL_HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /URL_HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Kde:

Hodnotu URL_HTML5 je nutné nahradit obsahem pole URL komponenty HTML5 Gateway nakonfigurované v konzole pro správu při generování tokenu pairingu.
GW_NAME je nutné nahradit názvem komponenty Edge Gateway umístěné na stejném serveru jako HTML5 Gateway. Znak | na konci řádku musí zůstat zachován.
ORGANIZATION_NAME je nutné nahradit názvem organizace, ke které se předchozí komponenta Edge Gateway připojuje.

Příklad

Pro platformu s následujícím nastavením:

Název organizace: my-organization-name
Deklarace komponenty HTML5 Gateway v konzole pro správu:
- Název: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Server Edge Gateway má:
- Službu Edge Gateway s názvem edge-gateway
- Službu HTML5 Gateway s názvem html5-gateway

Vytvořený konfigurační soubor /etc/ipdiva/httpd/commonParameters.extra.conf bude nastaven takto:

<Location /HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Před použitím nového nastavení musíte ověřit, že nová konfigurace nezpůsobuje žádné blokující chyby webového serveru Apache2.
Za tímto účelem spusťte následující příkaz:

1	`apache2ctl configtest`

Pokud je odpověď Syntax OK, lze změny použít níže uvedeným příkazem. V opačném případě zkontrolujte svou konfiguraci v souboru /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Připojení komponent Edge Gateway a HTML5 Gateway¶

Pozor!

Pokud pro komponentu SSL Router používáte certifikáty vydané jinou certifikační autoritou (CA) než Systancia, musíte kořenovou CA přidat do důvěryhodných CA komponenty Edge Gateway: přidejte kořenovou CA komponenty SSL Router do důvěryhodných CA pro připojení Edge Gateway nebo HTML5 Gateway.

Chcete-li nakonfigurovat instance Edge Gateway a HTML5 Gateway na serveru, postupujte podle informací uvedených v následující dokumentaci: Pairing serveru