Integrazioni API

Integrazioni API

Corellix offre API REST per integrare i dati di monitoraggio con sistemi esterni come SIEM, ticketing, e dashboard personalizzate.

Accesso alle API

Generare una API Key

1. Accedi al Customer Portal
2. Vai su Impostazioni → API Keys
3. Clicca Nuova API Key
4. Assegna un nome descrittivo (es. “Integrazione ServiceNow”)
5. Copia e salva la chiave in modo sicuro

Autenticazione

Tutte le richieste API richiedono autenticazione tramite header:

Authorization: Bearer YOUR_API_KEY

Endpoint Disponibili

Sessioni

Recupera le sessioni attive o lo storico:

GET https://api.corellix.io/api/v1/sessions

Parametri:

Parametro	Tipo	Descrizione
status	string	active, disconnected, all
from	datetime	Data inizio (ISO 8601)
to	datetime	Data fine (ISO 8601)
deliveryGroup	string	Filtra per Delivery Group
page	int	Numero pagina
pageSize	int	Elementi per pagina (max 100)

Esempio risposta:

{
  "data": [
    {
      "id": "sess-abc123",
      "userName": "mario.rossi@azienda.com",
      "machineName": "VDI-001",
      "deliveryGroup": "Windows 11 Pool",
      "status": "Active",
      "startTime": "2025-12-19T08:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "total": 150
  }
}

Applicazioni

Recupera il catalogo applicazioni:

GET https://api.corellix.io/api/v1/applications

Esempio risposta:

{
  "data": [
    {
      "id": "app-xyz789",
      "name": "Microsoft Word",
      "usageCount": 1250
    }
  ]
}

Statistiche

Recupera statistiche aggregate:

GET https://api.corellix.io/api/v1/stats/summary

Esempio risposta:

{
  "activeSessions": 45,
  "totalSessionsToday": 230,
  "uniqueUsersToday": 87,
  "topApplications": [
    { "name": "Microsoft Outlook", "count": 180 },
    { "name": "Google Chrome", "count": 156 }
  ]
}

Rate Limiting

Per garantire la stabilità del servizio, le API hanno i seguenti limiti:

Limite	Valore
Richieste per minuto	100
Richieste per giorno	10.000

Se superi i limiti, riceverai un errore 429 Too Many Requests.

Codici di Errore

Codice	Descrizione
200	Successo
400	Richiesta non valida
401	Non autenticato
403	Non autorizzato
404	Risorsa non trovata
429	Troppe richieste
500	Errore interno

Esempi di Integrazione

PowerShell

$headers = @{
    "Authorization" = "Bearer YOUR_API_KEY"
}

$response = Invoke-RestMethod -Uri "https://api.corellix.io/api/v1/sessions?status=active" -Headers $headers
$response.data | Format-Table userName, machineName, status

Python

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.corellix.io/api/v1/sessions",
    headers=headers,
    params={"status": "active"}
)
sessions = response.json()["data"]

Supporto

Per domande sulle API o richieste di nuovi endpoint:

• 📧 Email: api-support@corellix.io