Mengumpulkan log InterSystems Caché

Didukung di:

Google SecOps SIEM

Dokumen ini menjelaskan cara menyerap log InterSystems Caché ke Google Security Operations menggunakan agen Bindplane.

InterSystems Caché adalah platform database dan aplikasi berperforma tinggi yang digunakan dalam layanan kesehatan dan keuangan. Layanan ini menghasilkan log audit untuk operasi database, akses pengguna, dan peristiwa sistem. Parser mengekstrak kolom dari data audit Caché dan memetakannya ke Model Data Terpadu (UDM), yang mencatat identitas pengguna, atribut jaringan, detail proses, operasi file, dan hasil keamanan.

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 server InterSystems Caché
• Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
• Akses istimewa ke instance InterSystems Caché dengan otoritas untuk mengonfigurasi logging audit dan ekspor log

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: Buat akun layanan untuk Chronicle API (direkomendasikan)

1. Login ke Google Cloud konsol 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).
   • Deskripsi akun layanan: 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, lalu klik Create. File kunci akan didownload ke komputer Anda.
11. Simpan file kunci sebagai ingestion-auth.json di direktori Bindplane collector (/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.

Catatan: Kunci JSON adalah kredensial. Batasi akses ke file di host Bindplane dan rotasikan kunci sesuai dengan kebijakan organisasi Anda.

Opsi 2: Mendownload file autentikasi penyerapan (lama)

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.

Catatan: File ini mengautentikasi agen ke Ingestion API lama (malachiteingestion-pa.googleapis.com), yang dijadwalkan Google untuk dihentikan pada 20 Juli 2027. Berencana beralih ke Opsi 1 sebelum tanggal tersebut.

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.

   Catatan: ID pelanggan diperlukan untuk mengonfigurasi pengekspor agen Bindplane.

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.

Catatan: Konfigurasi pengekspor Chronicle API memerlukan pengumpul Bindplane v1.106.0 atau yang lebih baru. Perintah sebelumnya akan menginstal rilis terbaru. Jika Anda mengupdate penginstalan yang ada, upgrade pengumpul sebelum mengubah konfigurasi.

Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps

Menemukan file konfigurasi

• Linux:

  sudo nano /opt/observiq-otel-collector/config.yaml
  

• Windows:

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

Mengedit file konfigurasi

• Ganti seluruh konten config.yaml dengan konfigurasi berikut:

  receivers:
    udplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/intersystems_cache:
      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
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: INTERSYSTEMS_CACHE
      raw_log_field: body
  
  service:
    pipelines:
      logs/intersystems_cache:
        receivers:
          - udplog
        exporters:
          - chronicle/intersystems_cache
  

Parameter konfigurasi

Ganti placeholder berikut:

• Konfigurasi penerima:

  • udplog: Jenis penerima berdasarkan protokol:
    • udplog untuk syslog UDP
    • tcplog untuk syslog TCP
    • syslog untuk syslog RFC 3164/5424
  • 0.0.0.0: IP address to listen on:
    • 0.0.0.0 untuk memproses semua antarmuka (direkomendasikan)
    • Alamat IP tertentu untuk memproses satu antarmuka
  • 514: Nomor port yang akan diproses (misalnya, 514, 1514, 6514)

• Konfigurasi pengekspor:

  • <customer_id>: ID Pelanggan dari langkah sebelumnya
  • location: Ganti <LOCATION> dengan region instance Google SecOps Anda (misalnya, us, europe, atau asia-southeast1). Pengekspor mengawali chronicle.googleapis.com dengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.
  • project: Ganti <PROJECT_NUMBER> dengan nomor project dari IAM & Admin > Settings.
  • endpoint: Tetap tetapkan ke chronicle.googleapis.com.
  • Sesuaikan creds_file_path ke jalur file kunci JSON akun layanan Anda (Opsi 1), bergantung pada platform:
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json

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 file autentikasi penyerapan, dan jika instance Anda berada di luar Amerika Serikat, ganti malachiteingestion-pa.googleapis.com dengan endpoint regional Anda (misalnya, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/intersystems_cache:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: INTERSYSTEMS_CACHE
      raw_log_field: body
  

Catatan: Pengekspor ini akan berhenti berfungsi saat Ingestion API dihentikan pada 20 Juli 2027.

Menyimpan file konfigurasi

• Setelah mengedit, simpan file:
  • Linux: Tekan Ctrl+O, lalu Enter, lalu Ctrl+X
  • Windows: Klik File > Simpan

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 Services:

    1. Tekan Win+R, ketik services.msc, lalu tekan Enter.
    2. Cari observIQ OpenTelemetry Collector.
    3. Klik kanan, lalu pilih Restart.

    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 penerusan syslog InterSystems Caché

InterSystems Caché menulis peristiwa audit ke database audit internalnya. Konfigurasikan penerusan syslog untuk mengirim peristiwa ini ke agen Bindplane.

Mengaktifkan dan mengonfigurasi logging audit

1. Buka Caché Management Portal.
2. Buka Administrasi Sistem > Security > Auditing > Configure System Events.
3. Aktifkan peristiwa audit yang ingin Anda rekam (misalnya, %System/%Login/LoginFailure, %System/%Security/Protect).
4. Klik Simpan.

Mengonfigurasi penerusan syslog

1. Di Portal Pengelolaan, buka Administrasi Sistem > Keamanan > Audit > Konfigurasi Audit.
2. Aktifkan penerusan syslog untuk peristiwa audit.
3. Berikan detail konfigurasi berikut:
   • Server Syslog: Masukkan alamat IP host agen BindPlane (misalnya, 192.168.1.100).
   • Port: Masukkan 514 (harus cocok dengan port penerima Bindplane).
   • Protocol: Pilih UDP (harus cocok dengan jenis penerima Bindplane).

4. Klik Simpan.

   Catatan: Jika Caché tidak mendukung penerusan syslog native dalam versi Anda, gunakan class %SYS.Audit untuk mengekspor data audit secara terprogram dan meneruskan output menggunakan utilitas syslog seperti logger atau rsyslog.

Tabel pemetaan UDM

Kolom Log	Pemetaan UDM	Logika
deviceNtDomain	about.administrative_domain	Diganti nama/dipetakan
deviceExternalId	about.asset.asset_id	Dipetakan secara langsung
device_product	about.asset.asset_id	Dipetakan secara langsung
device_vendor	about.asset.asset_id	Dipetakan secara langsung
fileHash	about.file.full_path	Dipetakan secara langsung
filePath	about.file.full_path	Diganti nama/dipetakan
_hash	about.file.sha256	Diganti namanya/dipetakan
fileHash	about.file.sha256	Diganti namanya/dipetakan
fsize	about.file.size	Diganti namanya/dipetakan
dvchost	about.hostname	Diganti nama/dipetakan
ips	about.ip	Digabung
dvc_mac	about.mac	Dipetakan: slot → mac_address
dvcmac	about.mac	Digabung
mac_address	about.mac	Digabung
deviceTranslatedAddress	about.nat_ip	Digabung
Emne	about.process.command_line	Dipetakan secara langsung
Path	about.process.command_line	Dipetakan secara langsung
Subject	about.process.command_line	Dipetakan secara langsung
deviceProcessName	about.process.command_line	Diganti nama/dipetakan
dvcpid	about.process.pid	Diganti nama/dipetakan
permissions	about.resource.attribute.permissions	Digabung
additional_cfp1	additional.fields	Digabung
additional_cfp2	additional.fields	Digabung
additional_cfp3	additional.fields	Digabung
additional_cfp4	additional.fields	Digabung
additional_cn1	additional.fields	Digabung
additional_cn2	additional.fields	Digabung
additional_cn3	additional.fields	Digabung
additional_cs1	additional.fields	Digabung
additional_cs2	additional.fields	Digabung
additional_cs3	additional.fields	Digabung
additional_cs4	additional.fields	Digabung
additional_cs5	additional.fields	Digabung
additional_cs6	additional.fields	Digabung
additional_cs7	additional.fields	Digabung
additional_devicePayloadId	additional.fields	Digabung
additional_eventId	additional.fields	Digabung
additional_field	additional.fields	Digabung
additional_field_key	additional.fields	Dipetakan: smb_stage1 → additional_smb_stage1
additional_flexString1	additional.fields	Digabung
additional_fname	additional.fields	Digabung
additional_smb_stage1	additional.fields	Digabung
cs2	additional.fields	Dipetakan: arc_test → additional_cs2
cs5_label	additional.fields	Digabung
event_name	extensions.auth.type	Dipetakan: logout → AUTHTYPE_UNSPECIFIED, login → AUTHTYPE_UNSPECIFIED
field_intermediary	intermediary	Digabung
msg	metadata.description	Diganti namanya/dipetakan
Generated	metadata.event_timestamp	Diurai sebagai yyyy-MM-ddTHH:mm:ss
Received	metadata.event_timestamp	Diuraikan sebagai yyyy-MM-ddTHH:mm:ss
rt	metadata.event_timestamp	Diuraikan sebagai yyyy-MM-ddTHH:mm:ssZ
event_name	metadata.event_type	Mapped: logout → USER_LOGOUT, login → USER_LOGIN, `"LogSpyware","LogPredictiveMachin...
device_event_class_id	metadata.product_event_type	Dipetakan secara langsung
event_name	metadata.product_event_type	Dipetakan secara langsung
externalId	metadata.product_log_id	Dipetakan secara langsung
device_product	metadata.product_name	Dipetakan secara langsung
device_version	metadata.product_version	Dipetakan secara langsung
device_vendor	metadata.vendor_name	Diganti namanya/dipetakan
app_protocol_output	network.application_protocol	Dipetakan secara langsung
deviceDirection	network.direction	Dipetakan: 0 → INBOUND, 1 → OUTBOUND
requestMethod	network.http.method	Diganti namanya/dipetakan
agentZoneURI	network.http.referral_url	Dipetakan secara langsung
requestClientApplication	network.http.user_agent	Diganti namanya/dipetakan
ip_protocol_out	network.ip_protocol	Dipetakan secara langsung
in	network.received_bytes	Diganti nama/dipetakan
out	network.sent_bytes	Diganti namanya/dipetakan
sntdom	principal.administrative_domain	Diganti namanya/dipetakan
sourceServiceName	principal.application	Diganti namanya/dipetakan
Group_name	principal.group.group_display_name	Dipetakan secara langsung
Gruppenavn	principal.group.group_display_name	Dipetakan secara langsung
Device_name	principal.hostname	Dipetakan secara langsung
Enhetsnavn	principal.hostname	Dipetakan secara langsung
shost	principal.hostname	Diganti nama/dipetakan
principal_ip	principal.ip	Digabung
shost	principal.ip	Digabung
mac	principal.mac	Digabung
sourceTranslatedAddress	principal.nat_ip	Digabung
sourceTranslatedPort	principal.nat_port	Diganti nama/dipetakan
spt	principal.port	Diganti namanya/dipetakan
sproc	principal.process.command_line	Diganti namanya/dipetakan
spid	principal.process.pid	Diganti nama/dipetakan
principal_role	principal.user.attribute.roles	Digabung
suser	principal.user.user_display_name	Dipetakan secara langsung
suid	principal.user.userid	Diganti nama/dipetakan
_action	security_result.action	Digabung
act	security_result.action	Dipetakan: accept → _action, deny → _action
Action_Taken	security_result.action_details	Dipetakan secara langsung
act	security_result.action_details	Dipetakan secara langsung
cat	security_result.category_details	Digabung
Scan_Type	security_result.description	Dipetakan secara langsung
Type	security_result.description	Dipetakan secara langsung
msg_data_2	security_result.description	Dipetakan secara langsung
infection_channel_label	security_result.detection_fields	Digabung
operasjon_label	security_result.detection_fields	Digabung
operation_label	security_result.detection_fields	Digabung
permission_label	security_result.detection_fields	Digabung
spyware_Grayware_Type_label	security_result.detection_fields	Digabung
threat_probability_label	security_result.detection_fields	Digabung
tillatelse_label	security_result.detection_fields	Digabung
mwProfile	security_result.rule_name	Dipetakan secara langsung
severity	security_result.severity	Dipetakan: "0", "1", "2", "3", "LOW" → LOW, `"4", "5", "6", "MEDIUM", "SUBSTANTIAL", "INFO"...
severity	security_result.severity_details	Dipetakan secara langsung
Result	security_result.summary	Dipetakan secara langsung
appcategory	security_result.summary	Dipetakan secara langsung
reason	security_result.summary	Diganti namanya/dipetakan
Spyware	security_result.threat_name	Dipetakan secara langsung
Unknown_Threat	security_result.threat_name	Dipetakan secara langsung
Virus_Malware_Name	security_result.threat_name	Dipetakan secara langsung
oldFilePath	src.file.full_path	Diganti nama/dipetakan
oldFileSize	src.file.size	Diganti nama/dipetakan
old_permissions	src.resource.attribute.permissions	Digabung
dntdom	target.administrative_domain	Diganti nama/dipetakan
app	target.application	Dipetakan secara langsung
destinationServiceName	target.application	Diganti namanya/dipetakan
ahost	target.hostname	Dipetakan secara langsung
temp_dhost	target.hostname	Dipetakan secara langsung
IPv6_Address	target.ip	Digabung
agt	target.ip	Digabung
dst_ip	target.ip	Digabung
ipv6	target.ip	Dipetakan: - → IPv6_Address
atz	target.location.country_or_region	Dipetakan secara langsung
amac	target.mac	Digabung
mac_address	target.mac	Digabung
destination_translated_address	target.nat_ip	Digabung
destinationTranslatedPort	target.nat_port	Diganti nama/dipetakan
dpt	target.port	Diganti namanya/dipetakan
dproc	target.process.command_line	Diganti namanya/dipetakan
File_name	target.process.file.full_path	Dipetakan secara langsung
Infected_Resource	target.process.file.full_path	Dipetakan secara langsung
Object	target.process.file.full_path	Dipetakan secara langsung
Objekt	target.process.file.full_path	Dipetakan secara langsung
dpid	target.process.pid	Diganti nama/dipetakan
resource_Type_label	target.resource.attribute.labels	Digabung
request	target.url	Dipetakan secara langsung
target_role	target.user.attribute.roles	Digabung
CustomerName	target.user.user_display_name	Dipetakan secara langsung
temp_duser	target.user.user_display_name	Dipetakan secara langsung
Bruker	target.user.userid	Dipetakan secara langsung
User_value	target.user.userid	Dipetakan secara langsung
temp_duid	target.user.userid	Dipetakan secara langsung
T/A	extensions.auth.type	Konstanta: AUTHTYPE_UNSPECIFIED
T/A	metadata.event_type	Konstanta: USER_LOGOUT
T/A	network.direction	Konstanta: INBOUND
T/A	security_result.severity	Konstanta: LOW

Log Perubahan

Melihat Log Perubahan untuk parser ini

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