> Source: https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/Gateways/

# Gateways Management

Il-modulu **Gateways** jelenka l-komponenti Edge Gateway (gateways mhux HTML5) iddikjarati fuq il-pjattaforma u jagħtik il-possibbiltà li żżid wieħed, tibdel il-konfigurazzjoni tiegħu (ċertifikat, mogħdijiet tal-ħażna tar-reġistrazzjonijiet, pairing) jew tneħħih. Din il-paġna hija maħsuba għal amministratur jew integratur li jimmaniġġja l-flotta tal-komponenti Edge Gateway, il-pairing tagħhom mal-komponent Mediation Controller u l-ġbir tar-reġistrazzjonijiet video / SSH.

Biex ikun jista’ jintuża f’sessjoni, komponent Edge Gateway irid ikun marbut ma’ mill-inqas [sit](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/Sites/) wieħed. L-inklużjoni f’sit issir mill-modulu **Sites**, mhux minn dan.

> **Tutorjals relatati**
>
> - [Oħloq token tal-pairing għal komponent Edge Gateway](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Oħloq komponent Edge Gateway](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Lista tal-komponenti Edge Gateway

Il-modulu jiftaħ fuq grilja paġnata tal-komponenti Edge Gateway iddikjarati.

| Kolonna | Deskrizzjoni |
|---|---|
| **Name** | L-isem tal-komponent Edge Gateway, preċedut minn ikona li turi l-istat tal-konnessjoni tiegħu (online, offline, jistenna l-pairing). |
| **Description** | Deskrizzjoni libera mdaħħla mal-ħolqien. |
| **Sites** | Is-siti li magħhom huwa marbut il-komponent Edge Gateway. |
| **Type** | **With recording** jekk il-komponent Edge Gateway jappoġġja r-reġistrazzjoni tas-sessjonijiet, **Basic** f’każ ieħor. |
| **Version** | Il-verżjoni tal-komponent Edge Gateway. Meta jeżistu istanza master u istanza ta’ riżerva, iż-żewġ verżjonijiet jintwerew fuq żewġ linji. |

Azzjonijiet disponibbli fl-istrixxa tal-għodod:

| Azzjoni | Deskrizzjoni |
|---|---|
| **+** (żid) | Jiftaħ it-tieqa **Add Gateway**. |
| **Edit** | Jiftaħ it-tieqa **Edit Gateway** għall-komponent Edge Gateway magħżul. Jitnieda wkoll b’klikk doppju. |
| **×** (ħassar) | Iħassar il-komponenti Edge Gateway magħżula wara konferma. L-għażla multipla hija appoġġjata. |
| **Download recording certificate** | Iniżżel iċ-ċertifikat tal-awtorità tar-reġistrazzjoni tal-komponent Edge Gateway magħżul. Attivat biss jekk il-komponent Edge Gateway ikun **online**. |
| **Search** | Jiffiltra fuq parti mill-isem, 700 ms wara l-aħħar tasta (jew immedjatament b’`Enter`). |
| **Paġnazzjoni** | 15, 25 jew 50 ringiela għal kull paġna. |

---

## Żid komponent Edge Gateway

Il-buttuna **+** tiftaħ it-tieqa **Add Gateway**.

### Informazzjoni ġenerali

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Obbligatorju, 50 karattru l-aktar. Karattri permessi: ittri mingħajr aċċent, ċifri, `é`, `è`, `à`, `ô`, `â`, parentesi, spazju, `-`, `/`, `.` u `_`. |
| **Description** | Test liberu. |
| **FQDN** | L-isem kompletament kwalifikat tal-kompjuter li jospita l-komponent Edge Gateway. Irid jaqbel mas-CN taċ-ċertifikat tal-komponent Edge Gateway, inkella l-pairing jiġi rrifjutat (ara l-kapitolu [Messaġġi ta’ żball mas-salvataġġ](#error-messages-on-saving)). |
| **Archives** | Il-mogħdija lokali fejn il-komponent Edge Gateway jarkivja r-reġistrazzjonijiet tal-vidjo RDP. Mimlija minn qabel b’`/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Il-mogħdija lokali fejn il-komponent Edge Gateway jarkivja r-reġistrazzjonijiet SSH. Mimlija minn qabel b’`/var/ipdiva/care/sshrecord`. |

It-tliet oqsma **FQDN**, **Archives** u **Archives SSH** jikkonċernaw biss il-komponenti Edge Gateway b’reġistrazzjoni: huma moħbija fuq komponent Edge Gateway li ma jappoġġahiex.

### Paring Token

Il-kaxxa ta’ selezzjoni **Create a pairing token** turi t-taqsima **Paring Token**, moħbija b’mod default.

| Qasam | Deskrizzjoni |
|---|---|
| **SSL certificate** | Ċertifikat tal-gateway li għandu jittella’. Lista drop-down tistabbilixxi l-format mistenni — `pkcs12` (default) jew `pem` — u s-selettur tal-fajls imbagħad jaċċetta biss l-estensjoni korrispondenti, `.p12` jew `.pem`. |
| **Certificate or private key password** | Frażi ta’ aċċess taċ-ċertifikat tal-komponent Edge Gateway, fejn applikabbli. |
| **Import a Careserver certificate** | Meta tkun immarkata, turi ċ-ċertifikat tas-server tar-reġistrazzjoni: l-istess tliet elementi (format, fajl, password). |
| **Pairing key validity period** | Id-data u l-ħin li warajhom it-token ma jkunx jista’ jintuża aktar. Default: illum + 7 ijiem, fil-format `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | L-indirizz IP pubbliku li minnu l-komponent Edge Gateway huwa awtorizzat jagħmel il-pairing. Dan huwa l-indirizz kif jarah is-servizz Mediation Controller: wara NAT, daħħal l-indirizz pubbliku. |

> **L-aħħar żewġ oqsma jiġu żblukkati miċ-ċertifikat**
>
> **Pairing key validity period** u **IP authorized to use the token** jibqgħu **inattivi** sakemm ma jkunx intgħażel fajl ta’ ċertifikat validu. Għalhekk, fajl li l-estensjoni tiegħu ma taqbilx mal-format magħżul iħallihom inattivi — sakemm jiġi pprovdut fajl konformi.

Il-buttuna **Validate** tissejvja l-komponent Edge Gateway. Jekk is-salvataġġ jipproduċi token tal-pairing, tinfetaħ tieqa **Paring Token**, li turi ċ-ċavetta u tindika li hija **biex tintuża meta jiġi installat il-gateway**. Tingħalaq bil-buttuna **Close**: iċ-ċavetta trid tiġi kkupjata mit-tieqa.

---

## Editja komponent Edge Gateway

Agħżel komponent Edge Gateway fil-lista u kklikkja l-ikona **Properties** (jew ikklikkja darbtejn fuq ir-ringiela). It-tieqa **Edit Gateway** tkun diġà mimlija bis-settings attwali u bid-dettalji taċ-ċertifikat marbut.

L-oqsma huma l-istess bħal fil-ħolqien, bir-regoli li ġejjin:

- il-qasam **Name** jibqa’ editjabbli;
- **FQDN**, **Archives** u **Archives SSH** huma moħbija jekk il-komponent Edge Gateway ma jappoġġjax ir-reġistrazzjoni, u **diżattivati** sakemm ma jkunx online;
- **Pairing key validity period** u **IP authorized to use the token** jistgħu jinbidlu biss fuq komponent Edge Gateway **li jkun qed jistenna l-pairing**;
- qasam **Authentication Token**, li jinqara biss, jidher fuq komponent Edge Gateway li qed jistenna l-pairing.

> **Bidla tal-mogħdijiet tal-arkivju**
>
> Il-bidla ta’ **Archives** jew **Archives SSH** tagħmel ir-reġistrazzjonijiet preċedenti inaċċessibbli mill-konsol. Tintalab konferma qabel ma tiġi applikata l-bidla, u falliment min-naħa tal-komponent Edge Gateway jiġi rrappurtat bil-messaġġ **An error occured during the update of storage paths.**

---

## Ħassar komponent Edge Gateway

Agħżel komponent Edge Gateway wieħed jew aktar u kklikkja l-buttuna **×**. Tintalab konferma. L-għażla multipla hija appoġġjata.

| Messaġġ | Kawża |
|---|---|
| **The following gateway is currently being used:** | Il-komponent Edge Gateway huwa marbut ma’ sit wieħed jew aktar. Irid jiġi mneħħi minnhom qabel it-tħassir. L-ismijiet ikkonċernati jiġu wara l-messaġġ, u jeżisti varjant fil-plural għal tħassir multiplu. |
| **Deletion failed for the following gateway:** | It-tħassir falla min-naħa tal-komponent Edge Gateway. L-ismijiet bl-iżball jiġu wara l-messaġġ. |

---

## Messaġġi ta’ żball mas-salvataġġ

| Messaġġ | Kawża |
|---|---|
| **This gateway already exists.** | Diġà jeżisti komponent Edge Gateway b’dak l-isem. |
| **Invalid Name** | L-isem sottomess ġie rrifjutat mis-server. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Iċ-ċertifikat tal-komponent Edge Gateway ma fihx is-CN mistenni. Il-messaġġ jagħti s-CN misjub u dak mistenni. |
| **The CN of the Careserver certificate sent does not match the expected CN** | L-istess każ għaċ-ċertifikat tas-server tar-reġistrazzjoni. |
| **Invalid certificate or private key password** | Il-frażi ta’ aċċess ipprovduta ma tiftaħx iċ-ċertifikat. |
| **Unable to contact the pairing system, please check its configuration** | Is-servizz tal-pairing ma weġibx. |
| **The given gateway is unreachable.** | Il-komponent Edge Gateway ma jwiġibx; l-operazzjoni tiġi abbandunata. |
| **The gateway management service is unreachable** | Is-servizz li jmexxi l-komponenti Edge Gateway ma weġibx. |
