In diesem Dokument wird beschrieben, wie Sie Cloud Identity Device Users-Logs mithilfe von Cloud Storage in Google Security Operations exportieren. Der Parser extrahiert zuerst Daten aus Cloud Identity Device Users-Protokollen im JSON-Format und wandelt den Zeitstempel in das standardisierte Format um. Anschließend werden bestimmte Felder aus den Rohlogdaten den entsprechenden Feldern im einheitlichen Datenmodell (UDM) für Nutzerentitäten, ihre Beziehungen zu Assets und zusätzliche Nutzerattribute wie Verwaltungs- und Passwortstatus zugeordnet.
Hinweise
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
Google Cloud Identity ist in Ihrem Google Cloud -Projekt aktiviert.
Google SecOps-Instanz.
Privilegierter Zugriff auf Google Cloud Identity und Cloud Logging.
Geben Sie auf der Seite Bucket erstellen die Bucket-Informationen ein. Klicken Sie nach jedem der folgenden Schritte auf Weiter, um mit dem nächsten Schritt fortzufahren:
Führen Sie im Abschnitt Einstieg die folgenden Schritte aus:
Geben Sie einen eindeutigen Namen ein, der den Anforderungen für Bucket-Namen entspricht, z. B. gcp-cloudidentity-users-logs.
Wenn Sie den hierarchischen Namespace aktivieren möchten, klicken Sie auf den Maximierungspfeil, um den Bereich Für dateiorientierte und datenintensive Arbeitslasten optimieren zu maximieren, und wählen Sie dann Hierarchischen Namespace für diesen Bucket aktivieren aus.
Wenn Sie ein Bucket-Label hinzufügen möchten, klicken Sie auf den Erweiterungspfeil, um den Abschnitt Labels zu maximieren.
Klicken Sie auf Label hinzufügen und geben Sie einen Schlüssel und einen Wert für das Label an.
Gehen Sie im Bereich Speicherort für Daten auswählen so vor:
Standorttyp auswählen.
Wählen Sie im Menü für den Standorttyp einen Speicherort aus, an dem die Objektdaten in Ihrem Bucket dauerhaft gespeichert werden sollen.
Wenn Sie die Bucket-übergreifende Replikation einrichten möchten, maximieren Sie den Bereich Bucket-übergreifende Replikation einrichten.
Wählen Sie im Abschnitt Speicherklasse für Ihre Daten auswählen entweder eine Standardspeicherklasse für den Bucket oder Autoclass für die automatische Verwaltung der Speicherklassen Ihrer Bucket-Daten aus.
Entfernen Sie im Abschnitt Zugriff auf Objekte steuern das Häkchen bei Verhinderung des öffentlichen Zugriffs erzwingen und wählen Sie ein Zugriffssteuerungsmodell für die Objekte Ihres Buckets aus.
Gehen Sie im Bereich Auswählen, wie Objektdaten geschützt werden so vor:
Wählen Sie unter Datenschutz die gewünschten Optionen für Ihren Bucket aus.
Um auszuwählen, wie Ihre Objektdaten verschlüsselt werden, klicken Sie auf den Erweiterungspfeil mit dem Label Datenverschlüsselung und wählen Sie eine Methode für die Datenverschlüsselung aus.
Klicken Sie auf Erstellen.
Export von Cloud Identity-Gerätenutzerlogs konfigurieren
Geben Sie die folgenden Konfigurationsparameter an:
Name der Senke: Geben Sie einen aussagekräftigen Namen ein, z. B. Cloudidentity-Users-Sink.
Sink Destination (Ziel für Senke): Wählen Sie Cloud Storage Storage (Cloud Storage) aus und geben Sie den URI für Ihren Bucket ein, z. B. gs://gcp-cloudidentity-users-logs.
Exportoptionen festlegen: Alle Log-Einträge einschließen.
Klicken Sie auf Erstellen.
Berechtigungen für Cloud Storage konfigurieren
Rufen Sie IAM & Verwaltung > IAM auf.
Suchen Sie das Cloud Logging-Dienstkonto.
Weisen Sie dem Bucket die Rolle roles/storage.admin zu.
Feeds einrichten
Es gibt zwei verschiedene Einstiegspunkte zum Einrichten von Feeds in der Google SecOps-Plattform:
SIEM-Einstellungen > Feeds > Neu hinzufügen
Content Hub > Content-Packs > Erste Schritte
Google Cloud Identity Device Users-Feed einrichten
Klicken Sie auf das Paket Google Cloud Compute Platform.
Suchen Sie nach dem Logtyp Google Cloud Identity Device Users und klicken Sie auf Neuen Feed hinzufügen.
Geben Sie Werte für die folgenden Felder an:
Quelltyp: Drittanbieter-API
OAuth-JWT-Endpunkt: Endpunkt zum Abrufen des OAuth-JSON-Webtokens (JWT).
JWT claims issuer (Aussteller von JWT-Ansprüchen): in der Regel die Client-ID.
JWT-Anspruch „subject“: normalerweise eine E-Mail-Adresse.
JWT-Anforderungen – Zielgruppe: Zielgruppe für JWT-Anforderungen.
Privater RSA-Schlüssel: im PEM-Format eingeben.
Erweiterte Optionen
Feedname: Ein vorausgefüllter Wert, der den Feed identifiziert.
Asset-Namespace: Der Namespace, der dem Feed zugeordnet ist.
Aufnahmelabels: Labels, die auf alle Ereignisse aus diesem Feed angewendet werden.
Klicken Sie auf Feed erstellen.
Weitere Informationen zum Konfigurieren mehrerer Feeds für verschiedene Logtypen in dieser Produktfamilie finden Sie unter Feeds nach Produkt konfigurieren.
UDM-Zuordnungstabelle
Logfeld
UDM-Zuordnung
Logik
collection_time.nanos
timestamp.nanos
Direkt aus dem Logfeld zugeordnet. Stellt den Zeitstempel des Ereignisses in Nanosekunden dar.
collection_time.seconds
timestamp.seconds
Direkt aus dem Logfeld zugeordnet. Stellt den Ereigniszeitstempel in Sekunden dar.
createTime
entity.metadata.creation_timestamp
Direkt aus dem Logfeld zugeordnet, nachdem es vom Filter date geparst wurde. Stellt den Erstellungszeitstempel des Nutzers dar.
managementState
entity.additional.fields.value.string_value
Direkt aus dem Logfeld zugeordnet. Stellt den Verwaltungsstatus des Nutzers dar.
Name
entity.entity.resource.name
Direkt aus dem Logfeld zugeordnet. Stellt den vollständigen Ressourcennamen des Gerätenutzers dar.
passwordState
entity.additional.fields.value.string_value
Direkt aus dem Logfeld zugeordnet. Gibt den Passwortstatus des Nutzers an. Dieses Feld wird nur zugeordnet, wenn das Feld passwordState im Rohlog vorhanden ist.
userEmail
entity.entity.user.email_addresses
Direkt aus dem Logfeld zugeordnet. Stellt die E-Mail-Adresse des Nutzers dar.
entity.additional.fields.key
Auf einen konstanten Wert Management State im Parser festgelegt. Dieses Feld wird verwendet, um Kontext für den managementState-Wert bereitzustellen.
entity.additional.fields.key
Auf einen konstanten Wert Password State im Parser festgelegt. Dieses Feld wird verwendet, um Kontext für den passwordState-Wert bereitzustellen, und ist nur vorhanden, wenn passwordState im Rohlog enthalten ist.
entity.entity.user.product_object_id
Aus dem Feld name extrahiert, indem der Filter grok verwendet wurde, um den Teil deviceuser_id zu erfassen. Stellt die eindeutige Kennung des Gerätenutzers dar.
entity.metadata.collected_timestamp.nanos
Kopiert von collection_time.nanos. Der Zeitstempel, der angibt, wann das Log erfasst wurde.
entity.metadata.collected_timestamp.seconds
Kopiert von collection_time.seconds. Der Zeitstempel, der angibt, wann das Log erfasst wurde.
entity.metadata.entity_type
Auf einen konstanten Wert USER im Parser festgelegt.
entity.metadata.product_name
Auf einen konstanten Wert GCP Cloud Identity Device Users im Parser festgelegt.
entity.metadata.vendor_name
Auf einen konstanten Wert Google Cloud Platform im Parser festgelegt.
relations.entity.asset.product_object_id
Aus dem Feld name extrahiert, indem der Filter grok verwendet wurde, um den Teil device_id zu erfassen. Stellt die eindeutige Kennung des Geräts dar.
relations.entity_type
Auf einen konstanten Wert ASSET im Parser festgelegt.
relations.relationship
Auf einen konstanten Wert MEMBER im Parser festgelegt.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-02 (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)"]]
