Mengumpulkan log Avaya Aura
Versi Parser: 3.0
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
- 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/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.0untuk mendengarkan di semua antarmuka (direkomendasikan)- Port
514adalah port syslog standar (memerlukan root di Linux; gunakan1514untuk 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
- 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 > Save
- 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. - Temukan 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 Avaya Aura
- Login ke konsol Avaya Aura.
- Buka EM > System Configuration > Logging Settings > Syslog.
- Aktifkan Pengiriman Log SYSLOG.
- Klik Tambahkan.
- Berikan detail konfigurasi berikut:
- Alamat Server: Masukkan alamat IP agen Bindplane.
- Port: Masukkan port pendengar agen BindPlane.
- Klik Simpan.
- Klik Konfirmasi.
- 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.