Mengumpulkan log Extreme Wireless
Versi Parser: 2.0
Dokumen ini menjelaskan cara menyerap log Extreme Wireless ke Google Security Operations menggunakan agen Bindplane.
Pengontrol nirkabel Extreme Networks menghasilkan pesan syslog untuk peristiwa asosiasi dan pelepasan klien, autentikasi, interaksi RADIUS, dan perubahan status titik akses. Parser mengekstrak kolom menggunakan pola grok dan memetakannya ke Model Data Terpadu (UDM).
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 pengontrol Extreme Networks CloudIQ
- Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
- Akses istimewa ke Extreme Networks CloudIQ
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 agen 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
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 aktif (berjalan).
Referensi penginstalan tambahan
Untuk opsi penginstalan dan pemecahan masalah tambahan, lihat Panduan penginstalan agen BindPlane.
Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps
Cari file konfigurasi
Linux:
sudo nano /etc/bindplane-agent/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edit file konfigurasi
Ganti seluruh konten
config.yamldengan konfigurasi berikut:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/extreme_wireless: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: EXTREME_WIRELESS raw_log_field: body service: pipelines: logs/extreme_wireless_to_chronicle: receivers: - udplog exporters: - chronicle/extreme_wireless
Parameter konfigurasi
Ganti placeholder berikut:
Konfigurasi penerima:
listen_address: Alamat IP dan port yang akan diproses:0.0.0.0untuk mendengarkan di semua antarmuka (direkomendasikan)- Port
514adalah port syslog standar (memerlukan root di Linux; gunakan1514untuk non-root)
Konfigurasi pengekspor:
creds_file_path: Jalur lengkap ke file autentikasi penyerapan:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: ID Pelanggan yang disalin dari konsol Google SecOpsendpoint: URL endpoint regional:- Amerika Serikat:
malachiteingestion-pa.googleapis.com - Eropa:
europe-malachiteingestion-pa.googleapis.com - Asia:
asia-southeast1-malachiteingestion-pa.googleapis.com - Lihat Endpoint Regional untuk mengetahui daftar lengkapnya
- Amerika Serikat:
Simpan file konfigurasi
- Setelah mengedit, simpan file:
- Linux: Tekan
Ctrl+O, laluEnter, laluCtrl+X - Windows: Klik File > Simpan
- 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 layanan:
- Tekan
Win+R, ketikservices.msc, lalu tekan Enter. - Cari observIQ OpenTelemetry Collector.
- Klik kanan, lalu pilih Mulai ulang.
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 syslog di Extreme Networks CloudIQ
- Login ke UI web CloudIQ.
- Buka Configure > Common Objects > Management > Syslog Servers.
- Klik +.
- Berikan detail konfigurasi berikut:
- Name: Berikan nama unik untuk server.
- Tingkat keparahan: Pilih Info.
- Pilih alamat IP syslog yang ada dari menu Pilih, atau klik +.
- Masukkan alamat IP agen Bindplane.
- Masukkan nomor port agen Bindplane.
- Klik TAMBAHKAN.
- Klik Save Syslog Server.
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
action |
security_result.detection_fields.key |
Nilai kolom action dari log mentah dipetakan ke security_result.detection_fields.key. |
action |
security_result.detection_fields.value |
Nilai kolom action dari log mentah dipetakan ke security_result.detection_fields.value. |
BSSID |
principal.resource.attribute.labels.key |
String "BSSID" ditetapkan ke principal.resource.attribute.labels.key. |
BSSID |
principal.resource.attribute.labels.value |
Nilai kolom BSSID dari log mentah dipetakan ke principal.resource.attribute.labels.value. |
collection_time.nanos |
metadata.event_timestamp.nanos |
Nilai collection_time.nanos dari log mentah dipetakan ke metadata.event_timestamp.nanos. |
collection_time.seconds |
metadata.event_timestamp.seconds |
Nilai collection_time.seconds dari log mentah dipetakan ke metadata.event_timestamp.seconds. |
collection_time.seconds |
timestamp.seconds |
Nilai collection_time.seconds dari log mentah dipetakan ke timestamp.seconds. |
collection_time.nanos |
timestamp.nanos |
Nilai collection_time.nanos dari log mentah dipetakan ke timestamp.nanos. |
data |
security_result.description |
Nilai kolom data dari log mentah, setelah mengalami beberapa transformasi gsub untuk menghapus karakter yang tidak diinginkan dan nilai "N/A", dipetakan ke kolom security_result.description. |
description |
security_result.description |
Nilai kolom description, yang diekstrak oleh parser grok, dipetakan ke kolom security_result.description. |
first |
security_result.detection_fields.key |
String "first" ditetapkan ke security_result.detection_fields.key. |
first |
security_result.detection_fields.value |
Nilai kolom first dari log mentah dipetakan ke security_result.detection_fields.value. |
hostname |
principal.asset.hostname |
Nilai kolom hostname dari log mentah dipetakan ke kolom principal.asset.hostname dan principal.hostname. |
hostname |
principal.hostname |
Nilai kolom hostname dari log mentah dipetakan ke kolom principal.asset.hostname dan principal.hostname. |
IP |
principal.asset.ip |
Nilai kolom IP dari log mentah dipetakan ke kolom principal.asset.ip dan principal.ip. |
IP |
principal.ip |
Nilai kolom IP dari log mentah dipetakan ke kolom principal.asset.ip dan principal.ip. |
MAC |
principal.resource.attribute.labels.key |
String "MAC" ditetapkan ke principal.resource.attribute.labels.key. |
MAC |
principal.resource.attribute.labels.value |
Nilai kolom MAC dari log mentah dipetakan ke principal.resource.attribute.labels.value. |
medium |
security_result.detection_fields.key |
String "medium" ditetapkan ke security_result.detection_fields.key. |
medium |
security_result.detection_fields.value |
Nilai kolom medium dari log mentah dipetakan ke security_result.detection_fields.value. metadata.event_type ditentukan oleh logika dalam parser. Jika kedua ID mesin principal dan target ada, ID tersebut akan ditetapkan ke NETWORK_CONNECTION. Jika ID pengguna principal atau target ada, nilainya ditetapkan ke USER_UNCATEGORIZED. Jika hanya ID mesin principal yang ada, ID tersebut akan ditetapkan ke STATUS_UPDATE. Jika tidak, nilai defaultnya adalah GENERIC_EVENT. String "EXTREME WIRELESS" ditetapkan ke metadata.product_name. |
prod_event_type |
metadata.product_event_type |
Nilai kolom prod_event_type dari log mentah dipetakan ke kolom metadata.product_event_type. |
port |
principal.port |
Nilai kolom port dari log mentah, yang dikonversi menjadi bilangan bulat, dipetakan ke kolom principal.port. |
problem_summary |
security_result.summary |
Nilai kolom problem_summary dari log mentah dipetakan ke kolom security_result.summary. |
SSID |
principal.resource.attribute.labels.key |
String "SSID" ditetapkan ke principal.resource.attribute.labels.key. |
SSID |
principal.resource.attribute.labels.value |
Nilai kolom SSID dari log mentah dipetakan ke principal.resource.attribute.labels.value. |
station |
principal.asset.hostname |
Nilai kolom station dari log mentah dipetakan ke kolom principal.asset.hostname dan principal.hostname. |
station |
principal.hostname |
Nilai kolom station dari log mentah dipetakan ke kolom principal.asset.hostname dan principal.hostname. |
target_host |
target.asset.hostname |
Nilai kolom target_host dari log mentah dipetakan ke kolom target.asset.hostname dan target.hostname. |
target_host |
target.hostname |
Nilai kolom target_host dari log mentah dipetakan ke kolom target.asset.hostname dan target.hostname. |
target_ip |
target.asset.ip |
Nilai kolom target_ip dari log mentah dipetakan ke kolom target.asset.ip dan target.ip. |
target_ip |
target.ip |
Nilai kolom target_ip dari log mentah dipetakan ke kolom target.asset.ip dan target.ip. |
target_port |
target.port |
Nilai kolom target_port dari log mentah, yang dikonversi menjadi bilangan bulat, dipetakan ke kolom target.port. |
target_user |
target.user.userid |
Nilai kolom target_user dari log mentah dipetakan ke kolom target.user.userid. |
user-profile |
security_result.detection_fields.key |
String "profil pengguna" ditetapkan ke security_result.detection_fields.key. |
user-profile |
security_result.detection_fields.value |
Nilai kolom user-profile dari log mentah dipetakan ke security_result.detection_fields.value. |
username |
principal.user.userid |
Nilai kolom username dari log mentah dipetakan ke kolom principal.user.userid. String "EXTREME_WIRELESS" ditetapkan ke metadata.vendor_name. |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.