Mengumpulkan log Cisco Wireless LAN Controller (WLC)

Didukung di:

Dokumen ini menjelaskan cara menyerap log Cisco Wireless LAN Controller (WLC) ke Google Security Operations menggunakan Bindplane. Parser mengekstrak kolom dari pesan syslog, yang menangani format JSON dan teks biasa. Proses ini menggunakan pola grok untuk mengidentifikasi kolom utama, termasuk stempel waktu, tingkat keparahan, dan konten pesan, lalu mengisi model UDM dengan data yang diekstrak, termasuk informasi prinsipal dan perantara jika tersedia dalam log.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut:

  • Instance Google SecOps
  • Windows 2016 atau yang lebih baru, atau host Linux dengan systemd
  • Jika berjalan di belakang proxy, pastikan port firewall terbuka
  • Akses istimewa ke Cisco Wireless LAN Controller
  • Pengontrol LAN Nirkabel Cisco yang menjalankan software AireOS 8.8.111.0 atau yang lebih baru

Mendapatkan file autentikasi penyerapan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Agen Pengumpulan.
  3. Download File Autentikasi Penyerapan.
    • Simpan file dengan aman di sistem tempat BindPlane akan diinstal.

Mendapatkan ID pelanggan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Profil.
  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

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

Referensi penginstalan tambahan

Untuk opsi penginstalan tambahan, lihat panduan penginstalan.

Mengonfigurasi agen BindPlane untuk menyerap Syslog dan mengirimkannya ke Google SecOps

  1. 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).

  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:
        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: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'CISCO_WIRELESS'
        raw_log_field: body
        ingestion_labels:

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels
    • Ganti port dan alamat IP sesuai kebutuhan di infrastruktur Anda.
    • Ganti <customer_id> dengan ID pelanggan yang sebenarnya.
    • Perbarui /path/to/ingestion-authentication-file.json ke jalur tempat file autentikasi disimpan di bagian Dapatkan file autentikasi penyerapan Google SecOps.

Mulai ulang agen Bindplane untuk menerapkan perubahan

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

    sudo systemctl restart bindplane-agent

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

    net stop BindPlaneAgent && net start BindPlaneAgent

Mengonfigurasi Syslog di Cisco WLC (GUI)

  1. Login ke UI web WLC.
  2. Buka Pengelolaan > Log > Konfigurasi.
  3. Masukkan alamat IP agen Bindplane di kolom Alamat IP Server Syslog.
  4. Klik Tambahkan.
  5. Berikan detail konfigurasi berikut:
    • Syslog Severity: Pilih Informational.
    • Fasilitas Syslog: Pilih Penggunaan Lokal 0.
  6. Klik Terapkan.

  7. Klik Simpan Konfigurasi.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
action_data read_only_udm.security_result.action_details Dipetakan langsung dari kolom action_data.
data read_only_udm.metadata.description Dipetakan langsung dari kolom data setelah beberapa pemrosesan (misalnya, menghapus stempel waktu, karakter tambahan). Diekstrak dari stempel waktu di awal pesan log. Berbagai format ditangani oleh parser. Ditentukan berdasarkan kolom mnemonic dan messageToProcess menggunakan logika kompleks dalam file cisco_wireless.include. Tetapkan ke "CISCO_WIRELESS". Penggabungan kolom facility, cisco_severity, dan mnemonic. Diekstrak dari pesan log jika tersedia. Tetapkan ke "CISCO_WIRELESS". Diekstrak dari kolom version jika tersedia. Tetapkan ke "CISCO". Setel ke "DHCP" jika peristiwa terkait dengan DHCP. Setel ke "BROADCAST" untuk peristiwa jaringan siaran. Setel ke "UDP" untuk peristiwa jaringan UDP. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Dipetakan dari kolom wlc_controller atau hostname, bergantung pada format log. Diekstrak dari deskripsi atau MessageSourceAddress jika tersedia. Dipetakan dari kolom wlc_controller atau hostname, bergantung pada format log. Diekstrak dari deskripsi atau MessageSourceAddress jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Dibuat dari kolom SourceModuleName dan SourceModuleType jika tersedia. Dipetakan dari read_only_udm.principal.user.userid saat userid terlihat seperti alamat email. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Ditentukan berdasarkan jenis dan deskripsi acara. Ditentukan berdasarkan jenis dan deskripsi acara. Dibuat dari kolom tertentu dalam deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Terkadang menggabungkan informasi dari beberapa kolom. Ditentukan berdasarkan kolom cisco_severity dan jenis peristiwa. Diperoleh dari kolom read_only_udm.security_result.severity. Ringkasan singkat hasil keamanan, yang berasal dari deskripsi dan jenis peristiwa. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Diekstrak dari deskripsi jika tersedia. Disetel ke "SETTING" untuk peristiwa modifikasi setelan. Diekstrak dari deskripsi jika tersedia.
event_data read_only_udm.metadata.product_event_type Dipetakan langsung dari kolom event_data.
event_id read_only_udm.metadata.product_log_id Dipetakan langsung dari kolom event_id.
event_ts read_only_udm.metadata.event_timestamp Dipetakan langsung dari kolom event_ts.
facility read_only_udm.metadata.product_event_type Dipetakan langsung dari kolom facility.
hostname read_only_udm.principal.hostname Dipetakan langsung dari kolom hostname.
hostname read_only_udm.target.hostname Dipetakan langsung dari kolom hostname.
inter_mac read_only_udm.intermediary.mac Dipetakan langsung dari kolom inter_mac.
intermediary_hostname read_only_udm.intermediary.hostname Dipetakan langsung dari kolom intermediary_hostname.
kv_data read_only_udm.principal.resource.attribute.labels Diuraikan sebagai pasangan nilai kunci dan digunakan untuk mengisi label.
log_message read_only_udm.security_result.description Dipetakan langsung dari kolom log_message.
MessageSourceAddress read_only_udm.principal.asset.ip Dipetakan langsung dari kolom MessageSourceAddress.
MessageSourceAddress read_only_udm.principal.ip Dipetakan langsung dari kolom MessageSourceAddress.
messageToProcess read_only_udm.metadata.description Dipetakan langsung dari kolom messageToProcess setelah beberapa pemrosesan.
mnemonic read_only_udm.metadata.event_type Digunakan bersama dengan kolom lain untuk menentukan jenis peristiwa.
mnemonic read_only_udm.metadata.product_event_type Dipetakan langsung dari kolom mnemonic.
severity_data read_only_udm.security_result.severity Dipetakan dari kolom severity_data setelah mengonversinya menjadi nilai enum.
SourceModuleName read_only_udm.principal.resource.attribute.labels Dipetakan langsung dari kolom SourceModuleName.
SourceModuleType read_only_udm.principal.resource.attribute.labels Dipetakan langsung dari kolom SourceModuleType.
timestamp read_only_udm.metadata.event_timestamp Dipetakan langsung dari kolom timestamp.
version read_only_udm.metadata.product_version Dipetakan langsung dari kolom version.
wlc_controller read_only_udm.principal.hostname Dipetakan langsung dari kolom wlc_controller.
wlc_controller read_only_udm.target.hostname Dipetakan langsung dari kolom wlc_controller.

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