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

최상위 필드

이벤트 필드

확장 필드

페이지 매김

가져와야 할 페이지 수를 확인하려면 첫 번째 응답의 TotalCount을(를) 사용합니다. 모든 이벤트를 검색할 때까지 이후 각 요청에서 Offset을(를) Limit만큼 증가시키십시오.

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

HTTP 상태 코드

추가 읽을거리

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