Sekoia.io 이벤트 검색 API 를 세 단계로 사용하세요. 쿼리와 시간 창으로 검색 작업을 생성하세요 (POST /v1/sic/conf/events/search/jobs), 작업이 완료될 때까지 기다렸다가 최대 1,000 개씩 페이지로 이벤트를 읽으세요. 이벤트 내보내기 이벤트 페이지의 버튼도 작동하지만 500 개 이벤트에서 멈춥니다. 대량을 다룰 때는 Sekoia 가 대량 내보내기 API 와 Sekoia 고유의 sekoia-event-exporter 도구를 제공합니다.
Sekoia.io 는 유럽의 SOC 플랫폼이며, 이 플랫폼의 이벤트 저장소는 사용자가 조사를 시작할 때 자주 처음 확인하는 곳입니다. Prime Core 에는 23,983 개의 탐지 규칙이 있으며, 676 MITRE ATT&CK 기법에 매핑되어 있습니다. 아래는 이벤트를 추출하고, 정리하며 LogTotal 에서 무료로 조사하는 방법입니다.
시작 전에
API 키 Sekoia.io 에서 이벤트 검색 권한으로 하나 생성하세요. 읽기 전용 상태는 검색에 충분하고, 대량 내보내기에는 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 운영 언어?
둘 다 존재합니다. Sekoia의 QuickStart API 예제는 dork를 사용하므로, API 키와 엔드포인트가 어떤 쿼리 언어를 수용하는지 확인하세요.
경고 뒤에 있는 이벤트를 내보낼 수 있습니까?
예: 필터를 사용하여 경고에 대한 이벤트 검색을 실행한 다음 위의 방법대로 내보내세요.