Mengumpulkan log audit HSM Entrust nShield
Versi Parser: 1.0
Dokumen ini menjelaskan cara menyerap log audit HSM Entrust nShield ke Google Security Operations menggunakan agen Bindplane.
Parser mengekstrak kolom dari log yang diformat syslog Entrust nShield HSM. Log ini menggunakan grok dan/atau kv untuk mengurai pesan log, lalu memetakan nilai ini ke Model Data Terpadu (UDM). Selain itu, fungsi ini juga menetapkan nilai metadata default untuk sumber dan jenis peristiwa.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Host Windows 2016 atau yang lebih baru atau Linux dengan
systemd - Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
- Akses istimewa ke konsol pengelolaan HSM Entrust nShield atau Software Security World
- Security World yang diinisialisasi dengan kemampuan logging audit
Mendapatkan file autentikasi penyerapan Google SecOps
- Login ke konsol Google SecOps.
- Buka SIEM Settings > Collection Agents.
- 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" /quiet
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.sh
Referensi penginstalan tambahan
Untuk opsi penginstalan tambahan, lihat Panduan penginstalan agen BindPlane.
Mengonfigurasi agen Bindplane untuk menyerap Syslog dan mengirimkannya ke Google SecOps
- Akses file konfigurasi:
- Cari file
config.yaml. Biasanya, file ini berada di direktori/opt/observiq-otel-collector/di Linux atau di direktori penginstalan di Windows. - Buka file menggunakan editor teks (misalnya,
nano,vi, atau Notepad).
- Cari file
Edit file
config.yamlsebagai berikut:receivers: udplog: # nShield HSM only supports UDP for audit logs 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: YOUR_CUSTOMER_ID endpoint: malachiteingestion-pa.googleapis.com # Use ENTRUST_HSM as the log type log_type: 'ENTRUST_HSM' 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
YOUR_CUSTOMER_IDdengan ID Pelanggan yang sebenarnya. - Ganti
/path/to/ingestion-authentication-file.jsondengan jalur file tempat file autentikasi disimpan di Langkah 1.
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:
sudo systemctl restart observiq-otel-collectorUntuk memulai ulang agen Bindplane di Windows, Anda dapat menggunakan konsol Services atau memasukkan perintah berikut:
net stop observiq-otel-collector && net start observiq-otel-collector
Mengonfigurasi penerusan Syslog di Entrust nShield HSM
Metode konfigurasi bergantung pada model deployment nShield HSM Anda. Pencatatan audit harus diaktifkan saat pembuatan Security World atau saat mengindoktrinasi HSM ke Security World yang ada.
Opsi 1: Mengonfigurasi menggunakan utilitas config-auditlogging (direkomendasikan)
Di komputer klien yang menginstal Security World Software, jalankan perintah berikut:
config-auditlogging --server <BINDPLANE_IP> --port 514 --enable-syslogGanti
<BINDPLANE_IP>dengan alamat IP host agen Bindplane Anda.- Perubahan konfigurasi ditulis ke file konfigurasi hardserver.
Mulai ulang hardserver untuk menerapkan perubahan:
- Linux:
/opt/nfast/sbin/init.d-ncipher restart - Windows:
net stop "nfast server" && net start "nfast server"
- Linux:
Opsi 2: Mengonfigurasi menggunakan file konfigurasi hardserver
- Edit file konfigurasi hardserver:
- Linux:
/opt/nfast/kmdata/config/config - Windows:
%NFAST_KMDATA%\config\config
- Linux:
Tambahkan atau ubah entri berikut dalam file konfigurasi:
auditlog_addr=<BINDPLANE_IP> auditlog_port=514*Ganti
<BINDPLANE_IP>dengan alamat IP host agen Bindplane Anda.Simpan file konfigurasi.
Mulai ulang hardserver untuk menerapkan perubahan:
- Linux:
/opt/nfast/sbin/init.d-ncipher restart - Windows:
net stop "nfast server" && net start "nfast server"
- Linux:
Opsi 3: Mengonfigurasi untuk HSM yang terhubung ke jaringan (nShield Connect)
Untuk HSM yang terhubung ke jaringan, Anda dapat melakukan push konfigurasi dari jarak jauh:
- Pastikan push konfigurasi diaktifkan di RFS (Remote File System).
Salin file konfigurasi HSM:
cp /opt/nfast/kmdata/hsm-ESN/config/config /opt/nfast/kmdata/hsm-ESN/config/config.newEdit
config.newuntuk menambahkan konfigurasi logging audit:[audit_logging] auditlog_addr=<BINDPLANE_IP> auditlog_port=514Kirim konfigurasi ke HSM:
cfg-pushnethsm --address=<HSM_IP> /opt/nfast/kmdata/hsm-ESN/config/config.new- Ganti
<HSM_IP>dengan alamat IP HSM nShield Connect Anda.
- Ganti
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
desc |
metadata.description |
Dipetakan secara langsung |
ts |
metadata.event_timestamp |
Diurai sebagai MMM d HH:mm:ss |
has_principal |
metadata.event_type |
Dipetakan: true → STATUS_UPDATE |
has_user |
metadata.event_type |
Dipetakan: true → USER_UNCATEGORIZED |
product_event |
metadata.product_event_type |
Dipetakan secara langsung |
session_id |
network.session_id |
Dipetakan secara langsung |
application |
principal.application |
Dipetakan secara langsung |
ip |
principal.asset.ip |
Digabung |
rhost |
principal.asset.ip |
Digabung |
ip |
principal.ip |
Digabung |
rhost |
principal.ip |
Digabung |
port |
principal.port |
Dipetakan secara langsung |
user |
principal.user.userid |
Dipetakan secara langsung |
| T/A | metadata.event_type |
Konstanta: USER_UNCATEGORIZED |
| T/A | metadata.product_name |
Konstanta: Entrust nShield HSM |
| T/A | metadata.vendor_name |
Konstanta: ENTRUST HSM |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.