> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/sonono/siem-connectors/siem-field-reference.md).

# SIEM フィールドリファレンス

このページでは、接続済みの SIEM に送信されるときに、各 Aikido の issue と各アクティビティログエントリに含まれるフィールドについて説明します。

特定の SIEM の接続方法については、こちらを参照してください [SIEM コネクタ](/docs/docs-ja/sonono/siem-connectors.md).

### ペイロード形式

各同期では、あなたの [issue の入力設定](/docs/docs-ja/sonono/siem-connectors.md)。アクティビティログを有効にすると、各同期で新しいアクティビティログエントリごとに 1 つのオブジェクトも送信されます。フィールドはすべての SIEM コネクタで共通です。

アクティビティログエントリには `data_type` が `activity_log`。issue オブジェクトには `data_type` フィールドがないため、SIEM で両者を区別するために使ってください。アクティビティログのフィールドについては、 [アクティビティログのフィールド](#activity-log-fields).

### 基本フィールド

| フィールド                  | 種類          | 説明                                                                                                                                                                                                                   |
| ---------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                   | 整数          | 各 issue の個別 ID です。                                                                                                                                                                                                   |
| `group_id`             | 整数          | この issue が属する issue グループの ID です。Aikido は、同じ根本原因を持つ関連する発生をまとめます。                                                                                                                                                      |
| `attack_surface`       | 文字列         | 以下のいずれか `frontend`, `backend`, `docker_container`, `cloud`, `cloud_instance`.                                                                                                                                        |
| `status`               | 文字列         | 以下のいずれか `open`, `ignored`, `snoozed`, `closed`.                                                                                                                                                                      |
| `severity`             | 文字列         | 以下のいずれか `critical`, `high`, `medium`, `low`.                                                                                                                                                                         |
| `severity_score`       | 整数          | この issue に対する Aikido の優先度スコアです。1 〜 100 の範囲です。                                                                                                                                                                        |
| `type`                 | 文字列         | 以下のいずれか `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`                 | 文字列または null | SAST、IaC、クラウド、および surface monitoring の issue に対するルールのタイトルです。その他の種類では null です。                                                                                                                                        |
| `programming_language` | 文字列または null | 影響を受けたファイルパスから検出されます。たとえば `JS`, `PHP`, `PY`, `Java`.                                                                                                                                                                 |
| `how_to_fix`           | 文字列または null | 利用可能な場合、この issue に対する Aikido の修復ガイダンスです。                                                                                                                                                                             |

### 脆弱性フィールド

| フィールド              | 種類          | 説明                                                                   |
| ------------------ | ----------- | -------------------------------------------------------------------- |
| `cve_id`           | 文字列または null | CVE ID、または Aikido の内部 CVE ID（たとえば `AIKIDO-2020-123`）公開 CVE が存在しない場合。 |
| `cve_id_alias`     | 文字列または null | 関連する公開 CVE。次の場合 `cve_id` が内部 Aikido CVE ID です。                       |
| `affected_package` | 文字列または null | 該当する場合、影響を受けるパッケージ名です。                                               |
| `affected_file`    | 文字列または null | 該当する場合、影響を受けるファイルまたは対象パスです。                                          |

### 場所フィールド

issue が見つかった場所に一致するフィールドグループのみが設定され、その他は null です。

| フィールド                                        | 種類                     | 説明                                 |
| -------------------------------------------- | ---------------------- | ---------------------------------- |
| `code_repo_id`, `code_repo_name`             | 整数または null、文字列または null | ソースコード issue 用のコードリポジトリです。         |
| `container_repo_id`, `container_repo_name`   | 整数または null、文字列または null | コンテナー issue 用のコンテナリポジトリです。         |
| `cloud_id`, `cloud_name`                     | 整数または null、文字列または null | クラウド issue 用のクラウドアカウントです。          |
| `domain_id`, `domain_name`                   | 整数または null、文字列または null | surface monitoring issue 用のドメインです。 |
| `virtual_machine_id`, `virtual_machine_name` | 整数または null、文字列または null | VM issue 用の仮想マシンです。                |

### ステータスと時刻のフィールド

| フィールド               | 種類                   | 説明                                                                                                                                   |
| ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `first_detected_at` | UNIX タイムスタンプ         | issue が最初に作成された時刻です。                                                                                                                 |
| `ignored_at`        | UNIX タイムスタンプまたは null | issue が無視された時刻です。無視されている場合。                                                                                                          |
| `closed_at`         | UNIX タイムスタンプまたは null | issue がクローズされた時刻です。クローズされている場合。                                                                                                      |
| `sla_remediate_by`  | UNIX タイムスタンプまたは null | 該当する場合、修復の SLA 期限です。                                                                                                                 |
| `snooze_until`      | UNIX タイムスタンプまたは null | issue がスヌーズされている場合、スヌーズの期限が切れる時刻です。                                                                                                  |
| `snooze_reason`     | 文字列                  | issue がスヌーズされている理由です。スヌーズされていない場合は空文字列です。                                                                                            |
| `ignore_reasons`    | 配列                   | issue が無視されている理由です。無視されていない場合は空配列です。各エントリには `kind` (`manual_ignore`, `auto_ignore`, `rule_ignore`、または `api_ignore`と、人間が読める `reason`. |

### issue 種別メタデータ

`issue_type_metadata` 一部の issue 種別にのみ含まれるオブジェクトで、以下のキーのうち最大 1 つが設定されます。issue の `type`:

| キー                   | フィールド                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| `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` （配列）                                                         |
| `eol`                | `eol_since` （UNIX タイムスタンプまたは null）、 `affected_version`                                               |
| `leaked_secret`      | `commit`, `line`                                                                                     |

### 例

```json
[
  {
    "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": "パッケージ minimist を 4.2.6 以降にアップグレードしてください。",
    "programming_language": "JS"
  }
]
```

## アクティビティログのフィールド

各アクティビティログエントリは、Aikido で issue を無視したり設定を変更したりするなど、issue や設定に対して行われた操作を記録します。Aikido は発生順に新しいエントリを送信し、既に送信済みのエントリは再送しません。

| フィールド              | 種類           | 説明                                                                               |
| ------------------ | ------------ | -------------------------------------------------------------------------------- |
| `data_type`        | 文字列          | 常に `activity_log`.                                                               |
| `id`               | 整数           | アクティビティログエントリの ID。                                                               |
| `timestamp`        | UNIX タイムスタンプ | 操作が発生した日時。                                                                       |
| `comment`          | 文字列          | 操作の人間が読める説明。                                                                     |
| `ソース`              | 文字列          | 操作のきっかけ。次のいずれか: `manual`, `checklist`, `rule`, `auto`, `api`.                    |
| `action`           | 文字列          | 実行された操作。たとえば `ignored`, `snoozed`, `closed`, `re_open`、または `autofix_pr_created`. |
| `user_id`          | 整数または null   | 操作を行ったユーザーの ID。次の場合は Null: `ソース` は `auto` または `api`.                             |
| `user_name`        | 文字列または null  | 操作を行ったユーザーの名前。次の場合は Null: `ソース` は `auto` または `api`.                              |
| `issue_id`         | 整数           | この操作が適用される個別 issue の ID。                                                         |
| `grouped_issue_id` | 整数           | この操作が適用される issue グループの ID。                                                       |

### アクティビティログの操作

`action` は次のいずれかです:

| カテゴリ       | 値                                                                                                                                                           |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 問題のステータス   | `snoozed`, `unsnoozed`, `ignored`, `auto_ignored`, `closed`, `re_open`, `adjust_severity`, `sla_dates_reset`                                                |
| Issue の修復  | `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`                                                                      |

### アクティビティログの例

```json
[
  {
    "data_type": "activity_log",
    "id": 42,
    "timestamp": 1713586140,
    "comment": "Rick Astley は手動でこの issue を無視しました",
    "source": "manual",
    "action": "ignored",
    "user_id": 1,
    "user_name": "Rick Astley",
    "issue_id": 10,
    "grouped_issue_id": 3
  }
]
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.aikido.dev/docs/docs-ja/sonono/siem-connectors/siem-field-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.