위반 사항 API

개요

Offenses API는 QRadar 에서 가장 최근의 위반 내역을 반환합니다. 결과는 위반 유형별로 필터링하거나, 사용자 및 엔터티 행동 분석(UEBA) 위반 사항으로만 제한할 수 있습니다.

엔드포인트

GET /api/offenses

조회 매개변수

유형 매개변수 값

• all: (기본값): 사용자 관련 위반 사항과 엔티티 관련 위반 사항을 모두 반환합니다(각각 최대 10건, 총 20건)
• user: 사용자와 관련된 위반 사항만 반환합니다(최대 20건)
• entity: 해당 인원과 관련된 위반 사항만 표시합니다(최대 20건)

필터링 규칙

• 매개변수가 지정되지 않은 경우, API는 유형에 관계없이 가장 최근의 위반 내역을 반환합니다.
• 유형 매개변수를 사용하면 결과를 특정 위반 유형으로 제한할 수 있습니다.
• 이 설정은 ueba_offense=true UEBA 관련 위반 사항만 반환합니다.
• 필터 매개변수를 조합하여 검색 결과를 더욱 세밀하게 조정할 수 있습니다.

응답

이 API는 다음과 같은 정보가 포함된 위반 내역 목록을 반환합니다:

• 공격 식별자
• 설명
• 오펜스 유형
• 심각도
• 위험지표
• 시작 시간
• 마지막으로 업데이트된 시간입니다.
• 현재 상태

응답 예시

{
  "offenses": [
    {
      "id": 12345,
      "description": "Multiple failed authentication attempts",
      "offense_type": "security",
      "severity": 7,
      "magnitude": 8,
      "start_time": "2026-06-15T10:15:00Z",
      "last_updated_time": "2026-06-15T11:30:00Z",
      "status": "OPEN"
    }
  ]
}

오류 처리