> Source: https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/EdgeGateway/ConnectAnEdgeGatewayWithPairingToken/

# Konnessjoni ta’ komponent Edge Gateway bl-użu tal-mekkaniżmu tal-pairing

> **Informazzjoni**
>
> Il-metodu tal-konnessjoni bil-pairing jaħdem bl-istess mod għal komponent Edge Gateway bħalma jaħdem għal komponent HTML5 Gateway.

> **Prerekwiżiti**
>
> Huwa meħtieġ aċċess SSH jew mill-konsol bl-utent `root` għall-komponent Edge Gateway.
>
> Biex il-pairing tal-komponent Edge Gateway jirnexxi, il-pakkett `ipdiva-gateway-setup` irid ikun installat fuq il-kompjuter. L-apparati virtwali kollha ta’ CyberElements Bastion (verżjoni 4.6 jew aktar reċenti) għandhom dan il-pakkett.
> Jekk ir-repożitorju ta’ Systancia huwa kkonfigurat b’mod korrett, il-kmand li ġej jiċċekkja l-preżenza tal-pakkett u jipprova jinstallah jekk ikun meħtieġ:
>
> ```
> 1
> ```

Ikkonnettja mas-server Edge Gateway permezz ta’ SSH jew fil-modalità tal-konsol bl-utent `root` u ħaddem kmand ekwivalenti għal dan li ġej biex tibda l-proċess tal-pairing għal komponent Edge Gateway jew HTML5 Gateway:

```
1
```

Hawn huma d-dettalji tal-għażliet differenti:

- `-s`: jiddefinixxi l-isem DNS tal-komponent Mediation Controller; jista’ jintuża indirizz IP, iżda x’aktarx ikun jeħtieġ l-użu tal-modalità mhux sigura.
- `-t`: jiddefinixxi t-token tal-pairing li għandu jintuża ([ġenerazzjoni ta’ token tal-pairing](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)).
- `-k`: attivazzjoni tal-modalità mhux sigura, li fiha l-verifika tal-validità taċ-ċertifikat web tal-komponent Mediation Controller tiġi diżattivata. Dan is-setting m’għandux jintuża b’mod sistematiku, iżda biss f’kuntesti fejn ikun meħtieġ u fejn il-preżenza ta’ attakkant MITM tkun ġiet eskluża (il-validazzjoni ta’ ċertifikat web tiżgura l-identità tas-server ikkuntattjat).
- `-n`: definizzjoni tas-suffiss tal-isem tal-istanza Edge Gateway fuq il-kompjuter; jekk ma jkunx definit, jintuża l-isem tal-istanza prinċipali, `gateway` jew `html5gateway`. Speċifika biss isem li fih numri, ittri, jew il-karattri speċjali `-` jew `_`. Għall-ewwel konnessjoni ta’ komponent Edge Gateway jew HTML5 Gateway mas-server, huwa rakkomandat li ma tissettjax il-parametru `-n`.
- `--no-care`: il-pairing mhux se jipprova jinstalla ċ-ċertifikat tas-servizz tar-reġistrazzjoni.
- `-v`: attivazzjoni tal-modalità dettaljata biex tinkiseb aktar informazzjoni dwar il-proċess tal-pairing.

> **Eżempji**
>
> Biex tinstalla l-ewwel istanza tal-komponent Edge Gateway fuq kompjuter, il-kmand li ġej ikun biżżejjed:
>
> ```
> 1
> ```
>
> Madankollu, jekk l-aċċess għas-server Mediation Controller ikun possibbli biss b’indirizz IP li ċ-ċertifikat web tiegħu mhuwiex adattat, allura l-modalità mhux sigura trid tiġi attivata (preferibbilment użata meta l-konnessjoni ma tgħaddix min-netwerk pubbliku):
>
> ```
> 1
> ```
>
> Jekk l-ewwel istanza tal-komponent Edge Gateway tkun diġà preżenti fuq il-kompjuter, ikun meħtieġ li tinħoloq istanza ġdida mingħajr ma jiġi modifikat iċ-ċertifikat tas-servizz tar-reġistrazzjoni:
>
> ```
> 1
> ```
>
> Il-kmand ta’ qabel, billi joħloq istanza ġdida bl-isem `gateway-instance-2` (il-komponenti Edge Gateway jieħdu awtomatikament il-prefiss `gateway-` filwaqt li l-komponenti HTML5 Gateway jieħdu l-prefiss `html5gateway-`), joħloq ukoll folders ġodda għal:
>
> - Il-ġestjoni tas-settings tal-istanza permezz tal-folder `/etc/ipdiva/gateway-instance-2/`.
> - Il-bidu, il-waqfien jew il-bidu mill-ġdid tal-istanza permezz tal-iskripts fil-folder `/usr/local/ipdiva/gateway-instance-2/bin/`.
