Collect Cloud Security Command Center Posture Violation logs

Supported in:

Google SecOps SIEM

Note: This feature is covered by Pre-GA Offerings 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 Security Operations Technical Support Service guidelines and the Google Security Operations Service Specific Terms.

This document explains how to export and ingest Security Command Center Posture Violation logs into Google Security Operations using Cloud Storage. The parser transforms raw JSON data from findings into a unified data model (UDM). It extracts relevant fields, restructures the data, maps it to UDM fields, and performs various validations and enrichments to ensure data quality and consistency.

Before you begin

• Ensure that Google Cloud Security Command Center is enabled in your Google Cloud environment.
• Ensure that you have a Google SecOps instance.
• Ensure that you have privileged access to Security Command Center 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-scc-posture-violation-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: 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: 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, select not to enforce public access prevention, and select an access control model for your bucket's objects.

      Note: If public access prevention is already enforced by your project's organization policy, the Prevent public access 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: Be sure to provide your Google SecOps service account with permissions to Read or Read & Write to the newly created bucket.

Configure Security Command Center logging

1. Sign in to the Google Cloud console.

2. Go to the Security Command Center page.

   Go to Security Command Center

3. Select your organization.

4. Click Settings.

5. Click the Continuous Exports tab.

6. Under Export name, click Logging Export.

7. Under Sinks, turn on Log Findings to Logging.

8. Under Logging project, enter or search for the project where you want to log findings.

9. Click Save.

Configure Google Cloud Security Command Center Posture Violation 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, scc-posture-violation-logs-sink.
   • Sink Destination: select Cloud Storage Storage and enter the URI for your bucket; for example, gs://gcp-scc-posture-violation-logs.

   • Log Filter:

     logName="projects/<your-project-id>/logs/cloudsecurityscanner.googleapis.com%2Fposture_violations"
     resource.type="cloud_security_center_posture_violation"
     

   • 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.

Configure a feed in Google SecOps to ingest Google Cloud Security Command Center Posture Violation logs

1. Go to SIEM Settings > Feeds.
2. Click Add new.
3. In the Feed name field, enter a name for the feed; for example, Google Cloud Security Command Center Posture Violation Logs.
4. Select Google Cloud Storage as the Source type.
5. Select Security Command Center Posture Violation as the Log type.
6. Click Get Service Account next to the Chronicle Service Account field.
7. Click Next.

8. Specify values for the following input parameters:

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

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

     Note: If you select the Delete transferred files or Delete transferred files and empty directories option, make sure that you granted appropriate permissions to the service account.

   • Asset namespace: the asset namespace.

   • Ingestion labels: the label applied to the events from this feed.

9. Click Next.

10. Review your new feed configuration in the Finalize screen, and then click Submit.

UDM Mapping Table

