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

# Installazione dell'agente di registrazione per Windows

L'agente di registrazione per Windows è utilizzato da CyberElements Bastion per aggiungere nuove funzionalità alle sessioni RDP:

- Possibilità di filtrare i flussi TCP e UDP accessibili all'utente
- Possibilità di avviare la registrazione della sessione per qualsiasi utente che si connette al server senza passare dal portale utente o dal client Desktop (funzionalità `direct access`)

Inoltre, durante le sessioni degli utenti vengono catturati eventi aggiuntivi:

- Apertura di finestre
- Chiusura di finestre
- Avvio di programmi
- Chiusura di programmi
- Contenuto degli appunti
- Attività dell'utente

## Prerequisiti

> **Compatibilità del client**
>
> Per sapere se l'agente è compatibile con i diversi sistemi operativi Microsoft Windows, consultare [la matrice di compatibilità](https://docs.cyberelements.io/bastion/4.6/it/CompatibilityMatrix/).

L'agente di registrazione richiede alcuni prerequisiti per funzionare correttamente. Alcuni riguardano soltanto la funzionalità di registrazione con agente delle applicazioni RDP e HTML5 RDP, altri l'accesso diretto con agente.

### Prerequisiti generali

L'agente di registrazione invia la registrazione della sessione dell'utente a CyberElements Bastion connettendosi all'Edge Gateway sulla porta `TCP 8443`. Per questo è necessario che il flusso di rete tra le due macchine sia aperto.

Per inviare la registrazione all'Edge Gateway in modo sicuro, l'agente di registrazione stabilisce con quest'ultimo una connessione sicura tramite TLS. TLS si basa sull'uso di certificati e, perché la connessione sia considerata affidabile e sicura, devono essere soddisfatti i vincoli seguenti:

- Il certificato del server, in questo caso l'Edge Gateway, non deve essere scaduto (data massima di validità).
- Il certificato del server, in questo caso l'Edge Gateway, deve essere emesso da un'autorità di certificazione riconosciuta come attendibile dalla macchina su cui è installato l'agente di registrazione.

  > **Informazioni aggiuntive**
  >
  > Il server su cui è installato l'agente di registrazione deve avere, come minimo, l'autorità di certificazione (CA) radice del certificato del server di registrazione nel proprio archivio locale delle autorità di certificazione attendibili.
  >
  > È quindi necessario:
  >
  > 1. Recuperare la CA radice del certificato del servizio di registrazione sull'Edge Gateway.
  > 2. Caricare questa CA sul server su cui è installato l'agente di registrazione.
  > 3. Installare la CA nell'archivio dei certificati «Trusted Root Certification Authorities» della macchina locale.
  >
  > > **Esempio con PowerShell**
  > >
  > > Un certificato in formato `.cer` può essere importato facilmente tramite PowerShell.
  > > A tale scopo, aprire un terminale PowerShell come amministratore della macchina ed eseguire il comando seguente:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Sostituire `<PATH_TO_CERT>` con il percorso del file del certificato.
  >
  > > **Esempio con PowerShell per il certificato Systancia, senza inviare file**
  > >
  > > Questo esempio consiste nell'installare la CA radice di Systancia, utilizzata dai client CyberElements Bastion che impiegano certificati forniti da Systancia.
  > >
  > > È inoltre possibile importare il certificato senza dover inviare o scaricare il file sulla macchina su cui è installato l'agente di registrazione.
  > > A tale scopo, aprire un terminale PowerShell come amministratore della macchina ed eseguire i comandi seguenti:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > Per utilizzare questo metodo con un'altra CA, modificare il valore della variabile `base64Cert` con il certificato desiderato codificato in base 64.
- Il certificato del server, in questo caso l'Edge Gateway, non deve essere revocato.
- La macchina su cui è installato l'agente di registrazione deve poter contattare il server, in questo caso l'Edge Gateway, con un nome DNS o un indirizzo IP coperto dal certificato del server tramite il suo Common Name (CN).

### Prerequisiti specifici delle applicazioni RDP con agente utilizzate su una postazione utente macOS o Ubuntu

