Kihagyás

Az Edge Gateway kiszolgáló telepítése

Megjegyzés

Emlékeztetőül: Debian rendszerű számítógépeken a root felhasználóra a következő paranccsal kell váltani:

1
su -

A tükör és a szükséges eszközök letöltése

A CyberElements Cleanroom 4.6 tükörtárháza és a Systancia-tárház aláírókulcsa erről a hivatkozásról tölthető le (ügyfélfiók létrehozása szükséges): Systancia Marketplace

A tükörtárház és a kulcs mellett a verziófrissítési folyamathoz külső gyártótól származó eszközökre is szükség lesz:

  • Egy SSH-ügyfél (Windows rendszeren használhatja a PuTTY programot)
  • Egy SCP-ügyfél (Windows rendszeren a WinSCP vagy a FileZilla eszköz használható)

Az SSH-ügyféllel csatlakozzon távolról a kiszolgálóhoz.

Az SCP-ügyféllel vigye át a fájlokat a távoli számítógépre.

A telepítés előkészítése

A hálózat konfigurálása

Erősen ajánlott statikus hálózati címet megadni az Edge Gateway kiszolgáló számára. Ehhez először le kell kérdeznie a számítógép hálózati csatolójának nevét és MAC-címét. Futtassa a következő parancsot root felhasználóként:

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

Ez a parancs megjeleníti a hálózati csatoló nevét, állapotát, MAC-címét és beállításait.

Példa

A parancs végrehajtása után a következő kimenet jelenik meg:

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

A hálózati csatoló neve ens192, MAC-címe pedig 00:50:56:a1:56:9f.

A hálózati csatoló nevének és MAC-címének meghatározása után már szerkesztheti a számítógép hálózati konfigurációját.
Szerkessze az /etc/network/interfaces fájlt, és módosítsa a következő sablon szerint:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 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

Ahol:

  • Az INTERFACE_NAME helyére a korábban lekérdezett hálózati csatoló nevét kell írni.
  • A MAC_ADDRESS helyére a korábban lekérdezett MAC-címet kell írni.
  • Az IP_GW helyére a kiszolgáló IP-címét kell írni.
  • A NETMASK helyére az IP-címhez tartozó alhálózati maszkot kell írni.
  • A NETWORK_GATEWAY helyére a hálózat alapértelmezett átjáróját kell írni.
  • Az IP_DNS helyére a DNS-kiszolgáló IP-címét kell írni. Ha több kiszolgálót kell konfigurálni (legfeljebb 3-at), szóközzel válassza el őket egymástól.
  • A DNS_SUFFIX helyére a használandó DNS-utótagot kell írni. Ha nem kell utótagot megadni, törölje a sort.
Példa 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 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

A konfiguráció alkalmazása előtt még három lépést kell elvégezni.

Az első a resolvconf és a bridge-utils csomag telepítése, hogy az előző fájlban megadott DNS-konfiguráció alkalmazható, a br0 csatoló pedig használható legyen:

1
apt install -y resolvconf bridge-utils

A második az /etc/hosts fájl konfigurációjának ellenőrzése a számítógép elsődleges IP-címe (IP_GW) tekintetében.
Ehhez szerkessze az /etc/hosts fájlt, és ellenőrizze, hogy a második sor a következő formátumú-e:

2
IP_GW   FQDN    MACHINE_NAME
Példa

Ha a számítógép neve EDGE-GATEWAY, nem tartozik tartományhoz, és IP_GW IP-címe 172.16.10.10, akkor a fájlt a következőképpen kell kiegészíteni:

2
172.16.10.10  EDGE-GATEWAY

Ha a számítógép a DOMAIN.LOCAL tartományhoz tartozik, akkor a fájlt a következőképpen kell kiegészíteni:

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

Figyelem!

A fájl helytelen konfigurációja hibát okozhat a collectd csomag telepítésekor.

Már csak a kiszolgálót kell újraindítani: 

1
reboot

Az APT csomagkezelő konfigurálása

Egy SCP-ügyféllel töltse fel a Systancia Marketplace-ről letöltött fájlokat a kiszolgáló /tmp/ könyvtárába:

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

Jelentkezzen be a kiszolgálóra root felhasználóként, majd futtassa a következő parancsokat a Systancia-tárház kicsomagolásához, az APT-ben való használatának konfigurálásához és a tárház hitelesítéséhez.

1
2
3
4
5
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

