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

# Instalace agenta nahrávání pro Windows

Agenta nahrávání pro Windows využívá CyberElements Bastion k přidání nových funkcí pro relace RDP:

- Možnost filtrovat datové toky TCP a UDP dostupné uživateli
- Možnost spustit nahrávání relace pro libovolného uživatele, který se připojuje k serveru bez průchodu přes uživatelský portál nebo klienta Desktop (funkce `direct access`)

Kromě toho se během uživatelských relací zachytávají další události:

- Otevření okna
- Zavření okna
- Spuštění programu
- Ukončení programu
- Obsah schránky
- Aktivita uživatele

## Předpoklady

> **Kompatibilita klienta**
>
> Informace o tom, zda je agent kompatibilní s různými operačními systémy Microsoft Windows, najdete v [matici kompatibility](https://docs.cyberelements.io/bastion/4.6/cs/CompatibilityMatrix/).

Agent nahrávání vyžaduje ke správnému fungování splnění několika předpokladů. Některé z nich se týkají pouze funkce nahrávání pomocí agenta pro aplikace RDP a HTML5 RDP, zatímco jiné se týkají přímého přístupu pomocí agenta.

### Obecné předpoklady

Agent nahrávání odesílá záznam relace uživatele zpět do CyberElements Bastion tak, že se připojí k serveru Edge Gateway na portu `TCP 8443`. To vyžaduje, aby byl síťový tok mezi oběma počítači otevřený.

Aby agent nahrávání bezpečně odeslal záznam zpět na server Edge Gateway, naváže s ním zabezpečené připojení pomocí protokolu TLS. TLS je založen na použití certifikátů a aby bylo připojení považováno za spolehlivé a zabezpečené, musí být splněny následující podmínky:

- Platnost certifikátu serveru, v tomto případě Edge Gateway, nesmí vypršet (maximální datum platnosti).
- Certifikát serveru, v tomto případě Edge Gateway, musí být vydán certifikační autoritou, kterou počítač, na kterém je nainstalován agent nahrávání, uznává jako důvěryhodnou.

  > **Další informace**
  >
  > Server, na kterém je nainstalován agent nahrávání, musí mít ve svém místním úložišti důvěryhodných certifikačních autorit minimálně kořenovou certifikační autoritu (CA) certifikátu serveru nahrávání.
  >
  > Je proto nutné:
  >
  > 1. Získat kořenovou CA certifikátu služby nahrávání na serveru Edge Gateway.
  > 2. Nahrát tuto CA na server, na kterém je nainstalován agent nahrávání.
  > 3. Nainstalovat CA do úložiště certifikátů „Trusted Root Certification Authorities“ na místním počítači.
  >
  > > **Příklad v prostředí PowerShell**
  > >
  > > Certifikát ve formátu `.cer` můžete snadno importovat pomocí prostředí PowerShell.
  > > Za tímto účelem otevřete terminál PowerShell jako správce počítače a spusťte následující příkaz:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Nahraďte `<PATH_TO_CERT>` cestou k souboru certifikátu.
  >
  > > **Příklad v prostředí PowerShell pro certifikát Systancia bez odesílání souborů**
  > >
  > > Tento příklad spočívá v instalaci kořenové CA společnosti Systancia, kterou používají klienti CyberElements Bastion využívající certifikáty dodané společností Systancia.
  > >
  > > Certifikát je také možné importovat, aniž byste museli soubor odesílat/stahovat na počítač, na kterém je nainstalován agent nahrávání.
  > > Za tímto účelem otevřete terminál PowerShell jako správce počítače a spusťte následující příkazy:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > Chcete-li tuto metodu použít s jinou CA, změňte hodnotu proměnné `base64Cert` na libovolný certifikát zakódovaný v base64.
- Certifikát serveru, v tomto případě Edge Gateway, nesmí být odvolán.
- Počítač, na kterém je nainstalován agent nahrávání, musí být schopen kontaktovat server, v tomto případě Edge Gateway, pomocí názvu DNS nebo IP adresy, na které se vztahuje certifikát serveru prostřednictvím svého Common Name (CN).

### Specifické předpoklady pro aplikace RDP s agenty používané na pracovní stanici uživatele se systémem macOS nebo Ubuntu

> **Upozornění**
>
> Následující předpoklady jsou nutné pouze v případě, že uživatel spouští aplikaci RDP s agentem a jeho pracovní stanice nepoužívá systém Windows (macOS nebo Ubuntu).
>
> Pokud mají uživatelé CyberElements Bastion pracovní stanice výhradně se systémem Windows, nebo v opačném případě používají výhradně aplikace RDP HTML5, lze následující předpoklady ignorovat.

Na cílovém serveru, na kterém je nasazen agent nahrávání, jsou vyžadovány následující klíče registru.

Nejprve první klíč zakáže seznam povolených spouštěcích programů ([dokument Microsoft](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Ve výchozím nastavení počítač s Windows povoluje jako spouštěcí program pouze `explorer.exe`.

```
1
2
```

Pokud počítač není server RDS, doporučuje se vždy použít následující klíč registru, aby se agent nahrávání mohl otevírat jako spouštěcí program:

```
1
2
```

### Specifické požadavky pro přímý přístup

> **Funkce přímého přístupu**
>
> Funkce přímého přístupu umožňuje spustit nahrávání relace uživatele při přístupu přes RDP nebo konzolu (fyzické připojení k počítači nebo prostřednictvím režimu konzoly hypervizoru), který neprochází přímo přes CyberElements Bastion.
>
> Pokud má uživatel oprávnění k přístupu k serveru, jeho relace bude nahrána. Pokud tomu tak není, bude uživatel ve výchozím nastavení odpojen.

Aby agent nahrávání fungoval v režimu přímého přístupu, je vyžadován certifikát x509. Tento certifikát musí splňovat následující požadavky:

- Certifikát musí být stále platný (doba platnosti nevypršela).
- Certifikát musí být typu (pole rozšířeného použití klíče) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Certifikát nesmí být odvolán.
- Omezení vyplývající z [úrovně zabezpečení 2 knihovny OpenSSL](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) znamenají, že:
    - Certifikát musí mít privátní klíč o délce alespoň 2048 bitů u šifer RSA, DSA a DH; u klíčů eliptických křivek (ECC) musí mít alespoň 224 bitů.
    - Podpis certifikátu nesmí být MD5 ani SHA-1 (upřednostňuje se SHA-512).
- Server nahrávání použije pole `Common Name` (CN) k identifikaci certifikátu, a tedy i počítače, na kterém se spouští přímé nahrávání. Toto pole musí být vyplněno.

## Ruční instalace na jednotlivý server

> **Vyžadována práva správce**
>
> K instalaci agenta jsou nutná práva správce.

Před instalací agenta jej musíte stáhnout z konzoly pro správu:

1. Otevřete pracovní prostor „Configurations“ pomocí tlačítka vlevo nahoře: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Otevřete dlaždici „Toolbox“ ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Na první kartě „Integration Tools“ vyberte instalační program odpovídající požadovanému operačnímu systému ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Po stažení agenta postupujte takto:

1. Spusťte instalační program `setup_CleanroomAgent.exe` na počítači, do kterého chcete nainstalovat agenta nahrávání.
2. V prvním okně klikněte na `Next`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Přijměte podmínky použití: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. Na třetí obrazovce v případě potřeby změňte instalační adresář agenta: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **Čtvrtá obrazovka zobrazuje možnosti instalace agenta v režimu přímého přístupu: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Povolení funkce přímého přístupu agenta.

   **`Recorded Sessions`**

   Volné pole přijímající tři různé hodnoty, které určují, kdy se má spustit nahrávání přímého přístupu:

   **`Logoff On Failure`**

   Možnost odpojit relaci uživatele, pokud nahrávání nelze zahájit, je přerušeno nebo uživatel nemá autorizaci k připojení k počítači.

   > **Doporučení**
   >
   > Při prvních instalacích nebo v případě, že není jisté splnění předpokladů, je nejlepší ponechat tuto možnost nezaškrtnutou. V opačném případě, pokud nastane problém s předpoklady nebo nastavením, nová připojení k serveru uživatele okamžitě odpojí (v závislosti na nastavení `Recorded Sessions`).

   > **Informace**
   >
   > Funkci přímého přístupu lze povolit i po instalaci. Postup najdete v části [nastavení klíčů registru agenta](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: nahrávání přímého přístupu nebude prováděno.
    - `remote`: jakýkoli přístup RDP k počítači spustí nahrávání.
    - `all`: nahrávání spustí přístup RDP i přístup z konzoly (fyzický přístup k počítači nebo přístup z režimu konzoly hypervizoru).
6. Nakonec se na páté obrazovce po kliknutí na tlačítko `Install` spustí instalace: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

Po instalaci vyžaduje agent další konfiguraci: [Nakonfigurujte agenta](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Nasazení z konzoly pro správu

> **Vyžadována práva správce**
>
> K instalaci agenta jsou nutná práva správce na cílovém počítači.

> **Další předpoklad**
>
> Agent se na cílový počítač nasazuje pomocí protokolu `SMB`. Proto musí být mezi komponentou Edge Gateway a tímto cílovým serverem otevřen tok `SMB` (TCP 445).

### Nasazení na jeden server

Agenta lze nasadit jednotlivě ze dvou míst konzoly pro správu. Díky tomu jej lze předem nakonfigurovat pro dva typy provozu:

1. Použití s aplikacemi RDP a HTML5 RDP: příprava agenta tak, aby mohl nahrávat relace uživatelů, kteří spouštějí aplikace RDP a HTML5 RDP.
2. Použití v režimu přímého přístupu: příprava agenta tak, aby kromě předchozího provozu mohl nahrávat i relace uživatelů, kteří se připojují přímo k serveru RDP.

#### Pro použití s aplikacemi RDP a HTML5 RDP

Pokud je aplikace RDP nebo HTML5 RDP nakonfigurována pro práci s agentem, výběr aplikace zpřístupní možnost nasadit agenta: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Po kliknutí na tlačítko nasazení agenta se zobrazí nové okno, které vyžaduje následující informace: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

IP adresa nebo název DNS cílového serveru, na který se má agent nahrávání nasadit. Ve výchozím nastavení toto pole přebírá údaje serveru zadaného v aplikaci RDP nebo HTML5 RDP.

**`Target drive`**

Písmeno jednotky Windows, na kterou bude agent nasazen. Obvykle jde o písmeno `C`, kterým se agent nasadí na jednotku `C:\`.

**`Target directory`**

Cesta k instalačnímu adresáři agenta; pokud neexistuje, bude vytvořen. Výchozí umístění agenta CyberElements Bastion je `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Zadejte komponentu Edge Gateway, která se má použít k nasazení agenta.

**`Domain`**

Název domény, ve které se nachází účet pro správu používaný k instalaci agenta.

**`Username`**

Název účtu správce, který se má použít k instalaci agenta. Tento účet musí mít možnost instalovat programy na cílový server.

**`Password`**

Heslo účtu správce.

Po zadání všech informací lze spustit nasazení agenta. Poslední okno ukáže, zda bylo nasazení agenta na cílový server úspěšné.

Mohou být nutná ještě další nastavení. Viz následující část: [Nakonfigurujte agenta](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### Pro použití v režimu přímého přístupu + aplikace RDP a HTML5 RDP

V části **Machine management** obrazovky přímého přístupu je k dispozici tlačítko, které umožňuje nasadit agenta: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Po kliknutí na tlačítko nasazení agenta se zobrazí nové okno, které vyžaduje následující informace: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

IP adresa nebo název DNS cílového serveru, na který se má agent nahrávání nasadit. Ve výchozím nastavení toto pole přebírá údaje serveru zadaného v aplikaci RDP nebo HTML5 RDP.

**`Target drive`**

Písmeno jednotky Windows, na kterou bude agent nasazen. Obvykle jde o písmeno `C`, kterým se agent nasadí na jednotku `C:\`.

**`Target directory`**

Cesta k instalačnímu adresáři agenta; pokud neexistuje, bude vytvořen. Výchozí umístění agenta CyberElements Bastion je `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Zadejte komponentu Edge Gateway, která se má použít k nasazení agenta.

**`Domain`**

Název domény, ve které se nachází účet pro správu používaný k instalaci agenta.

**`Username`**

Název účtu správce, který se má použít k instalaci agenta. Tento účet musí mít možnost instalovat programy na cílový server.

**`Password`**

Heslo účtu správce.

**`Sessions to record`**

Definice kontextu, ve kterém bude probíhat nahrávání relace:

1. `Record remote sessions (RDS) only`: nahrávání budou podléhat pouze vzdálené přístupy RDP.
2. `Record all sessions`: nahrávání budou podléhat vzdálené relace RDP i relace v režimu konzoly (fyzický přístup k počítači nebo přístup z režimu konzoly hypervizoru).
3. `Record no sessions`: žádné přímé připojení k serveru nebude relace nahrávat, agenta však lze nadále používat pro přístup prostřednictvím aplikací RDP a HTML5 RDP.

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

Možnost definovat název certifikátu, pomocí kterého se agent bude ověřovat vůči komponentě Edge Gateway. Pokud název není definován, agent vyhledá certifikát s názvem serveru.

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

Možnost odpojit a odhlásit uživatele (v závislosti na nastavení **Sessions to record**), pokud je komponenta Edge Gateway nedostupná nebo pokud uživatel nemá autorizaci k připojení k serveru.

> **Doporučení**
>
> Při prvních instalacích nebo v případě, že není jisté splnění předpokladů, je nejlepší ponechat tuto možnost nezaškrtnutou. V opačném případě, pokud nastane problém s předpoklady nebo nastavením, nová připojení k serveru uživatele okamžitě odpojí (v závislosti na nastavení `Sessions to record`).

Po zadání všech informací lze spustit nasazení agenta. Poslední okno ukáže, zda bylo nasazení agenta na cílový server úspěšné.

Mohou být nutná ještě další nastavení. Viz následující část: [Nakonfigurujte agenta](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Nasazení na více serverů

> **Informace**
>
> Tato metoda umožní nasadit agenta nahrávání pouze pro práci s aplikacemi RDP a HTML5 RDP. Aby agent fungoval v režimu přímého přístupu, bude nutné nasadit [konfiguraci](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) jinými prostředky (např. pomocí GPO).

> **Další předpoklad**
>
> Nasazení na více serverů je možné pouze na počítačích, které patří do domény AD, jež je sama nakonfigurována v `Authentication Domains` produktu CyberElements Bastion s povolenou možností `Allow RDS Server Management`.

V části `Management of RDS servers` přidejte jeden nebo více nových serverů RDS: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Vyhledejte servery, na které je třeba nasadit agenta nahrávání, a přidejte je přetažením do pravého panelu. Vyberte možnost `Deploy an agent`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Nakonfigurujte informace o nasazení agenta: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Písmeno jednotky Windows, na kterou bude agent nasazen. Obvykle jde o písmeno `C`, kterým se agent nasadí na jednotku `C:\`.

**`Target directory`**

Cesta k instalačnímu adresáři agenta; pokud neexistuje, bude vytvořen. Výchozí umístění agenta CyberElements Bastion je `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Zadejte komponentu Edge Gateway, která se má použít k nasazení agenta.

**`Domain`**

Název domény, ve které se nachází účet pro správu používaný k instalaci agenta.

**`Username`**

Název účtu správce, který se má použít k instalaci agenta. Tento účet musí mít možnost instalovat programy na cílový server.

**`Password`**

Heslo účtu správce.

Mohou být nutná ještě další nastavení. Viz následující část: [Nakonfigurujte agenta](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
