Mengumpulkan log Perangkat Cloud Identity
Dokumen ini menjelaskan cara mengumpulkan log Perangkat Cloud Identity ke Google SecOps menggunakan metode Third Party API, 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 merepresentasikan perangkat dan memperkayanya dengan informasi hardware dan metadata.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Penyiapan Delegasi Tingkat Domain untuk Akun Layanan. Akun Layanan harus diotorisasi 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 berbeda untuk menyiapkan feed di platform Google SecOps:
- Setelan SIEM > Feed > Tambahkan Feed Baru
- Hub Konten > Paket Konten > Mulai
Cara menyiapkan feed Google Cloud Perangkat Identitas
- Klik paket Google Cloud Compute platform.
- Cari jenis log Google Cloud Perangkat Identitas, lalu klik Tambahkan feed baru.
- Tentukan nilai untuk kolom berikut:
- Jenis Sumber: Pilih API pihak ketiga.
- Endpoint JWT OAuth: Masukkan endpoint token OAuth:
https://oauth2.googleapis.com/token - Penerbit klaim JWT: Masukkan alamat email Akun Layanan (ditemukan di file kunci JSON Akun Layanan).
- Subjek klaim JWT: Masukkan alamat email pengguna yang diberi peran admin layanan atau admin super di konsol Workspace (pengguna yang di-impersonate melalui Delegasi Tingkat Domain).
- Audiens klaim JWT: Masukkan endpoint lagi:
https://oauth2.googleapis.com/token - Kunci pribadi RSA: Tempelkan seluruh konten kunci pribadi dari file kunci JSON Akun Layanan (termasuk baris
-----BEGIN PRIVATE KEY-----dan-----END PRIVATE KEY-----).
Opsi lanjutan
- Nama Feed: Nilai yang telah 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 keluarga produk ini, lihat Mengonfigurasi feed menurut produk.
Metode Alternatif: Penyerapan melalui Cloud Storage
- Login ke Google Cloud konsol.
Buka halaman Cloud Storage Buckets.
Klik Buat.
Di halaman Buat bucket, masukkan informasi bucket Anda. Setelah setiap langkah berikut, klik Lanjutkan untuk melanjutkan ke langkah berikutnya:
Di bagian Mulai, 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 Optimalkan untuk beban kerja berorientasi file dan intensif data, lalu pilih Aktifkan namespace hierarkis di bucket ini.
Untuk menambahkan label bucket, klik panah peluas untuk meluaskan bagian Label.
Klik Tambahkan label, lalu tentukan kunci dan nilai untuk label Anda.
Di bagian Pilih tempat untuk menyimpan data Anda, lakukan tindakan berikut:
- Pilih Jenis lokasi.
Gunakan menu jenis lokasi untuk memilih Lokasi tempat data objek dalam bucket Anda akan disimpan secara permanen.
Untuk menyiapkan replikasi lintas bucket, luaskan bagian Siapkan replikasi lintas bucket.
Di bagian Pilih kelas penyimpanan untuk data Anda, 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 Pilih cara melindungi data objek, lakukan hal berikut:
- Pilih salah satu opsi di bagian Perlindungan data yang ingin Anda tetapkan untuk bucket.
- Untuk memilih cara mengenkripsi data objek Anda, klik panah peluas berlabel Enkripsi data, lalu pilih metode enkripsi data.
Klik Create.
Mengonfigurasi Ekspor Log Perangkat Cloud Identity
- Login ke Google Cloud konsol.
- Buka Logging > Log Router.
- Klik Create Sink.
Berikan parameter konfigurasi berikut:
- Sink Name: masukkan nama yang bermakna; misalnya,
cloud-identity-devices-logs-sink. - Tujuan Sink: 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"Tetapkan Opsi Ekspor: menyertakan 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 peran 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, setel 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/ 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 dalam 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 dalam log mentah. |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.