Mengumpulkan log Pengelolaan Imperva SecureSphere

Didukung di:

Dokumen ini menjelaskan cara menyerap log Imperva SecureSphere Management ke Google Security Operations menggunakan agen Bindplane.

Imperva SecureSphere adalah platform firewall aplikasi web, keamanan database, dan keamanan file yang menghasilkan pesan syslog berformat CEF untuk peristiwa keamanan, peristiwa sistem, dan pelanggaran kebijakan. Parser mengekstrak kolom dari pesan CEF menggunakan penguraian grok dan nilai kunci, lalu memetakannya ke Model Data Terpadu (UDM).

Sebelum memulai

Pastikan Anda memiliki prasyarat berikut:

  • Instance Google SecOps
  • Windows Server 2016 atau yang lebih baru, atau host Linux dengan systemd
  • Konektivitas jaringan antara agen Bindplane dan server Pengelolaan Imperva SecureSphere
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke Imperva SecureSphere Management Console

Mendapatkan kredensial Google SecOps untuk agen Bindplane

Untuk mengautentikasi agen Bindplane ke Google SecOps, pilih salah satu metode berikut:

  • Deployment baru: Gunakan Chronicle API (Opsi 1).
  • Deployment lama: Terus menggunakan file autentikasi penyerapan (Opsi 2) hingga Ingestion API dihentikan pada 20 Juli 2027.
  1. Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
  2. Buka IAM & Admin > Service Accounts.
  3. Klik Create service account.
  4. Berikan detail konfigurasi berikut:
    • Nama akun layanan: Masukkan nama untuk akun (misalnya, bindplane-ingest).
    • Deskripsi akun layanan: Masukkan deskripsi (misalnya, Bindplane agent log ingestion).
  5. Klik Create and continue.
  6. Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
  7. Klik Continue lalu klik Done.
  8. Klik akun layanan yang Anda buat, lalu buka tab Keys.
  9. Klik Add key > Create new key.
  10. Pilih JSON, lalu klik Create. File kunci didownload ke komputer Anda.
  11. Simpan file kunci sebagai ingestion-auth.json di direktori Bindplane collector (/opt/observiq-otel-collector/ingestion-auth.json di Linux atau C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json di Windows), atau perbarui creds_file_path di config.yaml agar sesuai dengan jalur tempat Anda menyimpannya.
  12. Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.

Opsi 2: Mendownload file autentikasi penyerapan (lama)

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Agen Pengumpulan.
  3. Download file autentikasi penyerapan.
  4. Simpan file dengan aman di sistem tempat agen BindPlane akan diinstal.

Mendapatkan ID pelanggan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Profil.
  3. Salin dan simpan ID Pelanggan dari bagian Detail Organisasi.

Menginstal agen Bindplane

Instal agen Bindplane di sistem operasi Windows atau Linux Anda sesuai dengan petunjuk berikut.

Penginstalan Windows

  1. Buka Command Prompt atau PowerShell sebagai administrator.
  2. Jalankan perintah berikut:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Tunggu hingga penginstalan selesai.

  4. Verifikasi penginstalan dengan menjalankan:

    sc query observiq-otel-collector
    

    Layanan akan ditampilkan sebagai RUNNING.

Penginstalan Linux

  1. Buka terminal dengan hak istimewa root atau sudo.
  2. Jalankan perintah berikut:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Tunggu hingga penginstalan selesai.

  4. Verifikasi penginstalan dengan menjalankan:

    sudo systemctl status observiq-otel-collector
    

    Layanan akan ditampilkan sebagai aktif (berjalan).

Referensi penginstalan tambahan

Untuk mengetahui opsi penginstalan dan pemecahan masalah tambahan, lihat Panduan penginstalan agen Bindplane.

Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps

