Sekoia.ioのイベント検索APIを3つのステップで使用します。クエリと時間枠を指定して検索ジョブを作成(POST /v1/sic/conf/events/search/jobs)、ジョブが完了するまで待ち、その後に1,000件までのページ単位でイベントを読みます。 イベントをエクスポート イベントページのボタンも使用できますが、500件で止まります。大容量の場合、Sekoiaは大規模エクスポートAPIと独自のsekoia-event-exporterツールを提供しています。
Sekoia.ioはヨーロッパのSOCプラットフォームで、そのイベントストアは調査中にユーザーが最初に見る場所です。Prime Coreには676のMITRE ATT&CK技術にマッピングされた23,983の検出ルールがあります。以下はイベントを取得し、それらをサニタイズしてLogTotalで無料で調査する方法です。
始める前に
APIキー。 Sekoia.ioでイベントを検索する権限を持ったAPIキーを作成します。検索には読み取り専用で十分ですが、大規模エクスポートにはSIC_MASSIVE_EXPORT_EVENTSの権限が必要です。
あなたの地域のAPIホスト。 デフォルトはhttps://api.sekoia.ioです。他の地域には独自のホストがあります。例えば、https://api.usa1.sekoia.io。
クエリ言語。 APIはイベントページと同じクエリを受け付けます。以下の例はクラシックな「dork」構文(term_lang: dork)を使用しています。まずUIでクエリを構築してテストしてください。
イベント検索APIでエクスポート
API="https://api.sekoia.io/v1"
H="Authorization: Bearer $SEKOIA_API_KEY"
# 1. 検索ジョブを作成
JOB=$(curl -sS -X POST "$API/sic/conf/events/search/jobs" -H "$H" -H 'Content-Type: application/json'
-d '{"term": "host.name:"web-03"", "earliest_time": "2026-10-19T00:00:00Z", "latest_time": "2026-10-20T00:00:00Z", "term_lang": "dork"}'
| jq -r '.uuid')
# 2. ジョブが完了するまで待つ(ステータス2)
until [ "$(curl -sS -H "$H" "$API/sic/conf/events/search/jobs/$JOB" | jq -r '.status')" = "2" ]; do sleep 3; done
# 3. イベントを1,000件ずつ読む
TOTAL=$(curl -sS -H "$H" "$API/sic/conf/events/search/jobs/$JOB" | jq '.total')
for ((off=0; off
curl -sS -H "$H" "$API/sic/conf/events/search/jobs/$JOB/events?limit=1000&offset=$off" | jq -c '.items[]'
done > sekoia_web03_1019.jsonl
イベントは最新のものから返ってきます。失敗したジョブはステータス2に達しないため、定期使用のためにスクリプトを記述する場合はタイムアウトを追加してください。
大容量エクスポートの場合、完了したジョブで大規模エクスポートを開始(POST /v1/sic/conf/events/search/jobs/
LogTotalでのアップロード、サニタイズ、およびレビュー
- アップロード。 開く logtotal.com そしてファイルをドロップインします。
- サニタイズ。
- レビュー。
問題が発生したとき
| 症状 | 考えられる原因 | Fix |
|---|---|---|
| UIエクスポートが500件で止まる | UIエクスポート制限 | APIまたは大規模エクスポートを使用 |
| 401または403 | キーがない、または検索権限がない | キーの役割を確認 |
| 有効なキーからのエラー | 地域のホストが間違っている | 地域のAPIホストを使用 |
| 待機ループが終わらない | ジョブが失敗したかキャンセルされた | ジョブステータスを確認し、クエリを絞り込む |
| 最新のイベントのみ | オフセットページングが追従されていない | 合計までオフセットでページを通過する |
FAQ
DorkまたはSekoia Operating Language?
両方とも存在します。SekoiaのクイックスタートのAPI例はdorkを使用しています。APIキーとエンドポイントで受け入れ可能なクエリ言語を確認してください。
アラートの後ろのイベントをエクスポートできますか?
はい:アラートのフィルターでイベント検索を実行し、上記と同様にエクスポートします。