Dokumen ini menjelaskan cara mengekspor log Pengguna Perangkat Cloud Identity ke Google Security Operations menggunakan Cloud Storage. Parser pertama-tama mengekstrak data dari log Cloud Identity Device Users berformat JSON dan mengubah stempel waktu ke format standar. Kemudian, data 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 memenuhi prasyarat berikut:
Google Cloud Identity diaktifkan di project Google Cloud Anda.
Instance Google SecOps.
Akses istimewa ke Google Cloud Identity dan Cloud Logging.
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-users-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 lokasi untuk menyimpan data Anda, lakukan hal 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 Pilih cara mengontrol akses ke objek, hapus centang Terapkan pencegahan akses publik, lalu pilih model Kontrol akses untuk objek bucket Anda.
Di bagian Pilih cara melindungi data objek, lakukan tindakan berikut:
Pilih salah satu opsi di bagian Perlindungan data yang ingin Anda tetapkan untuk bucket Anda.
Untuk memilih cara mengenkripsi data objek Anda, klik panah peluas berlabel Enkripsi data, lalu pilih metode enkripsi data.
Klik Buat.
Mengonfigurasi ekspor log Pengguna Perangkat Cloud Identity
Tetapkan Opsi Ekspor: menyertakan semua entri log.
Klik Buat.
Mengonfigurasi izin untuk Cloud Storage
Buka IAM & Admin > IAM.
Temukan akun layanan Cloud Logging.
Berikan roles/storage.admin pada bucket.
Menyiapkan feed
Ada dua titik entri berbeda untuk menyiapkan feed di platform Google SecOps:
Setelan SIEM > Feed > Tambahkan Baru
Hub Konten > Paket Konten > Mulai
Cara menyiapkan feed Pengguna Perangkat Identitas Google Cloud
Klik paket Google Cloud Compute platform.
Cari jenis log Google Cloud Pengguna Perangkat Identitas, lalu klik Tambahkan feed baru.
Tentukan nilai untuk kolom berikut:
Jenis Sumber: API pihak ketiga
Endpoint JWT OAuth: endpoint untuk mengambil token web JSON (JWT) OAuth.
Penerbit klaim JWT: biasanya ID klien.
Subjek klaim JWT: biasanya alamat email.
Audiens klaim JWT: Audiens klaim JWT.
Kunci pribadi RSA: masukkan dalam format PEM.
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.
Tabel Pemetaan UDM
Kolom Log
Pemetaan UDM
Logika
collection_time.nanos
timestamp.nanos
Dipetakan langsung dari kolom log. Mewakili stempel waktu peristiwa dalam nanodetik.
collection_time.seconds
timestamp.seconds
Dipetakan langsung dari kolom log. Mewakili stempel waktu acara dalam detik.
createTime
entity.metadata.creation_timestamp
Dipetakan langsung dari kolom log setelah diuraikan oleh filter date. Mewakili stempel waktu pembuatan pengguna.
managementState
entity.additional.fields.value.string_value
Dipetakan langsung dari kolom log. Mewakili status pengelolaan pengguna.
nama
entity.entity.resource.name
Dipetakan langsung dari kolom log. Mewakili nama lengkap resource 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 dalam log mentah.
userEmail
entity.entity.user.email_addresses
Dipetakan langsung dari kolom log. Mewakili alamat email pengguna.
entity.additional.fields.key
Ditetapkan ke nilai konstanta Management State dalam parser. Kolom ini digunakan untuk memberikan konteks pada nilai managementState.
entity.additional.fields.key
Ditetapkan ke nilai konstanta Password State dalam parser. Kolom ini digunakan untuk memberikan konteks pada nilai passwordState dan hanya ada jika passwordState ada di log mentah.
entity.entity.user.product_object_id
Diekstrak dari kolom name menggunakan filter grok, yang mengambil bagian deviceuser_id. Mewakili ID unik pengguna perangkat.
entity.metadata.collected_timestamp.nanos
Disalin dari collection_time.nanos. Menyatakan stempel waktu saat log dikumpulkan.
entity.metadata.collected_timestamp.seconds
Disalin dari collection_time.seconds. Menyatakan stempel waktu saat log dikumpulkan.
entity.metadata.entity_type
Ditetapkan ke nilai konstanta USER dalam parser.
entity.metadata.product_name
Ditetapkan ke nilai konstanta GCP Cloud Identity Device Users dalam parser.
entity.metadata.vendor_name
Ditetapkan ke nilai konstanta Google Cloud Platform dalam parser.
relations.entity.asset.product_object_id
Diekstrak dari kolom name menggunakan filter grok, yang mengambil bagian device_id. Menampilkan ID unik perangkat.
relations.entity_type
Ditetapkan ke nilai konstanta ASSET dalam parser.
relations.relationship
Ditetapkan ke nilai konstanta MEMBER dalam parser.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis document guides you through exporting Cloud Identity Device Users logs into Google Security Operations using Cloud Storage, transforming JSON-formatted logs into a standardized UDM format.\u003c/p\u003e\n"],["\u003cp\u003eYou must first create a Cloud Storage bucket, ensuring you have the necessary access to Google Cloud Identity, Cloud Logging, and a Google SecOps instance.\u003c/p\u003e\n"],["\u003cp\u003eThe configuration process involves setting up a log sink in Cloud Logging to direct logs to your Cloud Storage bucket and then creating a feed in Google SecOps to ingest these logs.\u003c/p\u003e\n"],["\u003cp\u003eThe parser maps raw log fields such as \u003ccode\u003ecollection_time\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emanagementState\u003c/code\u003e, and \u003ccode\u003euserEmail\u003c/code\u003e to corresponding fields in the unified data model (UDM), enriching the data with entity and relationship information.\u003c/p\u003e\n"],["\u003cp\u003eThe parser has been updated since its inception, including bug fixes such as the removal of \u003ccode\u003efirstSyncTime\u003c/code\u003e and \u003ccode\u003elastSyncTime\u003c/code\u003e, as well as enhancements to UDM field mapping for a more comprehensive understanding of device users.\u003c/p\u003e\n"]]],[],null,["# Collect Cloud Identity Device Users logs\n========================================\n\nSupported in: \nGoogle secops [SIEM](/chronicle/docs/secops/google-secops-siem-toc)\n| **Note:** This feature is covered by [Pre-GA Offerings Terms](https://chronicle.security/legal/service-terms/) of the Google Security Operations Service Specific Terms. Pre-GA features might have limited support, and changes to pre-GA features might not be compatible with other pre-GA versions. For more information, see the [Google SecOps Technical Support Service guidelines](https://chronicle.security/legal/technical-support-services-guidelines/) and the [Google SecOps Service Specific Terms](https://chronicle.security/legal/service-terms/).\n\nThis document explains how to export Cloud Identity Device Users logs into Google Security Operations using Cloud Storage. The parser first extracts data from JSON formatted `Cloud Identity Device Users` logs and transforms the timestamp to the standardized format. Then, it maps specific fields from the raw log data to the corresponding fields in the unified data model (UDM) for user entities, their relationships to assets, and additional user attributes like management and password states.\n\nBefore you begin\n----------------\n\nMake sure you have the following prerequisites:\n\n- Google Cloud Identity is enabled in your Google Cloud project.\n- Google SecOps instance.\n- Privileged access to Google Cloud Identity and Cloud Logging.\n\nCreate a Cloud Storage bucket\n-----------------------------\n\n1. Sign in to the [Google Cloud console](https://console.cloud.google.com/).\n2. Go to the **Cloud Storage Buckets** page.\n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n3. Click **Create**.\n\n4. On the **Create a bucket** page, enter your bucket information. After each of the following steps, click **Continue** to proceed to the next step:\n\n 1. In the **Get started** section, do the following:\n\n 1. Enter a unique name that meets the bucket name requirements; for example, **gcp-cloudidentity-users-logs**.\n 2. To enable hierarchical namespace, click the expander arrow to expand the **Optimize for file oriented and data-intensive workloads** section, and then select **Enable Hierarchical namespace on this bucket**.\n\n | **Note:** You cannot enable hierarchical namespace on an existing bucket.\n 3. To add a bucket label, click the expander arrow to expand the **Labels** section.\n\n 4. Click **Add label**, and specify a key and a value for your label.\n\n 2. In the **Choose where to store your data** section, do the following:\n\n 1. Select a **Location type**.\n 2. Use the location type menu to select a **Location** where object data within your bucket will be permanently stored.\n\n | **Note:** If you select the **dual-region** location type, you can also choose to enable **turbo replication** by using the relevant checkbox.\n 3. To set up cross-bucket replication, expand the **Set up cross-bucket replication** section.\n\n 3. In the **Choose a storage class for your data** section, either select a **default storage class** for the bucket, or select **Autoclass** for automatic storage class management of your bucket's data.\n\n 4. In the **Choose how to control access to objects** section, clear **Enforce public access prevention** , and select an **Access control** model for your bucket's objects.\n\n | **Note:** If public access prevention is already enforced by your project's organization policy, the **Enforce public access prevention on this bucket** checkbox is locked.\n 5. In the **Choose how to protect object data** section, do the following:\n\n 1. Select any of the options under **Data protection** that you want to set for your bucket.\n 2. To choose how your object data will be encrypted, click the expander arrow labeled **Data encryption**, and select a data encryption method.\n5. Click **Create**.\n\n| **Note:** Be sure to provide your Google SecOps service account with permissions to Read or Read \\& Write to the newly created bucket.\n\nConfigure Cloud Identity Device Users logs export\n-------------------------------------------------\n\n1. Sign in to the [Google Cloud console](https://console.cloud.google.com/).\n2. Go to **Logging \\\u003e Log Router**.\n3. Click **Create Sink**.\n4. Provide the following configuration parameters:\n\n - **Sink Name** : enter a meaningful name; for example, `Cloudidentity-Users-Sink`.\n - **Sink Destination** : select **Cloud Storage Storage** and enter the URI for your bucket; for example, `gs://gcp-cloudidentity-users-logs`.\n - **Log Filter**:\n\n logName=\"projects/\u003cyour-project-id\u003e/logs/cloudaudit.googleapis.com%2Factivity\"\n resource.type=\"cloud_identity_user\"\n\n - **Set Export Options**: include all log entries.\n\n5. Click **Create**.\n\nConfigure permissions for Cloud Storage\n---------------------------------------\n\n1. Go to **IAM \\& Admin \\\u003e IAM**.\n2. Locate the **Cloud Logging** service account.\n3. Grant the **roles/storage.admin** on the bucket.\n\nSet up feeds\n------------\n\nThere are two different entry points to set up feeds in the\nGoogle SecOps platform:\n\n- **SIEM Settings \\\u003e Feeds \\\u003e Add New**\n- **Content Hub \\\u003e Content Packs \\\u003e Get Started**\n\nHow to set up the Google Cloud Identity Device Users feed\n---------------------------------------------------------\n\n1. Click the **Google Cloud Compute platform** pack.\n2. Locate the **Google Cloud Identity Device Users** log type and click **Add new feed**.\n3. Specify values for the following fields:\n - **Source Type**: Third party API\n - **OAuth JWT endpoint**: endpoint to retrieve the OAuth JSON web token (JWT).\n - **JWT claims issuer**: usually the client ID.\n - **JWT claims subject**: usually an email address.\n - **JWT claims audience**: JWT claims audience.\n - **RSA private key**: enter in PEM format.\n\n**Advanced options**\n\n- **Feed Name**: A prepopulated value that identifies the feed.\n- **Asset Namespace**: Namespace associated with the feed.\n- **Ingestion Labels**: Labels applied to all events from this feed.\n\n1. Click **Create feed**.\n\n| **Note:** The Content Hub is not available on the SIEM standalone platform. To upgrade, contact your Google SecOps representative.\n\nFor more information about configuring multiple feeds for different log types within this product family, see [Configure feeds by product](/chronicle/docs/ingestion/ingestion-entities/configure-multiple-feeds).\n\nUDM Mapping Table\n-----------------\n\n**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/google-security-operations-2)"]]
