Mengumpulkan log Perangkat Cloud Identity
Versi Parser: 1.0
Dokumen ini menjelaskan cara mengumpulkan log Perangkat Cloud Identity ke
Google SecOps menggunakan metode API Pihak Ketiga, yang merupakan
pendekatan yang direkomendasikan. Parser mengekstrak kolom dari log JSON, mengubah kolom tertentu seperti deviceType dan tanggal, serta memetakannya ke UDM, sehingga membuat asset_entity yang mewakili perangkat dan memperkayanya dengan informasi hardware dan metadata.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Penyiapan Delegasi Seluruh Domain untuk Akun Layanan. Akun Layanan harus diberi otorisasi untuk cakupan berikut:
https://www.googleapis.com/auth/cloud-identity.devices.readonly
- API berikut diaktifkan di project Google Cloud Anda:
- Cloud Identity API
- Google Workspace Admin SDK
- Alert Center API
Direkomendasikan: Menyiapkan Feed API Pihak Ketiga
Ada dua titik entri yang berbeda untuk menyiapkan feed di platform Google SecOps:
- Settings > Data Management > Feeds > Add New Feed (Di platform khusus SIEM, Settings > Feeds > Add New Feed)
- Content Hub > Paket Konten > Mulai
Cara menyiapkan feed Google Cloud Perangkat Identitas
- Klik paket Google Cloud Compute platform.
- Temukan jenis log Google Cloud Identity Devices, lalu klik Add new feed.
- Tentukan nilai untuk kolom berikut:
- Jenis Sumber: Pilih API pihak ketiga.
- Endpoint JWT OAuth: Masukkan endpoint token OAuth:
https://oauth2.googleapis.com/token - JWT claims issuer: Masukkan alamat email Akun Layanan (dapat ditemukan di file kunci JSON Akun Layanan).
- JWT claims subject: Masukkan alamat email pengguna yang diberi peran services admin atau super admin di konsol Workspace (pengguna yang ditiru identitasnya melalui Delegasi Tingkat Domain).
- JWT claims audience: Masukkan endpoint lagi:
https://oauth2.googleapis.com/token - RSA private key: Tempelkan konten lengkap kunci pribadi dari file kunci JSON Akun Layanan (termasuk baris
-----BEGIN PRIVATE KEY-----dan-----END PRIVATE KEY-----).
Opsi lanjutan
- Nama Feed: Nilai yang diisi otomatis yang mengidentifikasi feed.
- Namespace Aset: Namespace yang terkait dengan feed.
- Label Penyerapan: Label yang diterapkan ke semua peristiwa dari feed ini.
- Klik Buat feed.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi beberapa feed untuk berbagai jenis log dalam kelompok produk ini, lihat Mengonfigurasi feed menurut produk.
Metode Alternatif: Penyerapan melalui Cloud Storage
- Login ke Google Cloud console.
Buka halaman Cloud Storage Buckets.
Klik Buat.
Di halaman Buat bucket, masukkan informasi bucket Anda. Setelah menyelesaikan setiap langkah berikut, klik Continue untuk melanjutkan ke langkah berikutnya:
Di bagian Get started, lakukan tindakan berikut:
- Masukkan nama unik yang memenuhi persyaratan nama bucket; misalnya, gcp-cloudidentity-devices-logs.
Untuk mengaktifkan namespace hierarkis, klik panah peluas untuk meluaskan bagian Optimize for file oriented and data-intensive workloads, lalu pilih Enable Hierarchical namespace on this bucket.
Untuk menambahkan label bucket, klik panah peluas untuk meluaskan bagian Labels.
Klik Add label, lalu tentukan kunci dan nilai untuk label Anda.
Di bagian Choose where to store your data, lakukan tindakan berikut:
- Pilih Location type.
Gunakan menu jenis lokasi untuk memilih Location tempat data objek dalam bucket Anda akan disimpan secara permanen.
Untuk menyiapkan replikasi lintas bucket, luaskan bagian Set up cross-bucket replication.
Di bagian Choose a storage class for your data, pilih kelas penyimpanan default untuk bucket, atau pilih Autoclass untuk pengelolaan kelas penyimpanan otomatis untuk data bucket Anda.
Di bagian Choose how to control access to objects, hapus centang Enforce public access prevention, lalu pilih model Access control untuk objek bucket Anda.
Di bagian Choose how to protect object data, lakukan hal berikut:
- Pilih salah satu opsi di bagian Perlindungan data yang ingin Anda tetapkan untuk bucket.
- Untuk memilih cara data objek Anda akan dienkripsi, klik panah peluas berlabel Enkripsi data, lalu pilih metode enkripsi data.
Klik Create.
Mengonfigurasi Ekspor Log Perangkat Cloud Identity
- Login ke Google Cloud console.
- Buka Logging > Log Router.
- Klik Create Sink.
Berikan parameter konfigurasi berikut:
- Sink Name: masukkan nama yang bermakna; misalnya,
cloud-identity-devices-logs-sink. - Sink Destination: pilih Cloud Storage Storage dan masukkan URI untuk bucket Anda; misalnya,
gs://gcp-cloudidentity-devices-logs/. Filter Log:
logName="projects/<your-project-id>/logs/cloudaudit.googleapis.com%2Factivity" resource.type="cloud_identity_device"Set Export Options: sertakan semua entri log.
- Sink Name: masukkan nama yang bermakna; misalnya,
Klik Create.
Mengonfigurasi izin untuk Cloud Storage
- Buka IAM & Admin > IAM.
- Temukan akun layanan Cloud Logging.
- Berikan roles/storage.admin pada bucket.
Tabel Pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
createTime |
entity.metadata.creation_timestamp |
Nilai createTime diuraikan sebagai stempel waktu dan dipetakan. |
deviceId |
entity.entity.asset.asset_id |
Dipetakan secara langsung. |
deviceType |
entity.entity.asset.platform_software.platform |
Dipetakan ke MAC jika nilai aslinya adalah MAC_OS atau IOS. Dipetakan ke WINDOWS, MAC, atau LINUX jika nilai aslinya cocok. Jika tidak, tetapkan ke UNKNOWN_PLATFORM. |
encryptionState |
entity.entity.asset.attribute.labels.key |
Nilai ditetapkan ke encryptionState. Digunakan sebagai bagian dari label. |
encryptionState |
entity.entity.asset.attribute.labels.value |
Dipetakan secara langsung. Digunakan sebagai bagian dari label. |
lastSyncTime |
entity.entity.asset.system_last_update_time |
Nilai lastSyncTime diuraikan sebagai stempel waktu dan dipetakan. |
managementState |
entity.entity.asset.attribute.labels.key |
Nilai ditetapkan ke managementState. Digunakan sebagai bagian dari label. |
managementState |
entity.entity.asset.attribute.labels.value |
Dipetakan secara langsung. Digunakan sebagai bagian dari label. |
model |
entity.entity.asset.hardware.model |
Dipetakan secara langsung. |
name |
entity.entity.asset.product_object_id |
Bagian setelah devices/ akan diekstrak dan dipetakan. |
name |
entity.entity.resource.name |
Dipetakan secara langsung. |
osVersion |
entity.entity.asset.platform_software.platform_version |
Dipetakan secara langsung. |
securityPatchTime |
entity.entity.asset.attribute.labels.key |
Nilai ditetapkan ke securityPatchTime. Digunakan sebagai bagian dari label. |
securityPatchTime |
entity.entity.asset.attribute.labels.value |
Dipetakan secara langsung. Digunakan sebagai bagian dari label. |
serialNumber |
entity.entity.asset.hardware.serial_number |
Dipetakan secara langsung. Disalin dari kolom create_time tingkat teratas di log mentah. Nilai ditetapkan ke ASSET. Nilai ditetapkan ke GCP Cloud Identity Devices. Nilai ditetapkan ke Google Cloud Platform. Disalin dari kolom create_time tingkat teratas di log mentah. |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.