> Source: https://docs.cyberelements.io/bastion/4.6/mt/HowTo/InstallationAndUsageOfWindowsRecordingAgent/

# Installazzjoni u użu tal-aġent tar-reġistrazzjoni għal Windows

- Installazzjoni

  ---

  Installazzjoni u skjerament tal-aġent tar-reġistrazzjoni għal Windows.

  [→ Installa](https://docs.cyberelements.io/bastion/4.6/mt/Installation/ClientAndAgent/AgentWindowsInstallation/)
- Konfigurazzjoni

  ---

  Ikkonfigura l-aġent tar-reġistrazzjoni għal Windows biex jaħdem mal-applikazzjonijiet RDP u HTML5 RDP u/jew mal-aċċess dirett.

  [→ Ikkonfigura](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

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.

## Użu tal-aġent tar-reġistrazzjoni mal-applikazzjonijiet RDP u HTML5 RDP

### Attivazzjoni tal-użu tal-aġent tar-reġistrazzjoni

Jekk l-aġent tar-reġistrazzjoni huwa installat u kkonfigurat b’mod korrett, l-attivazzjoni tal-użu tal-aġent issir fil-livell tal-applikazzjoni RDP jew HTML5 RDP ikkonċernata:

**RDP**

> ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_Applications_RecordingAgentConfiguration-RDP.png)

**HTML5 RDP**

> ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_Applications_RecordingAgentConfiguration-HTML5RDP.png)

Tliet parametri huma involuti fil-mekkaniżmu:

**`Without agent mode`**

Din l-opzjoni trid tibqa’ mhux immarkata biex l-aġent tar-reġistrazzjoni jaħdem.

**`Disconnect session if the recorder is not working`**

Dan jattiva jew jiddiżattiva miżura ta’ sigurtà meta r-reġistrazzjoni tas-sessjoni tfalli għal diversi raġunijiet. Jekk ir-reġistrazzjoni ma tistax issir, is-sessjoni RDP jew HTML5 RDP tal-utent tintemm. Nirrakkomandaw li tattiva dan is-setting biex tevita konnessjonijiet tal-utenti mingħajr reġistrazzjoni (pereżempju, f’każ ta’ ħsara fl-aġent tar-reġistrazzjoni).

**`Time before disconnection`**

Jekk l-opzjoni ta’ qabel hija attivata, din l-opzjoni tħallik tissettja l-ħin f’sekondi qabel ma ssir l-iskonnessjoni. Is-setting default huwa 30 sekonda, iżda jista’ jitnaqqas biex tiżdied ir-reattività jew jiżdied jekk, pereżempju, is-sessjonijiet tal-utenti huma magħrufa li huma twal.

### Illimita l-moviment laterali

Il-limitazzjoni tal-moviment laterali hija funzjonalità li tirrestrinġi l-konnessjonijiet tan-netwerk għas-sessjoni tal-utent. Din il-funzjonalità timblokka t-traffiku TCP/UDP kollu fi ħdan is-sessjoni tal-utent b’mod default, iżda l-amministraturi jistgħu jiftħu diversi flussi ta’ aċċess.

Ir-restrizzjonijiet jiġu kkonfigurati f’`access policy` u għalhekk jistgħu jvarjaw skont l-utent u jkollhom settings differenti għal utent wieħed (billi jiġu mmultiplikati l-politiki ta’ aċċess assenjati lilu). Utent b’diversi politiki ta’ aċċess għall-istess applikazzjoni jara restrizzjonijiet tan-netwerk ibbażati fuq l-aċċess l-aktar permissiv.

Ladarba applikazzjoni RDP jew HTML5 RDP b’aġent tiġi awtorizzata f’politika ta’ aċċess, it-tab `Network connections` issir disponibbli. Minn hemm, tista’ tattiva l-filtrar u tispeċifika n-netwerks awtorizzati għall-utent: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_AccessPolicies_NetworkConnections.png)

> **Informazzjoni**
>
> Kwalunkwe bidla f’dawn is-settings tiġi applikata għall-utenti biss meta jerġgħu jużaw l-applikazzjoni RDP jew HTML5 RDP ikkonċernata.

## Ikkonfigura r-reġistrazzjonijiet tal-aċċess dirett b’aġent

### Iddikjara s-servers ippreparati għall-aċċess dirett b’aġent

