Mengumpulkan log Sophos Central

Didukung di:

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.
  1. Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
  2. Buka IAM & Admin > Service Accounts.
  3. Klik Create service account.
  4. Berikan detail konfigurasi berikut:
    • Service account name: Masukkan nama akun (misalnya, bindplane-ingest).
    • Service account description: Masukkan deskripsi (misalnya, Bindplane agent log ingestion).
  5. Klik Create and continue.
  6. Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
  7. Klik Continue lalu klik Done.
  8. Klik akun layanan yang Anda buat, lalu buka tab Keys.
  9. Klik Add key > Create new key.
  10. Pilih JSON dan klik Create. File kunci akan didownload ke komputer Anda.
  11. Simpan file kunci sebagai ingestion-auth.json di direktori kolektor Bindplane (/opt/observiq-otel-collector/ingestion-auth.json di Linux atau C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json di Windows), atau perbarui creds_file_path di config.yaml agar sesuai dengan jalur tempat Anda menyimpannya.
  12. Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.

Opsi 2: Mendownload file autentikasi penyerapan (lama)

  1. Login ke konsol Google SecOps.
  2. Buka Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka Settings > Collection Agents.
  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 > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
  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](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](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

  1. 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).
  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:
        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_labels
    
  3. Ganti port dan alamat IP sesuai kebutuhan di infrastruktur Anda.

  4. Ganti <LOCATION> dengan region instance Google SecOps Anda (misalnya, us, europe, atau asia-southeast1). Pengekspor akan mengawali chronicle.googleapis.com dengan nilai ini.

  5. Ganti <PROJECT_NUMBER> dengan nomor project dari IAM & Admin > Settings.

  6. Ganti <customer_id> dengan ID Pelanggan yang sebenarnya.

  7. Ganti /path/to/ingestion-authentication-file.json dengan 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 exporters dengan kode berikut. Tetapkan creds_file_path ke jalur ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, ganti malachiteingestion-pa.googleapis.com dengan 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

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

    /opt/observiq-otel-collector/config.yaml
    
  2. Untuk 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

  1. Login ke Sophos Central Admin.
  2. Pilih Global Settings > API Token Management.
  3. Klik Add Token untuk membuat token baru.
  4. Masukkan nama token, lalu klik Simpan. API Token Summary untuk token yang diberikan akan ditampilkan.
  5. Di bagian API Token Summary, klik Copy untuk menyalin URL dan header akses API.

Menginstal Python di mesin tambahan

  1. Buka browser web, lalu buka situs Python.
  2. Klik Download Python untuk sistem operasi Anda (Windows atau Mac).
  3. Instal Python:

    • Di Windows:
      1. Jalankan penginstal.
      2. Centang kotak yang bertuliskan Add Python to PATH.
      3. Klik Install Now.
    • Di Mac:
      1. Python mungkin sudah diinstal; jika belum, Anda dapat menginstal versi terbaru menggunakan terminal.
      2. Buka Terminal dan ketik perintah berikut untuk memverifikasi:
    python --version
    

Mendownload skrip integrasi Sophos

  1. Buka halaman GitHub untuk Sophos Central SIEM Integration Repository.
  2. Klik tombol Code berwarna hijau > Download ZIP.
  3. Ekstrak file ZIP.

Menyiapkan konfigurasi skrip

  1. Temukan dan buka file config.ini dengan editor teks.
  2. 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).
  3. Simpan file dengan mengklik tombol Save.

Jalankan skrip:

  1. Buka folder skrip.
    • Di Windows:
      1. Tekan tombol Windows dan ketik cmd.
      2. Klik Command Prompt.
      3. Buka folder: cmd cd C:\Users\YourName\Downloads\Sophos-Central-SIEM-Integration
    • Di macOS:
      1. Buka Applications > Utilities.
      2. Buka Terminal.
      3. Buka folder: bash cd /Users/YourName/Downloads/Sophos-Central-SIEM-Integration
  2. Jalankan skrip:

    • Ketik perintah berikut untuk memulai skrip:
    python siem.py
    

Mengotomatiskan skrip agar berjalan terus-menerus

Di Windows (menggunakan Task Scheduler)

  1. Buka Task Scheduler dengan mengetik "Task Scheduler" di menu Start.
  2. Klik Create Task.
  3. Di tab General:
    • Beri nama tugas Anda (misalnya, Sophos Central Log Export).
  4. Di tab Triggers:
    • Klik New dan tetapkan tugas untuk dijalankan Daily atau At startup.
  5. Di tab Actions:
    • Klik New, lalu pilih Start a program.
    • Cari file yang dapat dieksekusi python.exe (biasanya ditemukan di C:\PythonXX\python.exe).
    • Di kolom Add arguments, ketik jalur ke skrip (misalnya, C:\Users\YourName\Downloads\Sophos-Central-SIEM-Integration\siem.py).
  6. Klik OK untuk menyimpan tugas.

Di Mac (menggunakan Cron Job)

  1. Buka Terminal.
  2. Ketik crontab -e dan tekan Enter.
  3. Tambahkan baris baru di akhir file:

    * * * * * /usr/bin/python /Users/YourName/Downloads/Sophos-Central-SIEM-Integration/siem.py
    
  4. Simpan 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.