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

# Windows-tallennusagentin asennus

CyberElements Bastion käyttää Windows-tallennusagenttia lisätäkseen uusia toimintoja RDP-istuntoihin:

- Mahdollisuus suodattaa käyttäjän käytettävissä olevia TCP- ja UDP-tietovirtoja
- Mahdollisuus käynnistää istuntotallennus jokaiselle käyttäjälle, joka yhdistää palvelimeen kulkematta käyttäjäportaalin tai Desktop-asiakkaan kautta (ominaisuus `direct access`)

Lisäksi käyttäjäistuntojen aikana tallennetaan lisätapahtumia:

- Ikkunan avaaminen
- Ikkunan sulkeminen
- Ohjelman käynnistys
- Ohjelman sulkeminen
- Leikepöydän sisältö
- Käyttäjän toiminta

## Edellytykset

> **Asiakasohjelman yhteensopivuus**
>
> Saat selville, onko agentti yhteensopiva eri Microsoft Windows -käyttöjärjestelmien kanssa, katsomalla [yhteensopivuusmatriisia](https://docs.cyberelements.io/bastion/4.6/fi/CompatibilityMatrix/).

Tallennusagentti edellyttää muutamia edellytyksiä toimiakseen oikein. Osa niistä on tarkoitettu vain agenttiin perustuvaan tallennustoimintoon RDP- ja HTML5-RDP-sovelluksille, kun taas toiset koskevat agenttiin perustuvaa suoraa pääsyä.

### Yleiset edellytykset

Tallennusagentti lähettää käyttäjän istuntotallenteen takaisin CyberElements Bastion -järjestelmään muodostamalla yhteyden Edge Gateway -palvelimeen portissa `TCP 8443`. Tämä edellyttää, että verkkoliikenne näiden kahden koneen välillä on avattu.

Lähettääkseen tallenteen turvallisesti takaisin Edge Gateway -palvelimeen tallennusagentti muodostaa sen kanssa suojatun yhteyden TLS:n avulla. TLS perustuu sertifikaattien käyttöön, ja seuraavien ehtojen on toteututtava, jotta yhteyttä pidetään luotettavana ja turvallisena:

- Palvelimen, tässä tapauksessa Edge Gateway -palvelimen, sertifikaatti ei saa olla vanhentunut (enimmäisvoimassaolopäivä).
- Palvelimen, tässä tapauksessa Edge Gateway -palvelimen, sertifikaatin on oltava sellaisen varmentajan myöntämä, jota se kone, jolle tallennusagentti on asennettu, pitää luotettavana.

  > **Lisätietoja**
  >
  > Palvelimella, jolle tallennusagentti on asennettu, on oltava vähintään tallennuspalvelimen sertifikaatin juurivarmentaja (CA) paikallisessa luotettujen varmentajien säilössään.
  >
  > Siksi on tarpeen:
  >
  > 1. Hakea tallennuspalvelun sertifikaatin juuri-CA Edge Gateway -palvelimelta.
  > 2. Ladata tämä CA palvelimelle, jolle tallennusagentti on asennettu.
  > 3. Asentaa CA paikallisen koneen sertifikaattisäilöön ”Trusted Root Certification Authorities”.
  >
  > > **Esimerkki PowerShellillä**
  > >
  > > Voit tuoda `.cer`-muotoisen sertifikaatin helposti PowerShellin avulla.
  > > Avaa tätä varten PowerShell-pääte koneen järjestelmänvalvojana ja suorita seuraava komento:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Korvaa `<PATH_TO_CERT>` sertifikaattitiedoston polulla.
  >
  > > **Esimerkki PowerShellillä Systancian sertifikaatille ilman tiedostojen lähettämistä**
  > >
  > > Tässä esimerkissä asennetaan Systancian juuri-CA, jota käyttävät ne CyberElements Bastion -asiakasohjelmat, jotka käyttävät Systancian toimittamia sertifikaatteja.
  > >
  > > Sertifikaatti on myös mahdollista tuoda ilman, että tiedosto täytyy lähettää tai ladata sille koneelle, jolle tallennusagentti on asennettu.
  > > Avaa tätä varten PowerShell-pääte koneen järjestelmänvalvojana ja suorita seuraavat komennot:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > Jos haluat käyttää tätä menetelmää toisen CA:n kanssa, muuta muuttujan `base64Cert` arvo haluamaksesi base64-koodatuksi sertifikaatiksi.
- Palvelimen, tässä tapauksessa Edge Gateway -palvelimen, sertifikaattia ei saa olla peruutettu.
- Koneen, jolle tallennusagentti on asennettu, on voitava ottaa yhteys palvelimeen, tässä tapauksessa Edge Gateway -palvelimeen, DNS-nimellä tai IP-osoitteella, joka kuuluu palvelimen sertifikaatin Common Name (CN) -kentän kattamiin.

### Erityiset edellytykset agentin kanssa käytettäville RDP-sovelluksille, joita käytetään macOS- tai Ubuntu-työasemalla

> **Varoitus**
>
> Seuraavat edellytykset ovat tarpeen vain, jos käyttäjä käynnistää RDP-sovelluksen agentin kanssa ja hänen työasemansa ei ole Windows (macOS tai Ubuntu).
>
> Jos CyberElements Bastion -käyttäjillä on yksinomaan Windows-työasemat tai muussa tapauksessa he käyttävät yksinomaan HTML5-RDP-sovelluksia, seuraavat edellytykset voi ohittaa.

Seuraavat rekisteriavaimet vaaditaan kohdepalvelimella, jolle tallennusagentti on otettu käyttöön.

Ensin ensimmäinen avain poistaa käytöstä sallittujen käynnistysohjelmien luettelon ([Microsoftin asiakirja](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Oletuksena Windows-kone sallii käynnistysohjelmana vain `explorer.exe`-ohjelman.

```
1
2
```

Jos kone ei ole RDS-palvelin, seuraavan rekisteriavaimen käyttöä suositellaan aina, jotta tallennusagentti voi avautua käynnistysohjelmana:

```
1
2
```

### Suoran pääsyn erityisvaatimukset

> **Suoran pääsyn ominaisuus**
>
> Suoran käytön toiminto mahdollistaa käyttäjän istunnon tallennuksen käynnistämisen sellaisissa RDP- tai konsolikäytöissä (fyysinen yhteys koneeseen tai hypervisorin konsolitilan kautta), jotka eivät kulje suoraan CyberElements Bastion -järjestelmän kautta.
>
> Jos käyttäjällä on oikeus käyttää palvelinta, hänen istuntonsa tallennetaan. Jos näin ei ole, käyttäjän yhteys katkaistaan oletuksena.

Jotta tallennusagentti voi toimia suoran pääsyn tilassa, tarvitaan x509-sertifikaatti. Tämän sertifikaatin on täytettävä seuraavat vaatimukset:

- Sertifikaatin on oltava edelleen voimassa (voimassaoloaika ei ole päättynyt).
- Sertifikaatin tyypin (laajennetun avaimen käytön kenttä) on oltava `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Sertifikaattia ei saa olla peruutettu.
- [OpenSSL:n suojaustasosta 2](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) johtuvat rajoitukset merkitsevät, että:
    - Sertifikaatilla on oltava vähintään 2048 bitin yksityinen avain RSA-, DSA- ja DH-salauksilla; elliptisten käyrien avaimilla (ECC) niiden on oltava vähintään 224 bittiä.
    - Sertifikaatin allekirjoitus ei saa olla MD5 tai SHA-1 (SHA-512 on suositeltavin).
- Tallennuspalvelin käyttää `Common Name` (CN) -kenttää sertifikaatin ja siten sen koneen tunnistamiseen, jolla suora tallennus käynnistetään. Tämä kenttä on täytettävä.

## Manuaalinen asennus yhdelle palvelimelle

> **Järjestelmänvalvojan oikeudet vaaditaan**
>
> Agentin asentaminen vaatii järjestelmänvalvojan oikeudet.

Ennen agentin asentamista se on ladattava hallintakonsolista:

1. Avaa työtila ”Configurations” vasemmassa yläkulmassa olevalla painikkeella: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Avaa ruutu ”Toolbox” ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Valitse ensimmäisellä välilehdellä ”Integration Tools” haluamallesi käyttöjärjestelmälle sopiva asennusohjelma ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Kun agentti on ladattu, noudata seuraavia vaiheita:

1. Suorita asennusohjelma `setup_CleanroomAgent.exe` koneella, jolle haluat asentaa tallennusagentin.
2. Napsauta ensimmäisessä ikkunassa `Next`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Hyväksy käyttöehdot: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. Muuta kolmannella näytöllä tarvittaessa agentin asennushakemistoa: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **Neljännellä näytöllä ovat agentin asennusvaihtoehdot suoran käytön tilassa: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Agentin suoran pääsyn toiminnon käyttöönotto.

   **`Recorded Sessions`**

   Vapaa kenttä, joka hyväksyy kolme eri arvoa sen määrittämiseksi, milloin suoran pääsyn tallennus käynnistetään:

   **`Logoff On Failure`**

   Asetus, jolla käyttäjän istunto katkaistaan, jos tallennusta ei voida käynnistää, se katkeaa tai käyttäjää ei ole valtuutettu muodostamaan yhteyttä koneeseen.

   > **Suositus**
   >
   > Ensiasennuksissa tai jos edellytysten täyttyminen on epävarmaa, tämä asetus on parasta jättää valitsematta. Muussa tapauksessa, jos edellytyksissä tai asetuksissa on ongelma, uudet yhteydet palvelimeen katkaisevat käyttäjän välittömästi (riippuen `Recorded Sessions` -asetuksista).

   > **Tietoa**
   >
   > Suoran pääsyn toiminto voidaan ottaa käyttöön myös asennuksen jälkeen. Katso tätä varten [agentin rekisteriavainten asetukset](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: suoran pääsyn tallennusta ei tehdä.
    - `remote`: mikä tahansa RDP-pääsy koneeseen käynnistää tallennuksen.
    - `all`: sekä RDP-pääsy että konsolipääsy (fyysinen pääsy koneeseen tai hypervisorin konsolitilasta) käynnistävät tallennuksen.
6. Lopuksi viidennellä näytöllä asennus alkaa, kun painiketta `Install` on napsautettu: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

Asennuksen jälkeen agentti vaatii lisämäärityksiä: [Määritä agentti](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Käyttöönotto hallintakonsolista

> **Järjestelmänvalvojan oikeudet vaaditaan**
>
> Agentin asentaminen vaatii järjestelmänvalvojan oikeudet kohdekoneessa.

> **Lisäedellytys**
>
> Agentti otetaan käyttöön kohdekoneessa `SMB`-protokollan avulla. Siksi `SMB`-liikenteen (TCP 445) on oltava avoinna Edge Gateway -palvelimen ja tämän kohdepalvelimen välillä.

### Käyttöönotto yhdellä palvelimella

Agentti voidaan ottaa käyttöön yksittäin kahdesta paikasta hallintakonsolissa. Näin se voidaan esimäärittää kahdenlaiseen toimintaan:

1. Käyttö RDP- ja HTML5 RDP -sovellusten kanssa: agentti valmistellaan niin, että se voi tallentaa RDP- ja HTML5 RDP -sovelluksia käyttävien käyttäjien istunnot.
2. Käyttö suoran pääsyn tilassa: agentti valmistellaan niin, että se voi edellisen toiminnan lisäksi tallentaa suoraan RDP-palvelimeen yhdistävien käyttäjien istunnot.

#### Käyttöön RDP- ja HTML5 RDP -sovellusten kanssa

Kun RDP- tai HTML5 RDP -sovellus on määritetty toimimaan agentin kanssa, sovelluksen valitseminen avaa mahdollisuuden ottaa agentti käyttöön: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Kun agentin käyttöönottopainiketta on napsautettu, avautuu uusi ikkuna, joka pyytää seuraavat tiedot: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

Kohdepalvelimen IP-osoite tai DNS-nimi, jolle tallennusagentti otetaan käyttöön. Oletuksena tämä kenttä käyttää RDP- tai HTML5 RDP -sovelluksessa määritetyn palvelimen tietoja.

**`Target drive`**

Windows-aseman kirjain, jolle agentti otetaan käyttöön. Yleisesti tämä on kirjain `C`, jolla agentti otetaan käyttöön asemalla `C:\`.

**`Target directory`**

Agentin asennushakemiston polku; jos sitä ei ole, se luodaan. CyberElements Bastion -agentin oletussijainti on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määritä Edge Gateway, jota käytetään agentin käyttöönotossa.

**`Domain`**

Sen toimialueen nimi, jossa agentin asentamiseen käytettävä hallintatili sijaitsee.

**`Username`**

Sen järjestelmänvalvojatilin nimi, jota käytetään agentin asentamiseen. Tämän tilin on pystyttävä asentamaan ohjelmia kohdepalvelimelle.

**`Password`**

Järjestelmänvalvojatilin salasana.

Kun kaikki tiedot on syötetty, agentin käyttöönotto voidaan käynnistää. Viimeinen ikkuna ilmoittaa, onnistuiko agentin käyttöönotto kohdepalvelimella vai ei.

Lisäasetukset voivat silti olla tarpeen. Katso seuraava osio: [Määritä agentti](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### Käyttöön suoran pääsyn tilassa + RDP- ja HTML5 RDP -sovellukset

Suoran pääsyn näytön kohdassa **Machine management** painike mahdollistaa agentin käyttöönoton: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Kun agentin käyttöönottopainiketta on napsautettu, avautuu uusi ikkuna, joka pyytää seuraavat tiedot: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

Kohdepalvelimen IP-osoite tai DNS-nimi, jolle tallennusagentti otetaan käyttöön. Oletuksena tämä kenttä käyttää RDP- tai HTML5 RDP -sovelluksessa määritetyn palvelimen tietoja.

**`Target drive`**

Windows-aseman kirjain, jolle agentti otetaan käyttöön. Yleisesti tämä on kirjain `C`, jolla agentti otetaan käyttöön asemalla `C:\`.

**`Target directory`**

Agentin asennushakemiston polku; jos sitä ei ole, se luodaan. CyberElements Bastion -agentin oletussijainti on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määritä Edge Gateway, jota käytetään agentin käyttöönotossa.

**`Domain`**

Sen toimialueen nimi, jossa agentin asentamiseen käytettävä hallintatili sijaitsee.

**`Username`**

Sen järjestelmänvalvojatilin nimi, jota käytetään agentin asentamiseen. Tämän tilin on pystyttävä asentamaan ohjelmia kohdepalvelimelle.

**`Password`**

Järjestelmänvalvojatilin salasana.

**`Sessions to record`**

Sen kontekstin määrittäminen, jossa istuntotallennus tapahtuu:

1. `Record remote sessions (RDS) only`: vain RDP-etäyhteydet tallennetaan.
2. `Record all sessions`: sekä RDP-etäistunnot että konsolitilan istunnot (fyysinen pääsy koneeseen tai hypervisorin konsolitilasta) tallennetaan.
3. `Record no sessions`: mikään suora yhteys palvelimeen ei johda istuntojen tallennukseen, mutta agenttia voidaan silti käyttää RDP- ja HTML5 RDP -sovellusten kautta tapahtuvassa pääsyssä.

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

Asetus, jolla määritetään sen sertifikaatin nimi, jota agentti käyttää tunnistautuessaan Edge Gateway -palvelimelle. Jos sitä ei ole määritetty, agentti etsii sertifikaattia, jonka nimi on palvelimen nimi.

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

Asetus, jolla käyttäjän istunto katkaistaan ja käyttäjä kirjataan ulos (riippuen **Sessions to record** -asetuksista), jos Edge Gateway ei ole tavoitettavissa tai käyttäjää ei ole valtuutettu muodostamaan yhteyttä palvelimeen.

> **Suositus**
>
> Ensiasennuksissa tai jos edellytysten täyttyminen on epävarmaa, tämä asetus on parasta jättää valitsematta. Muussa tapauksessa, jos edellytyksissä tai asetuksissa on ongelma, uudet yhteydet palvelimeen katkaisevat käyttäjän välittömästi (riippuen `Sessions to record` -asetuksista).

Kun kaikki tiedot on syötetty, agentin käyttöönotto voidaan käynnistää. Viimeinen ikkuna ilmoittaa, onnistuiko agentin käyttöönotto kohdepalvelimella vai ei.

Lisäasetukset voivat silti olla tarpeen. Katso seuraava osio: [Määritä agentti](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Käyttöönotto useilla palvelimilla

> **Tietoa**
>
> Tämä menetelmä sallii vain tallennusagentin käyttöönoton RDP- ja HTML5 RDP -sovellusten kanssa toimimista varten. Jotta agentti toimisi suoran pääsyn tilassa, [määritys](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) on otettava käyttöön muulla tavalla (esimerkiksi GPO:n kautta).

> **Lisäedellytys**
>
> Käyttöönotto useille palvelimille on mahdollista vain koneilla, jotka kuuluvat AD-toimialueeseen, joka on itse määritetty CyberElements Bastion -järjestelmän kohdassa `Authentication Domains` ja jossa vaihtoehto `Allow RDS Server Management` on käytössä.

Lisää `Management of RDS servers` -kohdasta yksi tai useampi uusi RDS-palvelin: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Etsi palvelimet, joille tallennusagentti on otettava käyttöön, ja lisää ne vetämällä ja pudottamalla oikeanpuoleiseen paneeliin. Valitse asetus `Deploy an agent`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Määritä agentin käyttöönoton tiedot: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Windows-aseman kirjain, jolle agentti otetaan käyttöön. Yleisesti tämä on kirjain `C`, jolla agentti otetaan käyttöön asemalla `C:\`.

**`Target directory`**

Agentin asennushakemiston polku; jos sitä ei ole, se luodaan. CyberElements Bastion -agentin oletussijainti on `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Määritä Edge Gateway, jota käytetään agentin käyttöönotossa.

**`Domain`**

Sen toimialueen nimi, jossa agentin asentamiseen käytettävä hallintatili sijaitsee.

**`Username`**

Sen järjestelmänvalvojatilin nimi, jota käytetään agentin asentamiseen. Tämän tilin on pystyttävä asentamaan ohjelmia kohdepalvelimelle.

**`Password`**

Järjestelmänvalvojatilin salasana.

Lisäasetukset voivat silti olla tarpeen. Katso seuraava osio: [Määritä agentti](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
