Edge Gateway servera instalēšana¶

Piezīme

Atgādinām, ka Debian datoros pārslēgšanās uz root jāveic ar tālāk norādīto komandu:

su -

Spoguļa un nepieciešamo rīku lejupielāde¶

CyberElements Cleanroom 4.6 spoguli un Systancia krātuves paraksta atslēgu var lejupielādēt, izmantojot šo saiti (nepieciešams izveidot klienta kontu): Systancia Marketplace

Papildus spogulim un atslēgai jaunināšanas procesam būs nepieciešami trešo pušu rīki:

SSH klients (operētājsistēmā Windows varat izmantot PuTTY)
SCP klients (operētājsistēmā Windows var izmantot rīkus WinSCP vai FileZilla)

Izmantojiet SSH klientu, lai attālināti izveidotu savienojumu ar savu serveri.

Izmantojiet SCP klientu, lai pārsūtītu failus uz savu attālo datoru.

Sagatavošanās instalēšanai¶

Tīkla konfigurācija¶

Edge Gateway serverim ļoti ieteicams definēt statisku tīkla adresi. Lai to izdarītu, vispirms jāiegūst jūsu datora tīkla saskarnes nosaukums un tās MAC adrese. Izpildiet tālāk norādīto komandu kā root:

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

Šī komanda parāda tīkla saskarnes nosaukumu, tās statusu, MAC adresi un saskarnes iestatījumus.

Piemērs

Pēc komandas izpildes tiek parādīta šāda izvade:

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

Tīkla saskarnes nosaukums ir ens192, un tās MAC adrese ir 00:50:56:a1:56:9f.

Kad tīkla saskarnes nosaukums un MAC adrese ir iegūti, var rediģēt datora tīkla konfigurāciju.
Rediģējiet failu /etc/network/interfaces, lai to mainītu atbilstoši šai veidnei:

# 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

Kur:

INTERFACE_NAME jāaizstāj ar iepriekš iegūto tīkla saskarnes nosaukumu.
MAC_ADDRESS jāaizstāj ar iepriekš iegūto MAC adresi.
IP_GW jāaizstāj ar servera IP adresi.
NETMASK jāaizstāj ar IP adresei atbilstošo tīkla masku.
NETWORK_GATEWAY jāaizstāj ar tīkla noklusējuma vārteju.
IP_DNS jāaizstāj ar DNS servera IP adresi. Ja jākonfigurē vairāki serveri (ne vairāk kā 3), atdaliet tos ar atstarpi.
DNS_SUFFIX jāaizstāj ar izmantojamo DNS sufiksu. Ja sufikss nav jānorāda, izdzēsiet šo rindu.

Piemērs

# 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

Pirms konfigurācijas lietošanas jāveic vēl trīs darbības.

Pirmā ir pakotņu resolvconf un bridge-utils instalēšana, lai varētu lietot iepriekšējā failā norādīto DNS konfigurāciju un izmantot saskarni br0:

apt install -y resolvconf bridge-utils

Otrā ir faila /etc/hosts konfigurācijas pārbaude attiecībā uz datora galveno IP adresi (IP_GW).
Lai to izdarītu, rediģējiet failu /etc/hosts un pārbaudiet, vai otrajai rindai ir šāds formāts:

2	`IP_GW FQDN MACHINE_NAME`

Piemērs

Ja dators ir nosaukts EDGE-GATEWAY, tas nepieder domēnam un tā IP adrese IP_GW ir 172.16.10.10, fails jāaizpilda šādi:

2	`172.16.10.10 EDGE-GATEWAY`

Ja dators pieder domēnam DOMAIN.LOCAL, fails jāaizpilda šādi:

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

Uzmanību!

Nepareiza faila konfigurācija var izraisīt kļūdu, instalējot pakotni collectd.

Atliek tikai restartēt serveri:

reboot

Pakotņu pārvaldnieka APT konfigurēšana¶

Augšupielādējiet no Systancia Marketplace lejupielādētos failus servera direktorijā /tmp/, izmantojot SCP klientu:

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

Piesakieties serverī kā root un pēc tam izpildiet tālāk norādītās komandas, lai izpakotu Systancia krātuvi, konfigurētu tās izmantošanu APT un to autentificētu.

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

