Mengumpulkan log Aqua Security

Versi Parser: 1.0

Didukung di:

Parser ini mengekstrak kolom dari log Aqua Security, lalu mengubahnya menjadi Unified Data Model (UDM). Parser ini mengurai kolom message sebagai JSON, mengekstrak pengguna, IP sumber, dan kolom relevan lainnya, memetakannya ke kolom UDM, dan mengategorikan peristiwa berdasarkan kolom action, sehingga memperkaya data dengan konteks keamanan seperti nama aturan, deskripsi, dan detail CVE.

Sebelum memulai

Pastikan Anda memiliki prasyarat berikut:

  • Instance Google SecOps.
  • Akses istimewa ke konsol pengelolaan Aqua Security.

Menyiapkan feed

Untuk mengonfigurasi feed, ikuti langkah-langkah berikut:

  1. Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
  2. Klik Tambahkan Feed Berita Baru.
  3. Di halaman berikutnya, klik Konfigurasi satu feed.
  4. Di kolom Feed name, masukkan nama untuk feed (misalnya, Aqua Security Logs).
  5. Pilih Webhook sebagai Jenis sumber.
  6. Pilih Aqua Security sebagai Log type.
  7. Klik Berikutnya.
  8. 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 diterapkan ke peristiwa dari feed ini.
  9. Klik Berikutnya.
  10. Tinjau konfigurasi feed di layar Finalisasi, lalu klik Kirim.
  11. Klik Buat Kunci Rahasia untuk membuat kunci rahasia guna mengautentikasi feed ini.
  12. Salin dan simpan kunci rahasia. Anda tidak dapat melihat kunci rahasia ini lagi. Jika perlu, Anda dapat membuat ulang kunci rahasia baru, tetapi tindakan ini akan membuat kunci rahasia sebelumnya tidak berlaku lagi.
  13. Dari tab Details, salin URL endpoint feed dari kolom Endpoint Information. Anda harus menentukan URL endpoint ini di aplikasi klien Anda.
  14. Klik Done.

Membuat kunci API untuk feed webhook

  1. Buka Google Cloud console > Credentials.

    Buka Kredensial

  2. Klik Create credentials, lalu pilih kunci API.

  3. Batasi akses kunci API ke Chronicle API.

Menentukan URL endpoint

  1. Di aplikasi klien Anda, tentukan URL endpoint HTTPS yang disediakan di feed webhook.
  2. Aktifkan autentikasi dengan menentukan kunci API dan kunci rahasia sebagai bagian dari header kustom dalam format berikut:

    X-goog-api-key = API_KEY
    X-Webhook-Access-Key = SECRET
    

    Rekomendasi: Tentukan kunci API sebagai header, bukan menentukannya di URL.

  3. Jika 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
    

    Ganti kode berikut:

    • ENDPOINT_URL: URL endpoint feed.
    • API_KEY: kunci API untuk melakukan autentikasi ke Google SecOps.
    • SECRET: kunci rahasia yang Anda buat untuk mengautentikasi feed.

Membuat Webhook di Aqua Security untuk Google SecOps

  1. Login ke konsol Aqua Security.
  2. Buka Settings > Image Scan Results Webhook.
  3. Centang kotak Enable sending image scan results.
  4. Masukkan <ENDPOINT_URL>, diikuti dengan <API_KEY> dan <SECRET>.
  5. Klik Simpan.

Tabel Pemetaan UDM

Kolom Log (Menaik) Pemetaan UDM Logika
jsonPayload.action metadata.event_type Dipetakan berdasarkan nilai 'jsonPayload.action'. Lihat kode parser untuk pemetaan tertentu.
jsonPayload.action security_result.summary Dipetakan secara langsung.
jsonPayload.adjective target.file.full_path Dipetakan secara langsung jika 'jsonPayload.container' kosong.
jsonPayload.category target.asset.category Dipetakan secara langsung.
jsonPayload.cfappname target.application Dipetakan secara langsung.
jsonPayload.cfspace principal.user.userid Dipetakan secara langsung jika 'jsonPayload.user' kosong.
jsonPayload.command principal.ip Diekstrak menggunakan pola grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.command principal.user.userid Diekstrak menggunakan pola grok "user %{GREEDYDATA:user_id} \(%{IP:src_ip}\)".
jsonPayload.container target.asset.product_object_id Dipetakan secara langsung.
jsonPayload.data security_result.detection_fields Diurai sebagai key-value pair dan dipetakan ke setiap kolom dalam 'security_result.detection_fields'.
jsonPayload.description security_result.description Dipetakan secara langsung jika 'jsonPayload.reason' kosong.
jsonPayload.host principal.hostname Dipetakan secara langsung.
jsonPayload.hostgroup target.group.group_display_name Dipetakan secara langsung.
jsonPayload.hostid target.asset_id Dipetakan sebagai "host id: %{jsonPayload.hostid}".
jsonPayload.hostip target.ip Dipetakan secara langsung.
jsonPayload.image target.file.full_path Dipetakan secara langsung.
jsonPayload.level security_result.action Tetapkan ke "ALLOW" jika 'jsonPayload.level' adalah "success".
jsonPayload.reason security_result.description Dipetakan secara langsung.
jsonPayload.rule security_result.rule_name Dipetakan secara langsung.
jsonPayload.user principal.user.userid Dipetakan secara langsung.
jsonPayload.vm_location target.asset.location.name Dipetakan secara langsung.
jsonPayload.vm_name target.resource.name Dipetakan secara langsung.
resource.labels.instance_id target.resource.id Dipetakan secara langsung.
resource.labels.project_id target.asset.attribute.cloud.project.id Dipetakan secara langsung.
resource.labels.zone target.asset.attribute.cloud.availability_zone Dipetakan secara langsung.
timestamp metadata.event_timestamp Dipetakan langsung setelah dikonversi ke format ISO8601.
extensions.auth.type Tetapkan ke "SSO" jika 'jsonPayload.description' berisi "SAML", jika tidak, tetapkan ke "AUTHTYPE_UNSPECIFIED" jika 'jsonPayload.action' adalah "login" atau "Login".
metadata.log_type Tetapkan ke "AQUA_SECURITY".
metadata.product_name Tetapkan ke "AQUA_SECURITY".
metadata.vendor_name Tetapkan ke "AQUA_SECURITY".
target.asset.attribute.cloud.environment Tetapkan ke "GOOGLE_CLOUD_PLATFORM".
target.resource.type Tetapkan ke "VIRTUAL_MACHINE".

Log Perubahan

Melihat Log Perubahan untuk parser ini

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.