Mengumpulkan log Avaya Aura

Versi Parser: 3.0

Didukung di:

Dokumen ini menjelaskan cara menyerap log Avaya Aura ke Google Security Operations menggunakan agen Bindplane.

Avaya Aura adalah platform komunikasi terpadu yang membuat pesan syslog untuk peristiwa login/logout pengguna, perubahan konfigurasi sistem, dan peristiwa keamanan. Parser mengekstrak kolom dari pesan syslog 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 sistem Avaya Aura
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke Avaya Aura

Mendapatkan file autentikasi penyerapan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Agen Pengumpulan.
  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 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
    
  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 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.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Edit file konfigurasi

  • Ganti seluruh konten config.yaml dengan konfigurasi berikut:

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/avaya_aura:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: AVAYA_AURA
            raw_log_field: body
    
    service:
        pipelines:
            logs/avaya_aura_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/avaya_aura
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • listen_address: Alamat IP dan port yang akan diproses:
      • 0.0.0.0 untuk mendengarkan di semua antarmuka (direkomendasikan)
      • Port 514 adalah port syslog standar (memerlukan root di Linux; gunakan 1514 untuk non-root)
  • Konfigurasi eksportir:

    • 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
    • customer_id: ID Pelanggan yang disalin dari konsol Google SecOps
    • endpoint: 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

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:

      sudo systemctl status observiq-otel-collector
      
    2. Periksa 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-collector
      
    • Konsol layanan:

      1. Tekan Win+R, ketik services.msc, lalu tekan Enter.
      2. Temukan observIQ OpenTelemetry Collector.
      3. Klik kanan, lalu pilih Mulai Ulang.
      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 syslog di Avaya Aura

  1. Login ke konsol Avaya Aura.
  2. Buka EM > System Configuration > Logging Settings > Syslog.
  3. Aktifkan Pengiriman Log SYSLOG.
  4. Klik Tambahkan.
  5. Berikan detail konfigurasi berikut:
    • Alamat Server: Masukkan alamat IP agen Bindplane.
    • Port: Masukkan port pendengar agen BindPlane.
  6. Klik Simpan.
  7. Klik Konfirmasi.
  8. Mulai ulang Avaya Aura.

Tabel pemetaan UDM

Kolom log Pemetaan UDM Logika
data{}.@timestamp metadata.event_timestamp Stempel waktu peristiwa diuraikan dari kolom data menggunakan pola grok dan ditetapkan ke kolom event_timestamp di bagian metadata UDM.
data{}.host principal.hostname Nilai host diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom nama host dalam bagian principal UDM.
data{}.portal security_result.about.resource.attribute.labels.value Nilai portal diekstrak dari kolom data menggunakan pola grok dan ditetapkan sebagai nilai label Portal dalam bagian about.resource.attribute.labels dari security_result di UDM.
data{}.prod_log_id metadata.product_log_id Nilai prod_log_id diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom product_log_id di bagian metadata UDM.
data{}.sec_cat security_result.category_details Nilai sec_cat diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom category_details dalam bagian security_result UDM.
data{}.sec_desc security_result.description Nilai sec_desc diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom description dalam bagian security_result UDM.
data{}.severity security_result.severity Nilai tingkat keparahan diekstrak dari kolom data menggunakan pola grok. Jika tingkat keparahannya adalah warn, fatal, atau error (tidak peka huruf besar/kecil), tingkat keparahan tersebut dipetakan ke HIGH di kolom security_result.severity UDM. Jika tidak, jika tingkat keparahan adalah info (tidak peka huruf besar/kecil), maka akan dipetakan ke LOW.
data{}.summary security_result.summary Nilai ringkasan diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom ringkasan dalam bagian security_result UDM.
data{}.user_id target.user.userid Nilai user_id diekstrak dari kolom data menggunakan pola grok dan ditetapkan ke kolom userid dalam bagian target.user UDM.
extensions.auth.type Kolom auth.type disetel ke AUTHTYPE_UNSPECIFIED jika kolom event_name berisi log(in|on) atau logoff (tidak peka huruf besar/kecil), atau jika kolom summary berisi login atau logoff (tidak peka huruf besar/kecil) dan kolom user_id tidak kosong.
metadata.description Kolom deskripsi diisi dengan nilai kolom desc jika tidak kosong.
metadata.event_type Kolom event_type ditentukan berdasarkan logika berikut: - Jika kolom event_name berisi log(in|on) atau kolom summary berisi login (tidak peka huruf besar/kecil) dan kolom user_id tidak kosong, event_type ditetapkan ke USER_LOGIN. - Jika kolom event_name berisi logoff atau kolom summary berisi logoff (tidak peka huruf besar/kecil) dan kolom user_id tidak kosong, event_type ditetapkan ke USER_LOGOUT. - Jika kolom has_principal adalah true, event_type ditetapkan ke STATUS_UPDATE. - Jika tidak, event_type tetap GENERIC_EVENT (nilai default).
metadata.log_type log_type di-hardcode menjadi AVAYA_AURA.
metadata.product_event_type Kolom product_event_type diisi dengan nilai kolom event_name jika tidak kosong.
metadata.product_name product_name di-hardcode menjadi AVAYA AURA.
metadata.vendor_name vendor_name di-hardcode menjadi AVAYA AURA.
security_result.action Kolom tindakan dalam bagian security_result ditetapkan berdasarkan logika berikut: - Jika kolom ringkasan berisi fail atau failed (tidak peka huruf besar/kecil), tindakan ditetapkan ke BLOCK. - Jika kolom ringkasan berisi success (tidak peka huruf besar/kecil), tindakan akan disetel ke ALLOW.
security_result.severity_details Kolom severity_details diisi dengan nilai kolom severity_details jika tidak kosong.
timestamp.nanos metadata.event_timestamp.nanos Nilai nanos dari kolom stempel waktu dipetakan langsung ke kolom nanos dalam bagian event_timestamp metadata di UDM.
timestamp.seconds metadata.event_timestamp.seconds Nilai detik dari kolom stempel waktu dipetakan langsung ke kolom detik dalam bagian event_timestamp metadata di UDM.
time event.idm.read_only_udm.metadata.event_timestamp Dipetakan dari log perubahan
src_ip event.idm.read_only_udm.principal.ip dan event.idm.read_only_udm.principal.asset.ip Dipetakan dari log perubahan
src_port event.idm.read_only_udm.principal.port Dipetakan dari log perubahan
dst_ip event.idm.read_only_udm.target.ip dan event.idm.read_only_udm.target.asset.ip Dipetakan dari log perubahan
dst_port event.idm.read_only_udm.target.port Dipetakan dari log perubahan
process_pid event.idm.read_only_udm.principal.process.pid Dipetakan dari log perubahan
principal_application event.idm.read_only_udm.principal.application Dipetakan dari log perubahan
network_protocol event.idm.read_only_udm.network.ip_protocol Dipetakan dari log perubahan
application_protocol_version event.idm.read_only_udm.network.application_protocol_version Dipetakan dari log perubahan
community_id event.idm.read_only_udm.network.community_id Dipetakan dari log perubahan
security_description event.idm.read_only_udm.security_result.description Dipetakan dari log perubahan
device_uptime event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cmg_trap_subsystem event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cmg_trap_onboard event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cmg_trap_location event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
syslog_priority event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

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