SIEM-API

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

Ihren Endpunkt und Ihre Anmeldedaten finden

Jeder Workspace verfügt über eine eigene Audit-Endpunkt-URL und eigene Anmeldedaten. So finden Sie sie:

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

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

Sie können den Secret Key auf dieser Seite jederzeit neu generieren oder widerrufen. Durch das Neugenerieren eines Schlüssels wird der vorherige sofort ungültig.

Authentifizierung

Jede Anfrage erfordert zwei benutzerdefinierte Header:

Ereignisse abrufen

GET {your-audit-endpoint}?Offset=0&Limit=500
ClientId: {your-client-id}
ClientSecret: {your-secret-key}

Abfrageparameter

Curl-Beispiel

curl -G '{your-audit-endpoint}' \
  -H 'ClientId: {your-client-id}' \
  -H 'ClientSecret: {your-secret-key}' \
  --data-urlencode 'Offset=0' \
  --data-urlencode 'Limit=500'

Antwortformat

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

Felder der obersten Ebene

Ereignisfelder

Erweiterungsfelder

Paginierung

Verwenden Sie TotalCount aus der ersten Antwort, um zu bestimmen, wie viele Seiten abgerufen werden müssen. Erhöhen Sie Offset bei jeder nachfolgenden Anfrage um Ihr Limit, bis alle Ereignisse abgerufen wurden.

Page 1: Offset=0,   Limit=500   → events 1–500
Page 2: Offset=500, Limit=500   → events 501–1000
...

HTTP-Statuscodes

Weiterführende Informationen

Audit Export in Altium 365 – Einrichtung und Konfiguration durch den Workspace-Administrator.