# RunReveal

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

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

チームがすでに RunReveal を SIEM として使用しており、Aikido の検出結果をインフラ、アプリケーション、監査シグナルと相関分析するための単一の場所がほしい場合に便利です。

### 要件

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

* **Webhook ID** － RunReveal の Generic Webhook または Structured Webhook ソースから取得します。
* **ベアラートークン** － Structured Webhook ソースを使用している場合、または Generic Webhook ソースで認証が有効になっている場合に必要です。

### RunReveal に接続する

{% stepper %}
{% step %}

#### RunReveal の Webhook 詳細を取得する

1. RunReveal ポータルで、次へ移動します： **Sources > New Source** を選択します **Generic Webhook** または **Structured Webhook**.

{% hint style="warning" %}
を選択した場合、 **Structured Webhook**Aikido が送信するすべてのレコードは RunReveal の [Structured Webhooks API スキーマ](https://docs.runreveal.com/sources/source-types/structured-webhooks#structured-webhooks-api)に一致している必要があります。一致しないレコードは RunReveal 側で拒否されます。よくわからない場合は **Generic Webhook**を使用してください。任意の JSON ペイロードを受け入れます。
{% endhint %}

2. ソースに名前を付け（例： `Aikido`）、保存します。
3. 次をコピーします： **Webhook ID**、URL 全体ではなく ID のみ（RunReveal に表示される URL の末尾部分）をコピーしてください。
4. 次をコピーします： **ベアラートークン**。これは Structured Webhooks では必須で、ソースで認証を有効にしていない限り Generic Webhooks では任意です。
{% endstep %}

{% step %}

#### SIEM を接続する

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

**設定**

* **Webhook ID** － RunReveal の Webhook ID。RunReveal の UI に表示される完全な URL ではなく、ID のみを貼り付けてください。

**オプション** *（任意。適切な既定値が事前入力されています）*

* **バッチデータサイズ** － 送信前にバッチ内のレコードの合計サイズの上限（バイト）。既定値 `1048576` （1 MiB）。
* **バッチレコード数** － 送信前に蓄積するレコード数の上限。既定値 `100`.
* **最大フラッシュ間隔** － 送信前にレコードを保持する最大時間（秒）。既定値 `5`.

この 3 つの制限のうち最初に到達したものが送信をトリガーします。

**認証**

* **ベアラートークン** － この Webhook ソース用に RunReveal が発行したベアラートークン。ソースで認証が無効な場合は空欄のままにしてください。

クリックします **接続をテスト**、その後 **変更を保存**.
{% endstep %}

{% step %}

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

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

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

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

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

{% hint style="warning" %}
RunReveal の webhook エンドポイントは、誤ったまたは存在しない Webhook ID、無効なトークン、空のペイロードを含むほぼすべてのリクエストに対して成功レスポンスを返します。 **接続テストに成功したことや、問題が同期されているように見えることは、データが実際に RunReveal に到達したことを確認するものではありません。** 必ず RunReveal ポータル内で確認してください。
{% endhint %}

RunReveal ポータルで、次を検索します： `ログ` で絞り込むテーブル `sourceType = 'webhook'` およびソース名で、レコードが到着していることを確認します。取り込みエラー（Structured Webhook のスキーマ不一致を含む）を確認するには、RunReveal の [ソースエラーページ](https://app.runreveal.com/dash/sources/errors) に移動し、ソースの種類と名前を選択します。

### 統合の管理

次から： **Settings > Integrations > RunReveal** Aikido で、次のことができます：

* **統合を管理** － Webhook ID、バッチ設定、またはベアラートークンを更新します。
* **統合を削除** － RunReveal の接続を解除します。これにより今後の同期はすべて停止しますが、すでに RunReveal に送信されたデータは削除されません。