Aqbeż għall-kontenut

Installazzjoni tas-server Mediation Controller

Nota

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

1
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 essenzjali li tikkonfigura indirizz tan-netwerk statiku għall-komponent Mediation Controller. Biex tagħmel dan, l-ewwel trid tikseb l-isem tal-interfaċċa tan-netwerk tal-kompjuter tiegħek. Ħaddem il-kmand li ġej bħala root:

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

Dan il-kmand juri l-isem tal-interfaċċa tan-netwerk, l-istatus tagħha, u l-indirizzi IP assenjati lill-interfaċċa.

Eżempju

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

1
ens192           UP             10.0.10.10/24

L-isem tal-interfaċċa tan-netwerk huwa ens192.

Ladarba jkun inkiseb l-isem tal-interfaċċa tan-netwerk, 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:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 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 INTERFACE_NAME
iface INTERFACE_NAME inet static
    address IP_MED_WEB
    netmask NETMASK
    gateway NETWORK_GATEWAY
    dns-nameservers IP_DNS_1 IP_DNS_2
    dns-search DNS_SUFFIX

# The secondary network interface
auto INTERFACE_NAME:1
iface INTERFACE_NAME:1 inet static
    address IP_MED_SSL
    netmask NETMASK

Fejn:

  • INTERFACE_NAME għandu jiġi sostitwit bl-isem tal-interfaċċa tan-netwerk miksub qabel.
  • IP_MED_WEB għandu jiġi sostitwit bl-indirizz IP prinċipali tas-server, li se jkun l-indirizz IP li permezz tiegħu jkunu aċċessibbli l-konsols web.
  • 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.
  • IP_MED_SSL għandu jiġi sostitwit bl-indirizz IP sekondarju tas-server. Dan se jkun l-indirizz IP li permezz tiegħu se jkun aċċessibbli l-komponent SSL Router.
Eżempju 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 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 eth0
iface eth0 inet static
    address 10.0.10.10
    netmask 255.255.255.0
    gateway 10.0.10.254
    dns-nameservers 10.0.10.100 10.0.10.101
    dns-search domain.local

# The secondary network interface
auto eth0:1
iface eth0:1 inet static
    address 10.0.10.11
    netmask 255.255.255.0

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

L-ewwel wieħed huwa li tinstalla l-pakkett resolvconf sabiex il-konfigurazzjoni DNS speċifikata fil-fajl preċedenti tkun tista’ tiġi applikata:

1
apt install -y resolvconf

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

2
IP_MED_WEB  FQDN    MACHINE_NAME
Eżempju

Jekk il-kompjuter jismu MEDIATION-CONTROLLER mingħajr ma jappartjeni għal dominju u l-indirizz IP tiegħu IP_MED_WEB huwa 10.0.10.10, allura l-fajl jimtela kif ġej:

2
10.0.10.10  MEDIATION-CONTROLLER

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

2
10.0.10.10  MEDIATION-CONTROLLER.DOMAIN.LOCAL   MEDIATION-CONTROLLER

Attenzjoni!

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

Fl-aħħar, ma jibqa’ xejn ħlief li terġa’ tibda s-servizz networking sabiex titgħabba l-konfigurazzjoni l-ġdida tan-netwerk: 

1
systemctl restart networking

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.

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

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:

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

Verifika tal-preżenza tal-locale en_US.utf8

L-installazzjoni tas-server Mediation Controller teħtieġ il-ġenerazzjoni tal-locales en_US.utf8.
Biex tivverifika jekk diġà ġewx ġenerati fuq is-server, ħaddem il-kmand li ġej bħala root: 

1
locale -a  | grep en_US.utf8

Jekk ir-riżultat tal-kmand juri en_US.utf8, mur għall-pass li jmiss tal-konfigurazzjoni ta’ GRUB.
Inkella, ħaddem il-kmandi li ġejjin biex iżżid dan il-locale mal-kompjuter:

1
2
sed -i "s/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/" /etc/locale.gen
locale-gen

