Installazzjoni tas-server Edge Gateway¶

Nota

Bħala tfakkira, il-qlib għal root fuq kompjuters Debian għandu jsir bil-kmand li ġej:

su -

Tniżżil tal-mirror u tal-għodod meħtieġa¶

Il-mirror ta’ CyberElements Cleanroom 4.6 u ċ-ċavetta tal-firma tar-repożitorju ta’ Systancia jistgħu jitniżżlu minn dan il-link (jeħtieġ il-ħolqien ta’ kont tal-klijent): Systancia Marketplace

Minbarra l-mirror u ċ-ċavetta, se jkunu meħtieġa għodod ta’ partijiet terzi għall-proċess tat-titjib tal-verżjoni:

Klijent SSH (fuq Windows, tista’ tuża PuTTY)
Klijent SCP (fuq Windows, jistgħu jintużaw l-għodod WinSCP jew FileZilla)

Uża l-klijent SSH biex tikkonnettja mill-bogħod mas-server tiegħek.

Uża l-klijent SCP biex tittrasferixxi fajls lejn il-kompjuter remot tiegħek.

Tħejjija għall-installazzjoni¶

Konfigurazzjoni tan-netwerk¶

Huwa rrakkomandat ħafna li tiddefinixxi indirizz tan-netwerk statiku għas-server Edge Gateway. Biex tagħmel dan, l-ewwel trid tikseb l-isem tal-interfaċċa tan-netwerk tal-kompjuter tiegħek u l-indirizz MAC tagħha. Ħaddem il-kmand li ġej bħala root:

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

Dan il-kmand juri l-isem tal-interfaċċa tan-netwerk, l-istatus tagħha, l-indirizz MAC tagħha, u s-settings tal-interfaċċa.

Eżempju

Wara li jiġi eżegwit il-kmand, jintwera l-output li ġej:

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

L-isem tal-interfaċċa tan-netwerk huwa ens192 u l-indirizz MAC tagħha huwa 00:50:56:a1:56:9f.

Ladarba jkunu nkisbu l-isem tal-interfaċċa tan-netwerk u l-indirizz MAC, issa huwa possibbli li teditja l-konfigurazzjoni tan-netwerk tal-kompjuter.
Editja l-fajl /etc/network/interfaces biex timmodifikah billi tuża l-mudell li ġej:

# 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

Fejn:

INTERFACE_NAME għandu jiġi sostitwit bl-isem tal-interfaċċa tan-netwerk miksub qabel.
MAC_ADDRESS għandu jiġi sostitwit bl-indirizz MAC miksub qabel.
IP_GW għandu jiġi sostitwit bl-indirizz IP tas-server.
NETMASK għandu jiġi sostitwit bil-maskra tan-netwerk assoċjata mal-indirizz IP.
NETWORK_GATEWAY għandu jiġi sostitwit bil-gateway default tan-netwerk.
IP_DNS għandu jiġi sostitwit bl-indirizz IP tas-server DNS. Jekk ikunu jridu jiġu kkonfigurati diversi servers (massimu ta’ 3), isseparahom bi spazju.
DNS_SUFFIX għandu jiġi sostitwit bis-suffiss DNS li għandu jintuża. Jekk ma jkun meħtieġ ebda suffiss, ħassar il-linja.

Eżempju

# 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

Qabel ma tapplika l-konfigurazzjoni, hemm tliet passi oħra x’tlesti.

L-ewwel wieħed huwa li tinstalla l-pakketti resolvconf u bridge-utils sabiex il-konfigurazzjoni DNS speċifikata fil-fajl preċedenti tkun tista’ tiġi applikata u l-interfaċċa br0 tkun tista’ tintuża:

apt install -y resolvconf bridge-utils

It-tieni wieħed huwa li tiċċekkja l-konfigurazzjoni tal-fajl /etc/hosts fir-rigward tal-indirizz IP primarju tal-kompjuter (IP_GW).
Biex tagħmel dan, editja l-fajl /etc/hosts u ċċekkja li t-tieni linja tkun fil-format li ġej:

2	`IP_GW FQDN MACHINE_NAME`

Eżempju

Jekk il-kompjuter jismu EDGE-GATEWAY mingħajr ma jappartjeni għal dominju u l-indirizz IP tiegħu IP_GW huwa 172.16.10.10, allura l-fajl jimtela kif ġej:

2	`172.16.10.10 EDGE-GATEWAY`

Jekk il-kompjuter jappartjeni għad-dominju DOMAIN.LOCAL, allura l-fajl jimtela kif ġej:

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

Attenzjoni!

Konfigurazzjoni ħażina tal-fajl tista’ tikkawża żball meta jiġi installat il-pakkett collectd.

Ma jibqa’ xejn ħlief li terġa’ tibda s-server:

reboot

Konfigurazzjoni tal-maniġer tal-pakketti APT¶

Tella’ l-fajls imniżżla minn Systancia Marketplace fid-direttorju /tmp/ fuq is-server billi tuża klijent SCP:

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

Idħol fis-server bħala root, imbagħad ħaddem il-kmandi li ġejjin biex tiddekompressa r-repożitorju ta’ Systancia, tikkonfigura l-użu tiegħu f’APT, u tawtentikah.

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

