Collect Cloud Identity Devices logs

This guide will explain how to export Cloud Identity Devices logs into Google Security Operations using Cloud Storage. 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:

• Google Cloud Identity is enabled in your Google Cloud project.
• Google SecOps instance.
• Privileged access to Google Cloud Identity and Cloud Logging.

Create a Cloud Storage bucket

1. Sign in to the Google Cloud console.

2. Go to the Cloud Storage Buckets page.

   Go to Buckets

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.

      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.

      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.

   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.

ConfigureCloud Identity Devices Logs Export

1. Sign in to the Google Cloud console.
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.

Set up feeds

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

• SIEM Settings > Feeds
• Content Hub > Content Packs

Set up feeds from SIEM Settings > Feeds

To configure a feed, follow these steps:

1. Go to SIEM Settings > Feeds.
2. Click Add New Feed.
3. On the next page, click Configure a single feed.
4. In the Feed name field, enter a name for the feed; for example, GCP Cloud Identity Devices Logs.
5. Select Third party API as the Source type.
6. Select GCP Cloud Identity Devices as the Log type.
7. Click Next.
8. Specify values for the following input parameters:
   • OAuth JWT endpoint: endpoint to retrieve the OAuth JSON web token.
   • JWT claims issuer: usually the client ID.
   • JWT claims subject: usually an email address.
   • JWT claims audience: JWT claims audience.
   • RSA private key: enter in PEM format.
   • API version: API version to be used for fetching device info. Value should be one of v1, v1beta1, or vx. If no version is specified, v1 is used.
9. Click Next.
10. Review your new feed configuration in the Finalize screen, and then click Submit.

Set up feeds from the Content Hub

Specify values for the following fields:

• Storage Bucket URI: Cloud Storage bucket URL; for example, gs://gcp-cloudidentity-devices-logs.
• URI Is A: select Directory which includes subdirectories.

• Source deletion options: select the deletion option according to your preference.

Advanced options

• Feed Name: A prepopulated value that identifies the feed.
• Source Type: Method used to collect logs into Google SecOps.
• Asset Namespace: Namespace associated with the feed.
• Ingestion Labels: Labels applied to all events from this feed.

UDM Mapping Table

Changes

2022-03-27

• Mapped resource.name to the long unique resource name name.

2022-04-13

• Newly created parser.

Need more help? Get answers from Community members and Google SecOps professionals.