Mengumpulkan log Kiteworks (sebelumnya Accellion)

Versi Parser: 16.0

Didukung di:

Dokumen ini menjelaskan cara menyerap log Kiteworks (sebelumnya dikenal sebagai Accellion) ke Google Security Operations menggunakan Bindplane.

Kiteworks adalah platform berbagi dan tata kelola file yang aman yang menyediakan komunikasi konten perusahaan melalui email, berbagi file, transfer file terkelola, dan formulir web. Solusi ini memberikan visibilitas, kepatuhan, dan kontrol atas konten sensitif yang masuk dan keluar dari organisasi.

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 perangkat Kiteworks
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses istimewa ke konsol administrasi Kiteworks (peran Administrator Sistem)

Mendapatkan file autentikasi penyerapan Google SecOps

  1. Login ke konsol Google SecOps.
  2. Buka Setelan SIEM > Agen Pengumpulan.
  3. Download File Autentikasi Penyerapan. Simpan file dengan aman di sistem tempat BindPlane akan diinstal.

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.

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.

Mengonfigurasi agen Bindplane untuk menyerap syslog dan mengirimkannya ke Google SecOps

Cari file konfigurasi

  • Linux:

    sudo nano /status observiq-otel-collector/config.yaml
    
  • Windows:

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

Edit file konfigurasi

  • Ganti seluruh konten config.yaml dengan konfigurasi berikut:

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/accellion:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: ACCELLION
            raw_log_field: body
    
    service:
        pipelines:
            logs/accellion_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/accellion
    

Parameter konfigurasi

Ganti placeholder berikut:

  • Konfigurasi penerima:

    • listen_address: Alamat IP dan port yang akan diproses:
      • 0.0.0.0 untuk mendengarkan di 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 autentikasi penyerapan:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID Pelanggan yang disalin dari konsol Google SecOps
    • endpoint: URL endpoint regional:
      • Amerika Serikat: malachiteingestion-pa.googleapis.com
      • Eropa: europe-malachiteingestion-pa.googleapis.com
      • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Lihat Endpoint Regional untuk mengetahui daftar lengkapnya

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

  1. Jalankan perintah berikut:

    sudo systemctl restart observiq-otel-collector
    
  2. Pastikan layanan sedang berjalan:

    sudo systemctl status observiq-otel-collector
    
  3. Periksa log untuk mengetahui error:

    sudo journalctl -u observiq-otel-collector -f
    

Untuk memulai ulang agen Bindplane di Windows:

  1. Pilih salah satu opsi berikut:

    • Command Prompt atau PowerShell sebagai administrator:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • Konsol layanan:
      1. Tekan Win+R, ketik services.msc, lalu tekan Enter.
      2. Cari observIQ OpenTelemetry Collector.
      3. Klik kanan, lalu pilih Mulai ulang.
  2. Pastikan layanan sedang berjalan:

    sc query observiq-otel-collector
    
  3. Periksa log untuk mengetahui error:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

Mengonfigurasi penerusan syslog di Kiteworks (sebelumnya Accellion)

  1. Login ke konsol administrasi Kiteworks sebagai Administrator Sistem.
  2. Buka halaman Lokasi:
    • UI admin lama: Buka Sistem > Lokasi.
    • UI admin baru: Buka Penyiapan Sistem > Lokasi.
  3. Pilih lokasi target dari daftar.
  4. Buka bagian Layanan Eksternal.
  5. Luaskan panel Syslog Settings.
  6. Klik Tambahkan untuk membuat konfigurasi server syslog baru.
  7. Berikan detail konfigurasi berikut:
    • Server Syslog: Masukkan alamat IP host agen BindPlane (misalnya, 192.168.1.100).
    • Protocol: Pilih UDP atau TCP, bergantung pada konfigurasi penerima agen Bindplane Anda.
    • Port: Masukkan nomor port agen Bindplane (misalnya, 514).
    • Gunakan TLS: Centang kotak ini jika Anda ingin mentransmisikan pesan syslog melalui TLS (hanya tersedia jika TCP dipilih sebagai protokol).
    • Format: Pilih Format JSON (direkomendasikan untuk parsing terstruktur).
  8. Klik Simpan untuk menerapkan konfigurasi.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
