Mengumpulkan log Sophos Central
Dokumen ini menjelaskan cara mengumpulkan log Sophos Central menggunakan Bindplane. Parser mengubah log JSON menjadi model data terpadu (UDM). Parser ini mengekstrak kolom dari struktur JSON bertingkat, memetakannya ke kolom UDM, dan melakukan kategorisasi peristiwa berdasarkan kolom jenis, sehingga memperkaya data dengan detail dan tindakan spesifik untuk berbagai jenis peristiwa Sophos Central.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps.
- Anda menggunakan Windows 2016 atau yang lebih baru, atau host Linux dengan systemd.
- Anda memiliki komputer Windows atau Linux tambahan, yang mampu menjalankan Python secara terus-menerus.
- Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane.
- Akses istimewa ke konsol Sophos Central Admin.
Mendapatkan kredensial Google SecOps untuk agen Bindplane
Untuk mengautentikasi agen Bindplane ke Google SecOps, pilih salah satu metode berikut:
- Deployment baru: Gunakan Chronicle API (Opsi 1).
- Deployment lama: Terus gunakan file autentikasi penyerapan (Opsi 2) hingga Ingestion API dihentikan pada 20 Juli 2027.
Opsi 1: Membuat akun layanan untuk Chronicle API (direkomendasikan)
- Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
- Buka IAM & Admin > Service Accounts.
- Klik Create service account.
- Berikan detail konfigurasi berikut:
- Service account name: Masukkan nama akun (misalnya,
bindplane-ingest). - Service account description: Masukkan deskripsi (misalnya,
Bindplane agent log ingestion).
- Service account name: Masukkan nama akun (misalnya,
- Klik Create and continue.
- Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
- Klik Continue lalu klik Done.
- Klik akun layanan yang Anda buat, lalu buka tab Keys.
- Klik Add key > Create new key.
- Pilih JSON dan klik Create. File kunci akan didownload ke komputer Anda.
- Simpan file kunci sebagai
ingestion-auth.jsondi direktori kolektor Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsondi Linux atauC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsondi Windows), atau perbaruicreds_file_pathdiconfig.yamlagar sesuai dengan jalur tempat Anda menyimpannya. - Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.
Opsi 2: Mendownload file autentikasi penyerapan (lama)
- Login ke konsol Google SecOps.
- Buka Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka 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 > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
- 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](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](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
Referensi penginstalan tambahan
Untuk opsi pemasangan tambahan, lihat panduan pemasangan ini.
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: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' 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: chronicle.googleapis.com # Add optional ingestion labels for better organization log_type: 'SOPHOS_CENTRAL' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labelsGanti port dan alamat IP sesuai kebutuhan di infrastruktur Anda.
Ganti
<LOCATION>dengan region instance Google SecOps Anda (misalnya,us,europe, atauasia-southeast1). Pengekspor akan mengawalichronicle.googleapis.comdengan nilai ini.Ganti
<PROJECT_NUMBER>dengan nomor project dari IAM & Admin > Settings.Ganti
<customer_id>dengan ID Pelanggan yang sebenarnya.Ganti
/path/to/ingestion-authentication-file.jsondengan jalur file tempat file kunci akun layanan (Opsi 1) disimpan di Langkah 1.
Pengekspor API penyerapan lama
Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok
exportersdengan kode berikut. Tetapkancreds_file_pathke jalur ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, gantimalachiteingestion-pa.googleapis.comdengan endpoint regional Anda (misalnya,europe-malachiteingestion-pa.googleapis.com).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: 'SOPHOS_CENTRAL' raw_log_field: body ingestion_labels:
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux, jalankan perintah berikut:
/opt/observiq-otel-collector/config.yamlUntuk memulai ulang agen Bindplane di Windows, Anda dapat menggunakan konsol Services atau memasukkan perintah berikut:
net stop BindPlaneAgent && net start BindPlaneAgent
Mengonfigurasi akses Sophos Central API
- Login ke Sophos Central Admin.
- Pilih Global Settings > API Token Management.
- Klik Add Token untuk membuat token baru.
- Masukkan nama token, lalu klik Simpan. API Token Summary untuk token yang diberikan akan ditampilkan.
- Di bagian API Token Summary, klik Copy untuk menyalin URL dan header akses API.
Menginstal Python di mesin tambahan
- Buka browser web, lalu buka situs Python.
- Klik Download Python untuk sistem operasi Anda (Windows atau Mac).
Instal Python:
- Di Windows:
- Jalankan penginstal.
- Centang kotak yang bertuliskan Add Python to PATH.
- Klik Install Now.
- Di Mac:
- Python mungkin sudah diinstal; jika belum, Anda dapat menginstal versi terbaru menggunakan terminal.
- Buka Terminal dan ketik perintah berikut untuk memverifikasi:
python --version- Di Windows:
Mendownload skrip integrasi Sophos
- Buka halaman GitHub untuk Sophos Central SIEM Integration Repository.
- Klik tombol Code berwarna hijau > Download ZIP.
- Ekstrak file ZIP.
Menyiapkan konfigurasi skrip
- Temukan dan buka file
config.inidengan editor teks. - Edit file konfigurasi:
- Token API: Masukkan Kunci API yang disalin sebelumnya dari Sophos Central.
- Detail Server Syslog: Masukkan detail server syslog Anda.
- Host: Masukkan alamat IP Bindplane.
- Port: Masukkan nomor port Bindplane.
- Protocol: Masukkan UDP (Anda juga dapat menggunakan TCP atau TLS, bergantung pada penyiapan Anda).
- Simpan file dengan mengklik tombol Save.
Jalankan skrip:
- Buka folder skrip.
- Di Windows:
- Tekan tombol Windows dan ketik
cmd. - Klik Command Prompt.
- Buka folder:
cmd cd C:\Users\YourName\Downloads\Sophos-Central-SIEM-Integration
- Tekan tombol Windows dan ketik
- Di macOS:
- Buka Applications > Utilities.
- Buka Terminal.
- Buka folder:
bash cd /Users/YourName/Downloads/Sophos-Central-SIEM-Integration
- Di Windows:
Jalankan skrip:
- Ketik perintah berikut untuk memulai skrip:
python siem.py
Mengotomatiskan skrip agar berjalan terus-menerus
Di Windows (menggunakan Task Scheduler)
- Buka Task Scheduler dengan mengetik "Task Scheduler" di menu Start.
- Klik Create Task.
- Di tab General:
- Beri nama tugas Anda (misalnya,
Sophos Central Log Export).
- Beri nama tugas Anda (misalnya,
- Di tab Triggers:
- Klik New dan tetapkan tugas untuk dijalankan Daily atau At startup.
- Di tab Actions:
- Klik New, lalu pilih Start a program.
- Cari file yang dapat dieksekusi
python.exe(biasanya ditemukan diC:\PythonXX\python.exe). - Di kolom Add arguments, ketik jalur ke skrip (misalnya,
C:\Users\YourName\Downloads\Sophos-Central-SIEM-Integration\siem.py).
- Klik OK untuk menyimpan tugas.
Di Mac (menggunakan Cron Job)
- Buka Terminal.
- Ketik
crontab -edan tekan Enter. Tambahkan baris baru di akhir file:
* * * * * /usr/bin/python /Users/YourName/Downloads/Sophos-Central-SIEM-Integration/siem.pySimpan dan keluar dari editor.
Tabel Pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
created_at_label |
additional.fields |
Digabung |
datastream_label |
additional.fields |
Digabung |
security_result.description |
metadata.description |
Diganti namanya/dipetakan |
end |
metadata.event_timestamp |
Diurai sebagai RFC 3339 |
when |
metadata.event_timestamp |
Diurai sebagai RFC 3339 |
has_principal |
metadata.event_type |
Dipetakan: true → FILE_OPEN, true → NETWORK_CONNECTION, true → SCAN_UNCATEGORIZED |
type |
metadata.event_type |
Nilai yang dipetakan (total 14, mis. Event::Endpoint::DataLossPreventionAutomaticallyAllowed → `F... |
type |
metadata.product_event_type |
Dipetakan secara langsung |
type |
network.direction |
Dipetakan: Event::Endpoint::WebControlViolation → OUTBOUND, `Event::Endpoint::WindowsFirewa... |
type |
network.ip_protocol |
Dipetakan: Event::Endpoint::WebControlViolation → TCP |
dhost |
principal.asset.hostname |
Dipetakan secara langsung |
location |
principal.asset.hostname |
Dipetakan secara langsung |
data.source_info.ip |
principal.asset.ip |
Digabung |
source_info.ip |
principal.asset.ip |
Digabung |
dhost |
principal.hostname |
Dipetakan secara langsung |
location |
principal.hostname |
Dipetakan secara langsung |
data.source_info.ip |
principal.ip |
Digabung |
source_info.ip |
principal.ip |
Digabung |
type |
principal.user.attribute.labels |
Dipetakan: Event::Endpoint::DataLossPreventionAutomaticallyAllowed → username_label |
username_label |
principal.user.attribute.labels |
Digabung |
Username |
principal.user.user_display_name |
Dipetakan secara langsung |
source |
principal.user.user_display_name |
Dipetakan secara langsung |
source |
principal.user.userid |
Dipetakan secara langsung |
suser |
principal.user.userid |
Dipetakan secara langsung |
user_id |
principal.user.userid |
Dipetakan secara langsung |
endpoint_type_label |
security_result.about.labels |
Digabung |
sec_action |
security_result.action |
Digabung |
type |
security_result.action |
Mapped: Event::Endpoint::DataLossPreventionAutomaticallyAllowed → sec_action, `Event::En... |
group |
security_result.category_details |
Digabung |
name |
security_result.description |
Dipetakan secara langsung |
type |
security_result.description |
Dipetakan: Event::Endpoint::(UpdateRebootRequired/ServiceNotRunning/NonCompliant/OutOfDate) →... |
duid_label |
security_result.detection_fields |
Digabung |
id_label |
security_result.detection_fields |
Digabung |
rule |
security_result.rule_name |
Dipetakan secara langsung |
rules |
security_result.rule_name |
Dipetakan secara langsung |
severity |
security_result.severity |
Dipetakan: low → LOW, medium → MEDIUM, high → HIGH |
security_result.description |
security_result.summary |
Diganti namanya/dipetakan |
app |
target.application |
Dipetakan secara langsung |
application |
target.application |
Dipetakan secara langsung |
dhost |
target.asset.hostname |
Dipetakan secara langsung |
endpoint_id |
target.asset_id |
Dipetakan secara langsung |
f_path |
target.file.full_path |
Dipetakan secara langsung |
f_size |
target.file.size |
Diganti namanya/dipetakan |
dhost |
target.hostname |
Dipetakan secara langsung |
application |
target.process.file.full_path |
Dipetakan secara langsung |
core_remedy_items.items.0.descriptor |
target.process.file.full_path |
Dipetakan secara langsung |
data.core_remedy_items.items.0.descriptor |
target.process.file.full_path |
Dipetakan secara langsung |
file_path_1 |
target.process.file.full_path |
Dipetakan secara langsung |
customer_id |
target.resource.id |
Dipetakan secara langsung |
p_device |
target.resource.name |
Dipetakan secara langsung |
scan_name |
target.resource.name |
Dipetakan secara langsung |
type |
target.resource.name |
Dipetakan: Event::Endpoint::SavDisabled → Real time protection, `Event::Endpoint::Registere... |
type |
target.resource.type |
Nilai yang dipetakan (total 5, mis. Event::Endpoint::SavDisabled → SETTING, `Event::Endpoint::R... |
url |
target.url |
Dipetakan secara langsung |
principal.user.userid |
target.user.userid |
Dipetakan secara langsung |
suser |
target.user.userid |
Dipetakan secara langsung |
| T/A | metadata.event_type |
Konstanta: GENERIC_EVENT |
| T/A | metadata.product_name |
Konstanta: Sophos Central |
| T/A | metadata.vendor_name |
Konstanta: Sophos |
| T/A | network.direction |
Konstanta: OUTBOUND |
| T/A | network.ip_protocol |
Konstanta: TCP |
| T/A | security_result.description |
Konstanta: security_result.summary |
| T/A | security_result.severity |
Konstanta: LOW |
| T/A | target.resource.name |
Konstanta: Real time protection |
| T/A | target.resource.type |
Konstanta: SETTING |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.