Mengumpulkan log Barracuda WAF

Versi Parser: 35.0

Didukung di:

Dokumen ini menjelaskan cara menyerap log Barracuda Web Application Firewall (WAF) ke Google Security Operations menggunakan agen Bindplane.

Barracuda WAF menghasilkan log untuk traffic web (TR) dan peristiwa firewall web (WF) dalam format JSON dan syslog. Parser menormalisasi kolom dan memetakannya ke Unified Data Model (UDM), menangani resolusi alamat IP, pemetaan arah, dan normalisasi tingkat keparahan.

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 Barracuda WAF
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke Barracuda WAF

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:
      tcplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/barracuda_waf:
        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: BARRACUDA_WAF
        raw_log_field: body
    
    service:
      pipelines:
        logs/barracuda_waf_to_chronicle:
          receivers:
            - tcplog
          exporters:
            - chronicle/barracuda_waf
    

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/barracuda_waf:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: BARRACUDA_WAF
        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:

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

      ```bash
      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 Barracuda WAF

  1. Login ke konsol Barracuda WAF menggunakan kredensial administrator.
  2. Klik tab Advanced > Export logs.
  3. Di bagian Log ekspor, klik Tambahkan server log ekspor.
  4. Berikan nilai berikut:
    • Name: Masukkan nama untuk server log.
    • Log server type: Pilih Syslog.
    • IP Address or hostname: Masukkan alamat IP Bindplane.
    • Port: Masukkan port Bindplane.
    • Jenis koneksi: Pilih TCP (direkomendasikan; UDP atau SSL juga dapat digunakan).
    • Validasi sertifikat server: Pilih Tidak.
    • Sertifikat klien: Pilih None.
    • Log timestamp and hostname: Pilih Yes.
  5. Klik Tambahkan.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
action security_result.action Jika action adalah DENY, tetapkan ke BLOCK. Jika tidak, tetapkan ke ALLOW (khusus untuk jenis log WF). Juga digunakan untuk peristiwa firewall umum.
appProtocol network.application_protocol Jika appProtocol cocok dengan TLSv, tetapkan ke HTTPS. Jika tidak, gunakan nilai appProtocol.
attackDetails security_result.description Diekstrak dari log mentah untuk jenis log WF.
attackType security_result.summary Bagian dari security_result.summary, digabungkan dengan ruleType.
bytesReceived network.received_bytes Dikonversi menjadi bilangan bulat yang tidak bertanda tangan dan dipetakan untuk jenis log TR.
bytesSent network.sent_bytes Dikonversi menjadi bilangan bulat yang tidak bertanda tangan dan dipetakan untuk jenis log TR.
hostName target.hostname Jika hostName bukan alamat IP, gunakan nilainya. Jika tidak, data tersebut akan digabungkan ke dalam target.ip.
httpMethod loginId principal.user.userid Dipetakan untuk jenis log TR jika tidak sama dengan emptyToken.
logType metadata.product_event_type Jika TR, tetapkan metadata.product_event_type ke Barracuda Access Log. Jika WF, tetapkan ke Barracuda Web Firewall Log.
message metadata.description Digunakan saat desc tidak kosong.
referrer network.http.referral_url Dipetakan untuk jenis log TR jika tidak sama dengan emptyToken.
responseCode network.http.response_code Dikonversi menjadi bilangan bulat dan dipetakan untuk jenis log TR.
rule security_result.rule_name Dipetakan untuk jenis log WF.
ruleType security_result.summary Bagian dari security_result.summary, digabungkan dengan attackType.
sec_desc security_result.rule_name Digunakan untuk peristiwa firewall umum.
server target.ip Digabungkan ke dalam target.ip.
serv target.ip Digabungkan ke dalam target.ip.
severity security_result.severity Untuk jenis log WF: Dikonversi menjadi huruf besar. Jika EMERGENCY, ALER, atau CRITICAL, tetapkan security_result.severity ke CRITICAL. Jika ERROR, tetapkan ke HIGH. Jika WARNING, tetapkan ke MEDIUM. Jika NOTICE, tetapkan ke LOW. Jika tidak, tetapkan ke INFORMATIONAL.
src principal.ip Juga digunakan untuk peristiwa firewall umum dan beberapa pembaruan status.
srcPort principal.port Dikonversi ke bilangan bulat.
target targetPort target.port Dikonversi ke bilangan bulat.
time metadata.event_timestamp.seconds, metadata.event_timestamp.nanos, timestamp.seconds, timestamp.nanos Digabungkan dengan tz dan diuraikan untuk membuat stempel waktu peristiwa. Detik dan nano diekstrak dan diisi di kolom masing-masing.
url urlParams target.url Ditambahkan ke url jika tidak sama dengan emptyToken untuk jenis log TR.
userAgent userName target.user.userid, target.user.user_display_name Digunakan untuk peristiwa firewall umum. Jika tidak sama dengan emptyToken untuk jenis log TR, dipetakan ke target.user.user_display_name. Dihardcode ke Barracuda. Tetapkan ke NETWORK_HTTP jika src dan target ada. Tetapkan ke STATUS_UPDATE jika hanya src yang ada. Tetapkan ke GENERIC_EVENT sebagai default atau untuk skenario lain seperti penguraian CEF. Dihardcode ke BARRACUDA_WAF.
intermediary_host event.idm.read_only_udm.intermediary.hostname dan event.idm.read_only_udm.intermediary.asset.hostname Dipetakan dari log perubahan
syslog_priority event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
intermediary_ip event.idm.read_only_udm.intermediary.ip dan event.idm.read_only_udm.intermediary.asset.ip Dipetakan dari log perubahan
intermediary_port event.idm.read_only_udm.intermediary.port Dipetakan dari log perubahan
attackType event.idm.read_only_udm.security_result.threat_name Dipetakan dari log perubahan
policy_scope event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
reason event.idm.read_only_udm.security_result.description Dipetakan dari log perubahan
session_id event.idm.read_only_udm.network.session_id Dipetakan dari log perubahan
network_url event.idm.read_only_udm.network.http.referral_url Dipetakan dari log perubahan
inter_host null Dipetakan dari log perubahan
inter_host intermediary.hostname Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

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