Mengumpulkan log Kemp Load Balancer

Didukung di:

Google SecOps SIEM

Dokumen ini menjelaskan cara menyerap log Progress Kemp LoadMaster ke Google Security Operations menggunakan agen Bindplane.

Progress Kemp LoadMaster (sebelumnya Kemp Load Balancer) adalah pengontrol pengiriman aplikasi (ADC) yang menyediakan load balancing, offloading SSL, dan pengelolaan traffic untuk aplikasi perusahaan. ADC ini mendistribusikan traffic masuk ke beberapa server untuk memastikan ketersediaan tinggi, mengoptimalkan performa, dan meningkatkan keamanan aplikasi dan layanan berbasis web.

Sebelum memulai

Pastikan Anda memiliki prasyarat berikut:

• Instance Google SecOps
• Host Windows 2016 atau yang lebih baru atau Linux dengan systemd
• Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
• Akses istimewa ke antarmuka pengguna web (WUI) Progress Kemp LoadMaster

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)

1. Login ke Google Cloud konsol dan pilih Google Cloud project 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 akan didownload ke komputer Anda.
11. Simpan file kunci sebagai ingestion-auth.json di direktori pengumpul 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 , lalu salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.

Catatan: Kunci JSON adalah kredensial. Batasi akses ke file di host Bindplane dan ganti kunci sesuai dengan kebijakan organisasi Anda.

Opsi 2: Mendownload file autentikasi penyerapan (lama)

1. Login ke konsol Google SecOps.
2. Buka SIEM Settings > Collection Agents.
3. Download ingestion authentication file.
4. Simpan file dengan aman di sistem tempat agen Bindplane akan diinstal.

Catatan: File ini mengautentikasi agen ke Ingestion API lama (malachiteingestion-pa.googleapis.com), yang telah dijadwalkan Google untuk dihentikan pada 20 Juli 2027. Rencanakan untuk beralih ke Opsi 1 sebelum tanggal tersebut.

Mendapatkan ID pelanggan Google SecOps

1. Login ke konsol Google SecOps.
2. Buka SIEM Settings > Profile.
3. Salin dan simpan ID pelanggan dari bagian Organization Details.

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
   

Penginstalan Linux

1. Buka terminal dengan hak akses 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
   

Referensi Penginstalan Tambahan

Untuk opsi pemasangan tambahan, lihat panduan pemasangan ini.

Catatan: Konfigurasi pengekspor Chronicle API memerlukan pengumpul Bindplane v1.106.0 atau yang lebih baru. Perintah sebelumnya menginstal rilis terbaru. Jika Anda memperbarui penginstalan yang ada, upgrade pengumpul sebelum mengubah konfigurasi.

Mengonfigurasi Agen Bindplane untuk menyerap Syslog dan mengirim ke Google SecOps

1. Akses File Konfigurasi:

   • Temukan file config.yaml. Biasanya, file ini berada di direktori /opt/observiq-otel-collector/ di Linux atau di direktori penginstalan di Windows.
   • Buka file menggunakan editor teks (misalnya, nano, vi, atau Notepad).

2. Edit file config.yaml sebagai berikut:

     receivers:
       udplog:
         # Replace the port and IP address as required
         listen_address: "0.0.0.0:514"
   
     exporters:
       chronicle/chronicle_w_labels:
         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
         # Adjust the path to the credentials file you downloaded in Step 1
         creds_file_path: '/path/to/ingestion-authentication-file.json'
         # Replace with your actual customer ID from Step 2
         customer_id: YOUR_CUSTOMER_ID_HERE
         endpoint: chronicle.googleapis.com
         # Add optional ingestion labels for better organization
         log_type: 'KEMP_LOADBALANCER'
         raw_log_field: body
         ingestion_labels:
   
     service:
       pipelines:
         logs/source0__chronicle_w_labels-0:
           receivers:
             - udplog
           exporters:
             - chronicle/chronicle_w_labels
   

3. Ganti port dan alamat IP sesuai kebutuhan di infrastruktur Anda.

4. Ganti YOUR_CUSTOMER_ID_HERE dengan ID pelanggan yang sebenarnya.

5. Perbarui /path/to/ingestion-authentication-file.json ke jalur file tempat file kunci akun layanan (Opsi 1) disimpan di Langkah 1.

6. Ganti <LOCATION> dengan region instance Google SecOps Anda (misalnya, us, europe, atau asia-southeast1). Pengekspor akan menambahkan awalan chronicle.googleapis.com dengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.

7. Ganti <PROJECT_NUMBER> dengan nomor project dari IAM & Admin > Settings.

Pengekspor Ingestion API lama

• Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok exporters dengan blok 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/chronicle_w_labels:
      compression: gzip
      # Adjust the path to the credentials file you downloaded in Step 1
      creds_file_path: '/path/to/ingestion-authentication-file.json'
      # Replace with your actual customer ID from Step 2
      customer_id: YOUR_CUSTOMER_ID_HERE
      endpoint: malachiteingestion-pa.googleapis.com
      # Add optional ingestion labels for better organization
      log_type: 'KEMP_LOADBALANCER'
      raw_log_field: body
      ingestion_labels:
  

