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

# A Windows-rögzítőügynök telepítése

A Windows rögzítőügynököt a CyberElements Bastion arra használja, hogy új funkciókkal bővítse az RDP-munkameneteket:

- A felhasználó számára elérhető TCP- és UDP-adatfolyamok szűrésének lehetősége
- A munkamenet-rögzítés elindításának lehetősége bármely, a kiszolgálóhoz csatlakozó felhasználó esetében, a felhasználói portál vagy a Desktop kliens megkerülésével (`direct access` funkció)

Ezenkívül a rendszer a felhasználói munkamenetek során további eseményeket is rögzít:

- Ablak megnyitása
- Ablak bezárása
- Program indítása
- Program bezárása
- A vágólap tartalma
- Felhasználói tevékenység

## Előfeltételek

> **A kliens kompatibilitása**
>
> Ha szeretné megtudni, hogy az ügynök kompatibilis-e a különböző Microsoft Windows operációs rendszerekkel, tekintse meg [a kompatibilitási mátrixot](https://docs.cyberelements.io/bastion/4.6/hu/CompatibilityMatrix/).

A rögzítőügynök megfelelő működéséhez néhány előfeltételnek teljesülnie kell. Ezek egy része kizárólag az RDP- és HTML5 RDP-alkalmazások ügynökalapú rögzítési funkciójára vonatkozik, mások pedig az ügynökalapú közvetlen hozzáférésre.

### Általános előfeltételek

A rögzítőügynök úgy küldi vissza a felhasználói munkamenet felvételét a CyberElements Bastion felé, hogy a `TCP 8443` porton csatlakozik az Edge Gateway komponenshez. Ehhez nyitva kell lennie a két számítógép közötti hálózati forgalomnak.

A felvétel biztonságos visszaküldéséhez a rögzítőügynök TLS használatával biztonságos kapcsolatot létesít az Edge Gateway komponenssel. A TLS tanúsítványokra épül, és a következő feltételeknek kell teljesülniük ahhoz, hogy a kapcsolat megbízhatónak és biztonságosnak minősüljön:

- A kiszolgáló – ebben az esetben az Edge Gateway komponens – tanúsítványa nem járhatott le (az érvényesség végső dátuma).
- A kiszolgáló – ebben az esetben az Edge Gateway komponens – tanúsítványát olyan hitelesítésszolgáltatónak kell kiállítania, amelyet a rögzítőügynököt futtató számítógép megbízhatónak ismer el.

  > **További információk**
  >
  > A rögzítőügynököt futtató kiszolgálónak a megbízható hitelesítésszolgáltatók helyi tárolójában legalább a rögzítési kiszolgáló tanúsítványának legfelső szintű hitelesítésszolgáltatóját (CA) tartalmaznia kell.
  >
  > Ezért a következőket kell tenni:
  >
  > 1. Kérje le az Edge Gateway komponensen futó rögzítési szolgáltatás tanúsítványának legfelső szintű CA-ját.
  > 2. Töltse fel ezt a CA-t arra a kiszolgálóra, amelyre a rögzítőügynök telepítve van.
  > 3. Telepítse a CA-t a helyi számítógép „Trusted Root Certification Authorities” tanúsítványtárolójába.
  >
  > > **Példa a PowerShell használatával**
  > >
  > > Egy `.cer` formátumú tanúsítvány egyszerűen importálható a PowerShell segítségével.
  > > Ehhez nyisson meg egy PowerShell-terminált a számítógép rendszergazdájaként, és futtassa a következő parancsot:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Cserélje le a `<PATH_TO_CERT>` értéket a tanúsítványfájl elérési útjára.
  >
  > > **Példa a PowerShell használatával a Systancia-tanúsítványhoz, fájlküldés nélkül**
  > >
  > > Ez a példa a Systancia legfelső szintű hitelesítésszolgáltatójának (root CA) telepítését mutatja be, amelyet a CyberElements Bastion azon ügyfelei használnak, akik a Systancia által biztosított tanúsítványokat használják.
  > >
  > > A tanúsítvány úgy is importálható, hogy a fájlt nem kell elküldeni/letölteni arra a számítógépre, amelyre a rögzítőügynök telepítve van.
  > > Ehhez nyisson meg egy PowerShell-terminált a számítógép rendszergazdájaként, és futtassa a következő parancsokat:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > Ha ezt a módszert egy másik CA-val szeretné használni, módosítsa a `base64Cert` változó értékét a választott, Base64 kódolású tanúsítványra.
- A kiszolgáló – ebben az esetben az Edge Gateway komponens – tanúsítványa nem lehet visszavonva.
- A rögzítőügynököt futtató számítógépnek el kell tudnia érni a kiszolgálót – ebben az esetben az Edge Gateway komponenst – olyan DNS-néven vagy IP-címen, amelyet a kiszolgálói tanúsítvány a köznapi nevével (CN) lefed.

### Az ügynökkel használt RDP-alkalmazásokra vonatkozó speciális előfeltételek macOS vagy Ubuntu rendszerű felhasználói munkaállomás esetén

> **Figyelmeztetés**
>
> A következő előfeltételek csak akkor szükségesek, ha a felhasználó ügynökkel indít RDP-alkalmazást, és a munkaállomása nem Windows rendszerű (macOS vagy Ubuntu).
>
> Ha a CyberElements Bastion felhasználóinak munkaállomásai kizárólag Windowst futtatnak, vagy ha nem így van, kizárólag HTML5 RDP-alkalmazásokat használnak, akkor a következő előfeltételek figyelmen kívül hagyhatók.

A következő beállításkulcsok szükségesek azon a célkiszolgálón, amelyen a rögzítőügynök üzembe van helyezve.

Először is az első kulcs kikapcsolja az engedélyezett indítóprogramok listáját ([Microsoft-dokumentum](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Alapértelmezés szerint egy Windows rendszerű számítógép csak az `explorer.exe` programot engedi meg indítóprogramként.

```
1
2
```

Ha a számítógép nem RDS-kiszolgáló, mindig ajánlott a következő beállításkulcs alkalmazása, hogy a rögzítőügynök indítóprogramként megnyílhasson:

```
1
2
```

### A közvetlen hozzáférés speciális követelményei

> **A közvetlen hozzáférés funkció**
>
> A közvetlen hozzáférési funkció lehetővé teszi a felhasználói munkamenet rögzítésének indítását olyan RDP- vagy konzolhozzáférés esetén (fizikai kapcsolat a számítógéppel vagy a hipervizor konzolmódján keresztül), amely nem közvetlenül a CyberElements Bastion útján történik.
>
> Ha a felhasználónak van engedélye a kiszolgálóhoz való hozzáféréshez, a rendszer rögzíti a munkamenetét. Ellenkező esetben a rendszer alapértelmezés szerint bontja a felhasználó kapcsolatát.

Ahhoz, hogy a rögzítőügynök közvetlen hozzáférési módban működjön, egy x509-tanúsítványra van szükség. A tanúsítványnak meg kell felelnie a következő követelményeknek:

- A tanúsítványnak még érvényesnek kell lennie (az érvényességi ideje nem járt le).
- A tanúsítvány típusának (kibővített kulcshasználat mező) `client authentication` értékűnek kell lennie (OID: 1.3.6.1.5.5.7.3.2).
- A tanúsítvány nem lehet visszavonva.
- Az [OpenSSL 2-es biztonsági szintjéből](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) eredő korlátozások a következőket vonják maguk után:
    - A tanúsítvány titkos kulcsának RSA, DSA és DH titkosítás esetén legalább 2048 bitesnek kell lennie; elliptikus görbés (ECC) kulcsok esetén legalább 224 bitesnek.
    - A tanúsítvány aláírása nem lehet MD5 vagy SHA-1 (az SHA-512 ajánlott).
- A rögzítési kiszolgáló a `Common Name` (CN) mező alapján azonosítja a tanúsítványt, és ezáltal azt a számítógépet, amelyen a közvetlen rögzítés elindul. Ezt a mezőt ki kell tölteni.

## Manuális telepítés egyetlen gépre

> **Rendszergazdai jogok szükségesek**
>
> Az ügynök telepítéséhez rendszergazdai jogok szükségesek.

Az ügynök telepítése előtt le kell töltenie azt a felügyeleti konzolról:

1. Nyissa meg a „Configurations” munkaterületet a bal felső sarokban található gombbal: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Nyissa meg a „Toolbox” csempét ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Az első, „Integration Tools” lapon válassza ki a kívánt operációs rendszernek megfelelő telepítőprogramot ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Az ügynök letöltése után kövesse az alábbi lépéseket:

1. Futtassa a `setup_CleanroomAgent.exe` telepítőprogramot azon a számítógépen, amelyre a rögzítőügynököt telepíteni szeretné.
2. Az első ablakban kattintson a `Next` gombra: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Fogadja el a használati feltételeket: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. A harmadik képernyőn szükség esetén módosítsa az ügynök telepítési könyvtárát: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **A negyedik képernyő az ügynök közvetlen hozzáférési módban történő telepítésének beállításait mutatja: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Az ügynök közvetlen hozzáférési funkciójának bekapcsolása.

   **`Recorded Sessions`**

   Szabad szöveges mező, amely három különböző értéket fogad el annak meghatározására, hogy mikor induljon el a közvetlen hozzáférések rögzítése:

   **`Logoff On Failure`**

   Beállítás, amely bontja a felhasználó munkamenetét, ha a rögzítés nem indítható el, megszakad, vagy ha a felhasználó számára nincs engedélyezve a csatlakozás a számítógéphez.

   > **Javaslat**
   >
   > Első telepítéseknél, vagy ha nem biztos, hogy az előfeltételek teljesülnek, ajánlott ezt a beállítást bejelöletlenül hagyni. Ellenkező esetben, ha probléma van az előfeltételekkel vagy a beállításokkal, a kiszolgálóhoz létesített új kapcsolatok azonnal bontják a felhasználó kapcsolatát (a `Recorded Sessions` beállításoktól függően).

   > **Információ**
   >
   > A közvetlen hozzáférési funkció a telepítés után is bekapcsolható. Ehhez lásd [az ügynök beállításkulcsainak beállításait](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: nem történik közvetlenhozzáférés-rögzítés.
    - `remote`: a számítógéphez való bármely RDP-hozzáférés elindítja a rögzítést.
    - `all`: az RDP-hozzáférések és a konzolos hozzáférések (fizikai hozzáférés a számítógéphez vagy a hipervizor konzolmódjából) egyaránt elindítják a rögzítést.
6. Végül az ötödik képernyőn a telepítés az `Install` gombra kattintás után indul el: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

A telepítés után az ügynök további konfigurálást igényel: [Az ügynök konfigurálása](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Üzembe helyezés a felügyeleti konzolról

> **Rendszergazdai jogok szükségesek**
>
> Az ügynök telepítéséhez rendszergazdai jogok szükségesek a célszámítógépen.

> **További előfeltétel**
>
> Az ügynök üzembe helyezése a célszámítógépen az `SMB` protokollal történik. Ezért az Edge Gateway komponens és a célkiszolgáló között nyitva kell lennie az `SMB` adatfolyamnak (TCP 445).

### Üzembe helyezés egyetlen kiszolgálón

Az ügynök a felügyeleti konzol két helyéről egyenként is üzembe helyezhető. Így kétféle működésre konfigurálható előre:

1. Használat RDP- és HTML5 RDP-alkalmazásokkal: az ügynök előkészítése arra, hogy rögzíteni tudja az RDP- és HTML5 RDP-alkalmazásokat futtató felhasználók munkameneteit.
2. Használat közvetlen hozzáférési módban: az ügynök előkészítése arra, hogy az előző működés mellett az RDP-kiszolgálóhoz közvetlenül csatlakozó felhasználók munkameneteit is rögzíteni tudja.

#### Használat RDP- és HTML5 RDP-alkalmazásokkal

Ha egy RDP- vagy HTML5 RDP-alkalmazás az ügynökkel való együttműködésre van konfigurálva, az alkalmazás kiválasztásával elérhetővé válik az ügynök üzembe helyezésének lehetősége: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Az ügynök üzembe helyezési gombjára kattintva megjelenik egy új ablak, amely a következő adatokat kéri: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

Annak a célkiszolgálónak az IP-címe vagy DNS-neve, amelyen a rögzítőügynököt üzembe kell helyezni. Alapértelmezés szerint ez a mező az RDP- vagy HTML5 RDP-alkalmazásban megadott kiszolgáló adatait használja.

**`Target drive`**

Annak a Windows-meghajtónak a betűjele, amelyre az ügynök települ. Általában ez a `C` betű, amellyel az ügynök a `C:\` meghajtóra kerül.

**`Target directory`**

Az ügynök telepítési könyvtárának elérési útja; ha nem létezik, a rendszer létrehozza. A CyberElements Bastion ügynök alapértelmezett helye: `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Adja meg az ügynök üzembe helyezéséhez használandó Edge Gateway komponenst.

**`Domain`**

Annak a tartománynak a neve, amelyben az ügynök telepítéséhez használt rendszergazdai fiók található.

**`Username`**

Az ügynök telepítéséhez használandó rendszergazdai fiók neve. Ennek a fióknak képesnek kell lennie programok telepítésére a célkiszolgálón.

**`Password`**

A rendszergazdai fiók jelszava.

Miután minden adatot megadott, elindítható az ügynök üzembe helyezése. Egy utolsó ablak jelzi, hogy az ügynök üzembe helyezése a célkiszolgálón sikeres volt-e.

További beállításokra is szükség lehet. Lásd a következő fejezetet: [Az ügynök konfigurálása](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### Használat közvetlen hozzáférési módban + RDP- és HTML5 RDP-alkalmazásokkal

A közvetlen hozzáférési képernyő **Machine management** részén egy gomb teszi lehetővé az ügynök üzembe helyezését: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Az ügynök üzembe helyezési gombjára kattintva megjelenik egy új ablak, amely a következő adatokat kéri: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

Annak a célkiszolgálónak az IP-címe vagy DNS-neve, amelyen a rögzítőügynököt üzembe kell helyezni. Alapértelmezés szerint ez a mező az RDP- vagy HTML5 RDP-alkalmazásban megadott kiszolgáló adatait használja.

**`Target drive`**

Annak a Windows-meghajtónak a betűjele, amelyre az ügynök települ. Általában ez a `C` betű, amellyel az ügynök a `C:\` meghajtóra kerül.

**`Target directory`**

Az ügynök telepítési könyvtárának elérési útja; ha nem létezik, a rendszer létrehozza. A CyberElements Bastion ügynök alapértelmezett helye: `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Adja meg az ügynök üzembe helyezéséhez használandó Edge Gateway komponenst.

**`Domain`**

Annak a tartománynak a neve, amelyben az ügynök telepítéséhez használt rendszergazdai fiók található.

**`Username`**

Az ügynök telepítéséhez használandó rendszergazdai fiók neve. Ennek a fióknak képesnek kell lennie programok telepítésére a célkiszolgálón.

**`Password`**

A rendszergazdai fiók jelszava.

**`Sessions to record`**

Annak a környezetnek a meghatározása, amelyben munkamenet-rögzítés történik:

1. `Record remote sessions (RDS) only`: csak az RDP-alapú távoli hozzáférések rögzítése történik meg.
2. `Record all sessions`: a távoli RDP-munkamenetek és a konzolmódú munkamenetek (fizikai hozzáférés a számítógéphez vagy a hipervizor konzolmódjából) egyaránt rögzítésre kerülnek.
3. `Record no sessions`: a kiszolgálóhoz létesített közvetlen kapcsolatok egyike sem rögzít munkamenetet, az ügynök azonban továbbra is használható az RDP- és HTML5 RDP-alkalmazásokon keresztüli hozzáférésekhez.

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

Beállítás annak a tanúsítványnak a megadására, amellyel az ügynök hitelesíti magát az Edge Gateway komponensnél. Ha nincs megadva, az ügynök a kiszolgáló nevével megegyező nevű tanúsítványt keres.

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

Beállítás, amely bontja a felhasználó kapcsolatát és kijelentkezteti őt (a **Sessions to record** beállításoktól függően), ha az Edge Gateway komponens nem érhető el, vagy ha a felhasználó számára nincs engedélyezve a csatlakozás a kiszolgálóhoz.

> **Javaslat**
>
> Első telepítéseknél, vagy ha nem biztos, hogy az előfeltételek teljesülnek, ajánlott ezt a beállítást bejelöletlenül hagyni. Ellenkező esetben, ha probléma van az előfeltételekkel vagy a beállításokkal, a kiszolgálóhoz létesített új kapcsolatok azonnal bontják a felhasználó kapcsolatát (a `Sessions to record` beállításoktól függően).

Miután minden adatot megadott, elindítható az ügynök üzembe helyezése. Egy utolsó ablak jelzi, hogy az ügynök üzembe helyezése a célkiszolgálón sikeres volt-e.

További beállításokra is szükség lehet. Lásd a következő fejezetet: [Az ügynök konfigurálása](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Üzembe helyezés több kiszolgálón

> **Információ**
>
> Ezzel a módszerrel a rögzítőügynök csak az RDP- és HTML5 RDP-alkalmazásokkal való működésre helyezhető üzembe. Ahhoz, hogy az ügynök közvetlen hozzáférési módban működjön, [a konfigurációt](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) más módon (pl. GPO-val) kell telepíteni.

> **További előfeltétel**
>
> Több kiszolgálón történő üzembe helyezés csak olyan számítógépeken lehetséges, amelyek egy AD-tartományhoz tartoznak, és ez a tartomány maga is konfigurálva van a CyberElements Bastion `Authentication Domains` beállításai között, bekapcsolt `Allow RDS Server Management` beállítással.

A `Management of RDS servers` részben adjon hozzá egy vagy több új RDS-kiszolgálót: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Keresse meg azokat a kiszolgálókat, amelyekre a rögzítőügynököt telepíteni kell, és húzza át őket a jobb oldali panelre. Válassza a `Deploy an agent` lehetőséget: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Konfigurálja az ügynök üzembe helyezési adatait: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Annak a Windows-meghajtónak a betűjele, amelyre az ügynök települ. Általában ez a `C` betű, amellyel az ügynök a `C:\` meghajtóra kerül.

**`Target directory`**

Az ügynök telepítési könyvtárának elérési útja; ha nem létezik, a rendszer létrehozza. A CyberElements Bastion ügynök alapértelmezett helye: `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Adja meg az ügynök üzembe helyezéséhez használandó Edge Gateway komponenst.

**`Domain`**

Annak a tartománynak a neve, amelyben az ügynök telepítéséhez használt rendszergazdai fiók található.

**`Username`**

Az ügynök telepítéséhez használandó rendszergazdai fiók neve. Ennek a fióknak képesnek kell lennie programok telepítésére a célkiszolgálón.

**`Password`**

A rendszergazdai fiók jelszava.

További beállításokra is szükség lehet. Lásd a következő fejezetet: [Az ügynök konfigurálása](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
