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

エラー処理