Biex tiddikjara server li jrid jaħdem fil-modalità ta’ aċċess dirett b’aġent, l-ewwel trid tiftaħ il-modulu `Machines management`:

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_DirectAccessSelection.png)

Imbagħad ikklikkja l-buttuna  biex iżżid server ġdid. Tidher tieqa ġdida biex tikkonfigura s-server il-ġdid: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MachinesManagement_AddMachine.png)

**`Name`**

Isem il-kompjuter kif jidher fil-konsol ta’ CyberElements Bastion.

**`Notification text`**

Il-messaġġ tan-notifika li l-utenti jirċievu meta jikkonnettjaw mas-server.

**`Record sessions as videos`**

Jattiva jew jiddiżattiva r-reġistrazzjoni bil-vidjo tas-sessjoni. Jekk tkun iddiżattivata, jinqabdu u jiġu rreġistrati biss l-avvenimenti tas-sessjoni.

**`Check video integrity at playback`**

Meta jinħoloq l-arkivju tal-vidjo, jiġi kkalkulat u maħżun hash (SHA-256) tal-fajl tal-vidjo. Meta l-amministraturi jaraw l-arkivju, jiġi ċċekkjat li l-hash ma ġiex modifikat. Jekk ikun ġie modifikat, jintbagħat messaġġ ta’ allarm lill-amministratur, peress li x’aktarx ikun hemm bidliet fir-reġistrazzjoni tal-vidjo (eż. sekwenzi sostitwiti jew maqtugħa).

**`Allow manual removal of archives`**

Ippermetti jew iċħad lill-amministraturi l-possibbiltà li jħassru l-arkivji tal-vidjo.

> **Informazzjoni**
>
> L-arkivji ġġenerati jżommu s-settings li kienu fis-seħħ fil-ħin tar-reġistrazzjoni. Il-bdil ta’ dan is-setting jaffettwa biss l-arkivji l-ġodda.

**`Delete archives automatically`**

Konfigurazzjoni tat-tħassir awtomatiku tal-arkivji wara li jinqabeż għadd speċifiku ta’ jiem.

> **Informazzjoni**
>
> L-arkivji ġġenerati jżommu s-settings li kienu fis-seħħ fil-ħin tar-reġistrazzjoni. Il-bdil ta’ dan is-setting jaffettwa biss l-arkivji l-ġodda.

**`Use agent mode`**

Opzjoni li trid tkun attivata biex is-server ikollu l-mekkaniżmu tal-aċċess dirett b’aġent attiv.

**`Host (CN of the certificate)`**

Indikazzjoni tal-attribut CN taċ-ċertifikat użat mill-aġent tar-reġistrazzjoni biex jawtentika ruħu mal-komponent Edge Gateway. Dan jikkorrispondi għall-[konfigurazzjoni taċ-ċertifikat tal-kompjuter](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#machine-certificate).

**`Use no agent`**

Jekk parametru mhuwiex utli għall-modalità ta’ tħaddim mixtieqa, jista’ jitħalla mhux immarkat.

### Konfigurazzjoni tad-drittijiet tal-aċċess dirett b’aġent

Il-konfigurazzjoni tad-drittijiet tal-aċċess dirett b’aġent hija simili għall-konfigurazzjoni tal-politiki ta’ aċċess għall-applikazzjonijiet. Drittijiet ġodda jiġu ddikjarati u drittijiet eżistenti jiġu modifikati permezz ta’ `Direct recording configuration`:

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/CLR_AdminConsole_DirectrecordingConfigurationsSelection.png)

Tista’ żżid konfigurazzjoni ġdida billi tikklikkja l-buttuna .

It-tabs tas-settings differenti huma simili għal dawk tal-politiki ta’ aċċess għall-applikazzjonijiet, ħlief għat-tab tal-gruppi, li tħallik iżżid grupp manwalment: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DirectRecordingConfigurations_GroupsPanel%2BManualEntrySelection.png)

Wara li tikklikkja l-buttuna taż-żieda manwali, tidher tieqa ġdida biex tindika l-isem tal-grupp u d-dominju tiegħu: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DirectRecordingConfigurations_AdditionOfACustomGroup.png)

