Mengumpulkan log Rapid7 Nexpose

Didukung di:

Dokumen ini menjelaskan cara menyerap log Rapid7 Nexpose ke Google Security Operations menggunakan agen Bindplane.

Rapid7 Nexpose (sekarang InsightVM) adalah platform manajemen kerentanan lokal yang digunakan untuk memindai, menilai, dan memprioritaskan kerentanan keamanan di seluruh jaringan Anda. Solusi ini menyediakan Konsol Keamanan berbasis web yang dapat diakses di https://<host>:3780 dan mendukung ekspor syslog native untuk meneruskan hasil pemindaian, penemuan kerentanan, dan peristiwa perubahan aset.

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 Rapid7 Nexpose Security Console
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke Rapid7 Nexpose Security Console dengan peran Global Administrator atau Security Manager

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 gunakan 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:
    • Service account name: Masukkan nama akun (misalnya, bindplane-ingest).
    • Service account description: 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 dan klik Create. File kunci akan didownload ke komputer Anda.
  11. Simpan file kunci sebagai ingestion-auth.json di direktori kolektor Bindplane (/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 Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka Settings > Collection Agents.
  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 > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
  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 active (running).

Referensi penginstalan tambahan

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

Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps

Menemukan file konfigurasi

  • Linux:

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

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

Mengedit file konfigurasi

  • Ganti seluruh konten config.yaml dengan konfigurasi berikut:

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/rapid7_nexpose:
        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: RAPID7_NEXPOSE
        raw_log_field: body
    
    service:
      pipelines:
        logs/rapid7_nexpose_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/rapid7_nexpose
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • listen_address: Alamat IP dan port untuk diproses:
      • 0.0.0.0 untuk memproses 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 tetapkan 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 ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, ganti malachiteingestion-pa.googleapis.com dengan endpoint regional Anda (misalnya, europe-malachiteingestion-pa.googleapis.com).

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

Simpan file konfigurasi

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

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 Restart.
      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 Rapid7 Nexpose

  1. Login ke antarmuka web Rapid7 Nexpose Security Console di https://<nexpose-host>:3780.
  2. Buka Administration > Global Settings.
  3. Scroll ke bawah ke bagian Syslog.
  4. Aktifkan penerusan syslog dan berikan detail konfigurasi berikut:
    • Syslog Server: Masukkan alamat IP host agen Bindplane.
    • Port: Masukkan 514 (atau port yang dikonfigurasi di penerima agen Bindplane).
    • Protocol: Pilih UDP (atau TCP jika dikonfigurasi di penerima).
  5. Klik Simpan.
  6. Untuk memverifikasi bahwa pesan syslog dikirim, jalankan pemindaian dan periksa log agen Bindplane untuk pesan masuk.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
additional.fields Digabungkan dari array kategori sebagai key-value pair "App Stack"; digabungkan dari kolom pci (adjustedCVSSScore, adjustedSeverityScore, fail, status) sebagai key-value pair; digabungkan dari kolom cvss v2/v3 sebagai kolom deteksi di sec_result
asset_id principal.asset.asset_id Setel ke "assetID: %{asset_id}" jika asset_id != ""
kategori additional.fields Digabungkan sebagai daftar nilai kunci "App Stack"
cve_id, cve_year extensions.vulns.vulnerabilities.cve_id Digabungkan dari cve_year dan cve_id jika keduanya ada
cvss.links, cvss.v2.accessComplexity, cvss.v2.accessVector, cvss.v2.authentication, cvss.v2.availabilityImpact, cvss.v2.confidentialityImpact, cvss.v2.integrityImpact, cvss.v2.vector, cvss.v3.attackComplexity, cvss.v3.attackVector, cvss.v3.availabilityImpact, cvss.v3.confidentialityImpact, cvss.v3.integrityImpact, cvss.v3.privilegeRequired, cvss.v3.scope, cvss.v3.userInteraction, cvss.v3.vector, links security_result.detection_fields Digabungkan dari link dan cvss.links sebagai key-value pair; digabungkan dari kolom cvss v2/v3 sebagai key-value pair dengan awalan (misalnya, "v2 accessComplexity")
menurun extensions.vulns.vulnerabilities.description Nilai disalin langsung dari desc jika ada
deskripsi metadata.description Nilai dari description.text jika deskripsi kosong, jika tidak, nilai akan disalin langsung
description.text metadata.description Nilai disalin langsung jika deskripsi kosong
event_type metadata.event_type Setel ke "SCAN_VULN_HOST" jika vulnerability_description atau vulnerability_data ada, atau "SCAN_HOST" jika has_principal bernilai benar, atau "GENERIC_EVENT"
has_principal Tetapkan ke true jika ip_address, host_name, atau asset_id ditetapkan
has_target Tetapkan ke true jika target_ip ditetapkan
host_name principal.hostname, principal.asset.hostname Nilai disalin langsung jika host_name != ""
ip_address principal.ip, principal.asset.ip Nilai disalin langsung jika ip_address != ""
last_assessed_for_vulnerabilities Dikonversi ke stempel waktu menggunakan berbagai format tanggal atau UNIX/UNIX_MS
pci.adjustedCVSSScore additional.fields Digabungkan sebagai key-value pair "adjustedCVSSScore" jika tidak kosong
pci.adjustedSeverityScore additional.fields Digabungkan sebagai pasangan nilai kunci "adjustedSeverityScore" jika tidak kosong
pci.fail additional.fields Digabungkan sebagai pasangan nilai kunci "fail" jika tidak kosong
pci.status additional.fields Digabungkan sebagai pasangan nilai kunci "status" jika tidak kosong
sec_result security_result Nilai disalin langsung jika sec_result != ""
target_ip target.ip, target.asset.ip Nilai disalin langsung jika target_ip != ""
timestamp Dikonversi menggunakan format stempel waktu syslog
title extensions.vulns.vulnerabilities.description Nilai dari vulnerability.Vulnerability_Title jika ada
vulnerability.Vulnerability_Severity extensions.vulns.vulnerabilities.severity Setel ke "HIGH" jika "Severe", "CRITICAL" jika "Critical", "MEDIUM" jika "Moderate"
vulnerability.Vulnerability_Title extensions.vulns.vulnerabilities.description Nilai disalin langsung
vulnerability.vulnerability_id extensions.vulns.vulnerabilities.vendor_vulnerability_id Nilai disalin langsung jika ada
vulnerability_data extensions.vulns.vulnerabilities Digabungkan dari setiap objek kerentanan dengan tingkat keparahan, cve_id, deskripsi, vendor_vulnerability_id
vulnerability_description extensions.vulns.vulnerabilities.description, metadata.description Digabungkan sebagai objek kerentanan jika ada; ditetapkan ke metadata.description
metadata.product_name Tetapkan ke "Nexpose"
metadata.vendor_name Tetapkan ke "Rapid7"
categories", "pci.adjustedCVSSScore", "pci.adjustedSeverityScore", "pci.fail", and "pci.status additional.fields Dipetakan dari log perubahan
cvss.v2.accessComplexity", "cvss.v2.accessVector", "cvss.v2.authentication", "cvss.v2.availabilityImpact", "cvss.v2.confidentialityImpact", "cvss.v2.integrityImpact", "cvss.v2.vector", "cvss.v3.attackComplexity", "cvss.v3.attackVector", "cvss.v3.availabilityImpact", "cvss.v3.confidentialityImpact", "cvss.v3.privilegeRequired", "cvss.v3.integrityImpact", "cvss.v3.scope", "cvss.v3.userInteraction", and "cvss.v3.vector security_result.detection_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.