Mengumpulkan log JFrog Artifactory

Didukung di:

Dokumen ini menjelaskan cara menyerap log JFrog Artifactory ke Google Security Operations menggunakan agen Bindplane.

JFrog Artifactory adalah pengelola repositori artefak universal yang menghasilkan pesan syslog untuk peristiwa akses repositori, autentikasi, perubahan konfigurasi, dan operasi artefak. Parser mengekstrak kolom dari syslog dan log berformat JSON menggunakan pola grok 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 server JFrog Artifactory
  • Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
  • Akses SSH ke instance JFrog Artifactory

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/jfrog_artifactory:
        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: JFROG_ARTIFACTORY
        raw_log_field: body
    
    service:
      pipelines:
        logs/jfrog_artifactory_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/jfrog_artifactory
    

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/jfrog_artifactory:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: JFROG_ARTIFACTORY
        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 JFrog Artifactory

  1. Hubungkan ke instance JFrog Artifactory.
  2. Edit file $JFROG_HOME/artifactory/var/etc/artifactory/logback.xml:

    vi $JFROG_HOME/artifactory/var/etc/artifactory/logback.xml
    
  3. Tambahkan appender syslog berikut ke file:

    <appender name="SYSLOG" class="ch.qos.logback.classic.net.SyslogAppender">
        <syslogHost><BINDPLANE_IP></syslogHost>
        <facility>SYSLOG</facility>
        <suffixPattern>[%thread] %logger %msg</suffixPattern>
    </appender>
    
    • Ganti <BINDPLANE_IP> dengan alamat IP agen Bindplane yang sebenarnya.
  4. Tambahkan referensi appender syslog ke root logger:

    <root>
        <level value="debug"/>
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
        <appender-ref ref="SYSLOG"/>
    </root>
    
  5. Simpan file dengan menekan ESC dan mengetik :wq.

Tabel pemetaan UDM

Kolom Log Pemetaan UDM Logika
action read_only_udm.metadata.product_event_type Nilai action dari log mentah dikonversi ke huruf kecil dan dipetakan.
datetime read_only_udm.metadata.event_timestamp Kolom datetime log mentah diuraikan dan dikonversi menjadi stempel waktu.
hostname read_only_udm.principal.hostname Dipetakan langsung dari kolom hostname log mentah.
id read_only_udm.metadata.product_log_id Dipetakan langsung dari kolom id log mentah (dari payload JSON).
ip read_only_udm.principal.ip Dipetakan langsung dari kolom ip log mentah. Dihardcode ke "USER_RESOURCE_ACCESS". Dihardcode ke "JFROG_ARTIFACTORY". Diprogram secara permanen ke "Artifactory". Diprogram secara permanen ke "JFROG".
owner read_only_udm.principal.user.userid Dipetakan jika username tidak ada dalam log mentah (dari payload JSON).
repo_name read_only_udm.target.resource.name Dipetakan langsung dari kolom repo_name log mentah.
repo_type read_only_udm.target.resource.resource_subtype Dipetakan langsung dari kolom repo_type log mentah.
scope read_only_udm.target.resource.name Dipetakan langsung dari kolom scope log mentah (dari payload JSON).
scope read_only_udm.target.resource.resource_subtype Di-hardcode ke "scope" jika scope ada dalam log mentah.
sequenceId read_only_udm.metadata.product_log_id Tanda kutip dihapus dari kolom sequenceId, lalu dipetakan.
subject read_only_udm.about.labels.key Dihardcode ke "subject" jika subject ada dalam log mentah.
subject read_only_udm.about.labels.value Dipetakan langsung dari kolom subject log mentah (dari payload JSON).
jenis read_only_udm.metadata.product_event_type Dipetakan langsung dari kolom type log mentah (dari payload JSON).
user read_only_udm.principal.user.userid Dipetakan langsung dari kolom user log mentah.
username read_only_udm.principal.user.userid Dipetakan langsung dari kolom username log mentah (dari payload JSON).
data.repository_key", "data.release_bundle_name", "data.release_bundle_version", "data.property_key", "data.property_values", "data.platforms.architecture", and "data.platforms.os additional.fields Dipetakan dari log perubahan
data.repo_key" ,"subscription_key","source","image_name", "data.platforms additional.fields Dipetakan dari log perubahan
domain principal.administrative_domain Dipetakan dari log perubahan
data.path target.file.full_path Dipetakan dari log perubahan
data.name target.user.user_display_name Dipetakan dari log perubahan
data.size target.file.size Dipetakan dari log perubahan
SHA256 target.process.file.sha256 Dipetakan dari log perubahan
target_ip target.ip Dipetakan dari log perubahan
desc metadata.description Dipetakan dari log perubahan
method network.http.method Dipetakan dari log perubahan
url target.url Dipetakan dari log perubahan
prin_url principal.url Dipetakan dari log perubahan
response_code network.http.response_code Dipetakan dari log perubahan
RequestMethod network.http.method Dipetakan dari log perubahan
RequestPath target.url Dipetakan dari log perubahan
DownstreamContentSize" and "DownstreamStatus Additional.Fields Dipetakan dari log perubahan
ServiceAddr principal.hostname Dipetakan dari log perubahan
ClientAddr target.ip Dipetakan dari log perubahan
user_agent network.http.user_agent Dipetakan dari log perubahan
level security_result.severity Dipetakan dari log perubahan
msg security_result.description Dipetakan dari log perubahan
protocol network.application_protocol Dipetakan dari log perubahan

Log Perubahan

Melihat Log Perubahan untuk parser ini

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