Führen Sie Ihre Suche über die Helix-Such-API aus: ein POST an https://apps.fireeye.com/helix/id/<instance-id>/api/v1/search mit Ihrem API-Schlüssel im x-fireeye-api-key-Header und der Abfrage im Textkörper. Regionale Instanzen verwenden ihre eigenen Hosts, wie beispielsweise helix.eu.fireeye.com. Die Ergebnisse werden als JSON zurückgegeben, und die ursprüngliche Protokollzeile wird im Rohdatenfeld behalten.
Trellix Helix, ehemals FireEye Helix und in neueren Dokumentationen als Helix Enterprise bezeichnet, kombiniert Protokollsuche mit Erkennungsinhalten. Prime Core verfügt über 18.667 Erkennungsregeln für Trellix Helix, die 632 MITRE ATT&CK-Techniken zugeordnet sind. Unten wird beschrieben, wie Sie Ereignisse extrahieren, bereinigen und kostenlos in LogTotal untersuchen können.
Bevor Sie beginnen
Ein API-Schlüssel. Erstellen Sie einen in Trellix Identity and Access Management unter API-Schlüssel, mit den Suchbereichen, die Ihre Abfrage benötigt.
Ihre Instanz-ID. Sie wird in der oberen linken Ecke der Helix-Oberfläche angezeigt und geht in jede API-URL ein.
Die Abfragesprache. Helix verwendet TQL, das MQL ersetzt hat. Freitextbegriffe ohne Feld werden mit dem Raw Message-Index abgeglichen. Erstellen und testen Sie die Abfrage zuerst auf der Helix-Suchseite.
Exportieren mit der Such-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
Sobald Sie die Struktur kennen, flatten Sie sie mit jq -c auf ein Ereignis pro Zeile, und ziehen Sie das Rohfeld mit jq -r heraus, wenn die Quelle Text war.
Hochladen, bereinigen und in LogTotal überprüfen
- Hochladen. Öffnen logtotal.com und legen Sie die Datei ab.
- Bereinigen.
- Überprüfen.
Wie das bei echten Daten aussieht.
Wenn es schiefgeht
| Symptom | Wahrscheinliche Ursache | Fix |
|---|---|---|
| 401 oder 403 | Fehlende Bereiche im Schlüssel oder falscher Header | Überprüfen Sie die Bereiche des Schlüssels; verwenden Sie x-fireeye-api-key |
| 404 | Falsche Instanz-ID oder regionaler Host | Kopieren Sie die Instanz-ID aus der Benutzeroberfläche; verwenden Sie den Host Ihrer Region |
| Abfragefehler | MQL-Syntax in einer TQL-Abfrage | Schreiben Sie sie in TQL um; testen Sie in der Benutzeroberfläche |
| Ergebnisse abgeschnitten | Ergebnislimit | Teilen Sie den Zeitbereich auf |
FAQ
Ist das dasselbe wie die Trellix EDR-Suche?
Nein. Trellix EDR hat seine eigene Echtzeit-Such-API. Dieser Leitfaden behandelt die Helix-Protokollsuche.
Was ist mit Helix-Warnungen?
Warnungen haben ihren eigenen Endpunkt (/api/v3/alerts). Für LogTotal exportieren Sie die Ereignisse dahinter.