> Source: https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/

# Ħolqien ta’ token tal-pairing għal komponent Edge Gateway

Biex toħloq token tal-pairing, trid toħloq komponent Edge Gateway jew HTML5 Gateway ġdid (jew teditja komponent Edge Gateway jew HTML5 Gateway eżistenti billi toħloq mill-ġdid token tal-pairing).

Aċċessa l-interfaċċa web tas-server Mediation Controller bl-URI `/system`.

> **Eżempji**
>
> Jekk l-aċċess għall-komponent Mediation Controller fuq l-indirizz IP web tiegħu huwa `10.0.10.10`, l-aċċess għall-interfaċċa tas-sistema se juża l-URL: https://10.0.10.10/system.
>
> Jekk l-aċċess għall-komponent Mediation Controller ikun possibbli b’isem DNS, pereżempju `cyberelements-bastion.domain.local`, allura l-aċċess għall-interfaċċa tas-sistema se juża l-URL: https://cyberelements-bastion.domain.local/system.
>
> > **Importanti!**
> >
> > Għal kwalunkwe bidla fil-password, fil-liċenzja jew fiċ-ċertifikati (SSL Router, Watchdog u l-klijent CyberElements Bastion), ikkonnettja mal-indirizz IP reali għall-clusters (`RIP_MED_WEB_MASTER` jew `RIP_MED_WEB_SLAVE`).

Ladarba tkun idħalt, segwi l-passi ta’ hawn taħt skont it-tip tal-pjattaforma tiegħek u t-tip ta’ komponent Edge Gateway li jrid jinħoloq.

**Edge Gateway**

> > **Prerekwiżiti meħtieġa**
> >
> > Biex toħloq b’suċċess komponent Edge Gateway ġdid, trid tikseb mill-inqas ċertifikat wieħed għall-konnessjoni tal-komponent Edge Gateway u t-tieni ċertifikat fakultattiv biex jaħdem is-servizz tar-reġistrazzjoni tal-aċċess dirett.
> >
> > Iċ-ċertifikat għall-komponent Edge Gateway irid ikun ċertifikat tal-awtentikazzjoni tal-klijent u jkollu CN fil-forma `edge-gateway-name@organization-name`. Fejn:
> >
> > - `edge-gateway-name` jikkorrispondi għall-isem loġiku tal-komponent Edge Gateway (peress li kompjuter Edge Gateway wieħed jista’ jkollu diversi istanzi li jaħdmu b’mod parallel, l-isem tal-komponent Edge Gateway jista’ jkun differenti mill-isem assenjat lill-kompjuter). L-isem ma għandux ikun fih karattri b’aċċent jew spazji, u l-uniċi karattri speċjali permessi huma `-` u `_`.
> > - `organization-name` jikkorrispondi għall-isem tal-organizzazzjoni li magħha se jikkonnettja l-komponent Edge Gateway. Peress li komponent Mediation Controller jista’ jkollu diversi organizzazzjonijiet, din l-informazzjoni hija essenzjali biex ikun jaf ma’ liema organizzazzjoni huwa marbut.
> >
> > Iċ-ċertifikat għas-servizz tar-reġistrazzjoni irid ikun ċertifikat tal-awtentikazzjoni tas-server, preferibbilment b’CN li jikkorrispondi għall-FQDN tal-kompjuter Edge Gateway.
> >
> > Innota li l-komponent Mediation Controller se jirrifjuta kwalunkwe ċertifikat li ma jiġix minn PKI/awtorità taċ-ċertifikazzjoni fdata. Biex iżżid PKI/awtorità taċ-ċertifikazzjoni fdata ġdida, segwi l-istruzzjonijiet fil-paġna li ġejja: [Żid awtorità taċ-ċertifikazzjoni fdata](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/AddANewTrustedCA/)
>
> 1. Iftaħ il-modulu tal-ġestjoni tal-komponenti Edge Gateway: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_OpenEdgeGatewaysModule.png)
> 2. Oħloq komponent Edge Gateway ġdid billi tikklikkja fuq l-ikona +: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_GatewaysManagement_AddGateway.png)
> 3. Imla l-oqsma differenti mitluba mill-interfaċċja: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_GatewaysManagement_AddGateway-ConfigurationWithPairing.png)
>     1. Agħti isem lill-komponent Edge Gateway il-ġdid.
>     2. Jekk trid, daħħal deskrizzjoni biex tidentifikah aħjar jew biex tifhem l-użu tiegħu.
>     3. Iddefinixxi l-FQDN tal-kompjuter. Din hija informazzjoni importanti li trid taqbel mas-CN taċ-ċertifikat għas-servizz tar-reġistrazzjoni.
>     4. Immarka l-għażla biex jinħoloq token tal-pairing.
>     5. Sib u daħħal il-password taċ-ċertifikat tal-komponent Edge Gateway.
>     6. Jekk tixtieq (rakkomandat meta toħloq l-ewwel istanza tal-komponent Edge Gateway fuq il-kompjuter), żid iċ-ċertifikat tas-servizz tar-reġistrazzjoni bil-password assoċjata tiegħu wara li timmarka `Import a Careserver certificate`.
>     7. Iddefinixxi l-perjodu ta’ validità tat-token tal-pairing.
>     8. Jekk tixtieq, illimita l-użu tat-token għal indirizz IP. Innota li dan huwa l-indirizz IP kif jarah il-komponent Mediation Controller. Jekk il-komponent Edge Gateway jagħmel parti mill-istess netwerk tal-komponent Mediation Controller, x’aktarx ikun l-indirizz IP privat; inkella, ikun l-indirizz IP pubbliku.
> 4. It-token tal-pairing imbagħad jiġi ġġenerat u jintwera fuq l-iskrin: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_GatewaysManagement_AddGateway-ParingTokenAfterCreation.png)

