Mengumpulkan log Pengguna Perangkat Cloud Identity

Versi Parser: 1.0

Didukung di:

Dokumen ini menjelaskan cara mengumpulkan log Pengguna Perangkat Cloud Identity ke Google Security Operations menggunakan metode API Pihak Ketiga, yang merupakan pendekatan yang direkomendasikan. Parser pertama-tama mengekstrak data dari log Cloud Identity Device Users berformat JSON dan mengubah stempel waktu ke format standar. Kemudian, parser ini memetakan kolom tertentu dari data log mentah ke kolom yang sesuai dalam model data terpadu (UDM) untuk entitas pengguna, hubungannya dengan aset, dan atribut pengguna tambahan seperti status pengelolaan dan sandi.

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 Identity Device Users

  1. Klik paket Google Cloud Compute platform.
  2. Cari jenis log Google Cloud Identity Device Users, lalu klik Add new feed.
  3. 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.
  1. 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

  1. Login ke Google Cloud console.
  2. Buka halaman Cloud Storage Buckets.

    Buka Bucket

  3. Klik Buat.

  4. Di halaman Buat bucket, masukkan informasi bucket Anda. Setelah menyelesaikan setiap langkah berikut, klik Continue untuk melanjutkan ke langkah berikutnya:

    1. Di bagian Get started, lakukan tindakan berikut:

      1. Masukkan nama unik yang memenuhi persyaratan nama bucket; misalnya, gcp-cloudidentity-users-logs.
      2. 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.

      3. Untuk menambahkan label bucket, klik panah peluas untuk meluaskan bagian Labels.

      4. Klik Add label, lalu tentukan kunci dan nilai untuk label Anda.

    2. Di bagian Choose where to store your data, lakukan tindakan berikut:

      1. Pilih Location type.
      2. Gunakan menu jenis lokasi untuk memilih Location tempat data objek dalam bucket Anda akan disimpan secara permanen.

      3. Untuk menyiapkan replikasi lintas bucket, luaskan bagian Set up cross-bucket replication.

    3. Di bagian Choose a storage class for your data, pilih default storage class untuk bucket, atau pilih Autoclass untuk pengelolaan kelas penyimpanan otomatis untuk data bucket Anda.

    4. Di bagian Choose how to control access to objects, hapus centang Enforce public access prevention, lalu pilih model Access control untuk objek bucket Anda.

    5. Di bagian Choose how to protect object data, lakukan hal berikut:

      1. Pilih salah satu opsi di bagian Perlindungan data yang ingin Anda tetapkan untuk bucket.
      2. Untuk memilih cara data objek Anda akan dienkripsi, klik panah peluas berlabel Enkripsi data, lalu pilih metode enkripsi data.
  5. Klik Create.

Mengonfigurasi ekspor log Pengguna Perangkat Cloud Identity

  1. Login ke Google Cloud console.
  2. Buka Logging > Log Router.
  3. Klik Create Sink.
  4. Berikan parameter konfigurasi berikut:

    • Sink Name: masukkan nama yang bermakna; misalnya, Cloudidentity-Users-Sink.
    • Sink Destination: pilih Cloud Storage Storage dan masukkan URI untuk bucket Anda; misalnya, gs://gcp-cloudidentity-users-logs/.
    • Filter Log:

      logName="projects/<your-project-id>/logs/cloudaudit.googleapis.com%2Factivity"
      resource.type="cloud_identity_user"
      
    • Set Export Options: sertakan semua entri log.

  5. Klik Create.

Mengonfigurasi izin untuk Cloud Storage

  1. Buka IAM & Admin > IAM.
  2. Temukan akun layanan Cloud Logging.
  3. Berikan roles/storage.admin pada bucket.

Tabel Pemetaan UDM

Kolom Log Pemetaan UDM Logika
collection_time.nanos timestamp.nanos Dipetakan langsung dari kolom log. Merepresentasikan stempel waktu peristiwa dalam nanodetik.
collection_time.seconds timestamp.seconds Dipetakan langsung dari kolom log. Menunjukkan stempel waktu peristiwa dalam detik.
Waktu pembuatan entity.metadata.creation_timestamp Dipetakan langsung dari kolom log setelah diuraikan oleh filter date. Merepresentasikan stempel waktu pembuatan pengguna.
managementState entity.additional.fields.value.string_value Dipetakan langsung dari kolom log. Merepresentasikan status pengelolaan pengguna.
nama entity.entity.resource.name Dipetakan langsung dari kolom log. Merepresentasikan nama resource lengkap pengguna perangkat.
passwordState entity.additional.fields.value.string_value Dipetakan langsung dari kolom log. Mewakili status sandi pengguna. Kolom ini hanya dipetakan jika kolom passwordState ada di log mentah.
userEmail entity.entity.user.email_addresses Dipetakan langsung dari kolom log. Menampilkan alamat email pengguna.
entity.additional.fields.key Tetapkan ke nilai konstan Management State dalam parser. Kolom ini digunakan untuk memberikan konteks pada nilai managementState.
entity.additional.fields.key Tetapkan ke nilai konstan Password State dalam parser. Kolom ini digunakan untuk memberikan konteks pada nilai passwordState dan hanya ada jika passwordState ada dalam log mentah.
entity.entity.user.product_object_id Diekstrak dari kolom name menggunakan filter grok, yang mengambil bagian deviceuser_id. Menunjukkan ID unik pengguna perangkat.
entity.metadata.collected_timestamp.nanos Disalin dari collection_time.nanos. Menunjukkan stempel waktu saat log dikumpulkan.
entity.metadata.collected_timestamp.seconds Disalin dari collection_time.seconds. Menunjukkan stempel waktu saat log dikumpulkan.
entity.metadata.entity_type Tetapkan ke nilai konstan USER dalam parser.
entity.metadata.product_name Tetapkan ke nilai konstan GCP Cloud Identity Device Users dalam parser.
entity.metadata.vendor_name Tetapkan ke nilai konstan Google Cloud Platform dalam parser.
relations.entity.asset.product_object_id Diekstrak dari kolom name menggunakan filter grok, yang mengambil bagian device_id. Menunjukkan ID unik perangkat.
relations.entity_type Tetapkan ke nilai konstan ASSET dalam parser.
relations.relationship Tetapkan ke nilai konstan MEMBER dalam parser.

Log Perubahan

Melihat Log Perubahan untuk parser ini

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