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

# Konfigurazzjoni tal-aġent tar-reġistrazzjoni għal Windows

L-aġent tar-reġistrazzjoni għal Windows jintuża minn CyberElements Bastion biex iżid funzjonalitajiet ġodda għas-sessjonijiet RDP:

- Possibbiltà li jiġu ffiltrati l-flussi TCP u UDP aċċessibbli għall-utent
- Possibbiltà li tiġi skattata r-reġistrazzjoni tas-sessjoni għal kwalunkwe utent li jikkonnettja mas-server mingħajr ma jgħaddi mill-portal tal-utent jew mill-klijent Desktop (funzjonalità `direct access`)

Barra minn hekk, jinqabdu avvenimenti addizzjonali waqt is-sessjonijiet tal-utenti:

- Ftuħ ta’ twieqi
- Għeluq ta’ twieqi
- Tnedija ta’ programmi
- Għeluq ta’ programmi
- Kontenut tal-clipboard
- Attività tal-utent

## Prerekwiżiti

> **Kompatibbiltà tal-klijent**
>
> Biex tkun taf jekk l-aġent huwiex kompatibbli mas-sistemi operattivi differenti ta’ Microsoft Windows, ara [il-matriċi tal-kompatibbiltà](https://docs.cyberelements.io/bastion/4.6/mt/CompatibilityMatrix/).

L-aġent tar-reġistrazzjoni jeħtieġ xi prerekwiżiti biex jaħdem sew. Xi wħud minnhom huma maħsuba biss għall-funzjonalità tar-reġistrazzjoni bbażata fuq aġent għall-applikazzjonijiet RDP u HTML5 RDP, filwaqt li oħrajn jikkonċernaw l-aċċess dirett ibbażat fuq aġent.

### Prerekwiżiti ġenerali

L-aġent tar-reġistrazzjoni jibgħat ir-reġistrazzjoni tas-sessjoni tal-utent lura lil CyberElements Bastion billi jikkonnettja mal-komponent Edge Gateway fuq il-port `TCP 8443`. Dan jeħtieġ li l-fluss tan-netwerk bejn iż-żewġ kompjuters ikun miftuħ.

Biex jibgħat ir-reġistrazzjoni lura lill-komponent Edge Gateway b’mod sigur, l-aġent tar-reġistrazzjoni jistabbilixxi konnessjoni sigura miegħu permezz ta’ TLS. TLS jiddependi fuq l-użu ta’ ċertifikati, u r-restrizzjonijiet li ġejjin għandhom jiġu vvalidati biex il-konnessjoni titqies affidabbli u sigura:

- Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, m’għandux ikun skada (data massima ta’ validità).
- Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, għandu jkun maħruġ minn awtorità taċ-ċertifikazzjoni rikonoxxuta bħala affidabbli mill-kompjuter li fuqu huwa installat l-aġent tar-reġistrazzjoni.

  > **Informazzjoni addizzjonali**
  >
  > Is-server li fuqu huwa installat l-aġent tar-reġistrazzjoni għandu jkollu, bħala minimu, l-awtorità taċ-ċertifikazzjoni (CA) għerq taċ-ċertifikat tas-server tar-reġistrazzjoni fil-ħażna lokali tiegħu tal-awtoritajiet taċ-ċertifikazzjoni affidabbli.
  >
  > Għalhekk huwa meħtieġ:
  >
  > 1. Ikseb is-CA għerq taċ-ċertifikat mis-servizz tar-reġistrazzjoni fuq il-komponent Edge Gateway.
  > 2. Tella’ din is-CA fuq is-server fejn huwa installat l-aġent tar-reġistrazzjoni.
  > 3. Installa s-CA fil-ħażna taċ-ċertifikati “Trusted Root Certification Authorities” fuq il-kompjuter lokali.
  >
  > > **Eżempju b’PowerShell**
  > >
  > > Tista’ timporta faċilment ċertifikat fil-format `.cer` permezz ta’ PowerShell.
  > > Biex tagħmel dan, iftaħ terminal PowerShell bħala l-amministratur tal-kompjuter u eżegwixxi l-kmand li ġej:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Ibdel `<PATH_TO_CERT>` bil-mogħdija lejn il-fajl taċ-ċertifikat.
  >
  > > **Eżempju b’PowerShell għaċ-ċertifikat ta’ Systancia mingħajr ma tibgħat fajls**
  > >
  > > Dan l-eżempju jinvolvi l-installazzjoni tal-awtorità ta’ ċertifikazzjoni root (CA) ta’ Systancia, li tintuża mill-klijenti CyberElements Bastion li jużaw ċertifikati pprovduti minn Systancia.
  > >
  > > Huwa possibbli wkoll li timporta ċ-ċertifikat mingħajr ma jkollok tibgħat/tniżżel il-fajl fuq il-kompjuter fejn huwa installat l-aġent tar-reġistrazzjoni.
  > > Biex tagħmel dan, iftaħ terminal PowerShell bħala l-amministratur tal-kompjuter u eżegwixxi l-kmandi li ġejjin:
  > >
  > > ```
  > >  1
  > >  2
  > >  3
  > >  4
  > >  5
  > >  6
  > >  7
  > >  8
  > >  9
  > > 10
  > > 11
  > > 12
  > > 13
  > > 14
  > > 15
  > > 16
  > > 17
  > > 18
  > > 19
  > > 20
  > > 21
  > > 22
  > > 23
  > > 24
  > > 25
  > > 26
  > > 27
  > > 28
  > > 29
  > > 30
  > > 31
  > > 32
  > > 33
  > > 34
  > > 35
  > > 36
  > > 37
  > > 38
  > > 39
  > > 40
  > > 41
  > > 42
  > > ```
  > >
  > > Biex tuża dan il-metodu ma’ CA oħra, ibdel il-valur tal-varjabbli `base64Cert` għaċ-ċertifikat tal-għażla tiegħek ikkodifikat f’base 64.
- Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, m’għandux ikun revokat.
- Il-kompjuter li fuqu huwa installat l-aġent tar-reġistrazzjoni għandu jkun jista’ jikkuntattja s-server, f’dan il-każ il-komponent Edge Gateway, b’isem DNS jew indirizz IP kopert miċ-ċertifikat tas-server permezz tal-Common Name (CN) tiegħu.

### Prerekwiżiti speċifiċi għall-applikazzjonijiet RDP b’aġenti użati fuq stazzjon tax-xogħol tal-utent macOS jew Ubuntu

> **Twissija**
>
> Il-prerekwiżiti li ġejjin huma meħtieġa biss jekk l-utent iniedi applikazzjoni RDP b’aġent u l-istazzjon tax-xogħol tiegħu ma jkunx Windows (macOS jew Ubuntu).
>
> Jekk l-utenti ta’ CyberElements Bastion għandhom stazzjonijiet tax-xogħol li jħaddmu esklussivament Windows jew, jekk le, jużaw esklussivament applikazzjonijiet HTML5 RDP, il-prerekwiżiti li ġejjin jistgħu jiġu injorati.

Iċ-ċwievet tar-reġistru li ġejjin huma meħtieġa fuq is-server fil-mira fejn huwa skjerat l-aġent tar-reġistrazzjoni.

L-ewwel nett, l-ewwel ċavetta se tiddiżattiva l-lista tal-programmi tal-bidu awtorizzati ([dokument ta’ Microsoft](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). B’mod default, kompjuter Windows jippermetti biss `explorer.exe` bħala programm tal-bidu.

```
1
2
```

Jekk il-kompjuter mhuwiex server RDS, l-applikazzjoni taċ-ċavetta tar-reġistru li ġejja hija dejjem rakkomandata sabiex l-aġent tar-reġistrazzjoni jkun jista’ jinfetaħ bħala programm tal-bidu:

```
1
2
```

### Rekwiżiti speċifiċi għall-aċċess dirett

> **Funzjonalità tal-aċċess dirett**
>
> Il-funzjonalità ta’ aċċess dirett tippermettilek tiskatta reġistrazzjoni tas-sessjoni tal-utent għal aċċess RDP jew bil-konsol (konnessjoni fiżika mal-kompjuter jew permezz tal-modalità konsol tal-ipervisur) li ma jgħaddix direttament minn CyberElements Bastion.
>
> Jekk l-utent ikollu permess biex jaċċessa s-server, is-sessjoni tiegħu tiġi rreġistrata. Jekk dan ma jkunx il-każ, b’mod default l-utent jiġi skonnettjat.

Biex l-aġent tar-reġistrazzjoni jaħdem fil-modalità tal-aċċess dirett, huwa meħtieġ ċertifikat x509. Dan iċ-ċertifikat għandu jissodisfa r-rekwiżiti li ġejjin:

- Iċ-ċertifikat għandu jkun għadu validu (il-perjodu ta’ validità ma jkunx skada).
- Iċ-ċertifikat għandu jkun tat-tip (qasam tal-użu avvanzat taċ-ċavetta) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Iċ-ċertifikat m’għandux ikun revokat.
- Ir-restrizzjonijiet tal-[livell ta’ sigurtà 2 ta’ OpenSSL](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) jimplikaw li:
    - Iċ-ċertifikat għandu jkollu ċavetta privata ta’ mill-inqas 2048 bit biċ-ċifri RSA, DSA u DH; għaċ-ċwievet b’kurva ellittika (ECC), dawn għandhom ikunu ta’ mill-inqas 224 bit.
    - Il-firma taċ-ċertifikat m’għandhiex tkun MD5 jew SHA-1 (SHA-512 huwa ppreferut).
- Is-server tar-reġistrazzjoni se juża l-qasam `Common Name` (CN) biex jidentifika ċ-ċertifikat u għalhekk il-kompjuter fejn tiġi skattata reġistrazzjoni diretta. Dan il-qasam għandu jimtela.

## Konfigurazzjonijiet permezz taċ-ċwievet tar-reġistru

Xi settings globali huma disponibbli fiċ-ċwievet tar-reġistru biex jaffettwaw it-tħaddim tal-aġent tar-reġistrazzjoni kemm meta jintuża mal-applikazzjonijiet kif ukoll fl-aċċess dirett.

```
1
2
3
```

**`DisconnectOnError`**

Jiddefinixxi l-imġiba tal-aġent tar-reġistrazzjoni meta jingħalaq ir-reġistratur tas-sessjoni. Jekk jiġi speċifikat il-valur `0` (imġiba default), meta jingħalaq ir-reġistratur, is-sessjoni tal-utent tingħalaq. Jekk jiġi speċifikat il-valur `1`, is-sessjoni tal-utent tiġi skonnettjata meta jingħalaq ir-reġistratur.

**`SessionEndTimeout`**

Definizzjoni taż-żmien (f’sekondi) għall-għeluq tas-sessjoni tal-utent qabel ma jsir għeluq sfurzat tas-sessjoni. B’mod default, dan il-parametru huwa ssettjat għal 10 sekondi.

## Konfigurazzjoni għat-tħaddim mal-applikazzjonijiet RDP u HTML5 RDP

F’din il-modalità tat-tħaddim, l-iskambji bejn il-komponent Mediation Controller, il-komponent Edge Gateway u l-aġent tar-reġistrazzjoni huma kif ġej:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as Server RDP<br/>Aġent tar-reġistrazzjoni

    MED->>+GW: Bgħit tal-informazzjoni tal-login <br/>tas-server RDP flimkien mal-informazzjoni tal-login <br/>tal-aġent tar-reġistrazzjoni
    GW->>AGENT: Inizjalizzazzjoni tal-konnessjoni RDP
    GW->>-AGENT: Bgħit tal-informazzjoni tal-login lis-<br/>servizz tar-reġistrazzjoni tal-Edge Gateway
    AGENT->>+GW: Konnessjoni mas-servizz tar-reġistrazzjoni
    GW->>-AGENT: Bgħit ta’ informazzjoni dwar il-filtrazzjoni tan-netwerk
    Note over AGENT: Applikazzjoni ta’ restrizzjonijiet <br/>tan-netwerk fuq l-utent
    loop Reġistrazzjoni kontinwa tas-sessjoni
        AGENT->>+GW: Bgħit kontinwu tar-reġistrazzjoni tal-vidjo <br/>+ avvenimenti tas-sessjoni
        Note over GW: Żieda kontinwa tar-reġistrazzjoni tal-vidjo <br/>fid-direttorju tal-ħażna temporanja
        GW->>-MED: Bgħit tal-avvenimenti tas-sessjoni riċevuti
        Note over MED: Reġistrazzjoni tal-avvenimenti <br/>fid-database tal-organizzazzjoni
    end
    break Tmiem tas-sessjoni
        AGENT->>GW: Bgħit ta’ informazzjoni li <br/>l-utent temm is-sessjoni RDP tiegħu
        Note over GW: Ir-reġistrazzjoni tal-vidjo tiġi mċaqalqa <br/>għad-direttorju tal-arkivju
        GW->>MED: Indikazzjoni tat-tmiem tas-sessjoni tal-utent
        Note over MED: Is-sessjoni tal-utent tgħaddi <br/>mix-xandir dirett għall-arkivju
    end
```

1. Il-komponent Mediation Controller jipprovdi lill-komponent Edge Gateway l-informazzjoni tal-konnessjoni għas-server RDP fil-mira. Jinkludi wkoll l-informazzjoni tal-konnessjoni li għandu għall-konnessjoni mas-servizz tar-reġistrazzjoni (l-FQDN tal-komponent Edge Gateway).
2. Il-komponent Edge Gateway jibda l-konnessjoni mas-server RDP.
3. Il-komponent Edge Gateway jibgħat l-informazzjoni tal-konnessjoni għas-servizz tar-reġistrazzjoni tiegħu lill-aġent tar-reġistrazzjoni.
4. L-aġent tar-reġistrazzjoni jibda l-konnessjoni mas-servizz tar-reġistrazzjoni.
5. Ladarba l-aġent ikun konness, is-servizz tar-reġistrazzjoni jirritorna l-lista tar-restrizzjonijiet tal-fluss tan-netwerk li għandhom jiġu applikati għas-sessjoni. Ladarba jirċevihom, l-aġent tar-reġistrazzjoni japplikahom għas-sessjoni tal-utent.
6. L-aġent tar-reġistrazzjoni jtella’ kontinwament u f’ħin reali r-reġistrazzjoni bil-vidjo tas-sessjoni tal-utent u l-avvenimenti kollha tas-sessjoni (eż. il-pressjonijiet tat-tasti jew it-tnedija ta’ programmi) lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni jaħżen ir-reġistrazzjoni bil-vidjo f’folder temporanju.
7. Is-servizz tar-reġistrazzjoni jirrapporta l-avvenimenti varji tas-sessjoni lill-komponent Mediation Controller, li mbagħad jaħżinhom fil-bażi tad-data tal-organizzazzjoni.
8. Meta tintemm is-sessjoni RDP tal-utent, l-aġent tar-reġistrazzjoni jirrapporta l-informazzjoni lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni mbagħad iċaqlaq il-vidjo rreġistrat għall-folder tal-arkivju tar-reġistrazzjonijiet tal-utenti.
9. Is-servizz tar-reġistrazzjoni jirrapporta t-tmiem tas-sessjoni tal-utent lill-komponent Mediation Controller. Għalhekk is-sessjoni ma tibqax viżibbli fit-taqsima Live Streaming tal-modulu Control Center iżda tgħaddi għat-taqsima Archives.

B’din is-sekwenza, huwa essenzjali li l-aġent tar-reġistrazzjoni jirċievi l-informazzjoni tal-konnessjoni korretta għas-servizz tar-reġistrazzjoni tal-komponent Edge Gateway. Din l-informazzjoni tinsab fis-settings tal-komponent Edge Gateway fil-qasam `FQDN`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_Gateway_Edit.png)

F’dan il-qasam, daħħal isem DNS li s-servers RDP ikunu jistgħu jirriżolvu.

> **Importanti**
>
> Iċ-ċertifikat assenjat lis-servizz tar-reġistrazzjoni `Careserver` irid ikopri l-isem speċifikat fil-qasam `FQDN`. Inkella, l-aġent tar-reġistrazzjoni jqis il-konnessjoni bħala mhux sigura u ma jniedix ir-reġistrazzjoni tas-sessjoni.

## Konfigurazzjoni għat-tħaddim bl-aċċess dirett

F’din il-modalità tat-tħaddim, l-iskambji bejn il-komponent Mediation Controller, il-komponent Edge Gateway u l-aġent tar-reġistrazzjoni huma kif ġej:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as Server RDP<br/>Aġent tar-reġistrazzjoni

    Note over AGENT: Skoperta ta’ sessjoni <br/>ġdida li għandha tiġi rreġistrata
    AGENT->>+GW: Konnessjoni mas-servizz tar-reġistrazzjoni
    GW->>-MED: Indikazzjoni ta’ konnessjoni ġdida <br/>b’aċċess dirett għall-utent X
    alt Jekk l-utent X huwa awtorizzat
        MED->>+GW: Bgħit ta’ informazzjoni li l-utent X <br/>huwa awtorizzat jikkonnettja u bgħit <br/>tal-lista tal-filtri tan-netwerk li għandhom jiġu applikati
        GW->>-AGENT: Bgħit ta’ informazzjoni dwar il-filtrazzjoni tan-netwerk <br/>u l-awtorizzazzjoni tal-konnessjoni <br/>għall-utent X
        Note over AGENT: Applikazzjoni ta’ restrizzjonijiet <br/>tan-netwerk fuq l-utent X
        loop Reġistrazzjoni kontinwa tas-sessjoni
            AGENT->>+GW: Bgħit kontinwu tar-reġistrazzjoni tal-vidjo <br/>+ avvenimenti tas-sessjoni
            Note over GW: Żieda kontinwa tar-reġistrazzjoni tal-vidjo <br/>fid-direttorju tal-ħażna temporanja
            GW->>-MED: Bgħit tal-avvenimenti tas-sessjoni riċevuti
            Note over MED: Reġistrazzjoni tal-avvenimenti <br/>fid-database tal-organizzazzjoni
        end
        break Tmiem tas-sessjoni
            AGENT->>GW: Bgħit ta’ informazzjoni li <br/>l-utent X temm is-sessjoni RDP tiegħu
            Note over GW: Ir-reġistrazzjoni tal-vidjo tiġi mċaqalqa <br/>għad-direttorju tal-arkivju.
            GW->>MED: Indikazzjoni tat-tmiem tas-sessjoni tal-utent
            Note over MED: Is-sessjoni tal-utent tgħaddi <br/>mix-xandir dirett għall-arkivju
        end
    else If user X is not authorized
        MED->>+GW: Bgħit ta’ informazzjoni li l-utent <br/>X mhuwiex awtorizzat jagħmel login
        GW->>-AGENT: Bgħit ta’ notifika dwar <br/>iċ-ċaħda tal-login tal-utent X
        Note over AGENT: Logout tal-utent X
    end
```

1. Sessjoni ġdida tiġi skoperta mill-aġent tar-reġistrazzjoni, li jibda konnessjoni mas-servizz tar-reġistrazzjoni ta’ komponent Edge Gateway.
2. Il-komponent Edge Gateway jibgħat l-informazzjoni tal-konnessjoni (l-isem tal-utent u l-isem komuni (CN) taċ-ċertifikat użat mill-aġent tar-reġistrazzjoni) lill-komponent Mediation Controller. Il-komponent Mediation Controller iwieġeb b’żewġ modi differenti skont is-settings tad-drittijiet tal-aċċess.
3. Jekk l-utent ikun awtorizzat jikkonnettja mas-server, il-komponent Mediation Controller jirrapporta lura lill-komponent Edge Gateway l-aċċess possibbli għal dan l-utent u l-lista tal-filtri tan-netwerk li għandhom jiġu applikati.
4. Il-komponent Edge Gateway jirritorna din l-informazzjoni lill-aġent tar-reġistrazzjoni. Ladarba jirċeviha, l-aġent tar-reġistrazzjoni japplika l-filtri tan-netwerk għas-sessjoni tal-utent.
5. L-aġent tar-reġistrazzjoni jtella’ kontinwament u f’ħin reali r-reġistrazzjoni bil-vidjo tas-sessjoni tal-utent u l-avvenimenti kollha tas-sessjoni (eż. il-pressjonijiet tat-tasti jew it-tnedija ta’ programmi) lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni jaħżen ir-reġistrazzjoni bil-vidjo f’folder temporanju.
6. Is-servizz tar-reġistrazzjoni jirrapporta l-avvenimenti varji tas-sessjoni lill-komponent Mediation Controller, li mbagħad jaħżinhom fil-bażi tad-data tal-organizzazzjoni.
7. Meta tintemm is-sessjoni RDP tal-utent, l-aġent tar-reġistrazzjoni jirrapporta l-informazzjoni lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni mbagħad iċaqlaq il-vidjo rreġistrat għall-folder tal-arkivju tar-reġistrazzjonijiet tal-utenti.
8. Is-servizz tar-reġistrazzjoni jirrapporta t-tmiem tas-sessjoni tal-utent lill-komponent Mediation Controller. Għalhekk is-sessjoni ma tibqax viżibbli fit-taqsima Live Streaming tal-modulu Control Center iżda tgħaddi għat-taqsima Archives.
9. Jekk l-utent ma jkunx awtorizzat jikkonnettja mas-server, il-komponent Mediation Controller jirrapporta lill-komponent Edge Gateway l-aċċess mhux awtorizzat għal dak l-utent.
10. Il-komponent Edge Gateway jgħaddi l-informazzjoni lill-aġent tar-reġistrazzjoni, li jiskonnettja s-sessjoni tal-utent.

### Ċwievet tar-reġistru

Irrispettivament minn kif ikun installat, l-aġent tar-reġistrazzjoni għandu l-komponenti kollha meħtieġa għall-modalitajiet kollha tat-tħaddim previsti tiegħu. Għalhekk, sabiex jaħdem fil-modalità tal-aċċess dirett, jaqra ċ-ċwievet tar-reġistru li ġejjin biex jiddetermina l-konfigurazzjoni tiegħu:

```
1
2
3
4
```

**`MachineName`**

L-isem taċ-ċertifikat li l-aġent tar-reġistrazzjoni se juża biex jikkonnettja mas-servizz tar-reġistrazzjoni ta’ komponent Edge Gateway. B’mod default, u jekk ma jkunx definit, l-aġent jipprova juża ċertifikat bl-isem tal-kompjuter.

**`LogOffOnFailure`**

Indikazzjoni tal-imġiba tal-aġent meta ma jkunx jista’ jikkonnettja ma’ komponent Edge Gateway jew jekk l-utent ma jkunx awtorizzat jikkonnettja mal-kompjuter. Bil-valur `0`, ma sseħħ l-ebda skonnessjoni, filwaqt li bil-valur `1` l-utent jiġi skonnettjat (imġiba default).

**`RecordedSessions`**

Definizzjoni tat-tipi ta’ sessjonijiet soġġetti għar-reġistrazzjoni:

- `none` : ma ssir l-ebda reġistrazzjoni tal-aċċess dirett (setting default).
- `remote` : kull aċċess RDP għall-kompjuter iniedi reġistrazzjoni.
- `all` : l-aċċess RDP u l-aċċess mill-konsol (aċċess fiżiku għall-kompjuter jew mill-modalità tal-konsol tal-ipervisur) iniedu r-reġistrazzjoni.

> **Liema valuri taċ-ċwievet huma meħtieġa għall-aċċess dirett?**
>
> L-uniku valur taċ-ċavetta meħtieġ biex jiġi attivat il-mekkaniżmu tal-aċċess dirett huwa `RecordedSessions` bil-valur `remote` jew `all`. Innota li skont l-ambjent, jista’ jkun meħtieġ ukoll il-valur taċ-ċavetta `MachineName`.

### Ċertifikat tal-kompjuter

L-aġent tar-reġistrazzjoni se jipprova juża ċertifikat għall-awtentikazzjoni mas-servizz tar-reġistrazzjoni. Dan iċ-ċertifikat irid ikun ġie installat fiċ-ċertifikati personali tal-kompjuter.

L-aġent se juża ċ-ċertifikat li l-isem tiegħu jikkorrispondi għall-valur taċ-ċavetta `MachineName` (ara l-[kapitolu ta’ qabel](#registry-keys)) u jekk dan ma jkunx definit, jipprova juża ċertifikat bl-isem tal-kompjuter.

### Dikjarazzjoni tal-komponenti Edge Gateway li l-aġent jista’ jikkuntattja

L-aġent tar-reġistrazzjoni juża informazzjoni lokali biex jiddetermina l-lista tas-servers Edge Gateway li għandu jikkuntattja sabiex itella’ r-reġistrazzjonijiet tas-sessjonijiet tal-utenti.

Biex timmodifika l-lista tas-servers Edge Gateway li jistgħu jiġu kkuntattjati, l-ewwel trid twaqqaf is-servizz `CleanroomAgent`.

> **Twissija!**
>
> Il-waqfien tas-servizz `CleanroomAgent` iwassal biex tintemm ir-reġistrazzjoni tas-sessjonijiet attwali fuq is-server, u kull sessjoni ġdida miftuħa fuq is-server ma tiġix irreġistrata.

Is-servizz jista’ jitwaqqaf permezz ta’ PowerShell (huma meħtieġa d-drittijiet tal-amministratur):

```
1
```

Wara li twaqqaf is-servizz, immodifika jew oħloq il-fajl `[RECORDING_AGENT_DIR]\gateways.xml` li ġej, fejn `[RECORDING_AGENT_DIR]` huwa l-folder tal-installazzjoni tal-aġent tar-reġistrazzjoni. Bil-folder tal-installazzjoni default, il-fajl irid ikun preżenti jew jinħoloq f’dan il-post:

- CyberElements Bastion: `C:\Program Files (x86)\Systancia\Safe\gateways.xml`

Dan il-fajl XML jikkonsisti f’tikketta `gateways` u f’daqstant tikketti `element` daqs kemm hemm komponenti Edge Gateway li jistgħu jiġu kkuntattjati.

> **Eżempju**
>
> Jekk l-aġent tar-reġistrazzjoni jkollu bżonn jikkuntattja komponent Edge Gateway bl-FQDN `edge-gateway-1.domain.local`, il-fajl XML ikun kif ġej:
>
> ```
> 1
> 2
> 3
> 4
> ```
>
> Iżda jekk ikun hemm żewġ komponenti Edge Gateway x’jikkuntattja, `edge-gateway-1.domain.local` u `edge-gateway-2.domain.local`, il-fajl ikun kif ġej:
>
> ```
> 1
> 2
> 3
> 4
> 5
> ```

Wara li timmodifika l-fajl `gateways.xml` b’mod korrett, erġa’ ibda s-servizz `CleanroomAgent`:

```
1
```

## Konfigurazzjoni tas-servizz tar-reġistrazzjoni biex jawtentika ċ-ċertifikati minn PKI ta’ parti terza

B’mod default, is-servizz tar-reġistrazzjoni jqis validi biss iċ-ċertifikati maħruġa mill-PKI ta’ Systancia. Sabiex tuża ċertifikati minn awtorità taċ-ċertifikazzjoni (CA) oħra, trid issegwi l-passi deskritti fi [Żieda ta’ CA mal-folder speċifiku tal-komponent Edge Gateway](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/EdgeGateway/AddANewTrustedCertificationAuthority/#add-to-the-edge-gateway-specific-directory).

Ladarba ċ-ċertifikati CA jkunu fil-post it-tajjeb, ma jibqa’ xejn ħlief li terġa’ tibda s-servizz tar-reġistrazzjoni, għal darb’oħra bħala superutent `root`:

> **Twissija!**
>
> Il-bidu mill-ġdid ta’ dan is-servizz iwaqqaf is-sessjonijiet attwali u jtemm kważi kollha. Eżegwixxi l-kmand li ġej biss meta ebda sessjoni tal-utenti ma tkun għaddejja mill-komponent Edge Gateway, sabiex ma jkunx hemm impatt fuq l-utenti.

```
1
```

Wara li terġa’ tibda s-servizz tar-reġistrazzjoni, tista’ tiċċekkja li l-awtoritajiet taċ-ċertifikazzjoni (CA) l-ġodda ġew ikkunsidrati b’mod korrett billi tikkonsulta r-reġistri tas-servizz:

```
1
```

Ir-reġistri miksuba jindikaw fit-tarf tal-linja l-ismijiet tal-fajls taċ-ċertifikati li ġew mgħobbija mis-servizz tar-reġistrazzjoni.

> **Eżempju**
>
> Wara ż-żieda ta’ żewġ awtoritajiet taċ-ċertifikazzjoni bl-ismijiet `MY-CA-ROOT.pem` u `MY-INTERMEDIATE-CA.pem`, ir-reġistri miksuba jidhru hekk (il-bidu tar-reġistru ġie maqtugħ iżda fih, fost affarijiet oħra, id-data u l-isem tal-kompjuter):
>
> ```
> 1
> 2
> 3
> 4
> ```