Határozottan javasoljuk, hogy az apt parancsok futtatásakor kapcsolja ki a szükségtelen csomagok telepítését. Ehhez futtassa a következő parancsot:

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

A CyberElements Bastion Edge Gateway kiszolgáló telepítése

Az alapvető komponensek telepítése

Indítsa el az összetevők telepítését a következő paranccsal, root felhasználóként:

1
apt install -y ipdiva-base

Az összes függőség letöltése után megnyílik egy ablak, amelyben ki kell választania a kiszolgáló típusát. Válassza a gateway lehetőséget:

Mit tegyen, ha hiba történik?

Ha hibát vétett a megadott adatokban, folytassa az ipdiva-base csomag telepítését, majd a következő paranccsal konfigurálja újra a kiszolgálót:

1
dpkg-reconfigure ipdiva-base

Az Edge Gateway komponensek telepítése

Ezután indítsa el az Edge Gateway komponens saját összetevőinek telepítését a következő paranccsal:

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

Az Edge Gateway kiszolgáló összetevői most már telepítve vannak. Már csak a számítógépet kell újraindítani, hogy az újonnan telepített összetevők inicializálódhassanak:

1
reboot

A HTML5 Gateway komponensek telepítése

A következő paranccsal indítsa el a HTML5 Gateway összetevőinek telepítését az Edge Gateway kiszolgálón:

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

A következő parancssorokkal kapcsolja be és konfigurálja a fájlátvitel és a virtuális nyomtató funkcióját:

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

Konfiguráció

A HTML5 Gateway csatlakoztatása előtti konfigurációk

A HTML5-alkalmazások működéséhez további beállításokat kell konfigurálni a Mediation Controller kiszolgálón. Jelentkezzen be a Mediation Controller kiszolgálóra root felhasználóként.

Hozza létre vagy módosítsa az /etc/ipdiva/httpd/commonParameters.extra.conf fájlt, és adjon hozzá egy, az alábbinak megfelelő szakaszt:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
<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>

Ahol:

  • Az URL_HTML5 értéket a HTML5 Gateway felügyeleti konzolon a pairing token létrehozásakor konfigurált URL mezőjének tartalmára kell cserélni.
  • A GW_NAME helyére egy olyan Edge Gateway komponens nevét kell írni, amely ugyanazon a kiszolgálón található, mint a HTML5 Gateway. A sor végén lévő | karaktert meg kell tartani.
  • Az ORGANIZATION_NAME helyére annak a szervezetnek a nevét kell írni, amelyhez az előző Edge Gateway komponens csatlakozik.
Példa

A következő beállításokkal rendelkező platform esetén:

  • A szervezet neve: my-organization-name
  • A HTML5 Gateway deklarálása a felügyeleti konzolon:
    • Name: html5-gateway
    • URL: HTML5
    • Protocol: WebSocket
  • Egy Edge Gateway kiszolgálón a következők találhatók:
    • Egy edge-gateway nevű Edge Gateway szolgáltatás
    • Egy html5-gateway nevű HTML5 Gateway szolgáltatás

A létrehozott /etc/ipdiva/httpd/commonParameters.extra.conf konfigurációs fájlt a következőképpen kell beállítani: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
<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>

Az új beállítások alkalmazása előtt ellenőriznie kell, hogy az új konfiguráció nem okoz-e blokkoló hibát az Apache2 webkiszolgálóban.
Ehhez futtassa a következő parancsot:

1
apache2ctl configtest

Ha a válasz Syntax OK, akkor a módosítások az alábbi paranccsal alkalmazhatók. Ellenkező esetben ellenőrizze a konfigurációt az /etc/ipdiva/httpd/commonParameters.extra.conf fájlban.

1
systemctl reload apache2

Az Edge Gateway és a HTML5 Gateway csatlakoztatása

Figyelem!

Ha az SSL Router komponenshez nem a Systancia, hanem más hitelesítésszolgáltató (CA) által kibocsátott tanúsítványokat használ, a legfelső szintű hitelesítésszolgáltatót hozzá kell adnia az Edge Gateway megbízható hitelesítésszolgáltatóihoz: az SSL Router legfelső szintű hitelesítésszolgáltatójának hozzáadása a megbízható hitelesítésszolgáltatókhoz az Edge Gateway vagy a HTML5 Gateway kapcsolódásához.

Az Edge Gateway és a HTML5 Gateway példányok kiszolgálón való konfigurálásához kövesse az alábbi dokumentációban szereplő információkat: A kiszolgáló csatlakoztatása pairing segítségével