# Coralogix

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

Aikido の問題を Coralogix に送信して一元監視し、セキュリティの検出結果を他のオブザーバビリティデータとあわせて検索できるようにします。

チームがすでに Coralogix を使っていて、Aikido の検出結果をインフラ、アプリケーション、監査シグナルと相関付ける単一の場所が欲しい場合に便利です。

### 要件

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

* **リージョン** - アカウントがプロビジョニングされている Coralogix のリージョン（`us1`, `us2`, `us3`, `eu1`, `eu2`, `ap1`, `ap2`、または `ap3`）。これは、データの送信先となるリージョナルエンドポイントを決定するため、アカウントと一致している必要があります。
* **Send-Your-Data API キー** - Coralogix アカウントから取得します。
* **アプリケーション名とサブシステム名** - Coralogix が受信データを整理するために使用するラベルです。

### Coralogix への接続

{% stepper %}
{% step %}

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

1. Coralogix にサインインし、アカウント URL を次と照合してください [Coralogix のエンドポイント一覧](https://coralogix.com/docs/integrations/coralogix-endpoints/) で確認してください **リージョン**.
2. Coralogix で次へ移動します **設定 > API キー** に移動し、 **キーを追加**.
3. 選択します **Send Your Data キー**に名前（例: 「Aikido」）を付けて、作成します。
4. キーはすぐにコピーしてください。Coralogix では 1 回しか表示されません。
{% endstep %}

{% step %}

#### SIEM を接続する

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

**設定**

* **リージョン** - アカウントがプロビジョニングされている Coralogix のリージョン。既定値は `us1`.
* **アプリケーション名** - 各レコードに付与されます。Coralogix はこれを使って環境やテナントを分離します。例: `aikido`.
* **サブシステム名** - 各レコードに付与されます。Coralogix はこれを使って、アプリケーション内のコンポーネントを分離します。例: `prod`.
* **通信タイプ** - Coralogix に到達するために使用するトランスポート。現在は **REST（Send-Your-Data）** のみサポートされています。
* **Send-Your-Data API キー** - Coralogix で生成したキー。

**オプション**

* **タイムスタンプのレコード位置** *（任意）* - 受信データ内のタイムスタンプフィールドを指す JSONPath または gjson パス（例: `$.timestamp`）。空欄にすると、送信時刻で各レコードに付与されます。
* **バッチ設定** - 送信前のデータのバッチ方法を制御します:
  * **バッチデータサイズ** - 送信前のバッチの最大合計サイズ（バイト）。既定値は Coralogix の 1 リクエストあたり 2 MB の制限を下回るようになっています。
  * **バッチレコード数** - バッチが自動送信される前に蓄積するレコードの最大数。
  * **最大フラッシュ間隔** - サイズや件数に関係なく、送信前にレコードを保持する最大時間（秒）。

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

{% step %}

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

Coralogix の連携ページで、以下の項目の下に **Issue 入力設定**、同期するAikidoの問題を設定します：

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

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

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

Coralogix で、次の項目の下のレコードを検索します **アプリケーション名** と **サブシステム名** 設定した内容。設定した同期頻度が経過するのを待つか、Aikido でテスト問題を発生させて、表示されることを確認します。

### 制限事項

* 2 MB を超えるリクエストは Coralogix によって拒否されます。既定のバッチサイズはこれを下回りますが、増やすと `413` エラーが発生する可能性があります。
* **アプリケーション名** と **サブシステム名** は接続全体で固定されるため、問題ごとに変えることはできません。
* REST（Send-Your-Data）トランスポートのみサポートされています。
* 30 秒以内に完了しないリクエストは失敗として扱われ、再試行されます。

### トラブルシューティング

* **接続拒否またはタイムアウト** - 確認してください **リージョン** が、実際に Coralogix アカウントがプロビジョニングされているリージョンと一致していること。誤ったリージョンはタイムアウトや `401`/`403` エラーが発生する可能性があります。
* **`401` / `403` エラーの原因になります** - Send-Your-Data API キーを再生成し、次の権限があることを確認してください `SendData` 権限。キーはリージョン単位で管理されるため、別の Coralogix アカウントやリージョンのキーは使えません。
* **`413 ペイロードが大きすぎます`** - 減らしてください **バッチデータサイズ** 。これにより、バッチが Coralogix の 2 MB リクエスト上限を下回ります。
* **`429 リクエストが多すぎます`** - Coralogix がアカウントにレート制限をかけています。同期頻度を下げるか、Coralogix に連絡して取り込み上限を引き上げてもらってください。
* **レコードの時刻が正しくありません** - 次を設定してください **タイムスタンプのレコード位置** イベント時刻を持つフィールドに。
* **レコードが誤ったアプリまたはサブシステムの下に表示される** - 次を再確認してください **アプリケーション名** と **サブシステム名**。どちらも各レコードにそのまま付与されます。

### 統合の管理

次から： **設定 > 連携 > Coralogix** Aikido で、次のことができます：

* **統合を管理** - リージョン、アプリケーション/サブシステム名、バッチ設定、または API キーを更新してください。
* **統合を削除** - Coralogix の接続を解除します。これにより今後の同期は停止しますが、すでに Coralogix に送信されたデータは削除されません。