日本語

Coralogix

この SIEM コネクタは現在、リクエストに応じて利用可能です。 サポートまでお問い合わせください ワークスペースで有効化してもらうために。

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

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

要件

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

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

Coralogix への接続

  1. Coralogix の認証情報を取得する

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

  2. 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 に到達できることを確認し、次に 変更を保存.

  3. 同期する問題を設定

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

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

    クリックします 設定を保存.

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

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 に送信されたデータは削除されません。