# Collect Cloud Identity Devices logs

**Parser Version:** 1.0
Supported in:

This document explains how to collect Cloud Identity Devices logs into
Google SecOps using the **Third Party API** method, which is the
recommended approach. The parser extracts fields from JSON logs, transforms
specific fields like `deviceType` and dates, and maps them to the UDM, creating
an `asset_entity` representing the device and enriching it with hardware and
metadata information.

## Before you begin

Ensure that you have the following prerequisites:

- A Google SecOps instance
- **Domain-Wide Delegation setup** for a Service Account. The Service Account must be authorized for the following scope:
  - **`https://www.googleapis.com/auth/cloud-identity.devices.readonly`**
- The following APIs are enabled in your Google Cloud project:
  - **Cloud Identity API**
  - **Google Workspace Admin SDK**
  - **Alert Center API**

## Recommended: Set up Third Party API Feeds

There are two different entry points to set up feeds in the
Google SecOps platform:

- **Settings \> Data Management \> Feeds \> Add New Feed** (On SIEM-only platform, **Settings \> Feeds \> Add New Feed**)
- **Content Hub \> Content Packs \> Get Started**

### How to set up the Google Cloud Identity Devices feed

1. Click the **Google Cloud Compute platform** pack.
2. Locate the **Google Cloud Identity Devices** log type and click **Add new feed**.
3. Specify values for the following fields:
   - **Source Type** : Select **Third party API**.
   - **OAuth JWT endpoint** : Enter the OAuth token endpoint: `https://oauth2.googleapis.com/token`
   - **JWT claims issuer** : Enter the Enter the **email address** of the Service Account (found in the Service Account's JSON key file).
   - **JWT claims subject** : Enter the email address of the user who is granted the role of **services admin** or **super admin** in the Workspace console (the user being impersonated through Domain-Wide Delegation).
   - **JWT claims audience** : Enter the endpoint again: `https://oauth2.googleapis.com/token`
   - **RSA private key** : Paste the full contents of the **private key** from the Service Account's JSON key file (including the `---BEGIN PRIVATE KEY---` and `---END PRIVATE KEY---` lines).

**Advanced options**

- **Feed Name**: A prepopulated value that identifies the feed.
- **Asset Namespace**: Namespace associated with the feed.
- **Ingestion Labels**: Labels applied to all events from this feed.

1. Click **Create feed**.

> [!NOTE]
> **Note:** The Content Hub is not available on the SIEM standalone platform. To upgrade, contact your Google SecOps representative.

For more information about configuring multiple feeds for different log types within this product family, see [Configure feeds by product](https://docs.cloud.google.com/chronicle/docs/ingestion/ingestion-entities/configure-multiple-feeds).

## Alternate Method: Ingestion via Cloud Storage

1. Sign in to the [Google Cloud console](https://console.cloud.google.com/).
2. Go to the **Cloud Storage Buckets** page.

   [Go to Buckets](https://console.cloud.google.com/storage/browser)
3. Click **Create**.

4. On the **Create a bucket** page, enter your bucket information. After each of the following steps, click **Continue** to proceed to the next step:

   1. In the **Get started** section, do the following:

      1. Enter a unique name that meets the bucket name requirements; for example, **gcp-cloudidentity-devices-logs**.
      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**.

         > [!NOTE]
         > **Note:** You cannot enable hierarchical namespace on an existing bucket.

      3. To add a bucket label, click the expander arrow to expand the **Labels** section.

      4. Click **Add label**, and specify a key and a value for your label.

   2. In the **Choose where to store your data** section, do the following:

      1. Select a **Location type**.
      2. Use the location type menu to select a **Location** where object data within your bucket will be permanently stored.

         > [!NOTE]
         > **Note:** If you select the **dual-region** location type, you can also choose to enable **turbo replication** by using the relevant checkbox.

      3. To set up cross-bucket replication, expand the **Set up cross-bucket replication** section.

   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.

   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.

      > [!NOTE]
      > **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.

   5. In the **Choose how to protect object data** section, do the following:

      1. Select any of the options under **Data protection** that you want to set for your bucket.
      2. To choose how your object data will be encrypted, click the expander arrow labeled **Data encryption**, and select a data encryption method.
5. Click **Create**.

> [!NOTE]
> **Note:** Be sure to provide your Google SecOps service account with permissions to Read or Read \& Write to the newly created bucket.

### Configure Cloud Identity Devices Logs Export

1. Sign in to the [Google Cloud console](https://console.cloud.google.com/).
2. Go to **Logging \> Log Router**.
3. Click **Create Sink**.
4. Provide the following configuration parameters:

   - **Sink Name** : enter a meaningful name; for example, `cloud-identity-devices-logs-sink`.
   - **Sink Destination** : select **Cloud Storage Storage** and enter the URI for your bucket; for example, `gs://gcp-cloudidentity-devices-logs/`.
   - **Log Filter**:

         logName="projects/<your-project-id>/logs/cloudaudit.googleapis.com%2Factivity"
         resource.type="cloud_identity_device"

   - **Set Export Options**: include all log entries.

5. Click **Create**.

### Configure permissions for Cloud Storage

1. Go to **IAM \& Admin \> IAM**.
2. Locate the **Cloud Logging** service account.
3. Grant the **roles/storage.admin** on the bucket.

## UDM Mapping Table

| Log Field | UDM Mapping | Logic |
|---|---|---|
| `createTime` | `entity.metadata.creation_timestamp` | The value of `createTime` is parsed as a timestamp and mapped. |
| `deviceId` | `entity.entity.asset.asset_id` | Directly mapped. |
| `deviceType` | `entity.entity.asset.platform_software.platform` | Mapped to `MAC` if the original value is `MAC_OS` or `IOS`. Mapped to `WINDOWS`, `MAC`, or `LINUX` if the original value matches. Otherwise, set to `UNKNOWN_PLATFORM`. |
| `encryptionState` | `entity.entity.asset.attribute.labels.key` | Value is set to `encryptionState`. Used as part of a label. |
| `encryptionState` | `entity.entity.asset.attribute.labels.value` | Directly mapped. Used as part of a label. |
| `lastSyncTime` | `entity.entity.asset.system_last_update_time` | The value of `lastSyncTime` is parsed as a timestamp and mapped. |
| `managementState` | `entity.entity.asset.attribute.labels.key` | Value is set to `managementState`. Used as part of a label. |
| `managementState` | `entity.entity.asset.attribute.labels.value` | Directly mapped. Used as part of a label. |
| `model` | `entity.entity.asset.hardware.model` | Directly mapped. |
| `name` | `entity.entity.asset.product_object_id` | The portion after `devices/` is extracted and mapped. |
| `name` | `entity.entity.resource.name` | Directly mapped. |
| `osVersion` | `entity.entity.asset.platform_software.platform_version` | Directly mapped. |
| `securityPatchTime` | `entity.entity.asset.attribute.labels.key` | Value is set to `securityPatchTime`. Used as part of a label. |
| `securityPatchTime` | `entity.entity.asset.attribute.labels.value` | Directly mapped. Used as part of a label. |
| `serialNumber` | `entity.entity.asset.hardware.serial_number` | Directly mapped. Copied from the top-level `create_time` field in the raw log. Value is set to `ASSET`. Value is set to `GCP Cloud Identity Devices`. Value is set to `Google Cloud Platform`. Copied from the top-level `create_time` field in the raw log. |

## Change Log

[View the Change Log for this parser](https://docs.cloud.google.com/chronicle/docs/ingestion/parser-list/gcp-cloudidentity-devices-changelog)

**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/)