API SIEM

Interfejs API SIEM udostępnia zdarzenia audytu Workspace jako stronicowany kanał JSON, zgodny ze standardem Common Event Format (CEF). Użyj go do importowania dzienników audytu Altium 365 do systemu Security Information and Event Management (SIEM) lub dowolnego zewnętrznego narzędzia do zapewniania zgodności.

Znajdowanie punktu końcowego i poświadczeń

Każdy Workspace ma własny adres URL punktu końcowego audytu i własne poświadczenia. Aby je znaleźć:

1. Przejdź do Admin → Settings → Audit Export w swoim Workspace.

2. Skopiuj Endpoint URL, Client ID i Secret Key.

Na tej stronie możesz w dowolnym momencie ponownie wygenerować lub unieważnić Secret Key. Ponowne wygenerowanie klucza natychmiast unieważnia poprzedni.

Uwierzytelnianie

Każde żądanie wymaga dwóch niestandardowych nagłówków:

Pobieranie zdarzeń

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

Parametry zapytania

Przykład Curl

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

Format odpowiedzi

{
  "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"
      }
    }
  ]
}

Pola najwyższego poziomu

Pola zdarzenia

Pola rozszerzenia

Stronicowanie

Użyj TotalCount z pierwszej odpowiedzi, aby określić, ile stron należy pobrać. Zwiększaj Offset o wartość Limit w każdym kolejnym żądaniu, aż wszystkie zdarzenia zostaną pobrane.

Strona 1: Offset=0,   Limit=500   → zdarzenia 1–500
Strona 2: Offset=500, Limit=500   → zdarzenia 501–1000
...

Kody statusu HTTP

Dalsza lektura

Audit Export w Altium 365 – konfiguracja i ustawienia administracyjne Workspace.