# Elasticsearch

{% hint style="info" %}
この SIEM コネクタは現在、リクエストに応じて利用可能です。 [サポートまでお問い合わせください](https://www.aikido.dev/contact) ワークスペースで有効化してもらうために。
{% endhint %}

Aikidoの課題をElasticsearchに送信して一元監視し、セキュリティ上の検出結果を他のログと並べて検索できるようにします。

チームがすでにElasticsearch（またはElastic Cloud）をSIEMとして使用しており、Aikidoの検出結果をインフラ、アプリケーション、監査のシグナルと相関させるための一元的な場所を求めている場合に便利です。

### 要件

接続する前に、Elasticから次の情報を取得してください:

* **ユーザー名とインデックス名** - 常に必要です。
* **認証** - いずれかの **APIキー**、または **パスワード** 上記のユーザー名用の
* **接続詳細** - 直接の **URL** あなたのElasticsearchクラスターへの、または **Cloud ID** Elastic Cloudを利用している場合。

接続時には、最後の2つのグループからそれぞれ1つずつ選ぶため、4通りの組み合わせがあります（例: URL + APIキー、またはCloud ID + パスワード）。

### Elasticsearchの接続

{% stepper %}
{% step %}

#### Elasticsearchの認証情報を取得する

あなたの〜にログインしてください [Elastic Cloudコンソール](https://cloud.elastic.co/home) そして、使用予定の接続タイプに必要な詳細を集めてください:

* **URL** - デプロイメントの概要からElasticsearchのエンドポイントURLを確認します。
* **Cloud ID** - Elastic Cloud経由で接続する場合は、デプロイメントの概要ページでこれを確認します。
* **APIキー** - 次から1つ生成します: **Stack Management > API Keys**.
* **ユーザー名とパスワード** - 既存のユーザーを使用するか、インデックスに書き込む権限を持つユーザーを作成します。
* **インデックス名** - Aikidoが書き込む対象のインデックスです。まだ存在しない場合、最初にデータが送信されたときにElasticsearchが自動的に作成します。
{% endstep %}

{% step %}

#### SIEM を接続する

次へ移動します： **Settings > Integrations** Aikido アプリで、新しい SIEM 統合を追加します。 **SIEM を接続する** ダイアログで次を選択します： **Elasticsearch** を選択して、次を入力します：

**設定**

* **ユーザー名** - Elasticsearchクラスターへの認証に使用するユーザー名です。
* **インデックス名** - データを書き込むインデックスです。存在しない場合は自動的に作成されます。
* **認証タイプ** - 認証方法を選択してください:
  * **APIキー** - 次を入力してください: **APIキー**.
  * **パスワード** - 次を入力してください: **パスワード** 上記のユーザー名用の
* **接続タイプ** - 接続方法を選択してください:
  * **URL** - 直接のものを入力してください **URL** あなたのElasticsearchクラスターの
  * **Cloud ID** - Elastic Cloudデプロイメントの〜を入力してください **Cloud ID**.

**オプション**

* **証明書検証をスキップ（安全でない）** - サーバーのTLS証明書の検証をスキップします。安全ではないため、テスト目的のみで使用してください。

クリックします **接続をテスト** AikidoがElasticsearchに到達できることを確認し、次に **変更を保存**.
{% endstep %}

{% step %}

#### 同期する問題を設定

Elasticsearch統合ページの、〜の下で **Issue 入力設定**で、どの Aikido の問題を SIEM に同期するかを設定します：

* **問題のステータス** － たとえば、未解決の問題のみを同期するか、解決済みや無視された問題も含めるかを選択します。
* **最小重大度** － 同期する最小の重大度レベル。
* **問題の種類** － 特定の問題タイプに限定するか、すべてを同期します。
* **Language** － 特定の言語に限定するか、すべてを同期します。
* **同期頻度** - Aikidoが一致する問題をElasticsearchに送信する頻度（例: 1時間ごと）。

クリックします **設定を保存**.
{% endstep %}
{% endstepper %}

### イベントが届いていることを確認する

Kibana（またはElasticsearchを直接クエリする方法）で、設定したインデックスを検索します。設定した同期頻度の時間が経過するまで待つか、Aikidoでテスト用の問題を発生させ、インデックスに新しいドキュメントとして表示されることを確認してください。

### 統合の管理

次から： **設定 > 統合 > Elasticsearch** Aikido で、次のことができます：

* **統合を管理** - ユーザー名、インデックス、認証、または接続詳細を更新します。
* **統合を削除** - Elasticsearchの接続を解除します。これにより今後の同期はすべて停止しますが、すでにElasticsearchに送信されたドキュメントは削除されません。