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

# Windowsi salvestusagendi konfigureerimine

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.

## Konfiguratsioonid registrivõtmete kaudu

Mõned globaalsed sätted on saadaval registrivõtmetes, et mõjutada salvestusagendi tööd nii rakendustega kasutamisel kui ka otsejuurdepääsul.

```
1
2
3
```

**`DisconnectOnError`**

Määratleb salvestusagendi käitumise, kui seansi salvesti suletakse. Kui on määratud väärtus `0` (vaikekäitumine), suletakse salvesti sulgemisel kasutaja seanss. Kui on määratud väärtus `1`, katkestatakse salvesti sulgemisel kasutaja seansi ühendus.

**`SessionEndTimeout`**

Kasutaja seansi sulgemiseks antava aja (sekundites) määratlus enne seansi sunnitud sulgemist. Vaikimisi on selle parameetri väärtus 10 sekundit.

## Konfiguratsioon RDP- ja HTML5 RDP-rakendustega töötamiseks

Selles töörežiimis toimub andmevahetus Mediation Controller teenuse, Edge Gateway komponendi ja salvestusagendi vahel järgmiselt:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as RDP-server<br/>Salvestusagent

    MED->>+GW: RDP-serveri sisselogimisteabe <br/>saatmine koos salvestusagendi <br/>sisselogimisteabega
    GW->>AGENT: RDP-ühenduse lähtestamine
    GW->>-AGENT: Sisselogimisteabe saatmine <br/>Edge Gateway salvestusteenusele
    AGENT->>+GW: Ühendumine salvestusteenusega
    GW->>-AGENT: Võrgufiltreerimise teabe saatmine
    Note over AGENT: Võrgupiirangute <br/>rakendamine kasutajale
    loop Pidev seansi salvestamine
        AGENT->>+GW: Videosalvestise pidev saatmine <br/>+ seansi sündmused
        Note over GW: Videosalvestise pidev lisamine <br/>ajutise salvestuse kataloogi
        GW->>-MED: Vastuvõetud seansisündmuste saatmine
        Note over MED: Sündmuste salvestamine <br/>organisatsiooni andmebaasi
    end
    break Seansi lõpp
        AGENT->>GW: Teate saatmine, et <br/>kasutaja on oma RDP-seansi lõpetanud
        Note over GW: Videosalvestis teisaldatakse <br/>arhiivikataloogi
        GW->>MED: Teade kasutaja seansi lõpust
        Note over MED: Kasutaja seanss läheb <br/>otseülekandest arhiivi
    end
```

1. Mediation Controller teenus edastab Edge Gateway komponendile siht-RDP-serveri ühendusteabe. Samuti lisab see ühendusteabe, mis tal on salvestusteenusega ühenduse loomiseks (Edge Gateway komponendi FQDN).
2. Edge Gateway komponent algatab ühenduse RDP-serveriga.
3. Edge Gateway komponent saadab salvestusagendile oma salvestusteenuse ühendusteabe.
4. Salvestusagent algatab ühenduse salvestusteenusega.
5. Kui agent on ühendatud, tagastab salvestusteenus seansile rakendatavate võrguvoo piirangute loendi. Pärast selle saamist rakendab salvestusagent need kasutaja seansile.
6. Salvestusagent laadib kasutaja seansi videosalvestise ja kõik seansisündmused (nt klahvivajutused või programmide käivitamised) pidevalt ja reaalajas salvestusteenusesse üles. Salvestusteenus talletab videosalvestise ajutises kaustas.
7. Salvestusteenus teatab seansi eri sündmustest Mediation Controller teenusele, mis talletab need organisatsiooni andmebaasis.
8. Kui kasutaja RDP-seanss lõpeb, teatab salvestusagent sellest salvestusteenusele. Seejärel teisaldab salvestusteenus salvestatud video kasutajasalvestiste arhiivikausta.
9. Salvestusteenus teatab kasutaja seansi lõpust Mediation Controller teenusele. Seetõttu ei ole seanss enam nähtav mooduli Control Center vaates Live Streaming, vaid liigub vaatesse Archives.

Selle jada puhul on oluline, et salvestusagent saaks Edge Gateway komponendi salvestusteenuse õige ühendusteabe. See teave on Edge Gateway komponendi sätetes väljal `FQDN`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_Gateway_Edit.png)

Sisestage sellele väljale DNS-nimi, mida RDP-serverid suudavad lahendada.

> **Oluline**
>
> Salvestusteenusele `Careserver` määratud sertifikaat peab hõlmama väljal `FQDN` määratud nime. Vastasel korral peab salvestusagent ühendust ebaturvaliseks ega käivita seansi salvestamist.

## Konfiguratsioon otsejuurdepääsuga töötamiseks

Selles töörežiimis toimub andmevahetus Mediation Controller teenuse, Edge Gateway komponendi ja salvestusagendi vahel järgmiselt:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as RDP-server<br/>Salvestusagent

    Note over AGENT: Uue salvestatava <br/>seansi tuvastamine
    AGENT->>+GW: Ühendumine salvestusteenusega
    GW->>-MED: Teade uuest otsejuurdepääsuga <br/>ühendusest kasutajale X
    alt Kui kasutajal X on luba
        MED->>+GW: Teate saatmine, et kasutajal X <br/>on lubatud ühenduda, ja rakendatavate <br/>võrgufiltrite loendi saatmine
        GW->>-AGENT: Võrgufiltreerimise teabe <br/>ja ühendusloa saatmine <br/>kasutajale X
        Note over AGENT: Võrgupiirangute <br/>rakendamine kasutajale X
        loop Pidev seansi salvestamine
            AGENT->>+GW: Videosalvestise pidev saatmine <br/>+ seansi sündmused
            Note over GW: Videosalvestise pidev lisamine <br/>ajutise salvestuse kataloogi
            GW->>-MED: Vastuvõetud seansisündmuste saatmine
            Note over MED: Sündmuste salvestamine <br/>organisatsiooni andmebaasi
        end
        break Seansi lõpp
            AGENT->>GW: Teate saatmine, et <br/>kasutaja X on oma RDP-seansi lõpetanud
            Note over GW: Videosalvestis teisaldatakse <br/>arhiivikataloogi.
            GW->>MED: Teade kasutaja seansi lõpust
            Note over MED: Kasutaja seanss läheb <br/>otseülekandest arhiivi
        end
    else If user X is not authorized
        MED->>+GW: Teate saatmine, et kasutajal <br/>X ei ole lubatud sisse logida
        GW->>-AGENT: Teatis kasutaja X <br/>sisselogimise keelamise kohta
        Note over AGENT: Kasutaja X väljalogimine
    end
```

