Mengumpulkan log ForgeRock OpenDJ
Versi Parser: 2.0
Dokumen ini menjelaskan cara menyerap log ForgeRock OpenDJ ke Google Security Operations menggunakan Bindplane.
ForgeRock OpenDJ adalah server direktori LDAP open source yang menyediakan penyimpanan data identitas dan layanan autentikasi. LDAP Directory Service menghasilkan log akses, log audit, dan log error untuk operasi LDAP, peristiwa autentikasi, dan modifikasi direktori. Parser mengekstrak kolom dari entri log OpenDJ 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 ForgeRock OpenDJ
- Jika beroperasi dari balik proxy, pastikan port firewall terbuka sesuai dengan persyaratan agen Bindplane
- Akses istimewa ke server ForgeRock OpenDJ dengan izin administrator
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: Membuat akun layanan untuk Chronicle API (direkomendasikan)
- Login ke konsolGoogle Cloud dan pilih project Google Cloud yang ditautkan ke instance Google SecOps Anda.
- Buka IAM & Admin > Service Accounts.
- Klik Create service account.
- Berikan detail konfigurasi berikut:
- Service account name: Masukkan nama akun (misalnya,
bindplane-ingest). - Service account description: Masukkan deskripsi (misalnya,
Bindplane agent log ingestion).
- Service account name: Masukkan nama akun (misalnya,
- Klik Create and continue.
- Di bagian Grant this service account access to project, klik Select a role, lalu pilih Chronicle Editor.
- Klik Continue lalu klik Done.
- Klik akun layanan yang Anda buat, lalu buka tab Keys.
- Klik Add key > Create new key.
- Pilih JSON dan klik Create. File kunci akan didownload ke komputer Anda.
- Simpan file kunci sebagai
ingestion-auth.jsondi direktori kolektor Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsondi Linux atauC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsondi Windows), atau perbaruicreds_file_pathdiconfig.yamlagar sesuai dengan jalur tempat Anda menyimpannya. - Buka IAM & Admin > Settings dan salin Project number. Anda akan memerlukannya untuk konfigurasi pengekspor.
Opsi 2: Mendownload file autentikasi penyerapan (lama)
- Login ke konsol Google SecOps.
- Buka Settings > Data Management > Collection Agents. Jika Anda menggunakan platform khusus SIEM, buka Settings > Collection Agents.
- Download file autentikasi penyerapan.
- Simpan file dengan aman di sistem tempat agen Bindplane akan diinstal.
Mendapatkan ID pelanggan Google SecOps
- Login ke konsol Google SecOps.
- Buka Setelan > Administrasi > Profil. Jika Anda menggunakan platform khusus SIEM, buka Settings > Profile.
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
- Buka Command Prompt atau PowerShell sebagai administrator.
Jalankan perintah berikut:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietTunggu hingga penginstalan selesai.
Verifikasi penginstalan dengan menjalankan:
sc query observiq-otel-collector
Layanan akan ditampilkan sebagai RUNNING.
Penginstalan Linux
- Buka terminal dengan hak istimewa root atau sudo.
Jalankan perintah berikut:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shTunggu hingga penginstalan selesai.
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.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Mengedit file konfigurasi
Ganti seluruh konten
config.yamldengan konfigurasi berikut:receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/opendj: 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: OPENDJ raw_log_field: body service: pipelines: logs/opendj: receivers: - tcplog exporters: - chronicle/opendj
Parameter konfigurasi
Ganti placeholder berikut:
Konfigurasi penerima:
tcplog: Jenis penerima berdasarkan protokol:udploguntuk syslog UDPtcploguntuk syslog TCPsysloguntuk syslog RFC 3164/5424
0.0.0.0: IP address to listen on:0.0.0.0untuk 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 sebelumnyalocation: Ganti<LOCATION>dengan region instance Google SecOps Anda (misalnya,us,europe, atauasia-southeast1). Pengekspor mengawalichronicle.googleapis.comdengan nilai ini. Lihat Endpoint Regional untuk mengetahui daftar lengkapnya.project: Ganti<PROJECT_NUMBER>dengan nomor project dari IAM & Admin > Settings.endpoint: Tetap tetapkan kechronicle.googleapis.com.- Sesuaikan
creds_file_pathke 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
- Linux:
Pengekspor API penyerapan lama
Jika Anda menggunakan file autentikasi penyerapan dari Opsi 2, ganti blok
exportersdengan kode berikut. Tetapkancreds_file_pathke jalur ke file autentikasi penyerapan, dan jika instance Anda berada di luar AS, gantimalachiteingestion-pa.googleapis.comdengan endpoint regional Anda (misalnya,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/opendj: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: OPENDJ raw_log_field: body
Simpan file konfigurasi
- Setelah mengedit, simpan file:
- Linux: Tekan
Ctrl+O, laluEnter, laluCtrl+X - Windows: Klik File > Save
- Linux: Tekan
Mulai ulang agen Bindplane untuk menerapkan perubahan
Untuk memulai ulang agen Bindplane di Linux:
Jalankan perintah berikut:
sudo systemctl restart observiq-otel-collectorPastikan layanan sedang berjalan:
sudo systemctl status observiq-otel-collectorPeriksa 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 layanan:
- Tekan
Win+R, ketikservices.msc, lalu tekan Enter. - Cari observIQ OpenTelemetry Collector.
- Klik kanan, lalu pilih Restart.
- Tekan
Pastikan layanan sedang berjalan:
sc query observiq-otel-collectorPeriksa log untuk mengetahui error:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Mengonfigurasi penerusan syslog ForgeRock OpenDJ
ForgeRock OpenDJ menyimpan log secara lokal di server. Konfigurasi penerusan syslog menggunakan daemon syslog sistem untuk mengirim log ini ke agen Bindplane.
Identifikasi direktori log OpenDJ. Lokasi defaultnya adalah:
/path/to/opendj/logs/- File log utama mencakup
access,audit, danerrors.
- File log utama mencakup
Konfigurasikan daemon syslog sistem (misalnya,
rsyslog) untuk memantau dan meneruskan file log OpenDJ. Buat file konfigurasi rsyslog baru:sudo nano /etc/rsyslog.d/opendj-forward.confTambahkan konten berikut:
module(load="imfile") input(type="imfile" File="/path/to/opendj/logs/access" Tag="opendj" Severity="info" Facility="local0") input(type="imfile" File="/path/to/opendj/logs/errors" Tag="opendj" Severity="error" Facility="local0") local0.* @@BINDPLANE_AGENT_IP:514Mulai ulang layanan rsyslog:
sudo systemctl restart rsyslog
Referensi pemetaan kolom UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
| interim_server | intermediary.hostname | Nama host perangkat perantara |
| metadata.event_type | Jenis peristiwa (misalnya, USER_LOGIN, NETWORK_CONNECTION) | |
| kv_fields.request.operation | metadata.product_event_type | Jenis peristiwa khusus produk |
| network.application_protocol | Protokol aplikasi yang digunakan (misalnya, HTTP, LDAP) | |
| application | principal.application | Nama aplikasi yang terkait dengan akun utama |
| kv_fields.client.ip | principal.ip | Alamat IP akun utama |
| kv_fields.client.port | principal.port | Nomor port principal |
| security_result.action | Tindakan yang diambil oleh sistem keamanan (misalnya, ALLOW, BLOCK) | |
| kv_fields.request.filter | security_result.description | Deskripsi hasil keamanan |
| kv_fields.server.ip | target.ip | Alamat IP target |
| kv_fields.server.port | target.port | Nomor port target |
| kv_fields.request.dn | target.resource.name | Nama resource |
| target.resource.type | Jenis resource |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.