Dokumen ini menjelaskan cara mengumpulkan log Barracuda Web Application Firewall (WAF) menggunakan Bindplane. Parser mengekstrak kolom dari log dalam format JSON dan Syslog, menormalisasinya, dan memetakannya ke Model Data Terpadu (UDM). Fitur ini menangani berbagai jenis log (traffic, firewall web) dan melakukan transformasi bersyarat berdasarkan nilai kolom, termasuk resolusi alamat IP/nama host, pemetaan arah, dan normalisasi tingkat keparahan.
Sebelum memulai
Pastikan Anda memiliki instance Google Security Operations.
Pastikan Anda menggunakan Windows 2016 atau yang lebih baru, atau host Linux dengan systemd.
Jika berjalan di belakang proxy, pastikan port firewall terbuka.
Pastikan Anda memiliki akses istimewa ke Barracuda WAF.
Mendapatkan file autentikasi penyerapan Google SecOps
Login ke konsol Google SecOps.
Buka Setelan SIEM > Agen Pengumpulan.
Download File Autentikasi Penyerapan. Simpan file dengan aman di sistem tempat BindPlane akan diinstal.
Mendapatkan ID pelanggan Google SecOps
Login ke konsol Google SecOps.
Buka Setelan SIEM > Profil.
Salin dan simpan ID Pelanggan dari bagian Detail Organisasi.
Menginstal agen Bindplane
Penginstalan Windows
Buka Command Prompt atau PowerShell sebagai administrator.
Mengonfigurasi agen BindPlane untuk menyerap Syslog dan mengirimkannya ke Google SecOps
Akses file konfigurasi:
Cari file config.yaml. Biasanya, file ini berada di direktori /etc/bindplane-agent/ di Linux atau di direktori penginstalan di Windows.
Buka file menggunakan editor teks (misalnya, nano, vi, atau Notepad).
Edit file config.yaml sebagai berikut:
receivers:tcplog:# Replace the port and IP address as requiredlisten_address:"0.0.0.0:54525"exporters:chronicle/chronicle_w_labels:compression:gzip# Adjust the path to the credentials file you downloaded in Step 1creds:'/path/to/ingestion-authentication-file.json'# Replace with your actual customer ID from Step 2customer_id:<customer_id>
endpoint:malachiteingestion-pa.googleapis.com# Add optional ingestion labels for better organizationingestion_labels:log_type:SYSLOGnamespace:barracuda_wafraw_log_field:bodyservice:pipelines:logs/source0__chronicle_w_labels-0:receivers:-tcplogexporters:-chronicle/chronicle_w_labels
Ganti port dan alamat IP sesuai kebutuhan di infrastruktur Anda.
Ganti <customer_id> dengan ID pelanggan yang sebenarnya.
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:
sudosystemctlrestartbindplane-agent
Untuk memulai ulang agen Bindplane di Windows, Anda dapat menggunakan konsol Services atau memasukkan perintah berikut:
net stop BindPlaneAgent && net start BindPlaneAgent
Mengonfigurasi Barracuda WAF
Login ke konsol Barracuda WAF menggunakan kredensial administrator.
Klik Tab lanjutan > Ekspor log.
Di bagian Log ekspor, klik Tambahkan server log ekspor.
Berikan nilai berikut:
Nama: masukkan nama untuk penerusan Google SecOps.
Log server type: pilih Syslog.
Alamat IP atau nama host: masukkan alamat IP Bindplane.
Port: masukkan port Bindplane.
Jenis koneksi: pilih jenis koneksi TCP (TCP direkomendasikan. Namun, protokol UDP atau SSL juga dapat digunakan).
Validasi sertifikat server: pilih Tidak.
Sertifikat klien: pilih Tidak ada.
Log timestamp and hostname: pilih Yes.
Klik Tambahkan.
Tabel Pemetaan UDM
Kolom Log
Pemetaan UDM
Logika
action
security_result.action
Jika action adalah DENY, tetapkan ke BLOCK. Jika tidak, setel 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 tidak bertanda tangan dan dipetakan untuk jenis log TR.
bytesSent
network.sent_bytes
Dikonversi menjadi bilangan bulat tidak bertanda tangan dan dipetakan untuk jenis log TR.
hostName
target.hostname
Jika hostName bukan alamat IP, gunakan nilainya. Jika tidak, akan digabungkan ke target.ip.
httpMethodloginId
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, setel ke INFORMATIONAL.
src
principal.ip
Juga digunakan untuk peristiwa firewall umum dan beberapa pembaruan status.
Digabungkan dengan tz dan diuraikan untuk membuat stempel waktu acara. Detik dan nanodetik diekstrak dan diisi di kolom masing-masing.
urlurlParams
target.url
Ditambahkan ke url jika tidak sama dengan emptyToken untuk jenis log TR.
userAgentuserName
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. Hardcode ke Barracuda. Ditetapkan ke NETWORK_HTTP jika src dan target ada. Disetel ke STATUS_UPDATE jika hanya src yang ada. Tetapkan ke GENERIC_EVENT sebagai default atau untuk skenario lain seperti parsing CEF. Hardcode ke BARRACUDA_WAF.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis guide explains how to collect and forward Barracuda Web Application Firewall (WAF) logs to Google Security Operations (SecOps) using the Bindplane agent, supporting both JSON and Syslog formats.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves downloading an ingestion authentication file and customer ID from the Google SecOps console, installing the Bindplane agent on either a Windows or Linux system, and configuring it to send Syslog data.\u003c/p\u003e\n"],["\u003cp\u003eThe Bindplane agent normalizes extracted fields from the logs and maps them to the Unified Data Model (UDM), including conditional transformations for IP/hostname resolution, directionality, and severity.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration steps include modifying the \u003ccode\u003econfig.yaml\u003c/code\u003e file to define log receivers, exporters, and ingestion parameters, ensuring proper customer ID and authentication file path details are inserted.\u003c/p\u003e\n"],["\u003cp\u003eThe Barracuda WAF console should be configured to forward logs to Bindplane via Syslog over a specified IP address and port using the recommended TCP connection type.\u003c/p\u003e\n"]]],[],null,["# Collect Barracuda WAF logs\n==========================\n\nSupported in: \nGoogle secops [SIEM](/chronicle/docs/secops/google-secops-siem-toc)\n| **Note:** This feature is covered by [Pre-GA Offerings Terms](https://chronicle.security/legal/service-terms/) of the Google Security Operations Service Specific Terms. Pre-GA features might have limited support, and changes to pre-GA features might not be compatible with other pre-GA versions. For more information, see the [Google SecOps Technical Support Service guidelines](https://chronicle.security/legal/technical-support-services-guidelines/) and the [Google SecOps Service Specific Terms](https://chronicle.security/legal/service-terms/).\n\nThis document explains how to collect Barracuda Web Application Firewall (WAF) logs using Bindplane. The parser extracts fields from logs in JSON and Syslog formats, normalizes them, and maps them to the Unified Data Model (UDM). It handles various log types (traffic, web firewall) and performs conditional transformations based on field values, including IP address/hostname resolution, directionality mapping, and severity normalization.\n\nBefore you begin\n----------------\n\n- Ensure that you have a Google Security Operations instance.\n- Ensure that you are using Windows 2016 or later, or a Linux host with `systemd`.\n- If running behind a proxy, ensure firewall [ports](/chronicle/docs/ingestion/use-bindplane-agent#verify_the_firewall_configuration) are open.\n- Ensure that you have privileged access to the Barracuda WAF.\n\nGet Google SecOps ingestion authentication file\n-----------------------------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Collection Agents**.\n3. Download the **Ingestion Authentication File**. Save the file securely on the system where Bindplane will be installed.\n\nGet Google SecOps customer ID\n-----------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Profile**.\n3. Copy and save the **Customer ID** from the **Organization Details** section.\n\nInstall the Bindplane agent\n---------------------------\n\n### Windows installation\n\n1. Open the **Command Prompt** or **PowerShell** as an administrator.\n2. Run the following command:\n\n msiexec /i \"https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi\" /quiet\n\n### Linux installation\n\n1. Open a terminal with root or sudo privileges.\n2. Run the following command:\n\n sudo sh -c \"$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)\" install_unix.sh\n\n### Additional installation resources\n\n- For additional installation options, consult this [installation guide](/chronicle/docs/ingestion/use-bindplane-agent#install_the_bindplane_agent).\n\nConfigure the Bindplane agent to ingest Syslog and send to Google SecOps\n------------------------------------------------------------------------\n\n1. Access the configuration file:\n\n 1. Locate the `config.yaml` file. Typically, it's in the `/etc/bindplane-agent/` directory on Linux or in the installation directory on Windows.\n 2. Open the file using a text editor (for example, `nano`, `vi`, or Notepad).\n2. Edit the `config.yaml` file as follows:\n\n receivers:\n tcplog:\n # Replace the port and IP address as required\n listen_address: \"0.0.0.0:54525\"\n\n exporters:\n chronicle/chronicle_w_labels:\n compression: gzip\n # Adjust the path to the credentials file you downloaded in Step 1\n creds: '/path/to/ingestion-authentication-file.json'\n # Replace with your actual customer ID from Step 2\n customer_id: \u003ccustomer_id\u003e\n endpoint: malachiteingestion-pa.googleapis.com\n # Add optional ingestion labels for better organization\n ingestion_labels:\n log_type: SYSLOG\n namespace: barracuda_waf\n raw_log_field: body\n\n service:\n pipelines:\n logs/source0__chronicle_w_labels-0:\n receivers:\n - tcplog\n exporters:\n - chronicle/chronicle_w_labels\n\n3. Replace the port and IP address as required in your infrastructure.\n\n4. Replace `\u003ccustomer_id\u003e` with the actual customer ID.\n\n5. Update `/path/to/ingestion-authentication-file.json` to the path where the authentication file was saved in the\n [Get Google SecOps ingestion authentication file](/chronicle/docs/ingestion/default-parsers/barracuda-waf#get-auth-file) section.\n\nRestart the Bindplane agent to apply the changes\n------------------------------------------------\n\n- To restart the Bindplane agent in Linux, run the following command:\n\n sudo systemctl restart bindplane-agent\n\n- To restart the Bindplane agent in Windows, you can either use the **Services** console or enter the following command:\n\n net stop BindPlaneAgent && net start BindPlaneAgent\n\nConfigure Barracuda WAF\n-----------------------\n\n1. Sign in to the **Barracuda WAF** console using administrator credentials.\n2. Click the **Advanced tab \\\u003e Export logs**.\n3. In the **Export logs** section, click **Add export log server**.\n4. Provide the following values:\n - **Name**: enter a name for the Google SecOps forwarder.\n - **Log server type** : select **Syslog**.\n - **IP Address or hostname** : enter the `Bindplane` IP address.\n - **Port** : enter the `Bindplane` port.\n - **Connection type** : select `TCP` connection type (TCP is recommended. However, UDP or SSL protocols can also be used).\n - **Validate server certificate** : select **No**.\n - **Client certificate** : select **None**.\n - **Log timestamp and hostname** : select **Yes**.\n - Click **Add**.\n\nUDM Mapping Table\n-----------------\n\n**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/google-security-operations-2)"]]