Thinkst Canary-Protokolle erfassen
In diesem Dokument wird beschrieben, wie Sie Thinkst Canary-Logs erfassen, indem Sie einen Google Security Operations-Feed mit der Drittanbieter-API einrichten.
Thinkst Canary bietet eine täuschungsbasierte Bedrohungserkennung: Hardware-, virtuelle und Cloud-Canaries imitieren echte Assets und Canarytokens fungieren als Stolperdrähte in Dateien, Anmeldedaten und URLs. Wenn ein Angreifer einen Canary berührt oder einen Token auslöst, zeichnet die Canary Console einen Vorfall auf. Der Feed ruft diese Vorfälle über die Console API ab.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Privilegierter Zugriff auf die Thinkst Canary Console
REST API in Thinkst Canary konfigurieren
- Melden Sie sich in Ihrer Thinkst Canary Console (
https://<DOMAIN_HASH>.canary.tools) an. - Klicken Sie rechts oben auf das Zahnradsymbol und wählen Sie Globale Einstellungen aus.
- Klicken Sie im Menü auf API.
- Wenn die API deaktiviert ist, klicken Sie auf API aktivieren.
Verwenden Sie den vorhandenen Standard-API-Schlüssel oder klicken Sie auf + Neuen API-Schlüssel hinzufügen, um einen dedizierten Schlüssel zu erstellen:
- API key type (API-Schlüsseltyp): Wählen Sie Read-Only (Schreibgeschützt) aus. Dies reicht für die Logerfassung aus.
- Hinweis: Geben Sie einen Namen für den Schlüssel ein (z. B.
Google SecOps Integration).
Kopieren und speichern Sie Folgendes an einem sicheren Ort:
- Domain-Hash: Die Kennung Ihrer Console. Ihr API-Hostname lautet
<DOMAIN_HASH>.canary.tools. - Auth-Token: Der API-Schlüssel, der zum Authentifizieren von Anfragen verwendet wird.
- Domain-Hash: Die Kennung Ihrer Console. Ihr API-Hostname lautet
Feed in Google SecOps konfigurieren, um Thinkst Canary-Logs aufzunehmen
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
Thinkst Canary Logs. - Wählen Sie Drittanbieter-API als Quelltyp aus.
- Wählen Sie Thinkst Canary als Protokolltyp aus.
- Klicken Sie auf Weiter.
Geben Sie Werte für die folgenden Eingabeparameter an:
- Authentifizierungs-HTTP-Header: Das zuvor generierte Token im Format
auth_token:<TOKEN>(z. B.auth_token:AAAABBBBCCCC111122223333). - API-Hostname: Der voll qualifizierte Domainname Ihres Thinkst Canary REST API-Endpunkt im Format
<DOMAIN_HASH>.canary.tools(z. B.myinstance.canary.tools). - Asset-Namespace: Der Asset-Namespace
- Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
- Authentifizierungs-HTTP-Header: Das zuvor generierte Token im Format
Klicken Sie auf Weiter.
Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Nach der Einrichtung ruft der Feed Logs von der Thinkst Canary-Instanz in chronologischer Reihenfolge ab.
Updates zu Vorfällen und erneute Zustellung
Die Canary Console API gibt einen Vorfall nicht nur bei der Erstellung, sondern auch bei jeder Aktualisierung zurück. Canary bündelt nachfolgende ähnliche Ereignisse aus derselben Quelle im vorhandenen Vorfall. Beispielsweise wird jeder Brute-Force-Angriffsversuch zu einem Ereignis innerhalb eines einzelnen Vorfalls. Auch andere Änderungen am Vorfall können eine erneute Zustellung auslösen.
In Google SecOps ist Folgendes zu erwarten:
- Vorfälle, die bereits übermittelt wurden, werden nach der Aktualisierung wieder im Feed angezeigt.
- Ein erneut gemeldeter Vorfall kann mit einem Ereigniszeitstempel angezeigt werden, der deutlich älter ist als der Zeitpunkt, zu dem er erneut gemeldet wurde. Das liegt daran, dass der Parser Ereigniszeitstempel von der ursprünglichen Erstellungszeit des Vorfalls und von den eigenen Auftretenszeiten der gebündelten Ereignisse ableitet, nicht von der Aktualisierungszeit.
Die erneute Übermittlung selbst ist das dokumentierte Verhalten der API für die Vorfallserfassung (sie filtert nach dem Aktualisierungszähler des Vorfalls) und kein Datenverlust oder Parserfehler.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
_canary_uptime_label |
additional.fields |
Zusammengeführt |
desc_events_n_func_code_label |
additional.fields |
Zusammengeführt |
desc_events_n_func_name_label |
additional.fields |
Zusammengeführt |
desc_events_n_sfunc_code_label |
additional.fields |
Zusammengeführt |
desc_events_n_sfunc_name_label |
additional.fields |
Zusammengeführt |
desc_events_n_timestamp_std_label |
additional.fields |
Zusammengeführt |
desc_events_n_unit_id_label |
additional.fields |
Zusammengeführt |
description_created_std_label |
additional.fields |
Zusammengeführt |
description_events_list_label |
additional.fields |
Zusammengeführt |
event_data_list |
additional.fields |
Zusammengeführt |
event_descrip_label |
additional.fields |
Zusammengeführt |
events_url_label |
additional.fields |
Zusammengeführt |
local_time_label |
additional.fields |
Zusammengeführt |
locale_label |
additional.fields |
Zusammengeführt |
lt_label |
additional.fields |
Zusammengeführt |
offline_text_label |
additional.fields |
Zusammengeführt |
updated_label |
additional.fields |
Zusammengeführt |
updated_std_label |
additional.fields |
Zusammengeführt |
_auth |
extensions.auth |
Umbenannt/zugeordnet |
_metadata |
metadata |
Umbenannt/zugeordnet |
_event_time |
metadata.event_timestamp |
Geparst als UNIX |
_metadata_event_timestamp |
metadata.event_timestamp |
Geparst als UNIX |
description.created_std |
metadata.event_timestamp |
Geparst als UNIX_MS |
elem.timestamp_std |
metadata.event_timestamp |
Geparst als yyyy-MM-dd HH:mm:ss ZZZ+0000 |
updated |
metadata.event_timestamp |
Geparst als EEE, dd MMM yyyy HH:mm:ss ZZZ |
updated_std |
metadata.event_timestamp |
Geparst als UNIX_MS |
format |
metadata.event_type |
Zugeordnet: grok → STATUS_UPDATE, grok → GENERIC_EVENT |
has_principal_hostname |
metadata.event_type |
Zugeordnet: true → STATUS_UPDATE |
_network |
network |
Umbenannt/zugeordnet |
_observer |
observer |
Umbenannt/zugeordnet |
_principal |
principal |
Umbenannt/zugeordnet |
ThinkstCanary_Process |
principal.application |
Direkt zugeordnet |
ThinkstCanary_Process |
principal.asset.hostname |
Direkt zugeordnet |
ThinkstCanary_Hostname |
principal.hostname |
Direkt zugeordnet |
_md_product_event_type |
security_result |
Zugeordnete Werte (insgesamt 10, z.B. Shared File Opened → _security_result, Host Port Scan → ... |
_security_result |
security_result |
Zusammengeführt |
format |
security_result |
Zugeordnet: kv → _security_result, json → _security_result |
_source |
src |
Umbenannt/zugeordnet |
_target |
target |
Umbenannt/zugeordnet |
| – | metadata.event_type |
Konstante: STATUS_UPDATE |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten