User Agent

Corellix User Agent

L’User Agent è un servizio Windows leggero che raccoglie informazioni sulle sessioni utente e le applicazioni in esecuzione.

Versione Attuale

v1.0.0 - 19 Dicembre 2025

Funzionalità

✅ Monitoraggio sessioni utente attive
✅ Raccolta applicazioni in esecuzione (path, nome, icona)
✅ Tracking connessioni TCP stabilite
✅ Cache locale intelligente (invia solo dati nuovi)
✅ Versioning e telemetria OS
✅ Servizio Windows con auto-restart

Architettura

┌─────────────────────────────────────────────────────────────────┐
│                    Macchina Utente                              │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │               Corellix User Agent v1.0.0                 │   │
│  │                                                          │   │
│  │  ┌─────────────────┐    ┌─────────────────────────────┐  │   │
│  │  │  App Collector  │    │  Connection Collector       │  │   │
│  │  └────────┬────────┘    └─────────────┬───────────────┘  │   │
│  │           └───────────┬───────────────┘                   │   │
│  │                       ▼                                   │   │
│  │           ┌───────────────────────┐                       │   │
│  │           │    Cache Locale       │                       │   │
│  │           │  (solo dati nuovi)    │                       │   │
│  │           └───────────┬───────────┘                       │   │
│  └───────────────────────┼──────────────────────────────────┘   │
└──────────────────────────┼──────────────────────────────────────┘
                           │ HTTP POST
                           ▼
┌──────────────────────────────────────────────────────────────────┐
│                  Corellix Collector (:5050)                      │
└──────────────────────────────────────────────────────────────────┘

Installazione

Scarica CorellixUserAgent-1.0.0.zip
Estrai ed esegui Setup.bat come amministratore
Configura nel wizard:
- Hostname/IP del Collector
- Porta (default: 5050)
- API Key (opzionale)

# Installazione base
powershell -ExecutionPolicy Bypass -File Setup-CorellixUserAgent.ps1 `
  -Silent `
  -CollectorUrl "http://collector:5050"

# Con API Key
powershell -ExecutionPolicy Bypass -File Setup-CorellixUserAgent.ps1 `
  -Silent `
  -CollectorUrl "http://collector:5050" `
  -ApiKey "your-api-key"

msiexec /i CorellixUserAgent-1.0.0.msi /qb ^
  COLLECTOR_HOST=collector.domain.com ^
  COLLECTOR_PORT=5050

Per deploy GPO:

Copia l’MSI su uno share di rete accessibile
Crea una GPO di tipo “Software Installation”
Punta al file MSI
Configura le proprietà COLLECTOR_HOST e COLLECTOR_PORT

Configurazione

File: `appsettings.json`

{
  "AgentSettings": {
    "ProxyServiceUrl": "http://localhost:5050",
    "ApiKey": "",
    "PollingIntervalSeconds": 30,
    "MaxBatchSize": 500
  }
}

Parametri

Parametro	Descrizione	Default
`ProxyServiceUrl`	URL completo del Collector	`http://localhost:5050`
`ApiKey`	Chiave API per autenticazione	(vuoto)
`PollingIntervalSeconds`	Intervallo di raccolta dati	30
`MaxBatchSize`	Numero massimo elementi per batch	500

Gestione Servizio

# Avviare il servizio
Start-Service CorellixUserAgent
# oppure
net start CorellixUserAgent

# Fermare il servizio
Stop-Service CorellixUserAgent

# Stato del servizio
Get-Service CorellixUserAgent

# Riavviare il servizio
Restart-Service CorellixUserAgent

Dati Raccolti

Ogni richiesta al Collector include:

{
  "agentHostName": "WORKSTATION-01",
  "agentVersion": "1.0.0",
  "osVersion": "Microsoft Windows NT 10.0.22631.0",
  "osArchitecture": "X64",
  "timestamp": "2025-12-19T10:30:00Z",
  "appUsages": [
    {
      "sessionId": 2,
      "userName": "DOMAIN\\user",
      "applicationName": "Microsoft Word",
      "processPath": "C:\\Program Files\\Microsoft Office\\...",
      "timestamp": "2025-12-19T10:30:00Z"
    }
  ],
  "newApps": [
    {
      "processPath": "C:\\Program Files\\...",
      "productName": "Microsoft Word",
      "icon": "base64..."
    }
  ]
}

Log

Directory: C:\Program Files\Corellix\UserAgent\logs\

File: corellix-user-agent-YYYYMMDD.log

# Visualizza log in tempo reale
Get-Content "C:\Program Files\Corellix\UserAgent\logs\corellix-user-agent-*.log" -Tail 50 -Wait

Disinstallazione

# Via PowerShell
powershell -ExecutionPolicy Bypass -File Setup-CorellixUserAgent.ps1 -Uninstall

# Via sc.exe
net stop CorellixUserAgent
sc.exe delete CorellixUserAgent

Troubleshooting

Requisiti

Requisito	Valore
OS	Windows 7+ / Server 2012 R2+
.NET	8.0 Runtime
RAM	~50 MB
Disco	~20 MB
Rete	Connettività verso Collector