Mengumpulkan log Cyolo OT

Versi Parser: 3.0

Didukung di:

Dokumen ini menjelaskan cara menyerap log Cyolo Secure Remote Access for OT ke Google Security Operations menggunakan agen Bindplane.

Cyolo menyediakan akses jarak jauh yang aman untuk lingkungan teknologi operasional (OT). Platform ini menghasilkan pesan syslog untuk peristiwa akses, autentikasi, dan aktivitas sesi. Parser mengekstrak kolom 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 platform Cyolo
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke konsol Admin Cyolo

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" /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 active (running).

Referensi penginstalan tambahan

Untuk opsi pemasangan dan pemecahan masalah tambahan, lihat Panduan pemasangan agen Bindplane.

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/cyolo_ot:
        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: CYOLO_OT
        raw_log_field: body
    
    service:
      pipelines:
        logs/cyolo_ot_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/cyolo_ot
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • listen_address: Alamat IP dan port untuk diproses:
      • 0.0.0.0 untuk memproses semua antarmuka (direkomendasikan)
      • Port 514 adalah port syslog standar (memerlukan root di Linux; gunakan 1514 untuk non-root)
  • Konfigurasi pengekspor:

    • creds_file_path: Jalur lengkap ke file kunci JSON akun layanan (Opsi 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID Pelanggan yang disalin dari konsol Google SecOps
    • 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.

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/cyolo_ot:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CYOLO_OT
        raw_log_field: body
    

Simpan file konfigurasi

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

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 syslog di Cyolo

  1. Login ke konsol Admin Cyolo.
  2. Buka Monitoring > Settings.
  3. Aktifkan Export Logs to System Logging Protocol (Syslog).
  4. Buka Integrations > Syslog Server.
  5. Berikan detail konfigurasi berikut:
    • Server name: Masukkan nama yang bermakna untuk server ini (misalnya, Google SecOps Bindplane).
    • Situs: Pilih satu situs atau beberapa situs dari drop-down.
    • IP Address: Masukkan alamat IP agen Bindplane.
    • Port: Masukkan nomor port agen Bindplane untuk koneksi UDP.
  6. Klik Simpan.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
_field additional.fields Digabung
authority_id_label additional.fields Digabung
authority_kind_label additional.fields Digabung
authority_name_label additional.fields Digabung
data_field additional.fields Digabung
duration_label additional.fields Digabung
kind_label additional.fields Digabung
log_level_label additional.fields Digabung
object_id_label additional.fields Digabung
object_kind_label additional.fields Digabung
object_name_label additional.fields Digabung
rules_label additional.fields Digabung
site_id_label additional.fields Digabung
subject_id_label additional.fields Digabung
subject_kind_label additional.fields Digabung
message extensions.auth.type Dipetakan: user disconnected → MACHINE
syslog_object_name extensions.auth.type Dipetakan: login → MACHINE
inter_host intermediary.asset.hostname Dipetakan secara langsung
inter_host intermediary.hostname Dipetakan secara langsung
message metadata.description Dipetakan secara langsung
msg metadata.description Dipetakan secara langsung
syslog_message metadata.description Dipetakan secara langsung
syslog_timestamp metadata.event_timestamp Diurai sebagai ISO8601
time metadata.event_timestamp Diurai sebagai MMM d HH:mm:ss
timestamp metadata.event_timestamp Diurai sebagai ISO8601
event_type metadata.event_type Dipetakan secara langsung
kind metadata.product_event_type Dipetakan secara langsung
prod_type metadata.product_event_type Dipetakan secara langsung
id metadata.product_log_id Dipetakan secara langsung
syslog_event_id metadata.product_log_id Dipetakan secara langsung
product_version metadata.product_version Dipetakan secara langsung
message network.application_protocol Dipetakan: rdp → RDP
client network.http.parsed_user_agent Dipetakan secara langsung
cyolouagent network.http.parsed_user_agent Dipetakan secara langsung
client network.http.user_agent Dipetakan secara langsung
cyolouagent network.http.user_agent Dipetakan secara langsung
syslog_client network.http.user_agent Dipetakan secara langsung
cyolosessionid network.session_id Dipetakan secara langsung
session_id network.session_id Dipetakan secara langsung
hostname observer.hostname Dipetakan secara langsung
container_id_label observer.resource.attribute.labels Digabung
internal_event_id_label observer.resource.attribute.labels Digabung
log_source_label observer.resource.attribute.labels Digabung
site_id_label observer.resource.attribute.labels Digabung
site_name_label observer.resource.attribute.labels Digabung
transaction_id_label observer.resource.attribute.labels Digabung
node_id observer.resource.product_object_id Dipetakan secara langsung
syslog_hostname principal.asset.hostname Dipetakan secara langsung
remote_address principal.asset.ip Digabung
syslog_remote_address principal.asset.ip Digabung
syslog_hostname principal.hostname Dipetakan secara langsung
remote_address principal.ip Digabung
syslog_remote_address principal.ip Digabung
country_code principal.location.country_or_region Dipetakan secara langsung
cyolocountrycode principal.location.country_or_region Dipetakan secara langsung
syslog_country_code principal.location.country_or_region Dipetakan secara langsung
node_id_label principal.resource.attribute.labels Digabung
site_name_label principal.resource.attribute.labels Digabung
transaction_id_label principal.resource.attribute.labels Digabung
cyolosubjectkind principal.resource.resource_subtype Dipetakan secara langsung
credentials_id_label principal.user.attribute.labels Digabung
credentials_name_label principal.user.attribute.labels Digabung
credentials_origin_label principal.user.attribute.labels Digabung
cyolosubjectid principal.user.product_object_id Dipetakan secara langsung
subject_id principal.user.product_object_id Dipetakan secara langsung
syslog_session_id principal.user.product_object_id Dipetakan secara langsung
cyolosubjectname principal.user.userid Dipetakan secara langsung
subject_name principal.user.userid Dipetakan secara langsung
syslog_id principal.user.userid Dipetakan secara langsung
action security_result.action Digabung
result security_result.action Dipetakan: failure → sr_action, success → sr_action
sr_action security_result.action Digabung
syslog_result security_result.action_details Dipetakan secara langsung
_field security_result.detection_fields Digabung
field security_result.detection_fields Digabung
key security_result.detection_fields Dipetakan: "cyoloauthkind", "cyolokind","cyoloresult" → _field
result security_result.outcome Dipetakan: failure → FAIL, success → PASS
authority_id security_result.rule_id Dipetakan secara langsung
cyoloauthid security_result.rule_id Dipetakan secara langsung
authority_name security_result.rule_name Dipetakan secara langsung
cyoloauthname security_result.rule_name Dipetakan secara langsung
severity security_result.severity Dipetakan: 1 → LOW
cyoloobjname target.application Dipetakan secara langsung
object_name target.application Dipetakan secara langsung
asset_id target.asset.asset_id Dipetakan secara langsung
destination_host target.asset.hostname Dipetakan secara langsung
dst target.asset.ip Digabung
asset_name target.asset.product_object_id Dipetakan secara langsung
destination_host target.hostname Dipetakan secara langsung
dst target.ip Digabung
destination_port target.port Dipetakan secara langsung
_field target.resource.attribute.labels Digabung
key target.resource.attribute.labels Dipetakan: cyolodstid → _field
cyoloobjid target.resource.product_object_id Dipetakan secara langsung
object_id target.resource.product_object_id Dipetakan secara langsung
cyoloobjkind target.resource.resource_subtype Dipetakan secara langsung
syslog_subject_name target.user.userid Dipetakan secara langsung
T/A extensions.auth.type Konstanta: MACHINE
T/A metadata.product_name Konstanta: CYOLO_OT
T/A metadata.vendor_name Konstanta: CYOLO_OT
T/A network.application_protocol Konstanta: RDP
T/A network.http.parsed_user_agent Konstanta: parseduseragent
T/A security_result.outcome Konstanta: FAIL
T/A security_result.severity Konstanta: LOW
inter_host event.idm.read_only_udm.intermediary.hostname dan event.idm.read_only_udm.intermediary.asset.hostname Dipetakan dari log perubahan
cyolosubjectname event.idm.read_only_udm.principal.user.userid Dipetakan dari log perubahan
cyolocountrycode event.idm.read_only_udm.principal.location.country_or_region Dipetakan dari log perubahan
cyolosubjectid event.idm.read_only_udm.principal.user.product_object_id Dipetakan dari log perubahan
dst event.idm.read_only_udm.target.ipdan event.idm.read_only_udm.target.asset.ip Dipetakan dari log perubahan
cyoloobjname event.idm.read_only_udm.target.application Dipetakan dari log perubahan
cyoloobjid event.idm.read_only_udm.target.resource.product_object_id Dipetakan dari log perubahan
cyolosessionid event.idm.read_only_udm.network.session_id Dipetakan dari log perubahan
cyolouagent event.idm.read_only_udm.network.http.user_agent dan event.idm.read_only_udm.network.http.parsed_user_agent Dipetakan dari log perubahan
cyoloauthid event.idm.read_only_udm.security_result.rule_id Dipetakan dari log perubahan
cyoloauthname event.idm.read_only_udm.security_result.rule_name Dipetakan dari log perubahan
cyolosubjectkind event.idm.read_only_udm.principal.resource.resource_subtype Dipetakan dari log perubahan
cyoloobjkind event.idm.read_only_udm.target.resource.resource_subtype Dipetakan dari log perubahan
prod_type event.idm.read_only_udm.metadata.product_event_type Dipetakan dari log perubahan
cyoloauthkind event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
cyolokind event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
cyoloresult event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
cyolodstid event.idm.read_only_udm.target.resource.attribute.labels Dipetakan dari log perubahan
cef_version event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
Signature_id event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cef_severity event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
start event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
act event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cyolotransid event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cyolocredentialsorigin event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cyolocredentialsid event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
cyolocredentialsname event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
time event.idm.read_only_udm.metadata.event_timestamp Dipetakan dari log perubahan
id event.idm.read_only_udm.metadata.product_log_id Dipetakan dari log perubahan
remote_address event.idm.read_only_udm.principal.ip Dipetakan dari log perubahan
remote_address event.idm.read_only_udm.principal.asset.ip Dipetakan dari log perubahan
country_code event.idm.read_only_udm.principal.location.country_or_region Dipetakan dari log perubahan
destination_host event.idm.read_only_udm.target.hostname Dipetakan dari log perubahan
destination_host event.idm.read_only_udm.target.asset.hostname Dipetakan dari log perubahan
destination_port event.idm.read_only_udm.target.port Dipetakan dari log perubahan
message event.idm.read_only_udm.metadata.description Dipetakan dari log perubahan
subject_name event.idm.read_only_udm.principal.user.userid Dipetakan dari log perubahan
subject_id event.idm.read_only_udm.principal.user.product_object_id Dipetakan dari log perubahan
timestamp event.idm.read_only_udm.metadata.event_timestamp Dipetakan dari log perubahan
object_name event.idm.read_only_udm.target.application Dipetakan dari log perubahan
object_id event.idm.read_only_udm.target.resource.product_object_id Dipetakan dari log perubahan
session_id event.idm.read_only_udm.network.session_id Dipetakan dari log perubahan
duration_str event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
message event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
subject_kind event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
authority_kind event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
log_level event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
object_kind event.idm.read_only_udm.additional.fields Dipetakan dari log perubahan
client event.idm.read_only_udm.network.http.user_agent Dipetakan dari log perubahan
client event.idm.read_only_udm.network.http.parsed_user_agent Dipetakan dari log perubahan
authority_id event.idm.read_only_udm.security_result.rule_id Dipetakan dari log perubahan
authority_name event.idm.read_only_udm.security_result.rule_name Dipetakan dari log perubahan
severity event.idm.read_only_udm.security_result.severity Dipetakan dari log perubahan
rules event.idm.read_only_udm.security_result.detection_fields Dipetakan dari log perubahan
hostname event.idm.read_only_udm.observer.hostname Dipetakan dari log perubahan
node_id event.idm.read_only_udm.observer.resource.product_object_id Dipetakan dari log perubahan
site_id event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
log_source event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
site_name event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
container_id event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
transaction_id event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
event_id event.idm.read_only_udm.observer.resource.attribute.labels Dipetakan dari log perubahan
kind event.idm.read_only_udm.metadata.product_event_type Dipetakan dari log perubahan
syslog_timestamp event.idm.read_only_udm.metadata.collected_timestamp Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

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