Cari file konfigurasi

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Edit file konfigurasi

  • Ganti seluruh konten config.yaml dengan konfigurasi berikut:

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/imperva_securesphere:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: IMPERVA_SECURESPHERE
        raw_log_field: body
    
    service:
      pipelines:
        logs/imperva_securesphere_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/imperva_securesphere
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • listen_address: Alamat IP dan port untuk diproses:
      • 0.0.0.0 untuk mendengarkan di semua antarmuka (direkomendasikan)
      • Port 514 adalah port syslog standar (memerlukan root di Linux; gunakan 1514 untuk non-root)
  • Konfigurasi pengekspor:

    • creds_file_path: Jalur lengkap ke file kunci JSON akun layanan (Opsi 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID Pelanggan yang disalin dari konsol Google SecOps
    • location: Ganti <LOCATION> dengan region instance Google SecOps Anda (misalnya, us, europe, atau asia-southeast1). Pengekspor mengawali chronicle.googleapis.com dengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.
    • project: Ganti <PROJECT_NUMBER> dengan nomor project dari IAM & Admin > Settings.
    • endpoint: Tetap disetel ke chronicle.googleapis.com.

Pengekspor API penyerapan lama

  • Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok exporters dengan kode berikut. Tetapkan creds_file_path ke jalur file autentikasi penyerapan, dan jika instance Anda berada di luar Amerika Serikat, ganti malachiteingestion-pa.googleapis.com dengan endpoint regional Anda (misalnya, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/imperva_securesphere:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: IMPERVA_SECURESPHERE
        raw_log_field: body
    

Simpan file konfigurasi

  • Setelah mengedit, simpan file:
    • Linux: Tekan Ctrl+O, lalu Enter, lalu Ctrl+X
    • Windows: Klik File > Simpan

Mulai ulang agen Bindplane untuk menerapkan perubahan

  • Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:

    sudo systemctl restart observiq-otel-collector
    
    1. Pastikan layanan sedang berjalan:

      sudo systemctl status observiq-otel-collector
      
    2. Periksa log untuk mengetahui error:

      sudo journalctl -u observiq-otel-collector -f
      
  • Untuk memulai ulang agen Bindplane di Windows, pilih salah satu opsi berikut:

    • Command Prompt atau PowerShell sebagai administrator:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • Konsol Services:

      1. Tekan Win+R, ketik services.msc, lalu tekan Enter.
      2. Cari observIQ OpenTelemetry Collector.
      3. Klik kanan, lalu pilih Mulai ulang.
      4. Pastikan layanan sedang berjalan:

        sc query observiq-otel-collector
        
      5. Periksa log untuk mengetahui error:

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Mengonfigurasi penerusan syslog di Imperva SecureSphere Management

  1. Login ke Imperva SecureSphere Management Console.
  2. Buka Configuration > Action Sets.
  3. Klik Add untuk membuat Set Tindakan baru.
  4. Berikan detail konfigurasi berikut:
    • Name: Masukkan nama deskriptif (misalnya, Google SecOps Syslog).

Mengonfigurasi tindakan peristiwa keamanan

  • Klik Add Action dan konfigurasikan:

    • Action Type: Pilih Syslog.
    • Host: Masukkan alamat IP agen Bindplane.
    • Port: Masukkan nomor port agen Bindplane (default 514).
    • Protocol: Pilih UDP atau TCP.
    • Syslog Log Level: Pilih DEBUG.
    • Syslog Facility: Pilih LOCAL0.
    • Message Format: Pilih Gateway Log - Security Event - System Log (syslog) using CEF standard.

Mengonfigurasi tindakan peristiwa sistem

  • Klik Add Action dan konfigurasikan:

    • Action Type: Pilih System Log.
    • Host: Masukkan alamat IP agen Bindplane.
    • Port: Masukkan nomor port agen Bindplane.
    • Protocol: Pilih UDP atau TCP.
    • Message Format: Pilih Log System Event to System Log (syslog) using CEF standard.

Menerapkan set tindakan ke kebijakan

  1. Buka Kebijakan > Kebijakan Keamanan.
  2. Untuk setiap kebijakan yang relevan, konfigurasikan Tindakan yang Diikuti untuk menggunakan Set Tindakan Anda.
  3. Buka Policies > System Events Policies.
  4. Konfigurasi kebijakan peristiwa sistem untuk menggunakan Set Tindakan untuk pemantauan yang komprehensif.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
action security_result.action_details Nilai kolom action ditetapkan ke kolom security_result.action_details.
application-name target.application Nilai kolom application-name ditetapkan ke kolom target.application.
cat security_result.category_details Nilai kolom cat ditetapkan ke kolom security_result.category_details.
class security_result.detection_fields.value Nilai kolom class ditetapkan ke kolom value dalam security_result.detection_fields. key yang sesuai adalah "class".
collection_time.seconds metadata.event_timestamp.seconds Nilai collection_time.seconds dari log mentah digunakan sebagai nilai detik untuk metadata.event_timestamp.
create-time metadata.event_timestamp.seconds Nilai create-time diuraikan dan nilai detiknya digunakan sebagai nilai detik untuk metadata.event_timestamp.
cs1 security_result.rule_name Nilai kolom cs1 ditetapkan ke kolom security_result.rule_name.
cs10 target.resource.attribute.labels.value Nilai kolom cs10 ditetapkan ke kolom value dalam target.resource.attribute.labels.
cs10Label target.resource.attribute.labels.key Nilai kolom cs10Label ditetapkan ke kolom key dalam target.resource.attribute.labels.
cs11 principal.application Nilai kolom cs11 ditetapkan ke kolom principal.application.
cs12 security_result.description Nilai kolom cs12, setelah menghapus tanda kurung kurawal dan tanda dolar, ditetapkan ke kolom security_result.description.
cs14 target.resource.attribute.labels.value Nilai kolom cs14 ditetapkan ke kolom value dalam target.resource.attribute.labels.
cs14Label target.resource.attribute.labels.key Nilai kolom cs14Label ditetapkan ke kolom key dalam target.resource.attribute.labels.
cs15 security_result.summary Nilai kolom cs15 ditetapkan ke kolom security_result.summary.
cs16 principal.process.command_line Nilai kolom cs16 ditetapkan ke kolom principal.process.command_line.
cs17 target.resource.resource_subtype Nilai kolom cs17 ditetapkan ke kolom target.resource.resource_subtype.
cs2 principal.group.group_display_name Nilai kolom cs2 ditetapkan ke kolom principal.group.group_display_name.
cs3 principal.hostname, principal.asset.hostname Nilai kolom cs3 ditetapkan ke kolom principal.hostname dan principal.asset.hostname.
cs4 target.application Nilai kolom cs4 ditetapkan ke kolom target.application, kecuali jika nilainya adalah "ProcessWitness".
cs5 metadata.description Nilai kolom cs5 ditetapkan ke kolom metadata.description.
cs6 target.resource_ancestors.name Nilai kolom cs6 ditetapkan ke kolom target.resource_ancestors.name.
cs7 target.resource_ancestors.resource_subtype Nilai kolom cs7 ditetapkan ke kolom target.resource_ancestors.resource_subtype.
cs8 target.resource.name, target.resource.resource_type Nilai kolom cs8 ditetapkan ke kolom target.resource.name, dan target.resource.resource_type ditetapkan ke "DATABASE".
cs9 principal.user.userid Nilai kolom cs9 ditetapkan ke kolom principal.user.userid.
description security_result.description Nilai kolom description ditetapkan ke kolom security_result.description.
dest-ip target.ip, target.asset.ip Alamat IP yang diekstrak dari kolom dest-ip ditetapkan ke kolom target.ip dan target.asset.ip.
dest-port target.port Nilai kolom dest-port, yang dikonversi menjadi bilangan bulat, ditetapkan ke kolom target.port.
deviceExternalId intermediary.hostname Nilai kolom deviceExternalId ditetapkan ke kolom intermediary.hostname.
dpt target.port Nilai kolom dpt, yang dikonversi menjadi bilangan bulat, ditetapkan ke kolom target.port.
dst target.ip, target.asset.ip Nilai kolom dst ditetapkan ke kolom target.ip dan target.asset.ip.
duser target.user.userid Nilai kolom duser ditetapkan ke kolom target.user.userid.
eventId metadata.product_log_id Nilai kolom eventId ditetapkan ke kolom metadata.product_log_id.
gateway-name security_result.detection_fields.value Nilai kolom gateway-name ditetapkan ke kolom value dalam security_result.detection_fields. key yang sesuai adalah "gateway-name".
http.request.method network.http.method Nilai kolom http.request.method ditetapkan ke kolom network.http.method.
http.request.user-agent network.http.user_agent Nilai kolom http.request.user_agent ditetapkan ke kolom network.http.user_agent.
http.response.code network.http.response_code Nilai kolom http.response.code, yang dikonversi menjadi bilangan bulat, ditetapkan ke kolom network.http.response_code.
http.session-id network.session_id Nilai kolom http.session-id ditetapkan ke kolom network.session_id.
http.user-name principal.user.userid Nilai kolom http.user-name, dengan tanda petik di sekitarnya dihapus, ditetapkan ke kolom principal.user.userid.
log_type metadata.log_type Nilai kolom log_type dari log mentah ditetapkan ke kolom metadata.log_type.
mx-ip intermediary.ip Nilai kolom mx-ip ditetapkan ke kolom intermediary.ip.
MxIP intermediary.ip Nilai kolom MxIP ditetapkan ke kolom intermediary.ip.
OSUser principal.user.userid Nilai kolom OSUser ditetapkan ke kolom principal.user.userid.
policy-name security_result.detection_fields.value Nilai kolom policy-name ditetapkan ke kolom value dalam security_result.detection_fields. key yang sesuai adalah "policy-name".
pquery target.resource.name, target.process.command_line Jika pquery tidak kosong dan berisi kata "from", nama tabel akan diekstrak dan ditetapkan ke target.resource.name, target.resource.resource_type akan ditetapkan ke "TABLE", dan seluruh nilai pquery akan ditetapkan ke target.process.command_line. Jika tidak, seluruh nilai pquery akan ditetapkan ke target.resource.name.
pro security_result.description Nilai kolom pro ditetapkan ke kolom security_result.description.
product metadata.product_name Nilai kolom product ditetapkan ke kolom metadata.product_name.
product_type metadata.product_event_type Nilai kolom product_type ditetapkan ke kolom metadata.product_event_type.
protocol network.ip_protocol Jika nilai kolom protocol adalah "TCP" atau "UDP", nilai tersebut akan ditetapkan ke kolom network.ip_protocol.
proto network.ip_protocol Nilai kolom proto ditetapkan ke kolom network.ip_protocol.
reason security_result.rule_name Nilai kolom reason ditetapkan ke kolom security_result.rule_name.
rt metadata.event_timestamp.seconds Nilai rt diuraikan dan nilai detiknya digunakan sebagai nilai detik untuk metadata.event_timestamp.
server-group-name target.resource.attribute.labels.value Nilai kolom server-group-name ditetapkan ke kolom value dalam target.resource.attribute.labels. key yang sesuai adalah "server-group-name".
server-group-simulation-mode target.resource.attribute.labels.value Nilai kolom server-group-simulation-mode ditetapkan ke kolom value dalam target.resource.attribute.labels. key yang sesuai adalah "server-group-simulation-mode".
service-name target.resource.attribute.labels.value Nilai kolom service-name ditetapkan ke kolom value dalam target.resource.attribute.labels. key yang sesuai adalah "service-name".
ServiceName target.application Jika ApplicationName tidak kosong dan ServiceName kosong, nilai ApplicationName akan ditetapkan ke ServiceName. Nilai ServiceName kemudian ditetapkan ke target.application.
severity security_result.severity, security_result.severity_details Nilai kolom severity dikonversi menjadi huruf besar. Jika salah satunya adalah "RENDAH", "SEDANG", "TINGGI", "KRITIS", maka akan ditetapkan ke security_result.severity. Jika "INFORMATIVE" atau "INFO", security_result.severity akan ditetapkan ke "INFORMATIONAL". Nilai asli juga ditetapkan ke security_result.severity_details.
severity_data security_result.severity Nilai kolom severity_data dikonversi menjadi huruf besar. Jika salah satunya adalah "HIGH", "LOW", "MEDIUM", "CRITICAL", "ERROR", "INFORMATIONAL", maka akan ditetapkan ke security_result.severity.
source-ip principal.ip, principal.asset.ip Nilai kolom source-ip ditetapkan ke kolom principal.ip dan principal.asset.ip.
source-port principal.port Nilai kolom source-port, yang dikonversi menjadi bilangan bulat, ditetapkan ke kolom principal.port.
spt principal.port Nilai kolom spt, yang dikonversi menjadi bilangan bulat, ditetapkan ke kolom principal.port.
src principal.ip, principal.asset.ip Nilai kolom src ditetapkan ke kolom principal.ip dan principal.asset.ip.
srcapp principal.application Nilai kolom srcapp ditetapkan ke kolom principal.application.
srchost principal.hostname, principal.asset.hostname Nilai kolom srchost ditetapkan ke kolom principal.hostname dan principal.asset.hostname.
vendor metadata.vendor_name Nilai kolom vendor ditetapkan ke kolom metadata.vendor_name.
version metadata.product_version Nilai kolom version ditetapkan ke kolom metadata.product_version.
violation-id security_result.detection_fields.value Nilai kolom violation-id ditetapkan ke kolom value dalam security_result.detection_fields. key yang sesuai adalah "violation-id".
violation-type security_result.detection_fields.value Nilai kolom violation-type ditetapkan ke kolom value dalam security_result.detection_fields. key yang sesuai adalah "violation-type".
timestamp event.idm.read_only_udm.metadata.event_timestamp Dipetakan dari log perubahan
externalId event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
deviceCustomDate1 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
flexString1 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
flexString2 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
flexString2Label event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
requestContext event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
flexNumber1 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cn2 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cn1 event.idm.read_only_udm.metadata.product_log_id Dipetakan dari log perubahan
ad.host event.idm.read_only_udm.observer.hostname Dipetakan dari log perubahan
requestMethod event.idm.read_only_udm.network.http.method Dipetakan dari log perubahan
request event.idm.read_only_udm.target.url Dipetakan dari log perubahan
msg event.idm.read_only_udm.security_result.summary Dipetakan dari log perubahan
flexNumber2 event.idm.read_only_udm.network.received_bytes Dipetakan dari log perubahan
flexString2 event.idm.read_only_udm.network.http.response_code Dipetakan dari log perubahan
cs6 event.idm.read_only_udm.network.http.user_agent Dipetakan dari log perubahan
name event.idm.read_only_udm.metadata.description Dipetakan dari log perubahan
cs2 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cs3 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cs4 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
suser event.idm.read_only_udm.principal.user.userid Dipetakan dari log perubahan
login_user event.idm.read_only_udm.principal.user.user_display_name Dipetakan dari log perubahan
princ_ip event.idm.read_only_udm.principal.ip dan event.idm.read_only_udm.principal.asset.ip Dipetakan dari log perubahan
cs1 event.idm.read_only_udm.security_result.rule_name Dipetakan dari log perubahan
cs5 event.idm.read_only_udm.security_result.description Dipetakan dari log perubahan
device_vendor event.idm.read_only_udm.metadata.vendor_name Dipetakan dari log perubahan
device_product event.idm.read_only_udm.metadata.product_name Dipetakan dari log perubahan
cs9 event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cs9Label event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cs17 event.idm.read_only_udm.target.resource.attribute.labels Dipetakan dari log perubahan
cs2Label event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
additional_json_data event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cs5 event.idm.read_only_udm.target.application Dipetakan dari log perubahan
cs4 event.idm.read_only_udm.target.resource.attribute.labels Dipetakan dari log perubahan
cs6 event.idm.read_only_udm.principal.application Dipetakan dari log perubahan
cs7 event.idm.read_only_udm.security_result.description Dipetakan dari log perubahan
cs11 event.idm.read_only_udm.target.resource.name Dipetakan dari log perubahan
cs10 event.idm.read_only_udm.metadata.product_log_id Dipetakan dari log perubahan
cs15 event.idm.read_only_udm.target.resource.attribute.labels Dipetakan dari log perubahan
cs9 event.idm.read_only_udm.security_result.threat_id Dipetakan dari log perubahan
cs12 event.idm.read_only_udm.principal.user.userid Dipetakan dari log perubahan
inter_host event.idm.read_only_udm.intermediary.hostname Dipetakan dari log perubahan
cs13 event.idm.read_only_udm.principal.hostname Dipetakan dari log perubahan
cs13 metadata.product_log_id Dipetakan dari log perubahan
cs1Label security_result.detection_fields Dipetakan dari log perubahan
cs2Label security_result.detection_fields Dipetakan dari log perubahan
cs3Label security_result.detection_fields Dipetakan dari log perubahan
cs5Label security_result.detection_fields Dipetakan dari log perubahan
cs10Label additional.fields Dipetakan dari log perubahan
cs12Label additional.fields Dipetakan dari log perubahan
cs13Label additional.fields Dipetakan dari log perubahan
cs14Label additional.fields Dipetakan dari log perubahan
cs16Label additional.fields Dipetakan dari log perubahan
cs17Label additional.fields Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

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