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 swojego systemu Security Information and Event Management (SIEM) lub dowolnych zewnętrznych narzędzi do 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.

W dowolnym momencie możesz ponownie wygenerować lub unieważnić Secret Key na tej stronie. 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 przy każdym kolejnym żądaniu, aż wszystkie zdarzenia zostaną pobrane.

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

Kody statusu HTTP

Dalsza lektura

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