Nirrakkomandaw bil-qawwa li tiddiżattiva l-installazzjoni ta’ pakketti mhux meħtieġa meta tħaddem il-kmandi apt. Biex tagħmel dan, ħaddem il-kmand li ġej:

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

Installazzjoni tas-server Edge Gateway ta’ CyberElements Bastion¶

Installazzjoni tal-komponenti bażiċi¶

Ibda l-installazzjoni tal-komponenti billi tuża l-kmand li ġej bħala root:

apt install -y ipdiva-base

Wara li jitniżżlu d-dipendenzi kollha, se tinfetaħ tieqa li titolbok tagħżel it-tip ta’ server. Agħżel gateway:

X’għandi nagħmel jekk ikun hemm żball?

Jekk ikun hemm żball fl-informazzjoni li daħħalt, kompli bl-installazzjoni tal-pakkett ipdiva-base u mbagħad uża l-kmand li ġej biex terġa’ tikkonfigura s-server:

1	`dpkg-reconfigure ipdiva-base`

Installazzjoni tal-komponenti Edge Gateway¶

Imbagħad, ibda l-installazzjoni tal-komponenti speċifiċi għall-komponent Edge Gateway billi tuża l-kmand li ġej:

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

Il-komponenti tas-server Edge Gateway issa huma installati. Ma jibqa’ xejn ħlief li terġa’ tibda l-kompjuter sabiex il-komponenti installati ġodda jkunu jistgħu jinizjalizzaw:

reboot

Installazzjoni tal-komponenti HTML5 Gateway¶

Uża l-kmand li ġej biex tibda l-installazzjoni tal-komponenti HTML5 Gateway fuq is-server Edge Gateway:

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

Uża l-linji tal-kmand li ġejjin biex tattiva u tikkonfigura l-funzjonalitajiet tat-trasferiment tal-fajls u tal-istampatur virtwali:

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

Konfigurazzjoni¶

Konfigurazzjonijiet qabel il-konnessjoni tal-komponent HTML5 Gateway¶

Sabiex l-applikazzjonijiet HTML5 jaħdmu, iridu jiġu kkonfigurati settings addizzjonali fuq is-server Mediation Controller. Idħol bħala root fis-server Mediation Controller.

Oħloq jew editja l-fajl /etc/ipdiva/httpd/commonParameters.extra.conf biex iżżid parti ekwivalenti għal dik li ġejja:

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

Fejn:

Il-valur URL_HTML5 irid jiġi sostitwit bil-kontenut tal-qasam URL tal-komponent HTML5 Gateway ikkonfigurat fil-konsol tal-amministrazzjoni waqt il-ġenerazzjoni tat-token tal-pairing.
GW_NAME għandu jiġi sostitwit bl-isem ta’ komponent Edge Gateway li jinsab fuq l-istess server tal-komponent HTML5 Gateway. Il-karattru | fl-aħħar tal-linja għandu jinżamm.
ORGANIZATION_NAME għandu jiġi sostitwit bl-isem tal-organizzazzjoni li magħha jikkonnettja l-komponent Edge Gateway preċedenti.

Eżempju

Għal pjattaforma bis-settings li ġejjin:

Isem l-organizzazzjoni: my-organization-name
Dikjarazzjoni tal-komponent HTML5 Gateway fil-konsol tal-amministrazzjoni:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Server Edge Gateway għandu:
- Servizz Edge Gateway bl-isem edge-gateway
- Servizz HTML5 Gateway bl-isem html5-gateway

Il-fajl tal-konfigurazzjoni /etc/ipdiva/httpd/commonParameters.extra.conf maħluq se jiġi kkonfigurat kif ġej:

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

Qabel ma tapplika s-settings il-ġodda, trid tiċċekkja li l-konfigurazzjoni l-ġdida ma tikkawża ebda żball li jimblokka s-server web Apache2.
Biex tagħmel dan, ħaddem il-kmand li ġej:

1	`apache2ctl configtest`

Jekk ir-risposta tkun Syntax OK, allura l-bidliet jistgħu jiġu applikati bil-kmand hawn taħt. Inkella, iċċekkja l-konfigurazzjoni tiegħek fil-fajl /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Konnessjoni tal-komponenti Edge Gateway u HTML5 Gateway¶

Attenzjoni!

Jekk tuża ċertifikati maħruġa minn awtorità taċ-ċertifikazzjoni (CA) li mhijiex dik ta’ Systancia għall-komponent SSL Router, trid iżżid l-awtorità taċ-ċertifikazzjoni għerq mal-awtoritajiet taċ-ċertifikazzjoni affidabbli tal-komponent Edge Gateway: żid l-awtorità taċ-ċertifikazzjoni għerq tal-komponent SSL Router mal-awtoritajiet affidabbli għall-konnessjoni tal-komponent Edge Gateway jew HTML5 Gateway.

Biex tikkonfigura l-istanzi Edge Gateway u HTML5 Gateway fuq is-server, segwi l-informazzjoni mogħtija fid-dokumentazzjoni li ġejja: Pairing tas-server