User Agent

User Agent

L’User Agent è un servizio Windows leggero che rileva le applicazioni in esecuzione nelle sessioni utente e le invia al Collector.

Funzionalità

• ✅ Rilevamento applicazioni in esecuzione (nome, icona)
• ✅ Tracciamento sessioni utente attive
• ✅ Impatto minimo sulle performance (< 50 MB RAM)
• ✅ Cache intelligente: invia solo dati nuovi o modificati
• ✅ Installazione silenziosa per deploy automatizzati
• ✅ Distribuzione via GPO/MSI per ambienti enterprise

Installazione

Manuale

Installazione con Wizard

1. Scarica CorellixUserAgent dal Customer Portal
2. Estrai il pacchetto sulla macchina target
3. Esegui Setup.bat come Amministratore
4. Configura:
   • Collector Host: hostname o IP del server Collector
   • Collector Port: 5050 (default)

Silenziosa

Installazione da Linea di Comando

# Installazione base
.\Setup-CorellixUserAgent.ps1 -Silent -CollectorHost "collector.tuodominio.com"

# Con porta personalizzata
.\Setup-CorellixUserAgent.ps1 -Silent -CollectorHost "collector.tuodominio.com" -CollectorPort 5050

GPO/MSI

Deploy via Group Policy

1. Copia il file MSI su uno share di rete accessibile
2. Crea una nuova GPO
3. Vai a Computer Configuration → Policies → Software Settings → Software Installation
4. Aggiungi il pacchetto MSI
5. Configura le proprietà:

COLLECTOR_HOST=collector.tuodominio.com
COLLECTOR_PORT=5050

Consiglio

Il deploy via GPO è il metodo consigliato per ambienti con molte VM.

Configurazione

File di Configurazione

Dopo l’installazione, il file di configurazione si trova in:

C:\Program Files\Corellix\UserAgent\appsettings.json

Parametri principali:

Parametro	Default	Descrizione
CollectorHost	-	Hostname o IP del Collector
CollectorPort	5050	Porta di comunicazione
ReportIntervalSeconds	30	Frequenza invio dati

Modifica Configurazione

Per modificare la configurazione dopo l’installazione:

1. Ferma il servizio
2. Modifica appsettings.json
3. Riavvia il servizio

Stop-Service CorellixUserAgent
# Modifica il file...
Start-Service CorellixUserAgent

Gestione del Servizio

Comandi Utili

# Verifica stato
Get-Service CorellixUserAgent

# Riavvia
Restart-Service CorellixUserAgent

# Visualizza log
Get-Content "C:\Program Files\Corellix\UserAgent\logs\agent.log" -Tail 30

Verifica Funzionamento

Per verificare che l’User Agent stia inviando dati:

1. Accedi al Customer Portal
2. Vai su Sessioni → Attive
3. Clicca su una sessione
4. Dovresti vedere l’elenco delle Applicazioni in uso

Troubleshooting

L’Agent non si avvia

1. Verifica che .NET 8.0 Runtime sia installato
2. Controlla i permessi della cartella di installazione
3. Verifica i log per messaggi di errore

Nessuna applicazione visibile

1. Verifica che il servizio sia in esecuzione sulla VM
2. Controlla la connettività verso il Collector:

   Test-NetConnection -ComputerName collector.tuodominio.com -Port 5050

3. Verifica che la sessione sia attiva (non disconnessa)

Errore di connessione al Collector

1. Verifica che il Collector sia raggiungibile dalla VM
2. Controlla le regole firewall
3. Verifica che hostname e porta siano corretti

Disinstallazione

Manuale

.\Uninstall-CorellixUserAgent.ps1

Via GPO

Rimuovi il pacchetto software dalla GPO. La disinstallazione avverrà automaticamente.

Privacy e Sicurezza

• L’User Agent raccoglie solo nome e percorso delle applicazioni
• Non vengono raccolti contenuti di documenti o dati utente
• Non vengono registrate attività di tastiera o mouse
• I dati vengono inviati solo al Collector locale, mai direttamente a Internet