Catatan: Pengekspor ini akan berhenti berfungsi saat Ingestion API dihentikan pada 20 Juli 2027.

Memulai ulang Agen Bindplane untuk menerapkan perubahan

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

     sudo systemctl restart observiq-otel-collector
   

2. Untuk memulai ulang agen Bindplane di Windows, Anda dapat menggunakan konsol Services atau memasukkan perintah berikut:

     net stop observiq-otel-collector && net start observiq-otel-collector
   

Mengonfigurasi penerusan syslog Progress Kemp LoadMaster

1. Login ke antarmuka pengguna web (WUI) Progress Kemp LoadMaster.
2. Buka System Configuration > Logging Options > Syslog Options.
3. Di kolom Remote Syslog Host, masukkan alamat IP host agen Bindplane (misalnya, 192.168.1.100).
4. Di kolom Remote Syslog Port, masukkan 514 (atau port yang dikonfigurasi di Bindplane).
5. Tetapkan opsi Info Syslog Messages ke Yes untuk mengaktifkan pesan log informasi.
6. Tetapkan opsi Warning Syslog Messages ke Yes untuk mengaktifkan pesan peringatan.
7. Tetapkan opsi Error Syslog Messages ke Yes untuk mengaktifkan pesan error.
8. Tetapkan opsi Critical Syslog Messages ke Yes untuk mengaktifkan pesan penting.
9. Tetapkan opsi Emergency Syslog Messages ke Yes untuk mengaktifkan pesan darurat.
10. Klik Set Syslog Parameters untuk menyimpan konfigurasi.
11. Untuk mengaktifkan logging syslog WAF, buka System Configuration > Logging Options > WAF Syslog Options.
12. Tetapkan opsi Remote Syslog ke Yes.

13. Klik Set WAF Syslog Parameters untuk menyimpan.

    Catatan: Untuk mengetahui informasi selengkapnya, lihat dokumentasi Progress Kemp LoadMaster.

Tabel pemetaan UDM

Kolom Log	Pemetaan UDM	Logika
hlen_label	additional.fields	Digabungkan
meta_sequenceId_label	additional.fields	Digabungkan
nhdrs_label	additional.fields	Digabungkan
intermediary	intermediary	Digabungkan
inter_hostname	intermediary.hostname	Dipetakan secara langsung
description	metadata.description	Dipetakan secara langsung
event_type	metadata.event_type	Diganti nama/dipetakan
log_event	metadata.product_event_type	Dipetakan secara langsung
sequenceId	metadata.product_log_id	Dipetakan secara langsung
ftpmethod	network.ftp.command	Dipetakan secara langsung
http_method	network.http.method	Dipetakan secara langsung
http_response_code	network.http.response_code	Dipetakan secara langsung
process_name	principal.application	Dipetakan secara langsung
src_ip	principal.ip	Digabungkan
srcip	principal.ip	Digabungkan
src_port	principal.port	Dipetakan secara langsung
srcport	principal.port	Dipetakan secara langsung
sec_result	security_result	Digabungkan
sshd	target.application	Dipetakan secara langsung
filename	target.file.full_path	Dipetakan secara langsung
file_size	target.file.size	Diganti nama/dipetakan
dest_ip	target.ip	Digabungkan
dstip	target.ip	Digabungkan
vs	target.ip	Digabungkan
dest_port	target.port	Dipetakan secara langsung
dstport	target.port	Dipetakan secara langsung
vs_port	target.port	Dipetakan secara langsung
pid	target.process.pid	Dipetakan secara langsung
http_path	target.url	Dipetakan secara langsung
resource	target.url	Dipetakan secara langsung
user	target.user.userid	Dipetakan secara langsung
T/A	additional.fields	Konstanta: meta_sequenceId_label
T/A	extensions.auth.type	Konstanta: AUTHTYPE_UNSPECIFIED
T/A	intermediary	Konstanta: intermediary
T/A	metadata.event_type	Konstanta: GENERIC_EVENT
T/A	metadata.product_name	Konstanta: KEMP_LOADBALANCER
T/A	metadata.vendor_name	Konstanta: KEMP
T/A	network.application_protocol	Konstanta: HTTP
T/A	principal.ip	Konstanta: src_ip
T/A	security_result	Konstanta: sec_result
T/A	target.ip	Konstanta: dest_ip
meta_sequenceId	event.idm.read_only_udm.additional.fields	Dipetakan dari log perubahan
event_type	USER_UNCATEGORIZED	Dipetakan dari log perubahan

Untuk mengetahui informasi selengkapnya tentang pemetaan kolom parser, lihat referensi parser KEMP_LOADBALANCER.

Log Perubahan

Lihat Log Perubahan untuk parser ini

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