API SIEM

L'API SIEM espone gli eventi di audit di Workspace come feed JSON paginato, compatibile con lo standard Common Event Format (CEF). Utilizzatela per ingerire i log di audit di Altium 365 nel vostro sistema SIEM (Security Information and Event Management) o in qualsiasi strumento di conformità esterno.

Trovare l'endpoint e le credenziali

Ogni Workspace ha un proprio URL e credenziali per l'endpoint di audit. Per trovarli:

1. Andare a Admin → Settings → Audit Export nel vostro spazio di lavoro.

2. Copiare il pulsante Endpoint URL, Client ID, e Secret Key.

È possibile rigenerare o revocare la chiave segreta da questa pagina in qualsiasi momento. La rigenerazione di una chiave invalida immediatamente quella precedente.

Autenticazione

Ogni richiesta richiede due intestazioni personalizzate:

Recuperare gli eventi

GET {il tuo endpoint di audit}?Offset=0&Limit=500
ClientId: {il tuo-client-id}
ClientSecret: {tua-chiave-segreta}

Parametri della query

Esempio di Curl

curl -G '{vostro-endpoint di audit}' \
  -H 'ClientId: {vostro-client-id}' \
  -H 'ClientSecret: {tua-chiave-segreta}' \
  --data-urlencode 'Offset=0' \
  --data-urlencode 'Limit=500'

Formato della risposta

{
  "TotalCount": 2,
  "Events": [
    {
      "CefVersion": "1",
      "DeviceVendor": "Altium",
      "DeviceProduct": "365 Platform",
      "DeviceVersion": "Cloud",
      "DeviceEventClassId": "",
      "Nome": "Login utente",
      "Estensione": {
        "dvchost": "host.domain.com",
        "msg": "Accesso utente riuscito",
        "rt": "2024-01-10T14:30:00Z",
        "dtz": "UTC+00:00",
        "suser": "sampleuser",
        "act": "login",
        "externalId": "45678",
        "cat": "authentication"
      }
    }
  ]
}

Campi di primo livello

Campi evento

Campi di estensione

Paginazione

Utilizza TotalCount dalla prima risposta per determinare quante pagine recuperare. Incrementare Offset per il proprio Limit a ogni richiesta successiva, finché non vengono recuperati tutti gli eventi.

Pagina 1: Offset=0, Limite=500 → eventi 1-500
Pagina 2: Offset=500, Limite=500 → eventi 501-1000
...

Codici di stato HTTP

Ulteriori letture

Esportazione di audit in Altium 365 - Impostazione e configurazione dell'amministratore dell'area di lavoro.