Użyj API wyszukiwania zdarzeń Sekoia.io w trzech krokach. Utwórz zadanie wyszukiwania (POST /v1/sic/conf/events/search/jobs) z zapytaniem i przedziałem czasowym, poczekaj, aż zadanie zostanie zakończone, a następnie odczytaj jego zdarzenia w stronach do 1 000. Funkcja Eksportuj zdarzenia Przycisk na stronie Zdarzenia działa również, ale zatrzymuje się na 500 zdarzeniach. W przypadku dużych wolumenów Sekoia oferuje API masowego eksportu oraz własne narzędzie sekoia-event-exporter.
Sekoia.io to europejska platforma SOC, a jej magazyn zdarzeń często jest pierwszym miejscem, do którego użytkownicy zaglądają podczas śledztwa. Prime Core ma 23 983 reguły wykrywania, zmapowane do 676 technik MITRE ATT&CK. Poniżej opisano, jak pobrać zdarzenia, zanonimizować je i zbadać za darmo w LogTotal.
Zanim zaczniesz
Klucz API. Utwórz jeden w Sekoia.io z uprawnieniami do wyszukiwania zdarzeń. Dla wyszukiwania wystarczy uprawnienie tylko do odczytu; masowy eksport wymaga uprawnienia SIC_MASSIVE_EXPORT_EVENTS.
API host twojego regionu. Domyślnie to https://api.sekoia.io. Inne regiony mają własne hosty, na przykład https://api.usa1.sekoia.io.
Język zapytań. API akceptuje te same zapytania co strona Zdarzenia. Poniższe przykłady używają klasycznej składni „dork” (term_lang: dork). Najpierw zbuduj i przetestuj zapytanie w interfejsie użytkownika.
Eksport za pomocą API wyszukiwania zdarzeń
API="https://api.sekoia.io/v1"
H="Authorization: Bearer $SEKOIA_API_KEY"
# 1. Utwórz zadanie wyszukiwania
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. czekaj, aż zadanie zostanie zakończone (status 2)
until [ "$(curl -sS -H "$H" "$API/sic/conf/events/search/jobs/$JOB" | jq -r '.status')" = "2" ]; do sleep 3; done
# 3. odczytaj zdarzenia, 1000 na raz
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
Zdarzenia wracają od najnowszych. Zadanie, które się nie powiedzie, nigdy nie osiąga statusu 2, więc dodaj limit czasu, jeśli piszesz skrypt do regularnego używania.
W przypadku dużych eksportów, rozpocznij masowy eksport na zakończonym zadaniu (POST /v1/sic/conf/events/search/jobs/
Prześlij, zanonimizuj i przejrzyj w LogTotal
- Prześlij. Otwórz logtotal.com i wrzuć plik.
- Zanonimizuj.
- Przejrzyj.
Kiedy coś pójdzie nie tak
| Objaw | Prawdopodobna przyczyna | Fix |
|---|---|---|
| Eksport z UI zatrzymuje się na 500 zdarzeniach | Limit eksportu UI | Użyj API lub masowego eksportu |
| 401 lub 403 | Brak klucza lub brak uprawnień do wyszukiwania | Sprawdź rolę klucza |
| Błędy z ważnego klucza | Nieprawidłowy host regionalny | Użyj API hosta Twojego regionu |
| Pętla oczekiwania nigdy się nie kończy | Zadanie nie powiodło się lub zostało anulowane | Sprawdź status zadania; zawęź zapytanie |
| Tylko najnowsze zdarzenia | Offsetowe stronicowanie nie zostało śledzone | Przeglądaj ze stronicowaniem offsetowym do całkowitej liczby |
FAQ
Dork czy Sekoia Operating Language?
Oba istnieją. Przykłady API w szybkiej konfiguracji Sekoia używają dork; sprawdź, które języki zapytań akceptuje Twoje API i punkt dostępowy.
Czy mogę eksportować zdarzenia za alertem?
Tak: uruchom wyszukiwanie zdarzeń z filtrami dla alertu, a następnie wyeksportuj jak powyżej.