Log Field	UDM Mapping	Logic
category	read_only_udm.metadata.product_event_type	Direct mapping.
changed_policy	read_only_udm.security_result.rule_name	Direct mapping.
cloudProvider	read_only_udm.target.resource.attribute.cloud.environment	Direct mapping.
createTime	read_only_udm.security_result.detection_fields[createTime]	Direct mapping.
finding.risks.riskCategory	read_only_udm.security_result.detection_fields[risk_category]	Direct mapping.
mute	read_only_udm.security_result.detection_fields[mute]	Direct mapping.
name	read_only_udm.metadata.product_log_id	Direct mapping.
originalProviderId	read_only_udm.target.resource.attribute.labels[original_provider_id]	Direct mapping.
parent	read_only_udm.target.resource_ancestors[0].name	Direct mapping.
parentDisplayName	read_only_udm.metadata.description	Direct mapping.
propertyDataTypes.changed_policy.primitiveDataType	read_only_udm.security_result.rule_labels[changed_policy_primitive_data_type]	Direct mapping.
propertyDataTypes.policy_drift_details.listValues.propertyDataTypes[0].structValue.fields.drift_details.structValue.fields.detected_configuration.primitiveDataType	read_only_udm.security_result.rule_labels[detected_configuration_primitive_data_type]	Direct mapping.
propertyDataTypes.policy_drift_details.listValues.propertyDataTypes[0].structValue.fields.drift_details.structValue.fields.expected_configuration.primitiveDataType	read_only_udm.security_result.rule_labels[expected_configuration_primitive_data_type]	Direct mapping.
propertyDataTypes.policy_drift_details.listValues.propertyDataTypes[0].structValue.fields.field_name.primitiveDataType	read_only_udm.security_result.rule_labels[field_name_primitive_data_type]	Direct mapping.
propertyDataTypes.posture_deployment_name.primitiveDataType	read_only_udm.security_result.detection_fields[posture_deployment_name_primitiveDataType]	Direct mapping.
propertyDataTypes.posture_deployment_resource.primitiveDataType	read_only_udm.security_result.detection_fields[posture_deployment_resource_primitiveDataType]	Direct mapping.
propertyDataTypes.posture_name.primitiveDataType	read_only_udm.security_result.detection_fields[posture_name_primitiveDataType]	Direct mapping.
propertyDataTypes.posture_revision_id.primitiveDataType	read_only_udm.security_result.detection_fields[posture_revision_id_primitiveDataType]	Direct mapping.
resource.cloudProvider	read_only_udm.target.resource.attribute.cloud.environment	Direct mapping.
resource.displayName	read_only_udm.target.resource.attribute.labels[resource_displayName]	Direct mapping.
resource.gcpMetadata.organization	read_only_udm.target.resource.attribute.labels[resource_organization]	Direct mapping.
resource.gcpMetadata.parent	read_only_udm.target.resource.attribute.labels[resource_parent]	Direct mapping.
resource.gcpMetadata.parentDisplayName	read_only_udm.target.resource.attribute.labels[resource_parentDisplayName]	Direct mapping.
resource.gcpMetadata.project	read_only_udm.target.resource.attribute.labels[resource_project]	Direct mapping.
resource.gcpMetadata.projectDisplayName	read_only_udm.target.resource.attribute.labels[resource_projectDisplayName]	Direct mapping.
resource.organization	read_only_udm.target.resource.attribute.labels[resource_organization]	Direct mapping.
resource.resourcePath.nodes.displayName	read_only_udm.target.resource_ancestors.name	Direct mapping.
resource.resourcePath.nodes.id	read_only_udm.target.resource_ancestors.product_object_id	Direct mapping.
resource.resourcePath.nodes.nodeType	read_only_udm.target.resource_ancestors.resource_subtype	Direct mapping.
resource.resourcePathString	read_only_udm.target.resource.attribute.labels[resource_path_string]	Direct mapping.
resource.service	read_only_udm.target.resource_ancestors[10].name	Direct mapping.
resource.type	read_only_udm.target.resource.attribute.labels[resource_type]	Direct mapping.
resourceName	read_only_udm.target.resource.name	Direct mapping.
securityPosture.changedPolicy	read_only_udm.security_result.rule_labels[changed_policy]	Direct mapping.
securityPosture.name	read_only_udm.security_result.detection_fields[security_posture_name]	Direct mapping.
securityPosture.policyDriftDetails[0].detectedValue	read_only_udm.security_result.rule_labels[policy_drift_details_detected_value]	Direct mapping.
securityPosture.policyDriftDetails[0].expectedValue	read_only_udm.security_result.rule_labels[policy_drift_details_expected_value]	Direct mapping.
securityPosture.policyDriftDetails[0].field	read_only_udm.security_result.rule_labels[policy_drift_details_field]	Direct mapping.
securityPosture.policySet	read_only_udm.security_result.rule_set	Direct mapping.
securityPosture.postureDeployment	read_only_udm.security_result.detection_fields[posture_deployment]	Direct mapping.
securityPosture.postureDeploymentResource	read_only_udm.security_result.detection_fields[posture_deployment_resource]	Direct mapping.
securityPosture.revisionId	read_only_udm.security_result.detection_fields[security_posture_revision_id]	Direct mapping.
severity	read_only_udm.security_result.severity	Direct mapping.
sourceProperties.categories[0]	read_only_udm.security_result.detection_fields[source_properties_categories]	Direct mapping.
sourceProperties.changed_policy	read_only_udm.security_result.rule_name	Direct mapping.
sourceProperties.name	read_only_udm.target.application	Direct mapping.
sourceProperties.policy_drift_details[0].drift_details.detected_configuration	read_only_udm.security_result.rule_labels[policy_drift_details_detected_configuration]	Direct mapping.
sourceProperties.policy_drift_details[0].drift_details.expected_configuration	read_only_udm.security_result.rule_labels[policy_drift_details_expected_configuration]	Direct mapping.
sourceProperties.policy_drift_details[0].field_name	read_only_udm.security_result.rule_labels[policy_drift_details_field_name]	Direct mapping.
sourceProperties.posture_deployment	read_only_udm.security_result.detection_fields[source_properties_posture_deployment_name]	Direct mapping.
sourceProperties.posture_deployment_name	read_only_udm.security_result.detection_fields[source_properties_posture_deployment_name]	Direct mapping.
sourceProperties.posture_deployment_resource	read_only_udm.security_result.detection_fields[source_properties_posture_deployment_resource]	Direct mapping.
sourceProperties.posture_name	read_only_udm.target.application	Direct mapping.
sourceProperties.posture_revision_id	read_only_udm.security_result.detection_fields[source_properties_posture_revision_id]	Direct mapping.
sourceProperties.revision_id	read_only_udm.security_result.detection_fields[source_properties_posture_revision_id]	Direct mapping.
state	read_only_udm.security_result.detection_fields[state]	Direct mapping.
	read_only_udm.metadata.vendor_name	The parser maps the static value Google.
	read_only_udm.metadata.product_name	The parser maps the static value Security Command Center.
	read_only_udm.target.resource.resource_type	The parser maps the static value CLUSTER.
	read_only_udm.security_result.about.investigation.status	The parser maps the static value NEW.
	read_only_udm.security_result.alert_state	The parser maps the static value ALERTING.
	read_only_udm.is_alert	The parser maps the static value true.
	read_only_udm.is_significant	The parser maps the static value true.
	read_only_udm.metadata.event_type	The parser maps to GENERIC_EVENT as default value. If the field 'category' equals to 'SECURITY_POSTURE_DRIFT' and 'client_device_present' and 'token_target.application' are not empty, it maps to 'SERVICE_MODIFICATION'. If the field 'category' equals to 'SECURITY_POSTURE_POLICY_DRIFT', 'SECURITY_POSTURE_POLICY_DELETE', 'SECURITY_POSTURE_DETECTOR_DRIFT' or 'SECURITY_POSTURE_DETECTOR_DELETE' and 'network_edr_not_present' is false and 'client_device_present' is true, it maps to 'SCAN_UNCATEGORIZED'. If the field 'token_metadata.event_type' equals to 'GENERIC_EVENT' and 'network_edr_not_present' is false and 'client_device_present' is true, it maps to 'STATUS_UPDATE'.
	read_only_udm.target.resource_ancestors[1].resource_type	The parser maps the static value CLOUD_PROJECT.
	read_only_udm.target.resource.product_object_id	The parser extracts the value from the 'parent' field, between the second and third '/' characters.
	read_only_udm.target.resource_ancestors[1].name	The parser extracts the value from the 'resourceName' field, between the fourth and fifth '/' characters.
	read_only_udm.security_result.url_back_to_product	The parser dynamically builds the URL using the organization, source, and finding IDs extracted from the log.
securityMarks.name	read_only_udm.security_result.detection_fields[securityMarks_name]	Direct mapping.

Changes

2025-02-07

• Updated the mapping for security_result.url_back_to_product UDM field. Added the project ID value from the raw log field value resource.projectDisplayName to end of the URL mapped to security_result.url_back_to_product UDM field with the prefix ;?project=.

2024-11-21

• Added support for the v2 version of the SCC API, and the following fields are included as part of the update
• resource.gcpMetadata.project
• resource.gcpMetadata.projectDisplayName
• resource.gcpMetadata.parent
• resource.gcpMetadata.parentDisplayName
• resource.gcpMetadata.folders.resourceFolder
• resource.gcpMetadata.folders.resourceFolderDisplayName
• resource.gcpMetadata.organization

2024-03-20

• Newly created parser.

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