Konfigurazzjoni tal-programm tal-ibbutjar GRUB

Ladarba jkunu ġew eżegwiti dawn il-kmandi, trid terġa’ tibda l-kompjuter wara li tapplika setting fil-programm tal-ibbutjar GRUB:

1
2
3
sed '9s/quiet/quiet vsyscall=emulate/' -i /etc/default/grub
update-grub
reboot

Installazzjoni tas-server Mediation Controller ta’ CyberElements Bastion

Installazzjoni tal-komponenti bażiċi

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

1
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 mediation:

Imbagħad agħżel il-modalità tal-installazzjoni standalone:

Imbagħad ikollok iddaħħal il-port li fuqu se jisma’ l-komponent SSL Router. Dan il-port tas-smigħ normalment ikun issettjat għal 443, iżda jista’ jintuża wkoll il-port 8443 jekk is-server Mediation Controller juża IP wieħed biss:

Imbagħad daħħal l-indirizz tal-aċċess web għas-server Mediation Controller (jikkorrispondi għal IP_MED_WEB fil-konfigurazzjoni tan-netwerk):

Fl-aħħar, daħħal l-indirizz IP tal-komponent SSL Router (jikkorrispondi għal IP_MED_SSL fil-konfigurazzjoni tan-netwerk):

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 speċifiċi

Ibda l-installazzjoni tal-komponenti speċifiċi għas-server Mediation Controller bil-kmand li ġej:

1
apt install -y ipdiva-safe-server

Is-server irid jerġa’ jinbeda biex titlesta l-installazzjoni (uża l-kmand reboot).

Installazzjoni tad-drivers għall-konnessjoni mad-databases Microsoft SQL Server

Jekk trid tikkonnettja ma’ database esterna u din hija Microsoft SQL Server, allura jridu jiġu installati drivers ODBC addizzjonali.

Hemm żewġ verżjonijiet disponibbli: il-verżjoni 17 u l-verżjoni 18.

Konnessjoni TLS meħtieġa għad-drivers fil-verżjoni 18

L-użu tad-drivers ODBC 18 jeħtieġ li l-konnessjoni tkun kriptata bl-użu ta’ TLS. Biex tagħmel dan, trid tikkonfigura MS SQL Server għall-kriptaġġ tal-konnessjoni.

Qabel ma tibda l-installazzjoni tad-drivers ODBC, trid tinstalla l-pakketti meħtieġa għat-tħejjija, imbagħad tħejji r-repożitorju ta’ Microsoft għall-installazzjoni tal-pakketti:

1
2
3
4
apt install -y curl apt-transport-https gpg
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
curl https://packages.microsoft.com/config/debian/12/prod.list > /etc/apt/sources.list.d/mssql-release.list
apt update

Imbagħad, installa d-drivers skont il-verżjoni magħżula u kkonfigura s-sistema biex tuża l-kmand sqlcmd:

1
2
3
ACCEPT_EULA=Y apt install -y msodbcsql17 mssql-tools python3-pip
pip install mssql-scripter --break-system-packages
ln -sfn /opt/mssql-tools/bin/sqlcmd /usr/bin/sqlcmd

1
2
3
ACCEPT_EULA=Y apt install -y msodbcsql18 mssql-tools18 python3-pip
pip install mssql-scripter --break-system-packages
ln -sfn /opt/mssql-tools18/bin/sqlcmd /usr/bin/sqlcmd

Id-drivers ODBC issa huma installati b’mod korrett.
Jekk is-server Mediation Controller għandu aċċess għal server MS SQL, il-kmand li ġej għandu jippermetti l-konnessjoni mas-server remot: 

1
sqlcmd -S SERVER\INSTANCE_NAME,PORT -U USER