acct principal.user.user_display_name Nilai acct dari kolom msg log mentah.
acct target.user.user_display_name Nilai acct dari kolom msg log mentah.
addr principal.ip Nilai addr dari kolom msg log mentah.
a0 security_result.about.labels.value Nilai a0 dari kolom msg log mentah, dengan key yang sesuai adalah "a0".
a1 security_result.about.labels.value Nilai a1 dari kolom msg log mentah, dengan key yang sesuai adalah "a1".
a2 security_result.about.labels.value Nilai a2 dari kolom msg log mentah, dengan key yang sesuai adalah "a2".
a3 security_result.about.labels.value Nilai a3 dari kolom msg log mentah, dengan key yang sesuai adalah "a3".
arch security_result.about.platform_version Nilai arch dari kolom msg log mentah. Hanya berlaku untuk SYSCALL type_name.
auid about.user.userid Nilai auid dari kolom msg log mentah.
auid security_result.detection_fields.value Nilai auid dari kolom msg log mentah, dengan key yang sesuai adalah "auid".
comm principal.application Nilai comm dari kolom msg log mentah.
cmd principal.process.command_line Nilai cmd dari kolom msg log mentah.
cwd security_result.detection_fields.value Nilai cwd dari kolom msg log mentah, dengan key yang sesuai adalah "cwd".
cwd target.process.file.full_path Nilai cwd dari kolom msg log mentah.
exe principal.process.file.full_path Nilai exe dari kolom msg log mentah.
exe target.process.file.full_path Nilai exe dari kolom msg log mentah.
exit security_result.about.labels.value Nilai exit dari kolom msg log mentah, dengan key yang sesuai adalah "Exit Code".
hostname principal.hostname Nilai hostname dari kolom msg log mentah.
key security_result.about.registry.registry_key Nilai key dari kolom msg log mentah. Hanya berlaku untuk SYSCALL type_name.
log_type metadata.log_type Nilai log_type dari log mentah.
msg security_result.action_details Nilai setelah res= di kolom msg log mentah.
msg security_result.summary Kombinasi kolom dari kolom msg log mentah. Diuraikan dari bagian audit kolom msg dalam log mentah. Dipetakan berdasarkan kolom type dalam log mentah. Misalnya, "USER_START" dipetakan ke "USER_LOGIN", "CRED_DISP" dipetakan ke "USER_LOGOUT", "CRED_ACQ" dipetakan ke "USER_LOGIN", "USER_END" dipetakan ke "USER_LOGOUT", "CRED_REFR" dipetakan ke "USER_LOGIN", "USER_CMD" dipetakan ke "USER_LOGIN", "CWD" dipetakan ke "STATUS_UPDATE", "PROCTITLE" dipetakan ke "STATUS_UPDATE", "USER_ACCT" dipetakan ke "USER_UNCATEGORIZED", dan "SYSCALL" dipetakan ke "USER_UNCATEGORIZED".
node principal.hostname Nilai node dari kolom msg log mentah.
pid principal.process.pid Nilai pid dari kolom msg log mentah.
ppid principal.process.parent_process.pid Nilai ppid dari kolom msg log mentah.
proctitle target.process.file.full_path Nilai heksadesimal proctitle yang didekode dari kolom msg log mentah. Dikodekan secara permanen ke "LINUX". Tetapkan ke "ALLOW" jika res=success ada di kolom msg log mentah.
ses network.session_id Nilai ses dari kolom msg log mentah.
syscall security_result.about.labels.value Nilai syscall dari kolom msg log mentah, dengan key yang sesuai adalah "Syscall".
success security_result.summary Digabungkan dengan kolom lain untuk membentuk ringkasan. Untuk peristiwa SYSCALL, logikanya adalah: jika success=yes, maka "yes, The System call succeeded", jika tidak, "no, The System call failed".
terminal principal.terminal Nilai terminal dari kolom msg log mentah.
timestamp timestamp Nilai timestamp dari entri log mentah.
tty principal.terminal Nilai tty dari kolom msg log mentah.
type metadata.product_event_type Nilai type dari kolom msg log mentah.
uid about.user.userid Nilai uid dari kolom msg log mentah. Hanya berlaku untuk SYSCALL type_name.
uid target.user.userid Nilai uid dari kolom msg log mentah. Ditetapkan ke "SETTING" jika type adalah "USER_ACCT".

Log Perubahan

Melihat Log Perubahan untuk parser ini

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