> **Attenzione**
>
> I prerequisiti seguenti sono necessari solo se l'utente avvia un'applicazione RDP con agente e la sua postazione non è Windows (macOS o Ubuntu).
>
> Se gli utenti di CyberElements Bastion hanno postazioni esclusivamente Windows oppure, in mancanza, utilizzano esclusivamente applicazioni HTML5 RDP, i prerequisiti seguenti possono essere ignorati.

Le chiavi di registro seguenti sono necessarie sul server di destinazione su cui è distribuito l'agente di registrazione.

In primo luogo, la prima chiave disabiliterà l'elenco dei programmi di avvio autorizzati ([documento Microsoft](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Per impostazione predefinita, una macchina Windows autorizza solo `explorer.exe` come programma di avvio.

```
1
2
```

Se la macchina non è un server RDS, si raccomanda comunque di applicare sempre la chiave di registro seguente, per permettere all'agente di registrazione di aprirsi come programma di avvio:

```
1
2
```

### Requisiti specifici dell'accesso diretto

> **Funzionalità di accesso diretto**
>
> La funzionalità di accesso diretto permette di avviare una registrazione della sessione dell'utente per gli accessi RDP o console (connessione fisica alla macchina o tramite la modalità console dell'hypervisor) che non passano direttamente da CyberElements Bastion.
>
> Se l'utente ha l'autorizzazione ad accedere al server, la sua sessione verrà registrata. In caso contrario, per impostazione predefinita l'utente verrà disconnesso.

Perché l'agente di registrazione funzioni in modalità di accesso diretto è necessario un certificato x509. Questo certificato deve soddisfare i requisiti seguenti:

- Il certificato deve essere ancora valido (periodo di validità non scaduto).
- Il certificato deve essere di tipo (campo di utilizzo avanzato della chiave) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Il certificato non deve essere revocato.
- I vincoli derivanti dal [livello di sicurezza 2 di OpenSSL](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) implicano che:
    - Il certificato deve avere una chiave privata di almeno 2048 bit con i cifrari RSA, DSA e DH; per le chiavi a curva ellittica (ECC) devono essere di almeno 224 bit.
    - La firma del certificato non deve essere MD5 o SHA-1 (è preferibile SHA-512).
- Il server di registrazione utilizzerà il campo `Common Name` (CN) per identificare il certificato e quindi la macchina su cui viene avviata una registrazione diretta. Questo campo deve essere compilato.

## Installazione manuale su un singolo server

> **Diritti di amministratore necessari**
>
> Per installare l'agente sono necessari i diritti di amministratore.

Prima di installare l'agente, è necessario scaricarlo dalla console di amministrazione:

1. Accedere allo spazio di lavoro «Configurations» tramite il pulsante situato in alto a sinistra: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Aprire il riquadro «Toolbox» ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Selezionare il programma di installazione corrispondente al sistema operativo desiderato nella prima scheda, «Integration Tools» ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Una volta scaricato l'agente, procedere come segue:

1. Eseguire il programma di installazione `setup_CleanroomAgent.exe` sulla macchina in cui si desidera installare l'agente di registrazione.
2. Fare clic su `Next` nella prima finestra: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Accettare le condizioni d'uso: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. Nella terza schermata, modificare se necessario la directory di installazione dell'agente: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **La quarta schermata presenta le opzioni di installazione dell'agente in modalità di accesso diretto: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Attivazione della funzionalità di accesso diretto dell'agente.

   **`Recorded Sessions`**

   Campo libero che accetta tre valori distinti, per definire quando deve essere attivata la registrazione degli accessi diretti:

   **`Logoff On Failure`**

   Opzione per disconnettere la sessione dell'utente se la registrazione non può essere avviata, viene interrotta o se l'utente non è autorizzato a connettersi alla macchina.

   > **Raccomandazione**
   >
   > Nelle prime installazioni, o se non si è certi del rispetto dei prerequisiti, è preferibile lasciare questa opzione non selezionata. In caso contrario, se si verifica un problema con i prerequisiti o con la configurazione, le nuove connessioni al server disconnetteranno immediatamente l'utente (in funzione della configurazione di `Recorded Sessions`).

   > **Informazioni**
   >
   > La funzionalità di accesso diretto può essere abilitata anche dopo l'installazione. A tale scopo, consultare [la configurazione delle chiavi di registro dell'agente](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: non verrà effettuata alcuna registrazione degli accessi diretti.
    - `remote`: qualsiasi accesso RDP alla macchina attiverà la registrazione.
    - `all`: sia gli accessi RDP sia gli accessi da console (accesso fisico alla macchina o dalla modalità console dell'hypervisor) attiveranno la registrazione.
6. Infine, nella quinta schermata, l'installazione inizierà dopo aver fatto clic sul pulsante `Install`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

Una volta installato, l'agente richiede una configurazione aggiuntiva: [Configurare l'agente](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Distribuzione dalla console di amministrazione

> **Diritti di amministratore necessari**
>
> Per installare l'agente sono necessari i diritti di amministratore sulla macchina di destinazione.

> **Prerequisito aggiuntivo**
>
> L'agente viene distribuito sulla macchina di destinazione tramite il protocollo `SMB`. Il flusso `SMB` (TCP 445) deve pertanto essere aperto tra l'Edge Gateway e tale server di destinazione.

### Distribuzione su un singolo server

L'agente può essere distribuito singolarmente da due punti della console di amministrazione. Questo consente di preconfigurarlo per due tipi di funzionamento:

1. Utilizzo con applicazioni RDP e RDP HTML5: preparare l'agente affinché possa registrare le sessioni degli utenti che eseguono applicazioni RDP e RDP HTML5.
2. Utilizzo in modalità di accesso diretto: preparare l'agente affinché possa registrare, oltre a quanto precede, le sessioni degli utenti che si connettono direttamente al server RDP.

#### Per l'utilizzo con applicazioni RDP e RDP HTML5

Quando un'applicazione RDP o RDP HTML5 è configurata per funzionare con l'agente, selezionandola si abilita la possibilità di distribuirlo: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Dopo aver fatto clic sul pulsante di distribuzione dell'agente, viene visualizzata una nuova finestra che richiede le informazioni seguenti: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

Indirizzo IP o nome DNS del server di destinazione sul quale distribuire l'agente di registrazione. Per impostazione predefinita, questo campo utilizza le informazioni del server indicato nell'applicazione RDP o RDP HTML5.

**`Target drive`**

Lettera dell'unità Windows sulla quale verrà distribuito l'agente. In genere si tratta della lettera `C`, per distribuire l'agente sull'unità `C:\`.

**`Target directory`**

Percorso della directory di installazione dell'agente; se non esiste, verrà creata. La posizione predefinita dell'agente CyberElements Bastion è `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Indicare l'Edge Gateway da utilizzare per la distribuzione dell'agente.

**`Domain`**

Nome del dominio in cui si trova l'account di amministrazione utilizzato per installare l'agente.

**`Username`**

Nome dell'account di amministratore da utilizzare per installare l'agente. Tale account deve poter installare programmi sul server di destinazione.

**`Password`**

Password dell'account di amministratore.

Una volta immesse tutte le informazioni, è possibile avviare la distribuzione dell'agente. Un'ultima finestra indicherà se la distribuzione dell'agente sul server di destinazione è riuscita o no.

Potrebbe essere necessaria una configurazione aggiuntiva. Consultare la sezione seguente: [Configurare l'agente](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### Per l'utilizzo in modalità di accesso diretto + applicazioni RDP e RDP HTML5

Dalla schermata degli accessi diretti, in **Machine management**, un pulsante consente di distribuire l'agente: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Dopo aver fatto clic sul pulsante di distribuzione dell'agente, viene visualizzata una nuova finestra che richiede le informazioni seguenti: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

Indirizzo IP o nome DNS del server di destinazione sul quale distribuire l'agente di registrazione. Per impostazione predefinita, questo campo utilizza le informazioni del server indicato nell'applicazione RDP o RDP HTML5.

**`Target drive`**

Lettera dell'unità Windows sulla quale verrà distribuito l'agente. In genere si tratta della lettera `C`, per distribuire l'agente sull'unità `C:\`.

**`Target directory`**

Percorso della directory di installazione dell'agente; se non esiste, verrà creata. La posizione predefinita dell'agente CyberElements Bastion è `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Indicare l'Edge Gateway da utilizzare per la distribuzione dell'agente.

**`Domain`**

Nome del dominio in cui si trova l'account di amministrazione utilizzato per installare l'agente.

**`Username`**

Nome dell'account di amministratore da utilizzare per installare l'agente. Tale account deve poter installare programmi sul server di destinazione.

**`Password`**

Password dell'account di amministratore.

**`Sessions to record`**

Definizione del contesto in cui verrà effettuata una registrazione di sessione:

1. `Record remote sessions (RDS) only`: solo gli accessi remoti RDP saranno oggetto di registrazione.
2. `Record all sessions`: le sessioni remote RDP e le sessioni in modalità console (accesso fisico alla macchina o dalla modalità console dell'hypervisor) saranno oggetto di registrazione.
3. `Record no sessions`: nessuna connessione diretta al server darà luogo a una registrazione; l'agente può tuttavia continuare a essere utilizzato per gli accessi tramite applicazioni RDP e RDP HTML5.

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

Opzione per definire il nome del certificato che l'agente utilizzerà per autenticarsi presso l'Edge Gateway. Se non viene definito, l'agente cercherà un certificato con il nome del server.

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

Opzione per disconnettere e chiudere la sessione dell'utente (in funzione della configurazione di **Sessions to record**) se l'Edge Gateway è irraggiungibile o se l'utente non è autorizzato a connettersi al server.

> **Raccomandazione**
>
> Nelle prime installazioni, o se non si è certi del rispetto dei prerequisiti, è preferibile lasciare questa opzione non selezionata. In caso contrario, se si verifica un problema con i prerequisiti o con la configurazione, le nuove connessioni al server disconnetteranno immediatamente l'utente (in funzione della configurazione di `Sessions to record`).

Una volta immesse tutte le informazioni, è possibile avviare la distribuzione dell'agente. Un'ultima finestra indicherà se la distribuzione dell'agente sul server di destinazione è riuscita o no.

Potrebbe essere necessaria una configurazione aggiuntiva. Consultare la sezione seguente: [Configurare l'agente](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Distribuzione su più server

> **Informazioni**
>
> Questo metodo consente di distribuire l'agente di registrazione unicamente per il funzionamento con applicazioni RDP e RDP HTML5. Affinché l'agente funzioni in modalità di accesso diretto, sarà necessario distribuire [la configurazione](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) con altri mezzi (ad esempio tramite GPO).

> **Prerequisito aggiuntivo**
>
> La distribuzione su più server è possibile solo su macchine appartenenti a un dominio AD, a sua volta configurato negli `Authentication Domains` di CyberElements Bastion con l'opzione `Allow RDS Server Management` abilitata.

In `Management of RDS servers`, aggiungere uno o più nuovi server RDS: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Cercare e aggiungere i server sui quali distribuire l'agente di registrazione, trascinandoli nel pannello di destra. Selezionare l'opzione `Deploy an agent`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Configurare le informazioni di distribuzione dell'agente: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Lettera dell'unità Windows sulla quale verrà distribuito l'agente. In genere si tratta della lettera `C`, per distribuire l'agente sull'unità `C:\`.

**`Target directory`**

Percorso della directory di installazione dell'agente; se non esiste, verrà creata. La posizione predefinita dell'agente CyberElements Bastion è `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Indicare l'Edge Gateway da utilizzare per la distribuzione dell'agente.

**`Domain`**

Nome del dominio in cui si trova l'account di amministrazione utilizzato per installare l'agente.

**`Username`**

Nome dell'account di amministratore da utilizzare per installare l'agente. Tale account deve poter installare programmi sul server di destinazione.

**`Password`**

Password dell'account di amministratore.

Potrebbe essere necessaria una configurazione aggiuntiva. Consultare la sezione seguente: [Configurare l'agente](https://docs.cyberelements.io/bastion/4.6/it/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