Fejn:

  • SERVER għandu jiġi sostitwit bl-isem DNS jew bl-indirizz IP tas-server MS SQL.
  • INSTANCE_NAME għandu jiġi sostitwit bl-isem tal-istanza li magħha trid tikkonnettja; jekk mhux meħtieġ, neħħi wkoll il-karattru \.
  • PORT għandu jiġi sostitwit bil-port tal-konnessjoni mal-istanza tad-database MS SQL.
  • USER għandu jiġi sostitwit bl-isem tal-utent biex tiġi stabbilita l-konnessjoni.
Eżempji

Jekk is-server Mediation Controller għandu aċċess għal server tad-database MS SQL permezz tal-indirizz IP 10.0.10.100, l-istanza li għandha tiġi aċċessata qed tisma’ fuq il-port 1433, u l-kont tal-aċċess huwa sql-user. Allura l-kmand tal-konnessjoni huwa kif ġej:

1
sqlcmd -S 10.0.10.100,1433 -U sql-user

Kieku kellha tiġi speċifikata l-istanza tal-konnessjoni bl-isem MSSQLINSTANCE, il-kmand jiġi mmodifikat kif ġej:

1
sqlcmd -S 10.0.10.100\MSSQLINSTANCE,1433 -U sql-user

Konfigurazzjoni ta’ server tal-ħin NTP

Huwa rakkomandat li tikkonfigura server tal-ħin biex l-arloġġ tas-sistema jibqa’ aġġornat. Il-passi meħtieġa huma deskritti fil-paġna tal-konfigurazzjoni NTP.

Konfigurazzjonijiet inizjali fuq CyberElements Bastion

Il-komponenti tas-server Mediation Controller huma installati. Issa trid tikkonfigura s-servizz Mediation Controller.

  • Ibdel il-passwords default

    Ibdel il-passwords default tal-konsols tas-sistema.

    Ibdel

  • Installazzjoni taċ-ċertifikati u tal-liċenzji

    Il-komponent Mediation Controller jeħtieġ diversi ċertifikati u liċenzja biex ikun operattiv.

    Installa ċ-ċertifikati u l-liċenzja

  • Konfigurazzjoni tal-awtoritajiet taċ-ċertifikazzjoni

    Żid l-awtorità jew l-awtoritajiet taċ-ċertifikazzjoni (CA) li ma jappartjenux lil Systancia u li se jintużaw għaċ-ċertifikati tal-komponenti Edge Gateway u HTML5 Gateway.

    Ikkonfigura l-awtoritajiet taċ-ċertifikazzjoni affidabbli

  • Ikkonfigura ċ-ċertifikat web

    Ikkonfigura ċ-ċertifikat web użat għall-konnessjoni mal-interfaċċi web

    Ikkonfigura

  • Iddikjara isem DNS

    Żid isem DNS awtorizzat biex jikkonnettja mal-interfaċċi web.

    Żid

  • Ikkonfigura l-ospitant virtwali SSL

    Konfigurazzjoni tal-ospitant virtwali SSL ta’ CyberElements Bastion, li permezz tiegħu tispeċifika l-indirizz tal-konnessjoni mal-komponent SSL Router għall-klijenti u għall-mekkaniżmu tal-pairing tal-komponenti Edge Gateway.

    Ikkonfigura

  • Ikkonfigura l-organizzazzjoni

    Konfigurazzjoni tal-organizzazzjoni ta’ CyberElements Bastion.

    Ikkonfigura

  • Iddikjara l-komponenti Edge Gateway

    Iddikjara l-komponenti Edge Gateway jew HTML5 Gateway li għandhom jiġu installati u iġġenera token tal-pairing.

    Oħloq tokens tal-pairing

  • Oħloq sit loġiku

    Oħloq u kkonfigura sit loġiku li jiġbor flimkien il-komponenti Edge Gateway u HTML5 Gateway li jistgħu jaċċessaw ir-riżorsi lokali.

    Oħloq sit

  • Installa komponent Edge Gateway

    Installa u kkonfigura komponent Edge Gateway ġdid mas-server Mediation Controller li għadu kif ġie installat.
    Tiġi kkonfigurata wkoll istanza HTML5 Gateway.

    Installa