Edge Gateway serverio diegimas¶

Pastaba

Primename, kad Debian kompiuteriuose į root reikia persijungti šia komanda:

su -

Veidrodinės saugyklos ir būtinų įrankių atsisiuntimas¶

CyberElements Cleanroom 4.6 veidrodį ir Systancia saugyklos parašo raktą galima atsisiųsti šiuo saitu (reikia susikurti kliento paskyrą): Systancia Marketplace

Be veidrodžio ir rakto, versijos atnaujinimo procesui reikės trečiųjų šalių įrankių:

SSH klientas (Windows sistemoje galite naudoti PuTTY)
SCP klientas (Windows sistemoje galima naudoti įrankius WinSCP arba FileZilla)

Naudokite SSH klientą, kad nuotoliniu būdu prisijungtumėte prie savo serverio.

Naudokite SCP klientą, kad perkeltumėte failus į nuotolinį kompiuterį.

Pasirengimas diegimui¶

Tinklo konfigūracija¶

Primygtinai rekomenduojama nustatyti statinį Edge Gateway serverio tinklo adresą. Norėdami tai padaryti, pirmiausia turite sužinoti savo kompiuterio tinklo sąsajos pavadinimą ir jos MAC adresą. Vykdykite šią komandą kaip root:

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

Ši komanda parodo tinklo sąsajos pavadinimą, jos būseną, MAC adresą ir sąsajos parametrus.

Pavyzdys

Įvykdžius komandą, rodoma ši išvestis:

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

Tinklo sąsajos pavadinimas yra ens192, o jos MAC adresas – 00:50:56:a1:56:9f.

Gavus tinklo sąsajos pavadinimą ir MAC adresą, galima redaguoti kompiuterio tinklo konfigūraciją.
Redaguokite failą /etc/network/interfaces ir pakeiskite jį pagal šį šabloną:

# 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

Čia:

INTERFACE_NAME reikia pakeisti anksčiau gautu tinklo sąsajos pavadinimu.
MAC_ADDRESS reikia pakeisti anksčiau gautu MAC adresu.
IP_GW reikia pakeisti serverio IP adresu.
NETMASK reikia pakeisti su IP adresu susieta tinklo kauke.
NETWORK_GATEWAY reikia pakeisti numatytuoju tinklo šliuzu.
IP_DNS reikia pakeisti DNS serverio IP adresu. Jei reikia sukonfigūruoti kelis serverius (daugiausia 3), atskirkite juos tarpu.
DNS_SUFFIX reikia pakeisti naudotinu DNS sufiksu. Jei sufikso įvesti nereikia, panaikinkite eilutę.

Pavyzdys

# 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

Prieš pritaikant konfigūraciją, reikia atlikti dar tris veiksmus.

Pirmasis – įdiegti paketus resolvconf ir bridge-utils, kad būtų galima pritaikyti ankstesniame faile nurodytą DNS konfigūraciją ir naudoti sąsają br0:

apt install -y resolvconf bridge-utils

Antrasis – patikrinti failo /etc/hosts konfigūraciją, susijusią su pagrindiniu kompiuterio IP adresu (IP_GW).
Norėdami tai padaryti, redaguokite failą /etc/hosts ir patikrinkite, ar antroji eilutė yra tokio formato:

2	`IP_GW FQDN MACHINE_NAME`

Pavyzdys

Jei kompiuteris pavadintas EDGE-GATEWAY ir nepriklauso domenui, o jo IP adresas IP_GW yra 172.16.10.10, failas būtų užpildytas taip:

2	`172.16.10.10 EDGE-GATEWAY`

Jei kompiuteris priklauso domenui DOMAIN.LOCAL, failas būtų užpildytas taip:

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

Dėmesio!

Neteisinga failo konfigūracija gali sukelti klaidą diegiant paketą collectd.

Belieka iš naujo paleisti serverį:

reboot

Paketų tvarkytuvo APT konfigūravimas¶

SCP klientu įkelkite iš Systancia Marketplace atsisiųstus failus į serverio katalogą /tmp/:

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

Prisijunkite prie serverio kaip root, tada vykdykite šias komandas, kad išskleistumėte Systancia saugyklą, sukonfigūruotumėte jos naudojimą APT ir ją autentifikuotumėte.

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

Primygtinai rekomenduojame išjungti nereikalingų paketų diegimą vykdant apt komandas. Norėdami tai padaryti, vykdykite šią komandą:

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

CyberElements Bastion Edge Gateway serverio diegimas¶

Pagrindinių komponentų diegimas¶

Pradėkite diegti komponentus vykdydami šią komandą kaip root:

apt install -y ipdiva-base

Atsisiuntus visas priklausomybes, atsidarys langas, kuriame reikės pasirinkti serverio tipą. Pasirinkite gateway:

Ką daryti įvykus klaidai?

Jei įvestoje informacijoje yra klaida, tęskite paketo ipdiva-base diegimą, tada naudokite šią komandą serveriui iš naujo sukonfigūruoti:

1	`dpkg-reconfigure ipdiva-base`

Edge Gateway komponentų diegimas¶

Tada pradėkite diegti Edge Gateway skirtus komponentus šia komanda:

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

Edge Gateway serverio komponentai dabar įdiegti. Belieka iš naujo paleisti kompiuterį, kad naujai įdiegti komponentai galėtų būti inicijuoti:

reboot

HTML5 Gateway komponentų diegimas¶

Naudokite šią komandą, kad pradėtumėte diegti HTML5 Gateway komponentus Edge Gateway serveryje:

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

Naudokite šias komandines eilutes, kad įjungtumėte ir sukonfigūruotumėte failų perdavimo ir virtualiojo spausdintuvo funkcijas:

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

Konfigūracija¶

Konfigūracijos prieš prijungiant HTML5 Gateway¶

Kad HTML5 taikomosios programos veiktų, Mediation Controller serveryje reikia sukonfigūruoti papildomus parametrus. Prisijunkite prie Mediation Controller serverio kaip root.

Sukurkite arba pakeiskite failą /etc/ipdiva/httpd/commonParameters.extra.conf ir pridėkite skyrių, atitinkantį šį:

<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>

Čia:

URL_HTML5 reikia pakeisti HTML5 Gateway lauko URL turiniu, sukonfigūruotu administravimo konsolėje generuojant pairing tokeną.
GW_NAME reikia pakeisti Edge Gateway, esančio tame pačiame serveryje kaip HTML5 Gateway, pavadinimu. Eilutės pabaigoje esantį simbolį | būtina palikti.
ORGANIZATION_NAME reikia pakeisti organizacijos, prie kurios jungiasi ankstesnis Edge Gateway, pavadinimu.

Pavyzdys

Platformai su šiais parametrais:

Organizacijos pavadinimas: my-organization-name
HTML5 Gateway deklaravimas administravimo konsolėje:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Edge Gateway serveris turi:
- Edge Gateway paslaugą, pavadintą edge-gateway
- HTML5 Gateway paslaugą, pavadintą html5-gateway

Sukurtas konfigūracijos failas /etc/ipdiva/httpd/commonParameters.extra.conf bus nustatytas taip:

<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>

Prieš pritaikydami naujus parametrus, turite patikrinti, ar nauja konfigūracija nesukelia jokių blokuojančių Apache2 žiniatinklio serverio klaidų.
Norėdami tai padaryti, vykdykite šią komandą:

1	`apache2ctl configtest`

Jei atsakymas yra Syntax OK, pakeitimus galima pritaikyti toliau pateikta komanda. Priešingu atveju patikrinkite konfigūraciją faile /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Edge Gateway ir HTML5 Gateway prijungimas¶

Dėmesio!

Jei komponentui SSL Router naudojate sertifikatus, išduotus ne Systancia, o kitos sertifikavimo institucijos (CA), turite įtraukti šakninę CA į Edge Gateway patikimų CA sąrašą: įtraukite SSL Router šakninę CA į patikimų CA sąrašą Edge Gateway arba HTML5 Gateway ryšiui.

Norėdami sukonfigūruoti Edge Gateway ir HTML5 Gateway egzempliorius serveryje, vadovaukitės šioje dokumentacijoje pateikta informacija: Serverio susiejimas per pairing