**HTML5 Gateway**

> > **Prerekwiżiti meħtieġa**
> >
> > Biex toħloq b’suċċess komponent HTML5 Gateway ġdid, trid tikseb ċertifikat biex tikkonnettja miegħu.
> > Iċ-ċertifikat għall-komponent HTML5 Gateway irid ikun ċertifikat tal-awtentikazzjoni tal-klijent u jkollu CN fil-forma `html5-gateway-name@organization-name`. Fejn:
> >
> > - `html5-gateway-name` jikkorrispondi għall-isem loġiku tal-komponent HTML5 Gateway (peress li kompjuter HTML5 Gateway wieħed jista’ jkollu diversi istanzi li jaħdmu b’mod parallel, l-isem tal-komponent HTML5 Gateway jista’ jkun differenti mill-isem assenjat lill-kompjuter). L-isem ma għandux ikun fih karattri b’aċċent jew spazji, u l-uniċi karattri speċjali permessi huma `-` u `_`.
> > - `organization-name` jikkorrispondi għall-isem tal-organizzazzjoni li magħha l-komponent HTML5 Gateway ikollu jikkonnettja. Peress li komponent Mediation Controller jista’ jkollu diversi organizzazzjonijiet, din l-informazzjoni hija essenzjali biex ikun jaf ma’ liema organizzazzjoni huwa marbut.
> >
> > Innota li l-komponent Mediation Controller se jirrifjuta kwalunkwe ċertifikat li ma jiġix minn PKI/awtorità taċ-ċertifikazzjoni fdata. Biex iżżid PKI/awtorità taċ-ċertifikazzjoni fdata ġdida, segwi l-istruzzjonijiet fil-paġna li ġejja: [Żid awtorità taċ-ċertifikazzjoni fdata](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/SystemConsole/AddANewTrustedCA/)
>
> 1. Iftaħ il-modulu tal-ġestjoni tal-komponenti HTML5 Gateway: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_OpenHTML5GatewaysModule.png)
> 2. Oħloq komponent HTML5 Gateway ġdid billi tikklikkja fuq l-ikona +: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_HTML5GatewaysManagement_AddGateway.png)
> 3. Imla l-oqsma differenti mitluba mill-interfaċċja: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_HTML5GatewaysManagement_AddGateway-ConfigurationWithPairing.png)
>     1. Agħti isem lill-komponent HTML5 Gateway il-ġdid.
>     2. Speċifika l-URL tal-aċċess (għall-ewwel istanza f’arkitettura Standalone, normalment dan huwa `HTML5`; għal Cluster, huwa `HTML5-1` u `HTML5-2`).
>     3. Jekk tixtieq, daħħal deskrizzjoni biex tidentifikah aħjar jew biex tifhem l-użu tiegħu.
>     4. Issettja l-protokoll għal `WebSocket`.
>     5. Immarka l-għażla biex jinħoloq token tal-pairing.
>     6. Sib u daħħal il-password taċ-ċertifikat tal-komponent HTML5 Gateway.
>     7. Iddefinixxi l-perjodu ta’ validità tat-token tal-pairing.
>     8. Jekk tixtieq, illimita l-użu tat-token għal indirizz IP. Innota li dan huwa l-indirizz IP kif jarah il-komponent Mediation Controller. Jekk il-komponent HTML5 Gateway jagħmel parti mill-istess netwerk tal-komponent Mediation Controller, x’aktarx ikun l-indirizz IP privat; inkella, ikun l-indirizz IP pubbliku.
> 4. It-token tal-pairing imbagħad jiġi ġġenerat u jintwera fuq l-iskrin: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_GatewaysManagement_AddGateway-ParingTokenAfterCreation.png)

> **Parir**
>
> Jekk it-token intilef jew ma setax jinkiseb wara l-ħolqien, l-editjar tas-settings tal-komponent Edge Gateway il-ġdid jerġa’ jurih.

Ladarba jinkiseb it-token tal-pairing, jista’ jintuża fuq komponent Edge Gateway jew HTML5 Gateway bl-istruzzjonijiet li ġejjin: [Konnessjoni ta’ komponent Edge Gateway b’token tal-pairing](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/EdgeGateway/ConnectAnEdgeGatewayWithPairingToken/).
