SIEM フィールドリファレンス
このページでは、接続された SIEM に送信される際に、各 Aikido の課題および各アクティビティログエントリに含まれるフィールドについて説明します。
特定の SIEM を接続する方法については、SIEM Connectors を参照してください。
ペイロード形式
各同期では JSON 配列が送信され、課題の入力設定に一致する課題ごとに 1 つのオブジェクトが含まれます。アクティビティログを有効にしている場合、各同期では新しいアクティビティログエントリごとに 1 つのオブジェクトも送信されます。フィールドはすべての SIEM コネクターで共通です。
アクティビティログエントリでは data_type が activity_log に設定されています。課題オブジェクトには data_type フィールドがないため、SIEM でこのフィールドを使って両者を区別してください。アクティビティログのフィールドについては、アクティビティログのフィールドを参照してください。
コアフィールド
| フィールド | 型 | 説明 |
|---|---|---|
id | integer | 個々の課題の ID。 |
group_id | integer | この課題が属する課題グループの ID。Aikido は、同じ根本的な課題に関連する発生をまとめてグループ化します。 |
attack_surface | string | frontend、backend、docker_container、cloud、cloud_instance のいずれか。 |
status | string | open、ignored、snoozed、closed のいずれか。 |
severity | string | critical、high、medium、low のいずれか。 |
severity_score | integer | 課題に対する Aikido の優先度スコア（1 から 100）。 |
type | string | open_source、leaked_secret、cloud、cloud_instance、docker_container、iac、sast、surface_monitoring、malware、eol、scm_security、ai_pentest、ai_code_analysis、mobile、license のいずれか。 |
rule | string または null | SAST、IaC、クラウド、サーフェスモニタリングの課題におけるルールのタイトル。その他の種類では null。 |
programming_language | string または null | 影響を受けるファイルパスから検出されます（例: JS、PHP、PY、Java）。 |
how_to_fix | string または null | 利用可能な場合、課題に対する Aikido の修正ガイダンス。 |
脆弱性フィールド
| フィールド | 型 | 説明 |
|---|---|---|
cve_id | string または null | CVE ID。公開 CVE が存在しない場合は、Aikido の内部 CVE ID（例: AIKIDO-2020-123）。 |
cve_id_alias | string または null | cve_id が Aikido の内部 CVE ID である場合の、関連する公開 CVE。 |
affected_package | string または null | 影響を受けるパッケージ名（存在する場合）。 |
affected_file | string または null | 影響を受けるファイルまたはターゲットのパス（存在する場合）。 |
ロケーションフィールド
課題が検出された場所に対応するフィールドグループのみが設定され、それ以外は null になります。
| フィールド | 型 | 説明 |
|---|---|---|
code_repo_id, code_repo_name | integer または null、string または null | ソースコードの課題におけるコードリポジトリ。 |
container_repo_id, container_repo_name | integer または null、string または null | コンテナの課題におけるコンテナリポジトリ。 |
cloud_id, cloud_name | integer または null、string または null | クラウドの課題におけるクラウドアカウント。 |
domain_id, domain_name | integer または null、string または null | サーフェスモニタリングの課題におけるドメイン。 |
virtual_machine_id, virtual_machine_name | integer または null、string または null | VM の課題における VM。 |
ステータスとタイミングのフィールド
| フィールド | 型 | 説明 |
|---|---|---|
first_detected_at | unix タイムスタンプ | 課題が最初に作成された日時。 |
ignored_at | unix タイムスタンプまたは null | 課題が無視された日時（無視されている場合）。 |
closed_at | unix タイムスタンプまたは null | 課題がクローズされた日時（クローズされている場合）。 |
sla_remediate_by | unix タイムスタンプまたは null | 修正の SLA 期限（適用される場合）。 |
snooze_until | unix タイムスタンプまたは null | 課題がスヌーズされている場合、スヌーズが期限切れになる日時。 |
snooze_reason | string | 課題がスヌーズされている理由。スヌーズされていない場合は空文字列。 |
ignore_reasons | array | 課題が無視されている理由。無視されていない場合は空配列。各エントリには kind（manual_ignore、auto_ignore、rule_ignore、api_ignore のいずれか）と、人が読める形式の reason が含まれます。 |
課題タイプのメタデータ
issue_type_metadata は一部の課題タイプにのみ含まれるオブジェクトで、課題の type に対応する以下のキーのうち最大 1 つが設定されます。
| キー | フィールド |
|---|---|
sast | start_line, end_line |
cloud | resource_id, resource_name, resource_kind |
surface_monitoring | cve_id, package_name, package_version, evidence, evidence_description, domain_target_url |
open_source | installed_version, patched_versions（array） |
eol | eol_since（unix タイムスタンプまたは null）、affected_version |
leaked_secret | commit, line |
例
[
{
"id": 1,
"group_id": 1,
"attack_surface": "backend",
"status": "open",
"severity": "critical",
"severity_score": 90,
"type": "open_source",
"rule": null,
"cve_id": "AIKIDO-2020-123",
"cve_id_alias": "CVE-2020-7598",
"affected_package": "minimist",
"affected_file": "package-lock.json",
"first_detected_at": 1700489005,
"code_repo_id": 1,
"code_repo_name": "test-service",
"container_repo_id": null,
"container_repo_name": null,
"cloud_id": null,
"cloud_name": null,
"domain_id": null,
"domain_name": null,
"virtual_machine_id": null,
"virtual_machine_name": null,
"ignored_at": null,
"closed_at": null,
"sla_remediate_by": 1700924603,
"snooze_until": null,
"snooze_reason": "",
"ignore_reasons": [],
"issue_type_metadata": {
"open_source": {
"installed_version": "4.2.0",
"patched_versions": ["4.2.6"]
}
},
"how_to_fix": "Upgrade package minimist to 4.2.6 or later.",
"programming_language": "JS"
}
]アクティビティログのフィールド
各アクティビティログエントリは、課題の無視や設定の変更など、Aikido の課題または設定に対して実行されたアクションを記録します。Aikido は新しいエントリを発生順に送信し、すでに送信済みのエントリは再送信しません。
| フィールド | 型 | 説明 |
|---|---|---|
data_type | string | 常に activity_log。 |
id | integer | アクティビティログエントリの ID。 |
timestamp | unix タイムスタンプ | アクションが発生した日時。 |
comment | string | アクションの人が読める形式の説明。 |
source | string | アクションをトリガーしたもの。manual、checklist、rule、auto、api のいずれか。 |
action | string | 実行されたアクション（例: ignored、snoozed、closed、re_open、autofix_pr_created）。 |
user_id | integer または null | アクションを実行したユーザーの ID。source が auto または api の場合は null。 |
user_name | string または null | アクションを実行したユーザーの名前。source が auto または api の場合は null。 |
issue_id | integer | アクションが適用される個々の課題の ID。 |
grouped_issue_id | integer | アクションが適用される課題グループの ID。 |
アクティビティログのアクション
action は以下のいずれかです。
| カテゴリ | 値 |
|---|---|
| 課題のステータス | snoozed, unsnoozed, ignored, auto_ignored, closed, re_open, adjust_severity, sla_dates_reset |
| 課題の修正 | autofix_pr_created, overwrite_license_type, license_score_contested |
| コンプライアンスへのプッシュ | drata_push, sprinto_push, thoropass_push |
| エクスポート | issues_exported, subdomains_exported |
| リポジトリとコンテナ | repo_activated, repo_deactivated, container_activated, container_deactivated, container_registry_activated, container_registry_deactivated |
| 設定 | autofix_settings_changed, autoship_settings_changed, autodeploy_repo_settings_changed, autodeploy_global_settings_changed, spending_limit_changed |
| AI ペンテスト | pentest_paused, pentest_resumed |
| コード品質 | code_quality_finding_ignored, code_quality_finding_unignored |
| エンドポイント保護 | protection_paused, protection_paused_all_devices, protection_resumed_all_devices |
アクティビティログの例
[
{
"data_type": "activity_log",
"id": 42,
"timestamp": 1713586140,
"comment": "Rick Astley manually ignored this issue",
"source": "manual",
"action": "ignored",
"user_id": 1,
"user_name": "Rick Astley",
"issue_id": 10,
"grouped_issue_id": 3
}
]