Thinkst Canary-Protokolle erfassen

Unterstützt in:

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

  1. Melden Sie sich in Ihrer Thinkst Canary Console (https://<DOMAIN_HASH>.canary.tools) an.
  2. Klicken Sie rechts oben auf das Zahnradsymbol und wählen Sie Globale Einstellungen aus.
  3. Klicken Sie im Menü auf API.
  4. Wenn die API deaktiviert ist, klicken Sie auf API aktivieren.
  5. 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).
  6. 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.

Feed in Google SecOps konfigurieren, um Thinkst Canary-Logs aufzunehmen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. Thinkst Canary Logs.
  5. Wählen Sie Drittanbieter-API als Quelltyp aus.
  6. Wählen Sie Thinkst Canary als Protokolltyp aus.
  7. Klicken Sie auf Weiter.
  8. 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.
  9. Klicken Sie auf Weiter.

  10. 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