SIEM-API

Die SIEM-API stellt Workspace-Audit-Ereignisse als paginierten JSON-Feed bereit, der mit dem CEF-Standard (Common Event Format) kompatibel ist. Verwenden Sie sie, um Altium 365-Auditprotokolle in Ihr SIEM-System (Security Information and Event Management) oder ein externes Compliance-Tooling aufzunehmen.

Finden Ihres Endpunkts und Ihrer Anmeldeinformationen

Jeder Workspace hat seine eigene Audit-Endpunkt-URL und Anmeldeinformationen. So finden Sie sie:

1. Gehen Sie zu Admin → Settings → Audit Export in Ihrem Arbeitsbereich.

2. Kopieren Sie die Endpoint URL, Client ID, und Secret Key.

Sie können den Geheimschlüssel auf dieser Seite jederzeit neu generieren oder widerrufen. Wenn Sie einen Schlüssel neu generieren, wird der vorherige Schlüssel sofort ungültig.

Authentifizierung

Für jede Anfrage sind zwei benutzerdefinierte Header erforderlich:

Abrufen von Ereignissen

GET {Ihr-Audit-Endpunkt}?Offset=0&Limit=500
ClientId: {Ihre-client-id}
ClientSecret: {Ihr-geheimer-Schlüssel}

Abfrage-Parameter

Curl Beispiel

curl -G '{Ihr-Audit-Endpunkt}' \
  -H 'ClientId: {Ihre-client-id}' \
  -H 'ClientSecret: {Ihr-geheimer-Schlüssel}' \
  --data-urlencode 'Versatz=0' \
  --data-urlencode 'Begrenzung=500'

Antwort-Format

{
  "TotalCount": 2,
  "Ereignisse": [
    {
      "CefVersion": "1",
      "DeviceVendor": "Altium",
      "DeviceProduct": "365 Plattform",
      "DeviceVersion": "Cloud",
      "DeviceEventClassId": "",
      "Name": "Benutzeranmeldung",
      "Extension": {
        "dvchost": "host.domain.com",
        "msg": "Benutzer erfolgreich angemeldet",
        "rt": "2024-01-10T14:30:00Z",
        "dtz": "UTC+00:00",
        "suser": "sampleuser",
        "act": "login",
        "externalId": "45678",
        "cat": "authentication"
      }
    }
  ]
}

Felder der obersten Ebene

Ereignis-Felder

Felder der Erweiterung

Paginierung

Verwenden Sie TotalCount aus der ersten Antwort, um zu bestimmen, wie viele Seiten geholt werden sollen. Erhöhen Sie Offset um Ihren Limit bei jeder weiteren Anfrage, bis alle Ereignisse abgerufen wurden.

Seite 1: Offset=0, Limit=500 → Ereignisse 1-500
Seite 2: Offset=500, Limit=500 → Ereignisse 501-1000
...

HTTP Status Codes

Weitere Lektüre

Audit-Export in Altium 365 - Einrichtung und Konfiguration des Workspace-Administrators.