> Source: https://docs.cyberelements.io/bastion/4.6/et/Installation/ClientAndAgent/AgentWindowsInstallation/

# Windowsi salvestusagendi installimine

CyberElements Bastion kasutab Windowsi salvestusagenti, et lisada RDP-seanssidele uusi funktsioone:

- Võimalus filtreerida kasutajale juurdepääsetavaid TCP- ja UDP-vooge
- Võimalus käivitada seansi salvestamine iga kasutaja jaoks, kes loob ühenduse serveriga kasutajaportaali või Desktop-klienti läbimata (funktsioon `direct access`)

Lisaks jäädvustatakse kasutajaseansside ajal täiendavaid sündmusi:

- Akna avamine
- Akna sulgemine
- Programmi käivitamine
- Programmi sulgemine
- Lõikelaua sisu
- Kasutaja tegevus

## Eeltingimused

> **Kliendi ühilduvus**
>
> Teavet selle kohta, kas agent ühildub erinevate Microsoft Windowsi operatsioonisüsteemidega, leiate [ühilduvusmaatriksist](https://docs.cyberelements.io/bastion/4.6/et/CompatibilityMatrix/).

Salvestusagent vajab nõuetekohaseks toimimiseks mõningaid eeltingimusi. Mõned neist on mõeldud ainult agendipõhise salvestusfunktsiooni jaoks RDP- ja HTML5 RDP-rakendustes, teised aga puudutavad agendipõhist otsejuurdepääsu.

### Üldised eeltingimused

Salvestusagent saadab kasutaja seansi salvestise tagasi lahendusele CyberElements Bastion, luues ühenduse Edge Gateway komponendiga pordis `TCP 8443`. Selleks peab kahe arvuti vaheline võrguvoog olema avatud.

Salvestise turvaliseks saatmiseks Edge Gateway serverisse loob salvestusagent sellega TLS-i abil turvalise ühenduse. TLS tugineb sertifikaatide kasutamisele ja selleks, et ühendust peetaks usaldusväärseks ja turvaliseks, peavad olema täidetud järgmised tingimused:

- Serveri, antud juhul Edge Gateway serveri, sertifikaat ei tohi olla aegunud (maksimaalne kehtivuskuupäev).
- Serveri, antud juhul Edge Gateway serveri, sertifikaadi peab olema väljastanud sertifitseerimisasutus, mida arvuti, kuhu salvestusagent on installitud, peab usaldusväärseks.

  > **Lisateave**
  >
  > Serveri, kuhu salvestusagent on installitud, usaldusväärsete sertifitseerimisasutuste kohalikus salves peab olema vähemalt salvestusserveri sertifikaadi juursertifitseerimisasutus (CA).
  >
  > Seetõttu tuleb:
  >
  > 1. Hankida Edge Gateway serveris asuva salvestusteenuse sertifikaadi juur-CA.
  > 2. Laadida see CA üles serverisse, kuhu salvestusagent on installitud.
  > 3. Installida CA kohaliku arvuti sertifikaadisalve „Trusted Root Certification Authorities“.
  >
  > > **Näide PowerShelliga**
  > >
  > > Saate `.cer`-vormingus sertifikaadi hõlpsalt PowerShelli kaudu importida.
  > > Selleks avage PowerShelli terminal arvuti administraatorina ja käivitage järgmine käsk:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Asendage `<PATH_TO_CERT>` sertifikaadifaili teega.
  >
  > > **Näide PowerShelliga Systancia sertifikaadi jaoks ilma faile saatmata**
  > >
  > > Selles näites installitakse Systancia juur-CA, mida kasutavad lahenduse CyberElements Bastion kliendid, kes kasutavad Systancia pakutud sertifikaate.
  > >
  > > Samuti on võimalik sertifikaat importida, ilma et peaks faili saatma/alla laadima arvutisse, kuhu salvestusagent on installitud.
  > > Selleks avage PowerShelli terminal arvuti administraatorina ja käivitage järgmised käsud:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > Selle meetodi kasutamiseks mõne muu CA-ga muutke muutuja `base64Cert` väärtuseks enda valitud base64-kodeeringus sertifikaat.
- Serveri, antud juhul Edge Gateway serveri, sertifikaat ei tohi olla tühistatud.
- Arvuti, kuhu salvestusagent on installitud, peab saama serveriga, antud juhul Edge Gateway serveriga, ühendust võtta DNS-nime või IP-aadressi kaudu, mida serveri sertifikaat hõlmab oma välja Common Name (CN) kaudu.

### Agendiga RDP-rakenduste erieeltingimused macOS-i või Ubuntu kasutajatööjaamas

> **Hoiatus**
>
> Järgmised eeltingimused on vajalikud ainult siis, kui kasutaja käivitab agendiga RDP-rakenduse ja tema tööjaam ei ole Windows (macOS või Ubuntu).
>
> Kui lahenduse CyberElements Bastion kasutajate tööjaamades töötab ainult Windows või kui nad muul juhul kasutavad ainult HTML5 RDP-rakendusi, võib järgmised eeltingimused vahele jätta.

Sihtserveris, kuhu salvestusagent on juurutatud, on nõutavad järgmised registrivõtmed.

Esiteks lülitab esimene võti välja lubatud käivitusprogrammide loendi ([Microsofti dokument](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Vaikimisi lubab Windowsi arvuti käivitusprogrammina ainult `explorer.exe`.

```
1
2
```

Kui arvuti ei ole RDS-server, on alati soovitatav rakendada järgmine registrivõti, et salvestusagent saaks käivitusprogrammina avaneda:

```
1
2
```

### Otsejuurdepääsu erinõuded

> **Otsejuurdepääsu funktsioon**
>
> Otsejuurdepääsu funktsioon võimaldab käivitada kasutaja seansi salvestamise RDP- või konsoolijuurdepääsu korral (füüsiline ühendus arvutiga või hüperviisori konsoolirežiimi kaudu), mis ei läbi otse lahendust CyberElements Bastion.
>
> Kui kasutajal on luba serverile juurde pääseda, salvestatakse tema seanss. Kui see nii ei ole, katkestatakse vaikimisi kasutaja ühendus.

Et salvestusagent saaks töötada otsejuurdepääsu režiimis, on vaja x509-sertifikaati. See sertifikaat peab vastama järgmistele nõuetele:

- Sertifikaat peab olema endiselt kehtiv (kehtivusaeg ei ole möödunud).
- Sertifikaat peab olema tüüpi (täiustatud võtmekasutuse väli) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Sertifikaat ei tohi olla tühistatud.
- [OpenSSL-i turbetasemest 2](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) tulenevad piirangud tähendavad, et:
    - Sertifikaadil peab RSA, DSA ja DH šifrite puhul olema vähemalt 2048-bitine privaatvõti; elliptiliste kõverate võtmete (ECC) puhul peavad need olema vähemalt 224-bitised.
    - Sertifikaadi allkiri ei tohi olla MD5 ega SHA-1 (eelistatud on SHA-512).
- Salvestusserver kasutab välja `Common Name` (CN) sertifikaadi ja seega ka selle arvuti tuvastamiseks, kus otsesalvestus käivitatakse. See väli peab olema täidetud.

## Ühekaupa käsitsi installimine

> **Vaja on administraatoriõigusi**
>
> Agendi installimiseks on vaja administraatoriõigusi.

Enne agendi installimist peate selle halduskonsoolist alla laadima:

1. Avage tööruum „Configurations“ vasakus ülanurgas asuva nupu abil: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Avage paan „Toolbox“ ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Valige esimesel vahekaardil „Integration Tools“ soovitud operatsioonisüsteemile sobiv installiprogramm ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Kui agent on alla laaditud, tehke järgmist:

1. Käivitage installiprogramm `setup_CleanroomAgent.exe` arvutis, kuhu soovite salvestusagendi installida.
2. Klõpsake esimeses aknas nuppu `Next`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Nõustuge kasutustingimustega: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. Muutke kolmandal kuval vajaduse korral agendi installikataloogi: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **Neljandal kuval kuvatakse agendi installisuvandid otsejuurdepääsu režiimis: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Agendi otsejuurdepääsu funktsiooni sisselülitamine.

   **`Recorded Sessions`**

   Vaba väli, mis aktsepteerib kolme erinevat väärtust, et määrata, millal otsejuurdepääsu salvestamine käivitatakse:

   **`Logoff On Failure`**

   Suvand, millega kasutaja seanss katkestatakse, kui salvestamist ei saa alustada, see katkeb või kasutaja pole autoriseeritud arvutiga ühendust looma.

   > **Soovitus**
   >
   > Esmaste installide korral või kui eeltingimuste täitmine pole kindel, on parem jätta see suvand märkimata. Vastasel juhul, kui eeltingimuste või sätetega on probleem, katkestavad uued ühendused serveriga kohe kasutaja ühenduse (olenevalt sätetest `Recorded Sessions`).

   > **Teave**
   >
   > Otsejuurdepääsu funktsiooni saab sisse lülitada ka pärast installimist. Selleks vaadake [agendi registrivõtmete sätteid](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: otsejuurdepääsu salvestamist ei tehta.
    - `remote`: iga RDP-juurdepääs arvutile käivitab salvestamise.
    - `all`: salvestamise käivitavad nii RDP-juurdepääs kui ka konsoolijuurdepääs (füüsiline juurdepääs arvutile või hüperviisori konsoolirežiimist).
6. Lõpuks, viiendal kuval, algab installimine pärast nupu `Install` klõpsamist: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

Pärast installimist vajab agent täiendavat konfigureerimist: [Konfigureerige agent](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Juurutamine halduskonsoolist

> **Vaja on administraatoriõigusi**
>
> Agendi installimiseks on vaja sihtarvutis administraatoriõigusi.

> **Täiendav eeltingimus**
>
> Agent juurutatakse sihtarvutisse protokolli `SMB` abil. Seetõttu peab `SMB`-andmevoog (TCP 445) olema Edge Gateway komponendi ja selle sihtserveri vahel avatud.

### Juurutamine ühte serverisse

Agenti saab halduskonsoolis üksikult juurutada kahest kohast. See võimaldab selle eelkonfigureerida kahte tüüpi toimimiseks:

1. Kasutamine RDP- ja HTML5 RDP-rakendustega: agent valmistatakse ette nii, et see saaks salvestada RDP- ja HTML5 RDP-rakendusi käitavate kasutajate seansse.
2. Kasutamine otsejuurdepääsu režiimis: agent valmistatakse ette nii, et see saaks lisaks eelnevale salvestada ka RDP-serveriga otse ühenduse loovate kasutajate seansse.

#### Kasutamiseks RDP- ja HTML5 RDP-rakendustega

Kui RDP- või HTML5 RDP-rakendus on konfigureeritud agendiga töötama, avab rakenduse valimine agendi juurutamise võimaluse: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Pärast agendi juurutamisnupu klõpsamist avaneb uus aken, mis küsib järgmist teavet: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

Sihtserveri IP-aadress või DNS-nimi, kuhu salvestusagent juurutatakse. Vaikimisi kasutab see väli RDP- või HTML5 RDP-rakenduses määratud serveri teavet.

**`Target drive`**

Windowsi draivi täht, kuhu agent juurutatakse. Tavaliselt on see täht `C`, millega agent juurutatakse draivile `C:\`.

**`Target directory`**

Agendi installikataloogi tee; kui kataloogi pole olemas, see luuakse. CyberElements Bastion agendi vaikeasukoht on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määrake Edge Gateway komponent, mida agendi juurutamiseks kasutada.

**`Domain`**

Domeeni nimi, kus asub agendi installimiseks kasutatav halduskonto.

**`Username`**

Agendi installimiseks kasutatava administraatorikonto nimi. See konto peab saama sihtserverisse programme installida.

**`Password`**

Administraatorikonto parool.

Kui kogu teave on sisestatud, saab agendi juurutamise käivitada. Viimane aken näitab, kas agendi juurutamine sihtserverisse õnnestus või mitte.

Vajalikud võivad olla veel täiendavad sätted. Vaadake järgmist peatükki: [Konfigureerige agent](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### Kasutamiseks otsejuurdepääsu režiimis + RDP- ja HTML5 RDP-rakendustega

Otsejuurdepääsu kuva jaotises **Machine management** on nupp, millega saab agendi juurutada: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Pärast agendi juurutamisnupu klõpsamist avaneb uus aken, mis küsib järgmist teavet: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

Sihtserveri IP-aadress või DNS-nimi, kuhu salvestusagent juurutatakse. Vaikimisi kasutab see väli RDP- või HTML5 RDP-rakenduses määratud serveri teavet.

**`Target drive`**

Windowsi draivi täht, kuhu agent juurutatakse. Tavaliselt on see täht `C`, millega agent juurutatakse draivile `C:\`.

**`Target directory`**

Agendi installikataloogi tee; kui kataloogi pole olemas, see luuakse. CyberElements Bastion agendi vaikeasukoht on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määrake Edge Gateway komponent, mida agendi juurutamiseks kasutada.

**`Domain`**

Domeeni nimi, kus asub agendi installimiseks kasutatav halduskonto.

**`Username`**

Agendi installimiseks kasutatava administraatorikonto nimi. See konto peab saama sihtserverisse programme installida.

**`Password`**

Administraatorikonto parool.

**`Sessions to record`**

Konteksti määratlus, milles seansi salvestamine toimub:

1. `Record remote sessions (RDS) only`: salvestatakse ainult RDP-kaugjuurdepääsud.
2. `Record all sessions`: salvestatakse RDP-kaugseansid ja konsoolirežiimi seansid (füüsiline juurdepääs arvutile või hüperviisori konsoolirežiimist).
3. `Record no sessions`: ükski otseühendus serveriga ei salvesta seansse, kuid agenti saab endiselt kasutada juurdepääsuks RDP- ja HTML5 RDP-rakenduste kaudu.

**`Use a different certificate than the target`**

Suvand, millega määratakse selle sertifikaadi nimi, mida agent kasutab Edge Gateway komponendiga autentimiseks. Kui seda pole määratud, otsib agent sertifikaati, mille nimi on serveri nimi.

**`Close the session if no gateway could be contacted`**

Suvand, millega kasutaja ühendus katkestatakse ja ta logitakse välja (olenevalt sätetest **Sessions to record**), kui Edge Gateway komponent pole kättesaadav või kui kasutaja pole autoriseeritud serveriga ühendust looma.

> **Soovitus**
>
> Esmaste installide korral või kui eeltingimuste täitmine pole kindel, on parem jätta see suvand märkimata. Vastasel juhul, kui eeltingimuste või sätetega on probleem, katkestavad uued ühendused serveriga kohe kasutaja ühenduse (olenevalt sätetest `Sessions to record`).

Kui kogu teave on sisestatud, saab agendi juurutamise käivitada. Viimane aken näitab, kas agendi juurutamine sihtserverisse õnnestus või mitte.

Vajalikud võivad olla veel täiendavad sätted. Vaadake järgmist peatükki: [Konfigureerige agent](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Juurutamine mitmesse serverisse

> **Teave**
>
> See meetod võimaldab juurutada salvestusagendi ainult töötamiseks RDP- ja HTML5 RDP-rakendustega. Selleks et agent töötaks otsejuurdepääsu režiimis, tuleb [konfiguratsioon](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) juurutada muul viisil (nt GPO kaudu).

> **Täiendav eeltingimus**
>
> Mitmesse serverisse juurutamine on võimalik ainult arvutites, mis kuuluvad AD-domeeni, mis on omakorda konfigureeritud CyberElements Bastion lahenduse jaotises `Authentication Domains` ja mille suvand `Allow RDS Server Management` on sisse lülitatud.

Lisage jaotisest `Management of RDS servers` üks või mitu uut RDS-serverit: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Otsige üles serverid, kuhu salvestusagent tuleb juurutada, ja lisage need, lohistades need parempoolsele paneelile. Valige suvand `Deploy an agent`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Konfigureerige agendi juurutamise teave: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Windowsi draivi täht, kuhu agent juurutatakse. Tavaliselt on see täht `C`, millega agent juurutatakse draivile `C:\`.

**`Target directory`**

Agendi installikataloogi tee; kui kataloogi pole olemas, see luuakse. CyberElements Bastion agendi vaikeasukoht on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määrake Edge Gateway komponent, mida agendi juurutamiseks kasutada.

**`Domain`**

Domeeni nimi, kus asub agendi installimiseks kasutatav halduskonto.

**`Username`**

Agendi installimiseks kasutatava administraatorikonto nimi. See konto peab saama sihtserverisse programme installida.

**`Password`**

Administraatorikonto parool.

Vajalikud võivad olla veel täiendavad sätted. Vaadake järgmist peatükki: [Konfigureerige agent](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
