Mengumpulkan log IONIX Pengelolaan Permukaan Serangan
Dokumen ini menjelaskan cara mengonfigurasi IONIX Pengelolaan Permukaan Serangan untuk mengirim log ke Google Security Operations menggunakan webhook.
IONIX adalah platform External Attack Surface Management (EASM) yang menemukan, menilai, dan memvalidasi eksposur keamanan di seluruh aset yang terhubung ke internet dan supply chain digital organisasi Anda. IONIX menyediakan item tindakan untuk temuan DNS, masalah PKI, eksposur cloud, dan kerentanan, sehingga memberikan alur kerja perbaikan yang diprioritaskan.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- IONIX Pengelolaan Permukaan Serangan mendukung push HTTP POST untuk pengiriman log
- Akses ke konsol Google Cloud (untuk pembuatan kunci API)
- Akun portal IONIX aktif dengan akses administrator ke Settings > Integrations
Membuat feed webhook di Google SecOps
Membuat feed
- 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,
IONIX ASM Logs). - Pilih Webhook sebagai Jenis sumber.
- Pilih IONIX sebagai Log type.
- Klik Berikutnya.
- Tentukan nilai untuk parameter input berikut:
- Pemisah pemisahan (opsional): Masukkan pemisah untuk memisahkan peristiwa multibaris. Nilai umum:
\n- Pembatas baris baru (paling umum untuk NDJSON)- Biarkan kosong jika setiap permintaan berisi satu peristiwa
- Namespace aset: Namespace aset
- Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini
- Pemisah pemisahan (opsional): Masukkan pemisah untuk memisahkan peristiwa multibaris. Nilai umum:
- Klik Berikutnya.
- Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Membuat dan menyimpan kunci rahasia
Setelah membuat feed, Anda harus membuat kunci rahasia untuk autentikasi:
- Di halaman detail feed, klik Buat Kunci Rahasia.
- Dialog akan menampilkan kunci rahasia.
- Salin dan simpan kunci rahasia dengan aman.
Mendapatkan URL endpoint feed
- Buka tab Detail untuk feed tersebut.
- Di bagian Endpoint Information, salin Feed endpoint URL.
Format URL-nya adalah:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDengan
{region}adalah region instance Google SecOps Anda (misalnya,us,europe, atauasia-southeast1), dan{parent}adalah jalur resource dalam formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Simpan URL ini untuk langkah berikutnya.
Klik Done.
Membuat kunci API Google Cloud
Google SecOps memerlukan kunci API untuk autentikasi. Buat kunci API yang dibatasi di konsol Google Cloud .
Membuat kunci API
- Buka halaman Credentials konsolGoogle Cloud .
- Pilih project Anda (project yang terkait dengan instance Google SecOps Anda).
- Klik Create credentials > kunci API.
- Kunci API akan dibuat dan ditampilkan dalam dialog.
- Klik Edit kunci API untuk membatasi kunci.
Membatasi kunci API
- Di halaman setelan kunci API:
- Name: Masukkan nama deskriptif (misalnya,
Google SecOps Webhook API Key)
- Name: Masukkan nama deskriptif (misalnya,
- Di bagian API restrictions:
- Pilih Restrict key.
- Di dropdown Select APIs, telusuri dan pilih Google SecOps API (atau Chronicle API).
- Klik Simpan.
- Salin nilai kunci API dari kolom Kunci API di bagian atas halaman.
- Simpan kunci API dengan aman.
Mengonfigurasi webhook IONIX Attack Surface Management
IONIX secara native mendukung pengiriman data peristiwa keamanan ke endpoint eksternal melalui HTTP POST menggunakan framework integrasinya. Integrasi ini dikonfigurasi di portal IONIX dan menggunakan mekanisme yang sama dengan integrasi Splunk HEC, yang disesuaikan untuk mengirim data ke endpoint webhook Google SecOps.
Membuat URL webhook
Gabungkan URL endpoint Google SecOps dan kunci API menjadi satu URL:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Contoh:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Mengonfigurasi integrasi di portal IONIX
- Login ke portal IONIX (misalnya,
https://<your-portal-name>.ionix.com). - Buka Settings > Integrations.
- Klik Splunk Integration > Settings.
Berikan detail konfigurasi berikut:
- HEC Token: Masukkan kunci rahasia yang dihasilkan dari feed webhook Google SecOps.
Splunk Server: Masukkan URL endpoint webhook Google SecOps lengkap dengan kunci API yang ditambahkan sebagai parameter kueri. Gunakan format berikut:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=<API_KEY>
Konfigurasikan push interval untuk menetapkan seberapa sering IONIX mengirim data ke endpoint (misalnya, setiap 60 menit).
Isi kolom data tambahan yang relevan dengan lingkungan Anda.
Klik Simpan.
Aktifkan integrasi dengan mengalihkan tombol integrasi ke Enabled.
Data akan mulai muncul di Google SecOps dalam satu siklus interval push. Pengiriman data awal mungkin memerlukan waktu hingga satu jam.
Alternatif: Menggunakan IONIX REST API dengan skrip kustom
Jika integrasi HEC Splunk native tidak memenuhi persyaratan, Anda dapat menggunakan REST API IONIX untuk mengambil data dan meneruskannya ke Google SecOps.
Membuat kunci API IONIX
- Login ke portal IONIX.
- Klik API Settings.
- Berikan nama untuk token.
- Pilih jenis token:
- Read-only (direkomendasikan untuk pengumpulan data)
- Baca-tulis
- Tetapkan tanggal habis masa berlaku untuk token.
- Klik Create Token.
- Salin token yang dihasilkan dan simpan dengan aman.
Endpoint API IONIX
Gunakan endpoint API berikut untuk mengambil data keamanan dari IONIX:
| Endpoint | Deskripsi |
|---|---|
/api/v1/remediation/action-items/open/ |
Membuka item tindakan (domain, endpoint root) |
/api/v1/remediation/action-items/all/detailed |
Semua item tindakan dengan informasi mendetail |
/api/v1/discovery/org-assets/export-discovery-evidence |
Bukti risiko dan penemuan aset |
/api/v1/discovery/org-assets |
Aset organisasi (termasuk tanggal first_seen) |
/api/v1/tests |
Hasil uji keamanan |
Contoh permintaan API
curl -X GET "https://api.portal.ionix.io/api/v1/remediation/action-items/all/detailed" \ -H "Authorization: Token <IONIX_API_KEY>" \ -H "Content-Type: application/json"
Meneruskan data ke Google SecOps
Setelah mengambil data dari IONIX API, teruskan data tersebut ke endpoint webhook Google SecOps:
curl -X POST "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>" \ -H "Content-Type: application/json" \ -d @ionix_events.json
Referensi metode autentikasi
Feed webhook Google SecOps mendukung beberapa metode autentikasi. Pilih metode yang didukung vendor Anda.
Metode 1: Header kustom (Direkomendasikan)
Jika vendor Anda mendukung header HTTP kustom, gunakan metode ini untuk keamanan yang lebih baik.
Format permintaan:
POST <ENDPOINT_URL> HTTP/1.1 Content-Type: application/json x-goog-chronicle-auth: <API_KEY> x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Kelebihan:
- Kunci API dan rahasia tidak terlihat di URL
- Lebih aman (header tidak dicatat dalam log akses server web)
- Metode yang lebih disukai jika vendor mendukungnya
Metode 2: Parameter kueri
Jika vendor Anda tidak mendukung header kustom, tambahkan kredensial ke URL.
Format URL:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>- Contoh:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...Format permintaan:
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Kekurangan:
- Kredensial terlihat di URL
- Dapat dicatat dalam log akses server web
- Kurang aman dibandingkan header
Metode 3: Hybrid (URL + Header)
Beberapa konfigurasi menggunakan kunci API di URL dan kunci rahasia di header.
Format permintaan:
POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1 Content-Type: application/json x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Nama header autentikasi
Google SecOps menerima nama header berikut untuk autentikasi:
Untuk kunci API:
x-goog-chronicle-auth(direkomendasikan)X-Goog-Chronicle-Auth(tidak peka huruf besar/kecil)
Untuk kunci rahasia:
x-chronicle-auth(direkomendasikan)X-Chronicle-Auth(tidak peka huruf besar/kecil)
Tabel pemetaan UDM
Untuk mengetahui informasi tentang cara kolom log IONIX dipetakan ke kolom Model Data Terpadu (UDM) Google Security Operations, telusuri jenis log IONIX di referensi parser default yang didukung.
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.