1. Salvestusagent tuvastab uue seansi ja algatab ühenduse mõne Edge Gateway komponendi salvestusteenusega.
2. Edge Gateway komponent saadab ühendusteabe (kasutajanimi ja salvestusagendi kasutatava sertifikaadi CN) Mediation Controller teenusele. Mediation Controller teenus vastab olenevalt juurdepääsuõiguste sätetest kahel erineval viisil.
3. Kui kasutajal on lubatud serveriga ühendust luua, teatab Mediation Controller teenus Edge Gateway komponendile selle kasutaja võimaliku juurdepääsu ja rakendatava võrgufiltrite loendi.
4. Edge Gateway komponent tagastab selle teabe salvestusagendile. Pärast selle saamist rakendab salvestusagent võrgufiltrid kasutaja seansile.
5. Salvestusagent laadib kasutaja seansi videosalvestise ja kõik seansisündmused (nt klahvivajutused või programmide käivitamised) pidevalt ja reaalajas salvestusteenusesse üles. Salvestusteenus talletab videosalvestise ajutises kaustas.
6. Salvestusteenus teatab seansi eri sündmustest Mediation Controller teenusele, mis talletab need organisatsiooni andmebaasis.
7. Kui kasutaja RDP-seanss lõpeb, teatab salvestusagent sellest salvestusteenusele. Seejärel teisaldab salvestusteenus salvestatud video kasutajasalvestiste arhiivikausta.
8. Salvestusteenus teatab kasutaja seansi lõpust Mediation Controller teenusele. Seetõttu ei ole seanss enam nähtav mooduli Control Center vaates Live Streaming, vaid liigub vaatesse Archives.
9. Kui kasutajal ei ole lubatud serveriga ühendust luua, teatab Mediation Controller teenus Edge Gateway komponendile selle kasutaja autoriseerimata juurdepääsust.
10. Edge Gateway komponent edastab teabe salvestusagendile, mis katkestab kasutaja seansi ühenduse.

### Registrivõtmed

Olenemata installimisviisist on salvestusagendil kõik komponendid, mida on vaja kõigi ette nähtud töörežiimide jaoks. Seetõttu loeb see otsejuurdepääsu režiimis töötamiseks oma konfiguratsiooni määramiseks järgmisi registrivõtmeid:

```
1
2
3
4
```

**`MachineName`**

Selle sertifikaadi nimi, mida salvestusagent kasutab mõne Edge Gateway komponendi salvestusteenusega ühenduse loomiseks. Vaikimisi ja kui see pole määratletud, proovib agent kasutada arvuti nimega sertifikaati.

**`LogOffOnFailure`**

Näitab agendi käitumist, kui see ei saa Edge Gateway komponendiga ühendust luua või kui kasutajal pole lubatud arvutiga ühendust luua. Väärtuse `0` korral ühendust ei katkestata, väärtuse `1` korral aga katkestatakse kasutaja ühendus (vaikekäitumine).

