Mengumpulkan log Rapid7 Nexpose
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.
Opsi 1: Membuat akun layanan untuk Chronicle API (direkomendasikan)
- Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
- Buka IAM & Admin > Service Accounts.
- Klik Create service account.
- Berikan detail konfigurasi berikut:
- Service account name: Masukkan nama akun (misalnya,
bindplane-ingest). - Service account description: Masukkan deskripsi (misalnya,
Bindplane agent log ingestion).
- Service account name: Masukkan nama akun (misalnya,
- Klik Create and continue.
- Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
- Klik Continue lalu klik Done.
- Klik akun layanan yang Anda buat, lalu buka tab Keys.
- Klik Add key > Create new key.
- Pilih JSON dan klik Create. File kunci akan didownload ke komputer Anda.
- Simpan file kunci sebagai
ingestion-auth.jsondi direktori kolektor Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsondi Linux atauC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsondi Windows), atau perbaruicreds_file_pathdiconfig.yamlagar sesuai dengan jalur tempat Anda menyimpannya. - Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.
Opsi 2: Mendownload file autentikasi penyerapan (lama)
- Login ke konsol Google SecOps.
- Buka Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka Settings > Collection Agents.
- Download file autentikasi penyerapan.
- Simpan file dengan aman di sistem tempat agen Bindplane akan diinstal.
Mendapatkan ID pelanggan Google SecOps
- Login ke konsol Google SecOps.
- Buka Setelan > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
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
- Buka Command Prompt atau PowerShell sebagai administrator.
Jalankan perintah berikut:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietTunggu hingga penginstalan selesai.
Verifikasi penginstalan dengan menjalankan:
sc query observiq-otel-collectorLayanan akan ditampilkan sebagai RUNNING.
Penginstalan Linux
- Buka terminal dengan hak istimewa root atau sudo.
Jalankan perintah berikut:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shTunggu hingga penginstalan selesai.
Verifikasi penginstalan dengan menjalankan:
sudo systemctl status observiq-otel-collectorLayanan 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.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Mengedit file konfigurasi
Ganti seluruh konten
config.yamldengan 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.0untuk memproses semua antarmuka (direkomendasikan)- Port
514adalah port syslog standar (memerlukan root di Linux; gunakan1514untuk 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
- Linux:
customer_id: ID Pelanggan yang disalin dari konsol Google SecOpslocation: Ganti<LOCATION>dengan region instance Google SecOps Anda (misalnya,us,europe, atauasia-southeast1). Pengekspor mengawalichronicle.googleapis.comdengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.project: Ganti<PROJECT_NUMBER>dengan nomor project dari IAM & Admin > Settings.endpoint: Tetap tetapkan kechronicle.googleapis.com.
Pengekspor API penyerapan lama
Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok
exportersdengan kode berikut. Tetapkancreds_file_pathke jalur ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, gantimalachiteingestion-pa.googleapis.comdengan 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, laluEnter, laluCtrl+X - Windows: Klik File > Save
- Linux: Tekan
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:
sudo systemctl restart observiq-otel-collectorPastikan layanan sedang berjalan:
sudo systemctl status observiq-otel-collectorPeriksa 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-collectorKonsol Services:
- Tekan
Win+R, ketikservices.msc, lalu tekan Enter. - Cari observIQ OpenTelemetry Collector.
- Klik kanan, lalu pilih Restart.
Pastikan layanan sedang berjalan:
sc query observiq-otel-collectorPeriksa log untuk mengetahui error:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Tekan
Mengonfigurasi penerusan syslog Rapid7 Nexpose
- Login ke antarmuka web Rapid7 Nexpose Security Console di
https://<nexpose-host>:3780. - Buka Administration > Global Settings.
- Scroll ke bawah ke bagian Syslog.
- 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).
- Klik Simpan.
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.