Mengumpulkan log Thinkst Canary
Dokumen ini menjelaskan cara mengumpulkan log Thinkst Canary dengan menyiapkan feed Google Security Operations menggunakan API Pihak Ketiga.
Thinkst Canary menyediakan deteksi ancaman berbasis penipuan: Canary hardware, virtual, dan cloud meniru aset nyata, dan Canarytoken bertindak sebagai jebakan dalam file, kredensial, dan URL. Saat penyerang menyentuh Canary atau memicu token, Canary Console akan mencatat insiden. Feed mengambil insiden tersebut dari Console API.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Akses istimewa ke Thinkst Canary Console
Mengonfigurasi REST API di Thinkst Canary
- Login ke Thinkst Canary Console (
https://<DOMAIN_HASH>.canary.tools). - Klik ikon roda gigi di sudut kanan atas, lalu pilih Setelan Global.
- Di menu, klik API.
- Jika API dinonaktifkan, klik Enable API.
Gunakan Kunci API Default yang ada, atau klik + Tambahkan kunci API baru untuk membuat kunci API khusus:
- Jenis kunci API: Pilih Hanya Baca. Hal ini sudah cukup untuk pengumpulan log.
- Catatan: Masukkan nama untuk kunci (misalnya,
Google SecOps Integration).
Salin dan simpan informasi berikut di lokasi yang aman:
- Domain Hash: ID Konsol Anda. Nama host API Anda adalah
<DOMAIN_HASH>.canary.tools. - Token Autentikasi: Kunci API yang digunakan untuk mengautentikasi permintaan.
- Domain Hash: ID Konsol Anda. Nama host API Anda adalah
Mengonfigurasi feed di Google SecOps untuk menyerap log Thinkst Canary
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Di halaman berikutnya, klik Konfigurasi satu feed.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
Thinkst Canary Logs). - Pilih API Pihak Ketiga sebagai Jenis sumber.
- Pilih Thinkst Canary sebagai Log type.
- Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
- Header HTTP autentikasi: Token yang dibuat sebelumnya, dalam format
auth_token:<TOKEN>(misalnya,auth_token:AAAABBBBCCCC111122223333). - Nama Host API: Nama domain yang sepenuhnya memenuhi syarat dari endpoint API REST Thinkst Canary Anda, dalam format
<DOMAIN_HASH>.canary.tools(misalnya,myinstance.canary.tools). - Namespace aset: Namespace aset
- Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini
- Header HTTP autentikasi: Token yang dibuat sebelumnya, dalam format
Klik Berikutnya.
Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Setelah penyiapan, feed akan mulai mengambil log dari instance Thinkst Canary dalam urutan kronologis.
Pembaruan dan pengiriman ulang insiden
Canary Console API menampilkan insiden lagi setiap kali insiden diperbarui, bukan hanya saat insiden dibuat. Canary menggabungkan peristiwa serupa berikutnya dari sumber yang sama ke dalam insiden yang ada. Misalnya, setiap upaya serangan brute force menjadi peristiwa di dalam satu insiden. Modifikasi insiden lainnya juga dapat memicu pengiriman ulang.
Perkirakan perilaku berikut di Google SecOps:
- Insiden yang telah dikirim akan muncul kembali di feed setelah diperbarui.
- Insiden yang dikirim ulang dapat muncul dengan stempel waktu peristiwa yang jauh lebih lama daripada saat insiden tersebut dikirim ulang. Hal ini karena parser memperoleh stempel waktu peristiwa dari waktu pembuatan asli insiden dan dari waktu terjadinya peristiwa yang dipaketkan, bukan dari waktu update.
Pengiriman ulang itu sendiri adalah perilaku yang terdokumentasi dari API pengumpulan insiden (API ini memfilter penghitung update insiden), bukan kehilangan data atau cacat parser.
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
_canary_uptime_label |
additional.fields |
Digabung |
desc_events_n_func_code_label |
additional.fields |
Digabung |
desc_events_n_func_name_label |
additional.fields |
Digabung |
desc_events_n_sfunc_code_label |
additional.fields |
Digabung |
desc_events_n_sfunc_name_label |
additional.fields |
Digabung |
desc_events_n_timestamp_std_label |
additional.fields |
Digabung |
desc_events_n_unit_id_label |
additional.fields |
Digabung |
description_created_std_label |
additional.fields |
Digabung |
description_events_list_label |
additional.fields |
Digabung |
event_data_list |
additional.fields |
Digabung |
event_descrip_label |
additional.fields |
Digabung |
events_url_label |
additional.fields |
Digabung |
local_time_label |
additional.fields |
Digabung |
locale_label |
additional.fields |
Digabung |
lt_label |
additional.fields |
Digabung |
offline_text_label |
additional.fields |
Digabung |
updated_label |
additional.fields |
Digabung |
updated_std_label |
additional.fields |
Digabung |
_auth |
extensions.auth |
Diganti namanya/dipetakan |
_metadata |
metadata |
Diganti namanya/dipetakan |
_event_time |
metadata.event_timestamp |
Diurai sebagai UNIX |
_metadata_event_timestamp |
metadata.event_timestamp |
Diurai sebagai UNIX |
description.created_std |
metadata.event_timestamp |
Diurai sebagai UNIX_MS |
elem.timestamp_std |
metadata.event_timestamp |
Diurai sebagai yyyy-MM-dd HH:mm:ss ZZZ+0000 |
updated |
metadata.event_timestamp |
Diurai sebagai EEE, dd MMM yyyy HH:mm:ss ZZZ |
updated_std |
metadata.event_timestamp |
Diurai sebagai UNIX_MS |
format |
metadata.event_type |
Dipetakan: grok → STATUS_UPDATE, grok → GENERIC_EVENT |
has_principal_hostname |
metadata.event_type |
Dipetakan: true → STATUS_UPDATE |
_network |
network |
Diganti namanya/dipetakan |
_observer |
observer |
Diganti namanya/dipetakan |
_principal |
principal |
Diganti namanya/dipetakan |
ThinkstCanary_Process |
principal.application |
Dipetakan secara langsung |
ThinkstCanary_Process |
principal.asset.hostname |
Dipetakan secara langsung |
ThinkstCanary_Hostname |
principal.hostname |
Dipetakan secara langsung |
_md_product_event_type |
security_result |
Nilai yang dipetakan (total 10, misalnya Shared File Opened → _security_result, Host Port Scan → ... |
_security_result |
security_result |
Digabung |
format |
security_result |
Dipetakan: kv → _security_result, json → _security_result |
_source |
src |
Diganti namanya/dipetakan |
_target |
target |
Diganti namanya/dipetakan |
| T/A | metadata.event_type |
Konstanta: STATUS_UPDATE |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.