**`RecordedSessions`**

Salvestamisele kuuluvate seansitüüpide määratlus:

- `none` : otsejuurdepääsu salvestamist ei tehta (vaikesäte).
- `remote` : iga RDP-juurdepääs arvutile käivitab salvestamise.
- `all` : RDP-juurdepääs ja konsoolijuurdepääs (füüsiline juurdepääs arvutile või hüperviisori konsoolirežiimi kaudu) käivitavad salvestamise.

> **Milliseid võtmeväärtusi on otsejuurdepääsuks vaja?**
>
> Ainus võtmeväärtus, mida on vaja otsejuurdepääsu mehhanismi sisselülitamiseks, on `RecordedSessions` väärtusega `remote` või `all`. Pange tähele, et olenevalt keskkonnast võib olla vaja ka võtmeväärtust `MachineName`.

### Arvuti sertifikaat

Salvestusagent proovib salvestusteenusega autentimiseks kasutada sertifikaati. See sertifikaat peab olema installitud arvuti isiklike sertifikaatide hulka.

Agent kasutab sertifikaati, mille nimi vastab võtmeväärtusele `MachineName` (vt [eelmine peatükk](#registry-keys)), ja kui see pole määratletud, proovib see kasutada arvuti nimega sertifikaati.

### Nende Edge Gateway komponentide deklareerimine, millega agent saab ühendust võtta

Salvestusagent kasutab kohalikku teavet, et määrata nende Edge Gateway serverite loend, millega tuleb kasutaja seansisalvestiste üleslaadimiseks ühendust võtta.

Nende Edge Gateway serverite loendi muutmiseks, millega saab ühendust võtta, peate esmalt peatama teenuse `CleanroomAgent`.

> **Hoiatus!**
>
> Teenuse `CleanroomAgent` peatamine lõpetab serveris käimasolevate seansside salvestamise ja serveris avatavaid uusi seansse ei salvestata.

Teenuse saab peatada PowerShelli kaudu (vaja on administraatoriõigusi):

```
1
```

Pärast teenuse peatamist muutke või looge järgmine fail `[RECORDING_AGENT_DIR]\gateways.xml`, kus `[RECORDING_AGENT_DIR]` on salvestusagendi installikaust. Vaikimisi installikausta korral peab fail selles asukohas olemas olema või tuleb see sinna luua:

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

See XML-fail koosneb sildist `gateways` ja nii mitmest sildist `element`, kui on Edge Gateway komponente, millega saab ühendust võtta.

> **Näide**
>
> Kui salvestusagent peab võtma ühendust Edge Gateway komponendiga, mille FQDN on `edge-gateway-1.domain.local`, oleks XML-fail järgmine:
>
> ```
> 1
> 2
> 3
> 4
> ```
>
> Kui aga ühendust tuleks võtta kahe Edge Gateway komponendiga, `edge-gateway-1.domain.local` ja `edge-gateway-2.domain.local`, oleks fail järgmine:
>
> ```
> 1
> 2
> 3
> 4
> 5
> ```

Pärast faili `gateways.xml` õiget muutmist taaskäivitage teenus `CleanroomAgent`:

```
1
```

## Salvestusteenuse konfigureerimine kolmanda osapoole PKI sertifikaatide autentimiseks

Vaikimisi peab salvestusteenus kehtivaks ainult Systancia PKI väljastatud sertifikaate. Teise sertimisasutuse (CA) sertifikaatide kasutamiseks peate järgima peatüki [CA lisamine Edge Gateway komponendi enda kausta](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/EdgeGateway/AddANewTrustedCertificationAuthority/#add-to-the-edge-gateway-specific-directory) juhiseid.

Kui CA sertifikaat või sertifikaadid on õiges asukohas, jääb üle vaid salvestusteenus taaskäivitada, taas superkasutajana `root`:

> **Hoiatus!**
>
> Selle teenuse taaskäivitamine peatab käimasolevad seansid ja lõpetab peaaegu kõik neist. Käivitage järgmine käsk ainult siis, kui ükski kasutajaseanss ei läbi Edge Gateway komponenti, et kasutajaid mitte mõjutada.

```
1
```

Pärast salvestusteenuse taaskäivitamist saate teenuse logidest kontrollida, kas uued CA-d on õigesti arvesse võetud:

```
1
```

Saadud logid näitavad rea lõpus nende sertifikaadifailide nimesid, mille salvestusteenus on laadinud.

> **Näide**
>
> Pärast kahe CA lisamist nimedega `MY-CA-ROOT.pem` ja `MY-INTERMEDIATE-CA.pem` näevad saadud logid välja nii (logi algus on kärbitud, kuid see sisaldab muu hulgas kuupäeva ja arvuti nime):
>
> ```
> 1
> 2
> 3
> 4
> ```