Mēs stingri iesakām atspējot nevajadzīgu pakotņu instalēšanu, izpildot apt komandas. Lai to izdarītu, izpildiet šādu komandu:

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

CyberElements Bastion Edge Gateway servera instalēšana¶

Pamatkomponentu instalēšana¶

Sāciet komponentu instalēšanu, izpildot tālāk norādīto komandu kā root:

apt install -y ipdiva-base

Pēc visu atkarību lejupielādes tiks atvērts logs, kurā jums tiks lūgts atlasīt servera tipu. Atlasiet gateway:

Kā rīkoties kļūdas gadījumā?

Ja ievadītajā informācijā ir kļūda, turpiniet pakotnes ipdiva-base instalēšanu un pēc tam izmantojiet tālāk norādīto komandu, lai atkārtoti konfigurētu serveri:

1	`dpkg-reconfigure ipdiva-base`

Edge Gateway komponentu instalēšana¶

Pēc tam sāciet Edge Gateway specifisko komponentu instalēšanu ar šādu komandu:

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

Edge Gateway servera komponenti tagad ir instalēti. Atliek tikai restartēt datoru, lai jaunizinstalētie komponenti varētu inicializēties:

reboot

HTML5 Gateway komponentu instalēšana¶

Izmantojiet šo komandu, lai sāktu HTML5 Gateway komponentu instalēšanu Edge Gateway serverī:

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

Izmantojiet šīs komandrindas, lai iespējotu un konfigurētu failu pārsūtīšanas un virtuālā printera funkcijas:

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

Konfigurācija¶

Konfigurācijas pirms HTML5 Gateway savienošanas¶

Lai HTML5 lietojumprogrammas darbotos, Mediation Controller serverī ir jākonfigurē papildu iestatījumi. Piesakieties Mediation Controller serverī kā root.

Izveidojiet vai modificējiet failu /etc/ipdiva/httpd/commonParameters.extra.conf, lai pievienotu sadaļu, kas līdzvērtīga tālāk norādītajai:

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

Kur:

URL_HTML5 ir jāaizstāj ar HTML5 Gateway lauka URL saturu, kas konfigurēts administrēšanas konsolē, ģenerējot pairing marķieri.
GW_NAME jāaizstāj ar tās Edge Gateway vārtejas nosaukumu, kas atrodas tajā pašā serverī, kurā HTML5 Gateway. Rakstzīme | rindas beigās ir jāsaglabā.
ORGANIZATION_NAME jāaizstāj ar tās organizācijas nosaukumu, ar kuru savienojas iepriekšminētā Edge Gateway vārteja.

Piemērs

Platformai ar šādiem iestatījumiem:

Organizācijas nosaukums: my-organization-name
HTML5 Gateway deklarēšana administrēšanas konsolē:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Edge Gateway serverim ir:
- Edge Gateway pakalpojums ar nosaukumu edge-gateway
- HTML5 Gateway pakalpojums ar nosaukumu html5-gateway

Izveidotais konfigurācijas fails /etc/ipdiva/httpd/commonParameters.extra.conf tiks iestatīts šādi:

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

Pirms jauno iestatījumu lietošanas jāpārbauda, vai jaunā konfigurācija neizraisa Apache2 tīmekļa servera bloķējošas kļūdas.
Lai to izdarītu, izpildiet šādu komandu:

1	`apache2ctl configtest`

Ja atbilde ir Syntax OK, izmaiņas var lietot ar tālāk norādīto komandu. Pretējā gadījumā pārbaudiet konfigurāciju failā /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Edge Gateway un HTML5 Gateway savienošana¶

Uzmanību!

Ja komponentam SSL Router izmantojat sertifikātus, ko izdevusi sertificēšanas iestāde (CA), kas nav Systancia, saknes CA ir jāpievieno Edge Gateway uzticamajām CA: pievienojiet SSL Router saknes CA uzticamajām CA Edge Gateway vai HTML5 Gateway savienojumam.

Lai serverī konfigurētu Edge Gateway un HTML5 Gateway instances, izpildiet tālāk norādītajā dokumentācijā sniegtos norādījumus: Servera pairing