> **Parir**
>
> Din il-funzjonalità hija utli b’mod partikolari jekk trid iżżid grupp lokali jew grupp f’OU differenti minn dik issettjata fil-konfigurazzjonijiet tad-dominju LDAP.

It-tabs l-oħra huma:

- `Sites`: tqiegħed il-konfigurazzjoni fuq sit wieħed jew aktar, u b’estensjoni, tippermetti lill-aġent tar-reġistrazzjoni jikkonnettja ma’ komponent Edge Gateway wieħed jew aktar marbut mas-siti awtorizzati.
- `Machines`: iżżid is-servers RDP iddikjarati [fil-kapitolu ta’ qabel](#declare-servers-prepared-for-direct-access-with-agent).
- `Alerts`: torbot allarmi mal-konfigurazzjoni.
- `Network connections`: tillimita l-movimenti laterali tal-utenti matul is-sessjonijiet tagħhom, b’funzjonalità identika għal dik tal-[limitazzjoni tal-moviment laterali tal-applikazzjonijiet RDP u HTML5 RDP](#limit-lateral-movement).

## Reġistri tal-aġent tar-reġistrazzjoni

### Attivazzjoni tar-reġistri tal-aġent tar-reġistrazzjoni

> **Twissija!**
>
> L-attivazzjoni tar-reġistri teħtieġ li jerġa’ jinbeda s-servizz tal-aġent tar-reġistrazzjoni, u dan iwaqqaf kwalunkwe reġistrazzjoni tas-sessjoni li tkun għaddejja fuq is-server.
> Skont is-settings taċ-ċavetta `LogOffOnFailure`, l-utent jew jiġi skonnettjat jew jibqa’ kkonnettjat.

Biex tattiva r-reġistri tal-aġent tar-reġistrazzjoni, trid twettaq il-passi li ġejjin:

1. Oħloq direttorju bl-isem `Log` fid-direttorju tal-installazzjoni tal-aġent (b’mod default, dan huwa `C:\Program Files (x86)\Systancia\Safe`).
2. Erġa’ ibda s-servizz `CleanroomAgent`, pereżempju bil-kmand PowerShell li ġej, imħaddem bħala amministratur:

   ```
   1
   ```

Kull darba li jinbeda s-servizz tal-aġent tar-reġistrazzjoni, jiġi ġġenerat fajl tar-reġistru ġdid fid-direttorju `Log` maħluq fil-pass 1.

### Kontenut tar-reġistri tal-aġent tar-reġistrazzjoni

Ir-reġistri ġġenerati mill-aġent tar-reġistrazzjoni jidhru hekk:

```
 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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
```

> **Inizjalizzazzjoni tal-aġent tar-reġistrazzjoni (linji 1-21)**
>
> Meta l-aġent tar-reġistrazzjoni jiġi inizjalizzat (linji 1-18), jinkitbu fir-reġistru diversi informazzjonijiet dwar is-sistema.
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> ```
>
> Il-linja 19 tispeċifika l-għadd ta’ komponenti Edge Gateway misjuba fil-fajl `gateways.xml` għat-tħaddim [fil-modalità diretta](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#declaration-of-edge-gateways-that-the-agent-can-contact).
>
> ```
> 19
> ```
>
> Il-linja 20 tindika problema fit-tagħbija ta’ ċwievet f’direttorju li ma jeżistix. Din hija funzjoni antika li ma taffettwax it-tħaddim ġenerali tal-aġent. Għalhekk dan ir-reġistru tal-iżball jista’ jiġi injorat.
>
> ```
> 20
> ```
>
> Il-linja 21 tispeċifika l-azzjoni tal-ikkupjar tal-eżekutibbli `CareInit.exe` f’`System32` sabiex jiġu koperti l-każijiet fejn applikazzjoni RDP b’aġent titnieda minn kompjuter macOS jew Ubuntu.
> F’din il-kundizzjoni, il-konnessjoni mas-server titlob li `CareInit.exe` jitħaddem bħala programm tal-bidu.
>
> ```
> 21
> ```

> **Konnessjoni ta’ applikazzjoni HTML5 RDP jew RDP b’aġent (linji 22-39)**
>
> Meta tinstab sessjoni RDP ġdida, jinkitbu r-reġistri li ġejjin biex jindikaw l-identifikazzjoni ta’ sessjoni RDP ġdida u jniżżlu l-isem tal-utent li daħal:
>
> ```
> 22
> 23
> 24
> 25
> ```
>
> Fir-reġistri ta’ hawn fuq, huwa l-utent `cyberelements_user` li kkonnettja permezz ta’ RDP.
>
> Meta titnieda applikazzjoni HTML5 RDP jew RDP b’aġent, jinħoloq kanal virtwali RDP speċifiku sabiex jintbagħtu lill-aġent tar-reġistrazzjoni l-indirizz tal-konnessjoni tal-komponent Edge Gateway u l-password unika għall-konnessjoni mas-servizz tar-reġistrazzjoni tal-komponent Edge Gateway.
> Dan jindika żewġ affarijiet:
>
> 1. L-aġent tar-reġistrazzjoni skopra li din hija konnessjoni RDP mibdija minn CyberElements Bastion, u għalhekk m’għandux jittratta s-sessjoni bħala aċċess dirett.
> 2. L-aġent tar-reġistrazzjoni rnexxielu jikseb l-indirizz tal-komponent Edge Gateway li lilu jrid jibgħat ir-reġistrazzjonijiet tal-vidjo u l-avvenimenti.
>
> Din l-informazzjoni kienet tikkorrispondi għal-linji 27-29, fejn fl-eżempju l-aġent tar-reġistrazzjoni kiseb l-indirizz tal-konnessjoni għall-komponent Edge Gateway (`my-edge-gateway.domain.local`) u password għal darba waħda (`K5efPBwVM2cIU0LaYQucZp0FV19nRIE5f5VYoBZz6EqlZOxNGM`):
>
> ```
> 29
> 30
> 31
> ```
>
> Imbagħad jiġu r-reġistri dwar l-applikazzjoni tar-regoli tal-filtrar tan-netwerk, li huma dettaljati fi blokk ta’ informazzjoni ieħor iktar ’l isfel fil-paġna.
>
> Daħla tar-reġistru tispeċifika meta l-aġent tar-reġistrazzjoni jibda l-konnessjoni mal-komponent Edge Gateway u liema password unika juża biex jawtentika ruħu.
>
> ```
> 35
> ```
>
> Fl-aħħar, meta l-utent jibda skonnessjoni, din tinqabad mill-aġent tar-reġistrazzjoni sabiex tintemm ir-reġistrazzjoni u jitneħħew ir-regoli tal-filtrar tan-netwerk, jekk ikun hemm. Dan jikkorrispondi għal-linji 36-39 tal-fajl tar-reġistru tal-eżempju:
>
> ```
> 36
> 37
> 38
> 39
> ```

> **Konnessjoni ta’ aċċess dirett RDP (linji 40-61)**
>
> Meta tinstab sessjoni RDP ġdida, jinkitbu r-reġistri li ġejjin biex jindikaw l-identifikazzjoni ta’ sessjoni RDP ġdida u jniżżlu l-isem tal-utent li daħal:
>
> ```
> 40
> 41
> 42
> 43
> ```
>
> Fir-reġistri ta’ hawn fuq, huwa l-utent `cyberelements_user` li kkonnettja permezz ta’ RDP.
>
> Waqt konnessjoni RDP diretta, il-kanal virtwali RDP speċifiku għat-tħaddim tal-applikazzjonijiet RDP jew HTML5 RDP b’aġent ma jintużax. Għalhekk l-aġent tar-reġistrazzjoni jikkonkludi li s-sessjoni miftuħa hija sessjoni ta’ aċċess dirett.
>
> ```
> 44
> ```
>
> Minħabba li nstab aċċess dirett, l-aġent tar-reġistrazzjoni jniżżel fir-reġistru l-gruppi differenti tal-utent li għadu kif ikkonnettja:
>
> ```
> 46
> ```
>
> > **Parir**
> >
> > B’din l-informazzjoni, tista’ tiddetermina r-raġunijiet għaliex ir-reġistrazzjonijiet tal-aċċess dirett ma jiġux skattati: jekk [il-kuntratt tal-aċċess dirett](#configuring-direct-access-rights-with-an-agent) ma jawtorizzax wieħed mill-gruppi tal-utent, jew jekk l-isem tad-dominju speċifikat għandux ikun l-isem qasir (isem netBIOS) jew l-isem sħiħ.
>
> L-aġent tar-reġistrazzjoni jispeċifika ma’ liema komponenti Edge Gateway se jkun jista’ jikkonnettja biex itella’ r-reġistrazzjoni tas-sessjoni tal-utent.
> Bħala tfakkira, dawn huma l-komponenti Edge Gateway li huma parti mill-fajl `gateways.xml` ikkonfigurat matul [il-konfigurazzjoni tal-aġent tar-reġistrazzjoni](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#declaration-of-edge-gateways-that-the-agent-can-contact).
>
> ```
> 47
> ```
>
> Imbagħad jiġi ċ-ċertifikat tal-klijent li l-aġent tar-reġistrazzjoni juża biex jawtentika ruħu mas-servizz tar-reġistrazzjoni.
> B’mod default, l-aġent tar-reġistrazzjoni jfittex ċertifikat li fl-attribut CN tiegħu jkun fih l-isem tas-server RDP, sakemm ma tkunx ġiet iddefinita ċ-ċavetta `MachineName`.
> Imbagħad l-aġent tar-reġistrazzjoni jispeċifika ċ-ċertifikat magħżul u l-informazzjoni dwar l-awtorità taċ-ċertifikazzjoni li ġġenerah.
>
> ```
> 48
> 49
> 50
> 51
> ```
>
> Fl-eżempju ta’ hawn fuq, l-aġent tar-reġistrazzjoni fittex ċertifikat li fih `my-rds-server` u sab wieħed bl-attribut CN `my-rds-server.domain.local` maħruġ mill-awtorità taċ-ċertifikazzjoni `SUB-CA`.
>
> Imbagħad jiġu r-reġistri dwar l-applikazzjoni tar-regoli tal-filtrar tan-netwerk, li huma dettaljati fi blokk ta’ informazzjoni ieħor iktar ’l isfel fil-paġna.
>
> Daħla tar-reġistru tispeċifika meta l-aġent tar-reġistrazzjoni jibda l-konnessjoni mal-komponent Edge Gateway u liema password unika juża biex jawtentika ruħu.
>
> ```
> 57
> ```
>
> Fl-aħħar, meta l-utent jibda skonnessjoni, din tinqabad mill-aġent tar-reġistrazzjoni sabiex tintemm ir-reġistrazzjoni u jitneħħew ir-regoli tal-filtrar tan-netwerk, jekk ikun hemm. Dan jikkorrispondi għal-linji 58-61 tal-fajl tar-reġistru tal-eżempju:
>
> ```
> 58
> 59
> 60
> 61
> ```

> **Applikazzjoni tar-regoli tal-filtrar tan-netwerk (linji 31 u 53-56)**
>
> Għal kull sessjoni identifikata mill-aġent tar-reġistrazzjoni, dan tal-aħħar jiddetermina jekk huwiex meħtieġ li jiġu applikati regoli tal-filtrar tan-netwerk għas-sessjoni tal-utent.
>
> Jekk ma jkunx meħtieġ li jiġu applikati regoli tal-filtrar tan-netwerk, l-aġent tar-reġistrazzjoni jindika `Filter not enabled`.
>
> ```
> 31
> ```
>
> Jekk ikun meħtieġ li jiġu applikati regoli tal-filtrar tan-netwerk, jidher il-messaġġ `Net filter enabled`.
> Wara din il-linja tal-attivazzjoni tal-filtru, jiġi indikat kull wieħed mill-filtri applikati, wieħed f’kull linja:
>
> ```
> 53
> 54
> 55
> 56
> ```
>
> Bħala tfakkira, meta l-filtrar tan-netwerk ikun attivat, l-imġiba default hija li jiġi mblukkat it-traffiku TCP/UDP kollu. Għalhekk, il-filtri indikati huma l-uniku traffiku TCP/UDP awtorizzat għall-programmi li jaħdmu fil-kuntest tal-utent.
> Fl-eżempju ta’ hawn fuq, il-konnessjonijiet lejn `TCP 10.10.1.42:443` u `UDP 10.10.20.1:53` huma ppermessi. Minbarra dawn iż-żewġ flussi awtorizzati mill-amministratur, il-fluss tal-konnessjoni mas-servizz tar-reġistrazzjoni huwa wkoll miftuħ biex ir-reġistrazzjoni tas-sessjoni tkun tista’ tintbagħat lura mill-programm responsabbli għaliha.
>
> > **Parir**
> >
> > Jekk l-ebda fluss ma jkun awtorizzat għall-utent, jintwerew biss il-linji li jindikaw li l-filtrar huwa attiv u li l-proċess tar-reġistrazzjoni jista’ jikkuntattja s-servizz tar-reġistrazzjoni tal-komponent Edge Gateway.

> **Il-konnessjoni mas-servizz tar-reġistrazzjoni falliet**
>
> Diversi problemi jistgħu jwasslu biex l-aġent tar-reġistrazzjoni ma jkunx jista’ jikkonnettja mas-servizz tar-reġistrazzjoni fuq komponent Edge Gateway.
>
> L-ewwel waħda hija blokk tal-fluss tan-netwerk. F’dan il-każ, meta l-aġent jipprova jikkonnettja mas-servizz tar-reġistrazzjoni, jikteb reġistri simili għal dawn:
>
> ```
> 1
> 2
> 3
> 4
> ```
>
> F’dan l-eżempju, il-linja 1 tindika li l-fluss ma setax jinbeda, filwaqt li l-linja 3 tispeċifika l-komponent Edge Gateway ikkonċernat u l-falliment tal-konnessjoni (innota wkoll in-numru `242` fl-aħħar tal-linja 3 għal dan it-tip ta’ problema).
>
> It-tieni problema li tista’ tiltaqa’ magħha hija l-inkapaċità tal-aġent tar-reġistrazzjoni, u b’estensjoni tas-server RDP, li jirrisolvi l-isem tal-komponent Edge Gateway:
>
> ```
> 1
> 2
> 3
> ```
>
> F’dan l-eżempju, il-linja 1 tikkonferma l-problema tar-riżoluzzjoni DNS tal-isem tal-komponent Edge Gateway.
> It-tieni linja tispeċifika l-falliment tal-konnessjoni u l-isem tal-komponent Edge Gateway. Innota li l-linja tispiċċa bin-numru `232` meta jkun hemm falliment fir-riżoluzzjoni DNS.
>
> It-tielet problema li tista’ sseħħ hija konnessjoni ma’ servizz li mhuwiex servizz tar-reġistrazzjoni, pereżempju, server tal-web li jisma’ fuq il-port `8443`. F’dan il-każ, jinkisbu r-reġistri li ġejjin:
>
> ```
> 1
> 2
> 3
> ```
>
> Il-linja 1 tindika difett fid-data skambjata, il-linja 2 tikkonferma l-problema tal-konnessjoni u tispeċifika l-iżball `140` fl-aħħar tal-linja.

> **L-ebda kuntratt ta’ aċċess dirett ma jippermetti li tiġi skattata r-reġistrazzjoni tas-sessjoni diretta.**
>
> Waqt l-aċċess dirett, mhux l-utenti kollha neċessarjament iridu jiġu rreġistrati. Jekk dan ikun il-każ, insibu r-reġistri li ġejjin:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> ```
>
> Ir-reġistri miksuba jibdew bħas-sessjonijiet diretti kollha maqbuda mill-aġent tar-reġistrazzjoni. Madankollu, ladarba tiġi stabbilita l-konnessjoni mas-servizz tar-reġistrazzjoni tal-komponent Edge Gateway, dan tal-aħħar jirritorna informazzjoni lill-aġent tar-reġistrazzjoni li tindika li l-utent li kkonnettja mhuwiex soġġett għar-reġistrazzjoni.
> Għalhekk l-aġent tar-reġistrazzjoni jindika li m’hemmx bżonn li tiġi rreġistrata s-sessjoni tal-utent (il-linja 14 tal-eżempju ta’ hawn fuq).
>
> Il-linja 7 telenka l-gruppi kollha miksuba mill-aġent tar-reġistrazzjoni għall-utent li kkonnettja.
> Din l-informazzjoni tħallik tiddetermina r-raġunijiet għaliex ir-reġistrazzjonijiet tal-aċċess dirett ma jiġux skattati: jekk [il-kuntratt tal-aċċess dirett](#configuring-direct-access-rights-with-an-agent) ma jawtorizzax wieħed mill-gruppi tal-utent, jew jekk l-isem tad-dominju speċifikat għandux ikun l-isem qasir (isem netBIOS) jew l-isem sħiħ.
