Jak eksportować logi Trellix Helix

Jak eksportować logi Trellix Helix

SOC Prime Team
SOC Prime Team linkedin icon Śledź

Uruchom wyszukiwanie przez Helix search API: POST do https://apps.fireeye.com/helix/id/<instance-id>/api/v1/search z kluczem API w nagłówku x-fireeye-api-key i zapytaniem w treści. Regionalne instancje używają własnych hostów, takich jak helix.eu.fireeye.com. Wyniki są zwracane jako JSON, a oryginalna linia logu jest przechowywana w polu surowej wiadomości.

Trellix Helix, dawniej FireEye Helix, a w nowszej dokumentacji zwany Helix Enterprise, łączy wyszukiwanie logów z zawartością wykrywających. Prime Core posiada 18 667 reguł wykrywających dla Trellix Helix, zmapowanych na 632 techniki MITRE ATT&CK. Poniżej znajduje się sposób na uzyskanie, oczyszczenie i zbadanie wydarzeń za darmo w LogTotal.

Rozpocznij za darmo

Zanim zaczniesz

Klucz API. Utwórz go w Trellix Identity and Access Management w sekcji Klucze API, z uprawnieniami wyszukiwania, które są potrzebne dla twojego zapytania.

Twój identyfikator instancji. Jest wyświetlany w lewym górnym rogu interfejsu Helix i jest częścią każdego URL API.

Język zapytań. Helix używa TQL, który zastąpił MQL. Terminy wolnego tekstu bez pola są dopasowywane względem indeksu surowej wiadomości. Stwórz i przetestuj zapytanie najpierw na stronie wyszukiwania Helix.

Eksportuj za pomocą search API

HELIX="https://apps.fireeye.com/helix/id/<instance-id>"

curl -sS -X POST "$HELIX/api/v1/search"
  -H "x-fireeye-api-key: $HELIX_KEY" -H 'Content-Type: application/json'
  -d '{"query": "hostname:"web-03""}'
  > helix_web03_1019.json

Gdy znasz strukturę, spłaszcz ją do jednego zdarzenia na linię za pomocą jq -c i wydrukuj surowe pole za pomocą jq -r, gdy źródłem był tekst.

Prześlij, oczyść i przejrzyj w LogTotal

  1. Prześlij. Otwórz logtotal.com i upuść plik.
  2. Oczyść. 
  3. Przejrzyj.

Jak to wygląda na rzeczywistych danych.

Gdy coś idzie nie tak

ObjawPrawdopodobna przyczynaFix
401 lub 403Brakujące zakresy klucza lub zły nagłówekSprawdź zakresy klucza; użyj x-fireeye-api-key
404Zła ID instancji lub regionalny hostSkopiuj identyfikator instancji z interfejsu, użyj hosta swojej regionu
Błąd zapytaniaSkładnia MQL w zapytaniu TQLPrzepisz w TQL; przetestuj w interfejsie
Wyniki ucięteLimit wynikówPodziel zakres czasu

FAQ

Czy to to samo co wyszukiwanie w Trellix EDR?

Nie. Trellix EDR ma własny rzeczywisty czas wyszukiwania przez API. Ten przewodnik dotyczy wyszukiwania logów Helix.

Co z alertami Helix?

Alerty mają własny punkt końcowy (/api/v3/alerts). Dla LogTotal wyeksportuj zdarzenia za nimi.

Dołącz do platformy Detection as Code firmy SOC Prime aby zwiększyć widoczność zagrożeń najbardziej istotnych dla Twojego biznesu. Aby pomóc Ci rozpocząć i natychmiast uzyskać wartość, umów się teraz na spotkanie z ekspertami SOC Prime.