SIEM API

SIEM API는 Workspace 감사 이벤트를 페이지 처리된 JSON 피드 형태로 제공하며, Common Event Format (CEF) 표준과 호환됩니다. 이를 사용해 Altium 365 감사 로그를 Security Information and Event Management(SIEM) 시스템 또는 외부 컴플라이언스 도구로 수집할 수 있습니다.

엔드포인트와 자격 증명 찾기

각 Workspace에는 고유한 감사 엔드포인트 URL과 자격 증명이 있습니다. 확인 방법은 다음과 같습니다.

1. Workspace에서 Admin → Settings → Audit Export로 이동합니다.

2. Endpoint URL, Client ID, Secret Key를 복사합니다.

이 페이지에서 언제든지 Secret Key를 재생성하거나 폐기할 수 있습니다. 키를 재생성하면 이전 키는 즉시 무효화됩니다.

인증

모든 요청에는 두 개의 사용자 지정 헤더가 필요합니다.

이벤트 가져오기

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

쿼리 매개변수

Curl 예제

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

응답 형식

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

최상위 필드

이벤트 필드

Extension 필드

페이지 처리

가져와야 할 페이지 수를 확인하려면 첫 번째 응답의 TotalCount를 사용합니다. 이후 요청마다 Offset를 Limit만큼 증가시켜 모든 이벤트를 가져올 때까지 반복합니다.

1페이지: Offset=0,   Limit=500   → 이벤트 1–500
2페이지: Offset=500, Limit=500   → 이벤트 501–1000
...

HTTP 상태 코드

추가 읽을거리

Altium 365의 Audit Export – Workspace 관리자 설정 및 구성.