Menyiapkan webhook SIEM
Sebelum memulai
- Pastikan projectGoogle Cloud untuk Google SecOps telah dikonfigurasi dan Chronicle API diaktifkan untuk project tersebut.
- Menautkan instance Google SecOps ke layanan Google Cloud .
Menggunakan contoh command line
Dokumen ini menyertakan contoh perintah curl untuk membantu Anda menyiapkan dan menguji feed webhook. Contoh ini menggunakan variabel placeholder yang dapat diedit. Untuk menggunakannya secara efektif:
Edit variabel: Saat mengikuti langkah-langkah penyiapan, Anda akan mendapatkan nilai untuk endpoint webhook, kunci API, dan rahasia. Klik variabel placeholder dalam kode contoh dan ganti dengan nilai sebenarnya:
ENDPOINT_URL: URL endpoint feed yang diperoleh saat Anda Membuat feed webhook HTTPS.API_KEY: Kunci API yang Anda Buat untuk feed webhook guna melakukan autentikasi ke Google SecOps.SECRET: Kunci rahasia yang dibuat saat Anda Membuat feed webhook HTTPS.
Mengedit variabel dalam satu contoh kode akan memperbaruinya di semua contoh di halaman ini.
Salin perintah: Klik ikon Salin contoh kode di blok kode.
Jalankan perintah: Tempel perintah yang disalin ke lingkungan terminal Anda dan jalankan.
Pastikan perintah
curlmenyertakan flag--fail(atau-f). Hal ini memastikan bahwacurlmenampilkan kode keluar bukan nol jika permintaan HTTP gagal, dan kode keluar0untuk menunjukkan keberhasilan. Anda akan membutuhkannya untuk langkah berikutnya.Memverifikasi keberhasilan: Perintah
curlyang berhasil tidak akan menampilkan output. Untuk mengonfirmasi keberhasilan, lakukan hal berikut:Jika perintah
curlmenyertakan flag--fail(atau-f), periksa kode keluar dengan menjalankan perintah berikut segera setelahnya:echo $?Kode keluar
0menunjukkan keberhasilan.
Menyiapkan feed webhook HTTPS
Untuk menyiapkan feed webhook HTTPS, lakukan hal berikut:
- Buat feed webhook HTTPS, lalu salin URL endpoint dan kunci rahasia.
- Buat kunci API untuk digunakan dengan URL endpoint. Anda juga dapat menggunakan kembali kunci API yang ada untuk melakukan autentikasi ke Google SecOps.
- Tentukan URL endpoint di aplikasi Anda.
Mengirim beberapa peristiwa dalam satu permintaan webhook
Contoh kode berikut menunjukkan cara memformat satu isi permintaan dengan beberapa objek JSON yang dipisahkan baris baru:
curl --location 'ENDPOINT_URL' \
--header 'Content-Type: application/json' \
--header 'X-goog-api-key: API_KEY' \
--header 'X-Webhook-Access-Key: SECRET' \
--data $'{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}\n{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \
--fail
Membuat feed webhook HTTPS
- Di menu Google SecOps, pilih Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan feed baru.
- Di kolom Nama feed, masukkan nama untuk feed.
- Dalam daftar Jenis sumber, pilih Webhook.
- Pilih Jenis log. Misalnya, untuk membuat feed bagi Open Cybersecurity Schema Framework, pilih Open Cybersecurity Schema Framework (OCSF) sebagai Log type.
- Klik Berikutnya.
- Opsional: Tentukan nilai untuk parameter input berikut:
- Pembatas pemisahan: pembatas yang digunakan untuk memisahkan baris log, seperti
\n. - Namespace aset: namespace aset.
- Label penyerapan: label yang akan diterapkan ke peristiwa dari feed ini.
- Pembatas pemisahan: pembatas yang digunakan untuk memisahkan baris log, seperti
- Klik Berikutnya.
- Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
- Klik Buat Kunci Rahasia untuk membuat kunci rahasia guna mengautentikasi feed ini.
- Salin dan simpan kunci rahasia karena Anda tidak dapat melihat rahasia ini lagi. Anda dapat membuat kunci rahasia baru, tetapi tindakan ini akan membuat kunci rahasia sebelumnya menjadi tidak berlaku.
- Dari tab Details, salin URL endpoint feed dari kolom Endpoint Information. Anda harus menentukan URL endpoint ini di aplikasi klien Anda.
- Opsional: Klik tombol Feed Diaktifkan untuk menonaktifkan feed. Feed diaktifkan secara default.
- Klik Done.
Membuat kunci API untuk feed webhook
- Buka halaman Credentials di konsol Google Cloud .
- Klik Create credentials, lalu pilih kunci API.
- Batasi akses kunci API ke Chronicle API.
Menentukan URL endpoint
- Di aplikasi klien Anda, tentukan endpoint HTTPS yang tersedia di feed webhook.
Aktifkan autentikasi dengan menentukan kunci API dan kunci rahasia sebagai header kustom dalam format berikut:
X-goog-api-key: API_KEY X-Webhook-Access-Key: SECRETSebaiknya tentukan kunci API sebagai header, bukan menentukannya di URL.
curl --location 'ENDPOINT_URL' \ --header 'Content-Type: application/json' \ --header 'X-goog-api-key: API_KEY' \ --header 'X-Webhook-Access-Key: SECRET' \ --data '{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \ --failJika klien webhook Anda tidak mendukung header kustom, Anda dapat menentukan kunci API dan kunci rahasia menggunakan parameter kueri dalam format berikut:
ENDPOINT_URL?key=API_KEY&secret=>SECRET
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.