Retrieves the next page of results.
patch(name, body=None, updateMask=None, x__xgafv=None)
Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
close()
@@ -288,7 +288,7 @@ patch(name, body=None, updateMask=None, x__xgafv=None)
- Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+ Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
Args:
name: string, Immutable. The resource name of the custom module. Its format is "organizations/{organization}/securityHealthAnalyticsSettings/customModules/{customModule}", or "folders/{folder}/securityHealthAnalyticsSettings/customModules/{customModule}", or "projects/{project}/securityHealthAnalyticsSettings/customModules/{customModule}" The id {customModule} is server-generated and is not user settable. It will be a numeric id containing 1-20 digits. (required)
diff --git a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html
index 096699d1b30..f348be232dc 100644
--- a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html
+++ b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.effectiveCustomModules.html
@@ -158,7 +158,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing effective security health analytics custom modules.
+ { # Response message for listing effective Security Health Analytics custom modules.
"effectiveSecurityHealthAnalyticsCustomModules": [ # Effective custom modules belonging to the requested parent.
{ # An EffectiveSecurityHealthAnalyticsCustomModule is the representation of a Security Health Analytics custom module at a specified level of the resource hierarchy: organization, folder, or project. If a custom module is inherited from a parent organization or folder, the value of the `enablementState` property in EffectiveSecurityHealthAnalyticsCustomModule is set to the value that is effective in the parent, instead of `INHERITED`. For example, if the module is enabled in a parent organization or folder, the effective enablement_state for the module in all child folders or projects is also `enabled`. EffectiveSecurityHealthAnalyticsCustomModule is read-only.
"customConfig": { # Defines the properties in a custom module configuration for Security Health Analytics. Use the custom module configuration to create custom detectors that generate custom findings for resources that you specify. # Output only. The user-specified configuration for the module.
diff --git a/docs/dyn/securitycenter_v1.folders.sources.findings.html b/docs/dyn/securitycenter_v1.folders.sources.findings.html
index 818fbda4ef5..2cc15f0c955 100644
--- a/docs/dyn/securitycenter_v1.folders.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.folders.sources.findings.html
@@ -192,43 +192,44 @@ Method Details
"listFindingsResults": [ # Findings matching the list request.
{ # Result containing the Finding and its StateChange.
"finding": { # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding. # Finding matching the search request.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -241,7 +242,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -249,46 +250,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -306,7 +307,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -315,14 +316,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -349,88 +350,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -453,10 +454,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -466,7 +467,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -474,7 +475,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -482,7 +483,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -490,11 +491,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -583,48 +584,49 @@ Method Details
Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.
Args:
- name: string, The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}" (required)
+ name: string, The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}". (required)
body: object, The request body.
The object takes the form of:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -637,7 +639,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -645,46 +647,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -702,7 +704,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -711,14 +713,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -745,88 +747,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -849,10 +851,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -862,7 +864,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -870,7 +872,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -878,7 +880,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -886,11 +888,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -947,43 +949,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -996,7 +999,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1004,46 +1007,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1061,7 +1064,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1070,14 +1073,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1104,88 +1107,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1208,10 +1211,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1221,7 +1224,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1229,7 +1232,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1237,7 +1240,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1245,11 +1248,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1319,43 +1322,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1368,7 +1372,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1376,46 +1380,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1433,7 +1437,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1442,14 +1446,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1476,88 +1480,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1580,10 +1584,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1593,7 +1597,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1601,7 +1605,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1609,7 +1613,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1617,11 +1621,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1692,43 +1696,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1741,7 +1746,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1749,46 +1754,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1806,7 +1811,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1815,14 +1820,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1849,88 +1854,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1953,10 +1958,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1966,7 +1971,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1974,7 +1979,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1982,7 +1987,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1990,11 +1995,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
diff --git a/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html b/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html
index 94478c080aa..34fa793a8ee 100644
--- a/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html
+++ b/docs/dyn/securitycenter_v1.organizations.bigQueryExports.html
@@ -121,7 +121,7 @@ Method Details
"updateTime": "A String", # Output only. The most recent time at which the BigQuery export was updated. This field is set by the server and will be ignored if provided on export creation or update.
}
- bigQueryExportId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.
+ bigQueryExportId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
diff --git a/docs/dyn/securitycenter_v1.organizations.muteConfigs.html b/docs/dyn/securitycenter_v1.organizations.muteConfigs.html
index a1a26fa9234..a3fa3b8bda6 100644
--- a/docs/dyn/securitycenter_v1.organizations.muteConfigs.html
+++ b/docs/dyn/securitycenter_v1.organizations.muteConfigs.html
@@ -120,7 +120,7 @@ Method Details
"updateTime": "A String", # Output only. The most recent time at which the mute config was updated. This field is set by the server and will be ignored if provided on config creation or update.
}
- muteConfigId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.
+ muteConfigId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
index d99782b9148..5f463fc7247 100644
--- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
+++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
@@ -100,7 +100,7 @@ Instance Methods
Retrieves the next page of results.
patch(name, body=None, updateMask=None, x__xgafv=None)
-Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
Method Details
close()
@@ -288,7 +288,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing security health analytics custom modules.
+ { # Response message for listing Security Health Analytics custom modules.
"nextPageToken": "A String", # If not empty, indicates that there may be more custom modules to be returned.
"securityHealthAnalyticsCustomModules": [ # Custom modules belonging to the requested parent.
{ # Represents an instance of a Security Health Analytics custom module, including its full module name, display name, enablement state, and last updated time. You can create a custom module at the organization, folder, or project level. Custom modules that you create at the organization or folder level are inherited by the child folders and projects.
@@ -348,7 +348,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing descendant security health analytics custom modules.
+ { # Response message for listing descendant Security Health Analytics custom modules.
"nextPageToken": "A String", # If not empty, indicates that there may be more custom modules to be returned.
"securityHealthAnalyticsCustomModules": [ # Custom modules belonging to the requested parent and its descendants.
{ # Represents an instance of a Security Health Analytics custom module, including its full module name, display name, enablement state, and last updated time. You can create a custom module at the organization, folder, or project level. Custom modules that you create at the organization or folder level are inherited by the child folders and projects.
@@ -422,7 +422,7 @@ Method Details
patch(name, body=None, updateMask=None, x__xgafv=None)
- Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+ Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
Args:
name: string, Immutable. The resource name of the custom module. Its format is "organizations/{organization}/securityHealthAnalyticsSettings/customModules/{customModule}", or "folders/{folder}/securityHealthAnalyticsSettings/customModules/{customModule}", or "projects/{project}/securityHealthAnalyticsSettings/customModules/{customModule}" The id {customModule} is server-generated and is not user settable. It will be a numeric id containing 1-20 digits. (required)
diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html
index b1d5dbeb676..cd7ebc68d6d 100644
--- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html
+++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.effectiveCustomModules.html
@@ -158,7 +158,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing effective security health analytics custom modules.
+ { # Response message for listing effective Security Health Analytics custom modules.
"effectiveSecurityHealthAnalyticsCustomModules": [ # Effective custom modules belonging to the requested parent.
{ # An EffectiveSecurityHealthAnalyticsCustomModule is the representation of a Security Health Analytics custom module at a specified level of the resource hierarchy: organization, folder, or project. If a custom module is inherited from a parent organization or folder, the value of the `enablementState` property in EffectiveSecurityHealthAnalyticsCustomModule is set to the value that is effective in the parent, instead of `INHERITED`. For example, if the module is enabled in a parent organization or folder, the effective enablement_state for the module in all child folders or projects is also `enabled`. EffectiveSecurityHealthAnalyticsCustomModule is read-only.
"customConfig": { # Defines the properties in a custom module configuration for Security Health Analytics. Use the custom module configuration to create custom detectors that generate custom findings for resources that you specify. # Output only. The user-specified configuration for the module.
diff --git a/docs/dyn/securitycenter_v1.organizations.sources.findings.html b/docs/dyn/securitycenter_v1.organizations.sources.findings.html
index 7903c5129eb..4dce5d5d24e 100644
--- a/docs/dyn/securitycenter_v1.organizations.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.organizations.sources.findings.html
@@ -125,43 +125,44 @@ Method Details
The object takes the form of:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -174,7 +175,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -182,46 +183,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -239,7 +240,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -248,14 +249,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -282,88 +283,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -386,10 +387,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -399,7 +400,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -407,7 +408,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -415,7 +416,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -423,11 +424,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -484,43 +485,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -533,7 +535,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -541,46 +543,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -598,7 +600,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -607,14 +609,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -641,88 +643,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -745,10 +747,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -758,7 +760,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -766,7 +768,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -774,7 +776,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -782,11 +784,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -914,43 +916,44 @@ Method Details
"listFindingsResults": [ # Findings matching the list request.
{ # Result containing the Finding and its StateChange.
"finding": { # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding. # Finding matching the search request.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -963,7 +966,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -971,46 +974,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1028,7 +1031,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1037,14 +1040,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1071,88 +1074,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1175,10 +1178,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1188,7 +1191,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1196,7 +1199,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1204,7 +1207,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1212,11 +1215,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1305,48 +1308,49 @@ Method Details
Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.
Args:
- name: string, The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}" (required)
+ name: string, The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}". (required)
body: object, The request body.
The object takes the form of:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1359,7 +1363,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1367,46 +1371,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1424,7 +1428,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1433,14 +1437,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1467,88 +1471,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1571,10 +1575,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1584,7 +1588,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1592,7 +1596,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1600,7 +1604,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1608,11 +1612,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1669,43 +1673,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1718,7 +1723,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1726,46 +1731,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1783,7 +1788,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1792,14 +1797,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1826,88 +1831,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1930,10 +1935,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1943,7 +1948,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1951,7 +1956,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1959,7 +1964,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1967,11 +1972,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2041,43 +2046,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -2090,7 +2096,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -2098,46 +2104,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -2155,7 +2161,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2164,14 +2170,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -2198,88 +2204,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -2302,10 +2308,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -2315,7 +2321,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2323,7 +2329,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -2331,7 +2337,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2339,11 +2345,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2414,43 +2420,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -2463,7 +2470,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -2471,46 +2478,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -2528,7 +2535,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2537,14 +2544,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -2571,88 +2578,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -2675,10 +2682,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -2688,7 +2695,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2696,7 +2703,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -2704,7 +2711,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -2712,11 +2719,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
diff --git a/docs/dyn/securitycenter_v1.projects.bigQueryExports.html b/docs/dyn/securitycenter_v1.projects.bigQueryExports.html
index bcecafcbb62..86bf311ad41 100644
--- a/docs/dyn/securitycenter_v1.projects.bigQueryExports.html
+++ b/docs/dyn/securitycenter_v1.projects.bigQueryExports.html
@@ -121,7 +121,7 @@ Method Details
"updateTime": "A String", # Output only. The most recent time at which the BigQuery export was updated. This field is set by the server and will be ignored if provided on export creation or update.
}
- bigQueryExportId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.
+ bigQueryExportId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
diff --git a/docs/dyn/securitycenter_v1.projects.muteConfigs.html b/docs/dyn/securitycenter_v1.projects.muteConfigs.html
index 91d7411e601..a95dc126e72 100644
--- a/docs/dyn/securitycenter_v1.projects.muteConfigs.html
+++ b/docs/dyn/securitycenter_v1.projects.muteConfigs.html
@@ -120,7 +120,7 @@ Method Details
"updateTime": "A String", # Output only. The most recent time at which the mute config was updated. This field is set by the server and will be ignored if provided on config creation or update.
}
- muteConfigId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.
+ muteConfigId: string, Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
index cc7d853fa81..3ec18c9279c 100644
--- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
+++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
@@ -100,7 +100,7 @@ Instance Methods
Retrieves the next page of results.
patch(name, body=None, updateMask=None, x__xgafv=None)
-Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
Method Details
close()
@@ -288,7 +288,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing security health analytics custom modules.
+ { # Response message for listing Security Health Analytics custom modules.
"nextPageToken": "A String", # If not empty, indicates that there may be more custom modules to be returned.
"securityHealthAnalyticsCustomModules": [ # Custom modules belonging to the requested parent.
{ # Represents an instance of a Security Health Analytics custom module, including its full module name, display name, enablement state, and last updated time. You can create a custom module at the organization, folder, or project level. Custom modules that you create at the organization or folder level are inherited by the child folders and projects.
@@ -348,7 +348,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing descendant security health analytics custom modules.
+ { # Response message for listing descendant Security Health Analytics custom modules.
"nextPageToken": "A String", # If not empty, indicates that there may be more custom modules to be returned.
"securityHealthAnalyticsCustomModules": [ # Custom modules belonging to the requested parent and its descendants.
{ # Represents an instance of a Security Health Analytics custom module, including its full module name, display name, enablement state, and last updated time. You can create a custom module at the organization, folder, or project level. Custom modules that you create at the organization or folder level are inherited by the child folders and projects.
@@ -422,7 +422,7 @@ Method Details
patch(name, body=None, updateMask=None, x__xgafv=None)
- Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of “inherited”). Updating the display name and custom config of a module is supported on resident modules only.
+ Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.
Args:
name: string, Immutable. The resource name of the custom module. Its format is "organizations/{organization}/securityHealthAnalyticsSettings/customModules/{customModule}", or "folders/{folder}/securityHealthAnalyticsSettings/customModules/{customModule}", or "projects/{project}/securityHealthAnalyticsSettings/customModules/{customModule}" The id {customModule} is server-generated and is not user settable. It will be a numeric id containing 1-20 digits. (required)
diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html
index 1ba6353f37f..af9d6ad90c3 100644
--- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html
+++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.effectiveCustomModules.html
@@ -158,7 +158,7 @@ Method Details
Returns:
An object of the form:
- { # Response message for listing effective security health analytics custom modules.
+ { # Response message for listing effective Security Health Analytics custom modules.
"effectiveSecurityHealthAnalyticsCustomModules": [ # Effective custom modules belonging to the requested parent.
{ # An EffectiveSecurityHealthAnalyticsCustomModule is the representation of a Security Health Analytics custom module at a specified level of the resource hierarchy: organization, folder, or project. If a custom module is inherited from a parent organization or folder, the value of the `enablementState` property in EffectiveSecurityHealthAnalyticsCustomModule is set to the value that is effective in the parent, instead of `INHERITED`. For example, if the module is enabled in a parent organization or folder, the effective enablement_state for the module in all child folders or projects is also `enabled`. EffectiveSecurityHealthAnalyticsCustomModule is read-only.
"customConfig": { # Defines the properties in a custom module configuration for Security Health Analytics. Use the custom module configuration to create custom detectors that generate custom findings for resources that you specify. # Output only. The user-specified configuration for the module.
diff --git a/docs/dyn/securitycenter_v1.projects.sources.findings.html b/docs/dyn/securitycenter_v1.projects.sources.findings.html
index 99eb973da8c..6dedbf379ac 100644
--- a/docs/dyn/securitycenter_v1.projects.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.projects.sources.findings.html
@@ -192,43 +192,44 @@ Method Details
"listFindingsResults": [ # Findings matching the list request.
{ # Result containing the Finding and its StateChange.
"finding": { # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding. # Finding matching the search request.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -241,7 +242,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -249,46 +250,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -306,7 +307,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -315,14 +316,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -349,88 +350,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -453,10 +454,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -466,7 +467,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -474,7 +475,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -482,7 +483,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -490,11 +491,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -583,48 +584,49 @@ Method Details
Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.
Args:
- name: string, The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}" (required)
+ name: string, The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}". (required)
body: object, The request body.
The object takes the form of:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -637,7 +639,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -645,46 +647,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -702,7 +704,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -711,14 +713,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -745,88 +747,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -849,10 +851,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -862,7 +864,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -870,7 +872,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -878,7 +880,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -886,11 +888,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -947,43 +949,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -996,7 +999,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1004,46 +1007,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1061,7 +1064,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1070,14 +1073,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1104,88 +1107,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1208,10 +1211,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1221,7 +1224,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1229,7 +1232,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1237,7 +1240,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1245,11 +1248,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1319,43 +1322,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1368,7 +1372,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1376,46 +1380,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1433,7 +1437,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1442,14 +1446,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1476,88 +1480,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1580,10 +1584,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1593,7 +1597,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1601,7 +1605,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1609,7 +1613,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1617,11 +1621,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1692,43 +1696,44 @@ Method Details
An object of the form:
{ # Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
- "access": { # Represents an access event. # Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc.
+ "access": { # Represents an access event. # Access details associated with the finding, such as more information on the caller, which method was accessed, and from where.
"callerIp": "A String", # Caller's IP address, such as "1.1.1.1".
"callerIpGeo": { # Represents a geographical location for a given access. # The caller IP's geolocation, which identifies where the call came from.
"regionCode": "A String", # A CLDR.
},
"methodName": "A String", # The method that the service account called, e.g. "SetIamPolicy".
- "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
- "principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
- "serviceAccountDelegationInfo": [ # Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
+ "principalEmail": "A String", # Associated email, such as "foo@google.com". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+ "principalSubject": "A String", # A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.
+ "serviceAccountDelegationInfo": [ # The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.
{ # Identity delegation history of an authenticated service account.
"principalEmail": "A String", # The email address of a Google account.
"principalSubject": "A String", # A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`
},
],
- "serviceAccountKeyName": "A String", # The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}"
+ "serviceAccountKeyName": "A String", # The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}".
"serviceName": "A String", # This is the API service that the service account made a call to, e.g. "iam.googleapis.com"
- "userAgentFamily": "A String", # What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.
- "userName": "A String", # A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.
+ "userAgentFamily": "A String", # Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.
+ "userName": "A String", # A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.
},
"canonicalName": "A String", # The canonical name of the finding. It's either "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}" or "projects/{project_number}/sources/{source_id}/findings/{finding_id}", depending on the closest CRM ancestor of the resource associated with the finding.
"category": "A String", # The additional taxonomy group within findings from a given source. This field is immutable after creation time. Example: "XSS_FLASH_INJECTION"
- "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile associated with the finding.
+ "cloudDlpDataProfile": { # The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding. # Cloud DLP data profile that is associated with the finding.
"dataProfile": "A String", # Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.
+ "parentType": "A String", # The resource hierarchy level at which the data profile was generated.
},
- "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud DLP inspection associated with the finding.
+ "cloudDlpInspection": { # Details about the Cloud Data Loss Prevention (Cloud DLP) [inspection job](https://cloud.google.com/dlp/docs/concepts-job-triggers) that produced the finding. # Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding.
"fullScan": True or False, # Whether Cloud DLP scanned the complete resource or a sampled subset.
- "infoType": "A String", # The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+ "infoType": "A String", # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
"infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
"inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
},
"compliances": [ # Contains compliance information for security standards associated to the finding.
{ # Contains compliance information about a security standard indicating unmet recommendations.
- "ids": [ # Policies within the standard/benchmark e.g. A.12.4.1
+ "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
"A String",
],
- "standard": "A String", # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp", etc.
- "version": "A String", # Version of the standard/benchmark e.g. 1.1
+ "standard": "A String", # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
+ "version": "A String", # Version of the standard or benchmark, for example, 1.1
},
],
"connections": [ # Contains information about the IP connection associated with the finding.
@@ -1741,7 +1746,7 @@ Method Details
},
],
"contacts": { # Output only. Map containing the points of contact for the given finding. The key represents the type of contact, while the value contains a list of all the contacts that pertain. Please refer to: https://cloud.google.com/resource-manager/docs/managing-notification-contacts#notification-categories { "security": { "contacts": [ { "email": "person1@company.com" }, { "email": "person2@company.com" } ] } }
- "a_key": { # The details pertaining to specific contacts
+ "a_key": { # Details about specific contacts
"contacts": [ # A list of contacts
{ # The email address of a contact.
"email": "A String", # An email address. For example, "`person123@company.com`".
@@ -1749,46 +1754,46 @@ Method Details
],
},
},
- "containers": [ # Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.
+ "containers": [ # Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"createTime": "A String", # The time at which the finding was created in Security Command Center.
- "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided. # Database associated with the finding.
- "displayName": "A String", # The human readable name of the database the user connected to.
- "grantees": [ # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).
+ "database": { # Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided. # Database associated with the finding.
+ "displayName": "A String", # The human-readable name of the database that the user connected to.
+ "grantees": [ # The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.
"A String",
],
- "name": "A String", # The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)
- "query": "A String", # The SQL statement associated with the relevant access.
- "userName": "A String", # The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.
+ "name": "A String", # The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.
+ "query": "A String", # The SQL statement that is associated with the database access.
+ "userName": "A String", # The username used to connect to the database. The username might not be an IAM principal and does not have a set format.
},
- "description": "A String", # Contains more detail about the finding.
+ "description": "A String", # Contains more details about the finding.
"eventTime": "A String", # The time the finding was first detected. If an existing finding is updated, then this is the time the update occurred. For example, if the finding represents an open firewall, this property captures the time the detector believes the firewall became open. The accuracy is determined by the detector. If the finding is later resolved, then this time reflects when the finding was resolved. This must not be set to a value greater than the current timestamp.
- "exfiltration": { # Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to. # Represents exfiltration associated with the Finding.
+ "exfiltration": { # Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to. # Represents exfiltrations associated with the finding.
"sources": [ # If there are multiple sources, then the data is considered "joined" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
"targets": [ # If there are multiple targets, each target would get a complete copy of the "joined" source data.
- { # Resource that has been exfiltrated or exfiltrated_to.
- "components": [ # Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.
+ { # Resource where data was exfiltrated from or exfiltrated to.
+ "components": [ # Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.
"A String",
],
- "name": "A String", # Resource's URI (https://google.aip.dev/122#full-resource-names)
+ "name": "A String", # The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
},
],
},
@@ -1806,7 +1811,7 @@ Method Details
"externalUri": "A String", # The URI that, if available, points to a web page outside of Security Command Center where additional information about the finding can be found. This field is guaranteed to be either empty or a well formed URL.
"files": [ # File associated with the finding.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1815,14 +1820,14 @@ Method Details
},
],
"findingClass": "A String", # The class of the finding.
- "iamBindings": [ # Represents IAM bindings associated with the Finding.
+ "iamBindings": [ # Represents IAM bindings associated with the finding.
{ # Represents a particular IAM binding, which captures a member's role addition, removal, or state.
"action": "A String", # The action that was performed on a Binding.
- "member": "A String", # A single identity requesting access for a Cloud Platform resource, e.g. "foo@google.com".
+ "member": "A String", # A single identity requesting access for a Cloud Platform resource, for example, "foo@google.com".
"role": "A String", # Role that is assigned to "members". For example, "roles/viewer", "roles/editor", or "roles/owner".
},
],
- "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise
+ "indicator": { # Represents what's commonly known as an _indicator of compromise_ (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise). # Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise).
"domains": [ # List of domains associated to the Finding.
"A String",
],
@@ -1849,88 +1854,88 @@ Method Details
"A String",
],
},
- "kernelRootkit": { # Kernel mode rootkit signatures. # Kernel Rootkit signature.
- "name": "A String", # Rootkit name when available.
- "unexpectedCodeModification": True or False, # True when unexpected modifications of kernel code memory are present.
- "unexpectedFtraceHandler": True or False, # True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedInterruptHandler": True or False, # True when interrupt handlers that are are not in the expected kernel or module code regions are present.
- "unexpectedKernelCodePages": True or False, # True when kernel code pages that are not in the expected kernel or module code regions are present.
- "unexpectedKprobeHandler": True or False, # True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
- "unexpectedProcessesInRunqueue": True or False, # True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
- "unexpectedReadOnlyDataModification": True or False, # True when unexpected modifications of kernel read-only data memory are present.
- "unexpectedSystemCallHandler": True or False, # True when system call handlers that are are not in the expected kernel or module code regions are present.
+ "kernelRootkit": { # Kernel mode rootkit signatures. # Signature of the kernel rootkit.
+ "name": "A String", # Rootkit name, when available.
+ "unexpectedCodeModification": True or False, # True if unexpected modifications of kernel code memory are present.
+ "unexpectedFtraceHandler": True or False, # True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedInterruptHandler": True or False, # True if interrupt handlers that are are not in the expected kernel or module code regions are present.
+ "unexpectedKernelCodePages": True or False, # True if kernel code pages that are not in the expected kernel or module code regions are present.
+ "unexpectedKprobeHandler": True or False, # True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.
+ "unexpectedProcessesInRunqueue": True or False, # True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.
+ "unexpectedReadOnlyDataModification": True or False, # True if unexpected modifications of kernel read-only data memory are present.
+ "unexpectedSystemCallHandler": True or False, # True if system call handlers that are are not in the expected kernel or module code regions are present.
},
"kubernetes": { # Kubernetes-related attributes. # Kubernetes resources associated with the finding.
- "accessReviews": [ # Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.
- { # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.
- "group": "A String", # Group is the API Group of the Resource. "*" means all.
- "name": "A String", # Name is the name of the resource being requested. Empty means all.
+ "accessReviews": [ # Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.
+ { # Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.
+ "group": "A String", # The API group of the resource. "*" means all.
+ "name": "A String", # The name of the resource being requested. Empty means all.
"ns": "A String", # Namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces. Both are represented by "" (empty).
- "resource": "A String", # Resource is the optional resource type requested. "*" means all.
- "subresource": "A String", # Subresource is the optional subresource type.
- "verb": "A String", # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
- "version": "A String", # Version is the API Version of the Resource. "*" means all.
+ "resource": "A String", # The optional resource type requested. "*" means all.
+ "subresource": "A String", # The optional subresource type.
+ "verb": "A String", # A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. "*" means all.
+ "version": "A String", # The API version of the resource. "*" means all.
},
],
- "bindings": [ # Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.
+ "bindings": [ # Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Represents a Kubernetes RoleBinding or ClusterRoleBinding.
- "name": "A String", # Name for binding.
- "ns": "A String", # Namespace for binding.
+ "name": "A String", # Name for the binding.
+ "ns": "A String", # Namespace for the binding.
"role": { # Kubernetes Role or ClusterRole. # The Role or ClusterRole referenced by the binding.
"kind": "A String", # Role type.
"name": "A String", # Role name.
"ns": "A String", # Role namespace.
},
"subjects": [ # Represents one or more subjects that are bound to the role. Not always available for PATCH requests.
- { # Represents a Kubernetes Subject.
- "kind": "A String", # Authentication type for subject.
- "name": "A String", # Name for subject.
- "ns": "A String", # Namespace for subject.
+ { # Represents a Kubernetes subject.
+ "kind": "A String", # Authentication type for the subject.
+ "name": "A String", # Name for the subject.
+ "ns": "A String", # Namespace for the subject.
},
],
},
],
- "nodePools": [ # GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.
- { # Provides GKE Node Pool information.
- "name": "A String", # Kubernetes Node pool name.
+ "nodePools": [ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.
+ { # Provides GKE node pool information.
+ "name": "A String", # Kubernetes node pool name.
"nodes": [ # Nodes associated with the finding.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
},
],
- "nodes": [ # Provides Kubernetes Node information.
- { # Kubernetes Nodes associated with the finding.
- "name": "A String", # Full Resource name of the Compute Engine VM running the cluster node.
+ "nodes": [ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.
+ { # Kubernetes nodes associated with the finding.
+ "name": "A String", # [Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.
},
],
- "pods": [ # Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.
- { # Kubernetes Pod.
+ "pods": [ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.
+ { # A Kubernetes Pod.
"containers": [ # Pod containers associated with this finding, if any.
{ # Container associated with the finding.
- "imageId": "A String", # Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
+ "imageId": "A String", # Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.
"labels": [ # Container labels, as provided by the container runtime.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
- "name": "A String", # Container name.
- "uri": "A String", # Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.
+ "name": "A String", # Name of the container.
+ "uri": "A String", # Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.
},
],
"labels": [ # Pod labels. For Kubernetes containers, these are applied to the container.
- { # Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().
- "name": "A String", # Label name.
- "value": "A String", # Label value.
+ { # Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).
+ "name": "A String", # Name of the label.
+ "value": "A String", # Value that corresponds to the label's name.
},
],
"name": "A String", # Kubernetes Pod name.
"ns": "A String", # Kubernetes Pod namespace.
},
],
- "roles": [ # Provides Kubernetes role information for findings that involve Roles or ClusterRoles.
+ "roles": [ # Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).
{ # Kubernetes Role or ClusterRole.
"kind": "A String", # Role type.
"name": "A String", # Role name.
@@ -1953,10 +1958,10 @@ Method Details
},
"moduleName": "A String", # Unique identifier of the module which generated the finding. Example: folders/598186756061/securityHealthAnalyticsSettings/customModules/56799441161885
"mute": "A String", # Indicates the mute state of a finding (either muted, unmuted or undefined). Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
- "muteInitiator": "A String", # First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.
+ "muteInitiator": "A String", # Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.
"muteUpdateTime": "A String", # Output only. The most recent time this finding was muted or unmuted.
- "name": "A String", # The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
- "nextSteps": "A String", # Next steps associate to the finding.
+ "name": "A String", # The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}", "folders/{folder_id}/sources/{source_id}/findings/{finding_id}", "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
+ "nextSteps": "A String", # Steps to address the finding.
"parent": "A String", # The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: "organizations/{organization_id}/sources/{source_id}"
"parentDisplayName": "A String", # Output only. The human readable display name of the finding source such as "Event Threat Detection" or "Security Health Analytics".
"processes": [ # Represents operating system processes associated with the Finding.
@@ -1966,7 +1971,7 @@ Method Details
],
"argumentsTruncated": True or False, # True if `args` is incomplete.
"binary": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # File information for the process executable.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1974,7 +1979,7 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
"envVariables": [ # Process environment variables.
- { # EnvironmentVariable is a name-value pair to store environment variables for Process.
+ { # A name-value pair representing an environment variable used in an operating system process.
"name": "A String", # Environment variable name as a JSON encoded string.
"val": "A String", # Environment variable value as a JSON encoded string.
},
@@ -1982,7 +1987,7 @@ Method Details
"envVariablesTruncated": True or False, # True if `env_variables` is incomplete.
"libraries": [ # File information for libraries loaded by the process.
{ # File information about the related binary/library used by an executable, or the script used by a script interpreter
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
@@ -1990,11 +1995,11 @@ Method Details
"size": "A String", # Size of the file in bytes.
},
],
- "name": "A String", # The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
- "parentPid": "A String", # The parent process id.
- "pid": "A String", # The process id.
- "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter.
- "contents": "A String", # Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)
+ "name": "A String", # The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+ "parentPid": "A String", # The parent process ID.
+ "pid": "A String", # The process ID.
+ "script": { # File information about the related binary/library used by an executable, or the script used by a script interpreter # When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
+ "contents": "A String", # Prefix of the file contents as a JSON-encoded string.
"hashedSize": "A String", # The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
"partiallyHashed": True or False, # True when the hash covers only a prefix of the file.
"path": "A String", # Absolute path of the file as a JSON encoded string.
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1.json
index 728bd71961e..7890f5fc610 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1.json
@@ -255,7 +255,7 @@
],
"parameters": {
"bigQueryExportId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -444,7 +444,7 @@
],
"parameters": {
"muteConfigId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -901,7 +901,7 @@
]
},
"patch": {
- "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \u201cinherited\u201d). Updating the display name and custom config of a module is supported on resident modules only.",
+ "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \"inherited\"). Updating the display name and custom config of a module is supported on resident modules only.",
"flatPath": "v1/folders/{foldersId}/securityHealthAnalyticsSettings/customModules/{customModulesId}",
"httpMethod": "PATCH",
"id": "securitycenter.folders.securityHealthAnalyticsSettings.customModules.patch",
@@ -1147,7 +1147,7 @@
],
"parameters": {
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"location": "path",
"pattern": "^folders/[^/]+/sources/[^/]+/findings/[^/]+$",
"required": true,
@@ -1552,7 +1552,7 @@
],
"parameters": {
"bigQueryExportId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -1741,7 +1741,7 @@
],
"parameters": {
"muteConfigId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -2318,7 +2318,7 @@
]
},
"patch": {
- "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \u201cinherited\u201d). Updating the display name and custom config of a module is supported on resident modules only.",
+ "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \"inherited\"). Updating the display name and custom config of a module is supported on resident modules only.",
"flatPath": "v1/organizations/{organizationsId}/securityHealthAnalyticsSettings/customModules/{customModulesId}",
"httpMethod": "PATCH",
"id": "securitycenter.organizations.securityHealthAnalyticsSettings.customModules.patch",
@@ -2768,7 +2768,7 @@
],
"parameters": {
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"location": "path",
"pattern": "^organizations/[^/]+/sources/[^/]+/findings/[^/]+$",
"required": true,
@@ -3084,7 +3084,7 @@
],
"parameters": {
"bigQueryExportId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -3273,7 +3273,7 @@
],
"parameters": {
"muteConfigId": {
- "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.",
+ "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.",
"location": "query",
"type": "string"
},
@@ -3730,7 +3730,7 @@
]
},
"patch": {
- "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \u201cinherited\u201d). Updating the display name and custom config of a module is supported on resident modules only.",
+ "description": "Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of \"inherited\"). Updating the display name and custom config of a module is supported on resident modules only.",
"flatPath": "v1/projects/{projectsId}/securityHealthAnalyticsSettings/customModules/{customModulesId}",
"httpMethod": "PATCH",
"id": "securitycenter.projects.securityHealthAnalyticsSettings.customModules.patch",
@@ -3976,7 +3976,7 @@
],
"parameters": {
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"location": "path",
"pattern": "^projects/[^/]+/sources/[^/]+/findings/[^/]+$",
"required": true,
@@ -4143,7 +4143,7 @@
}
}
},
- "revision": "20230410",
+ "revision": "20230515",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -4163,22 +4163,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
"type": "string"
},
"principalSubject": {
- "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "description": "A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.",
"type": "string"
},
"serviceAccountDelegationInfo": {
- "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "description": "The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
"items": {
"$ref": "ServiceAccountDelegationInfo"
},
"type": "array"
},
"serviceAccountKeyName": {
- "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
+ "description": "The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\". ",
"type": "string"
},
"serviceName": {
@@ -4186,26 +4186,26 @@
"type": "string"
},
"userAgentFamily": {
- "description": "What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.",
+ "description": "Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.",
"type": "string"
},
"userName": {
- "description": "A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.",
+ "description": "A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.",
"type": "string"
}
},
"type": "object"
},
"AccessReview": {
- "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.",
+ "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.",
"id": "AccessReview",
"properties": {
"group": {
- "description": "Group is the API Group of the Resource. \"*\" means all.",
+ "description": "The API group of the resource. \"*\" means all.",
"type": "string"
},
"name": {
- "description": "Name is the name of the resource being requested. Empty means all.",
+ "description": "The name of the resource being requested. Empty means all.",
"type": "string"
},
"ns": {
@@ -4213,19 +4213,19 @@
"type": "string"
},
"resource": {
- "description": "Resource is the optional resource type requested. \"*\" means all.",
+ "description": "The optional resource type requested. \"*\" means all.",
"type": "string"
},
"subresource": {
- "description": "Subresource is the optional subresource type.",
+ "description": "The optional subresource type.",
"type": "string"
},
"verb": {
- "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.",
+ "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.",
"type": "string"
},
"version": {
- "description": "Version is the API Version of the Resource. \"*\" means all.",
+ "description": "The API version of the resource. \"*\" means all.",
"type": "string"
}
},
@@ -4402,6 +4402,20 @@
"dataProfile": {
"description": "Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.",
"type": "string"
+ },
+ "parentType": {
+ "description": "The resource hierarchy level at which the data profile was generated.",
+ "enum": [
+ "PARENT_TYPE_UNSPECIFIED",
+ "ORGANIZATION",
+ "PROJECT"
+ ],
+ "enumDescriptions": [
+ "Unspecified parent type.",
+ "Organization-level configurations.",
+ "Project-level configurations."
+ ],
+ "type": "string"
}
},
"type": "object"
@@ -4415,7 +4429,7 @@
"type": "boolean"
},
"infoType": {
- "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
+ "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
"type": "string"
},
"infoTypeCount": {
@@ -4435,18 +4449,18 @@
"id": "Compliance",
"properties": {
"ids": {
- "description": "Policies within the standard/benchmark e.g. A.12.4.1",
+ "description": "Policies within the standard or benchmark, for example, A.12.4.1",
"items": {
"type": "string"
},
"type": "array"
},
"standard": {
- "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.",
+ "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.",
"type": "string"
},
"version": {
- "description": "Version of the standard/benchmark e.g. 1.1",
+ "description": "Version of the standard or benchmark, for example, 1.1",
"type": "string"
}
},
@@ -4509,7 +4523,7 @@
"type": "object"
},
"ContactDetails": {
- "description": "The details pertaining to specific contacts",
+ "description": "Details about specific contacts",
"id": "ContactDetails",
"properties": {
"contacts": {
@@ -4527,7 +4541,7 @@
"id": "Container",
"properties": {
"imageId": {
- "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
+ "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
"type": "string"
},
"labels": {
@@ -4538,11 +4552,11 @@
"type": "array"
},
"name": {
- "description": "Container name.",
+ "description": "Name of the container.",
"type": "string"
},
"uri": {
- "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.",
+ "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.",
"type": "string"
}
},
@@ -4711,30 +4725,30 @@
"type": "object"
},
"Database": {
- "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.",
"id": "Database",
"properties": {
"displayName": {
- "description": "The human readable name of the database the user connected to.",
+ "description": "The human-readable name of the database that the user connected to.",
"type": "string"
},
"grantees": {
- "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.",
"type": "string"
},
"query": {
- "description": "The SQL statement associated with the relevant access.",
+ "description": "The SQL statement that is associated with the database access.",
"type": "string"
},
"userName": {
- "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.",
"type": "string"
}
},
@@ -4763,7 +4777,7 @@
"type": "object"
},
"EnvironmentVariable": {
- "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.",
+ "description": "A name-value pair representing an environment variable used in an operating system process.",
"id": "EnvironmentVariable",
"properties": {
"name": {
@@ -4778,25 +4792,25 @@
"type": "object"
},
"ExfilResource": {
- "description": "Resource that has been exfiltrated or exfiltrated_to.",
+ "description": "Resource where data was exfiltrated from or exfiltrated to.",
"id": "ExfilResource",
"properties": {
"components": {
- "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.",
+ "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)",
+ "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).",
"type": "string"
}
},
"type": "object"
},
"Exfiltration": {
- "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.",
+ "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.",
"id": "Exfiltration",
"properties": {
"sources": {
@@ -4844,7 +4858,7 @@
"id": "File",
"properties": {
"contents": {
- "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)",
+ "description": "Prefix of the file contents as a JSON-encoded string.",
"type": "string"
},
"hashedSize": {
@@ -4878,7 +4892,7 @@
"properties": {
"access": {
"$ref": "Access",
- "description": "Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc."
+ "description": "Access details associated with the finding, such as more information on the caller, which method was accessed, and from where."
},
"canonicalName": {
"description": "The canonical name of the finding. It's either \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\" or \"projects/{project_number}/sources/{source_id}/findings/{finding_id}\", depending on the closest CRM ancestor of the resource associated with the finding.",
@@ -4890,11 +4904,11 @@
},
"cloudDlpDataProfile": {
"$ref": "CloudDlpDataProfile",
- "description": "Cloud DLP data profile associated with the finding."
+ "description": "Cloud DLP data profile that is associated with the finding."
},
"cloudDlpInspection": {
"$ref": "CloudDlpInspection",
- "description": "Cloud DLP inspection associated with the finding."
+ "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
},
"compliances": {
"description": "Contains compliance information for security standards associated to the finding.",
@@ -4919,7 +4933,7 @@
"type": "object"
},
"containers": {
- "description": "Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.",
+ "description": "Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.",
"items": {
"$ref": "Container"
},
@@ -4935,7 +4949,7 @@
"description": "Database associated with the finding."
},
"description": {
- "description": "Contains more detail about the finding.",
+ "description": "Contains more details about the finding.",
"type": "string"
},
"eventTime": {
@@ -4945,7 +4959,7 @@
},
"exfiltration": {
"$ref": "Exfiltration",
- "description": "Represents exfiltration associated with the Finding."
+ "description": "Represents exfiltrations associated with the finding."
},
"externalSystems": {
"additionalProperties": {
@@ -4987,7 +5001,7 @@
"type": "string"
},
"iamBindings": {
- "description": "Represents IAM bindings associated with the Finding.",
+ "description": "Represents IAM bindings associated with the finding.",
"items": {
"$ref": "IamBinding"
},
@@ -4995,11 +5009,11 @@
},
"indicator": {
"$ref": "Indicator",
- "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise"
+ "description": "Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise)."
},
"kernelRootkit": {
"$ref": "KernelRootkit",
- "description": "Kernel Rootkit signature."
+ "description": "Signature of the kernel rootkit."
},
"kubernetes": {
"$ref": "Kubernetes",
@@ -5030,7 +5044,7 @@
"type": "string"
},
"muteInitiator": {
- "description": "First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.",
+ "description": "Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.",
"type": "string"
},
"muteUpdateTime": {
@@ -5040,11 +5054,11 @@
"type": "string"
},
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"type": "string"
},
"nextSteps": {
- "description": "Next steps associate to the finding.",
+ "description": "Steps to address the finding.",
"type": "string"
},
"parent": {
@@ -5083,7 +5097,7 @@
],
"enumDescriptions": [
"This value is used for findings when a source doesn't write a severity value.",
- "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data, public SSH access with weak or no passwords, etc. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
+ "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data and public SSH access with weak or no passwords. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
"Vulnerability: A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities in order to gain direct access and the ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. An example is a database with weak or no passwords that is only accessible internally. This database could easily be compromised by an actor that had access to the internal network. Threat: Indicates a threat that is able to create new computational resources in an environment but not able to access data or execute code in existing resources.",
"Vulnerability: A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually (through multiple steps or a complex exploit) gain access and the ability to execute arbitrary code or exfiltrate data. An example is a service account with access to more projects than it should have. If an actor gains access to the service account, they could potentially use that access to manipulate a project the service account was not intended to. Threat: Indicates a threat that is able to cause operational impact but may not access data or execute unauthorized code.",
"Vulnerability: A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment, or prevents the root cause investigation of security issues. An example is monitoring and logs being disabled for resource configurations and access. Threat: Indicates a threat that has obtained minimal access to an environment but is not able to access data, execute code, or create resources."
@@ -5217,11 +5231,11 @@
"id": "GoogleCloudSecuritycenterV1Binding",
"properties": {
"name": {
- "description": "Name for binding.",
+ "description": "Name for the binding.",
"type": "string"
},
"ns": {
- "description": "Namespace for binding.",
+ "description": "Namespace for the binding.",
"type": "string"
},
"role": {
@@ -5975,7 +5989,7 @@
"type": "string"
},
"member": {
- "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".",
+ "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".",
"type": "string"
},
"role": {
@@ -6036,39 +6050,39 @@
"id": "KernelRootkit",
"properties": {
"name": {
- "description": "Rootkit name when available.",
+ "description": "Rootkit name, when available.",
"type": "string"
},
"unexpectedCodeModification": {
- "description": "True when unexpected modifications of kernel code memory are present.",
+ "description": "True if unexpected modifications of kernel code memory are present.",
"type": "boolean"
},
"unexpectedFtraceHandler": {
- "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedInterruptHandler": {
- "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKernelCodePages": {
- "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.",
+ "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKprobeHandler": {
- "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedProcessesInRunqueue": {
- "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
+ "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
"type": "boolean"
},
"unexpectedReadOnlyDataModification": {
- "description": "True when unexpected modifications of kernel read-only data memory are present.",
+ "description": "True if unexpected modifications of kernel read-only data memory are present.",
"type": "boolean"
},
"unexpectedSystemCallHandler": {
- "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
}
},
@@ -6079,42 +6093,42 @@
"id": "Kubernetes",
"properties": {
"accessReviews": {
- "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.",
+ "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.",
"items": {
"$ref": "AccessReview"
},
"type": "array"
},
"bindings": {
- "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.",
+ "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "GoogleCloudSecuritycenterV1Binding"
},
"type": "array"
},
"nodePools": {
- "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.",
+ "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.",
"items": {
"$ref": "NodePool"
},
"type": "array"
},
"nodes": {
- "description": "Provides Kubernetes Node information.",
+ "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.",
"items": {
"$ref": "Node"
},
"type": "array"
},
"pods": {
- "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.",
+ "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.",
"items": {
"$ref": "Pod"
},
"type": "array"
},
"roles": {
- "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.",
+ "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "Role"
},
@@ -6124,15 +6138,15 @@
"type": "object"
},
"Label": {
- "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().",
+ "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).",
"id": "Label",
"properties": {
"name": {
- "description": "Label name.",
+ "description": "Name of the label.",
"type": "string"
},
"value": {
- "description": "Label value.",
+ "description": "Value that corresponds to the label's name.",
"type": "string"
}
},
@@ -6212,7 +6226,7 @@
"type": "object"
},
"ListDescendantSecurityHealthAnalyticsCustomModulesResponse": {
- "description": "Response message for listing descendant security health analytics custom modules.",
+ "description": "Response message for listing descendant Security Health Analytics custom modules.",
"id": "ListDescendantSecurityHealthAnalyticsCustomModulesResponse",
"properties": {
"nextPageToken": {
@@ -6230,7 +6244,7 @@
"type": "object"
},
"ListEffectiveSecurityHealthAnalyticsCustomModulesResponse": {
- "description": "Response message for listing effective security health analytics custom modules.",
+ "description": "Response message for listing effective Security Health Analytics custom modules.",
"id": "ListEffectiveSecurityHealthAnalyticsCustomModulesResponse",
"properties": {
"effectiveSecurityHealthAnalyticsCustomModules": {
@@ -6364,7 +6378,7 @@
"type": "object"
},
"ListSecurityHealthAnalyticsCustomModulesResponse": {
- "description": "Response message for listing security health analytics custom modules.",
+ "description": "Response message for listing Security Health Analytics custom modules.",
"id": "ListSecurityHealthAnalyticsCustomModulesResponse",
"properties": {
"nextPageToken": {
@@ -6674,22 +6688,22 @@
"type": "object"
},
"Node": {
- "description": "Kubernetes Nodes associated with the finding.",
+ "description": "Kubernetes nodes associated with the finding.",
"id": "Node",
"properties": {
"name": {
- "description": "Full Resource name of the Compute Engine VM running the cluster node.",
+ "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.",
"type": "string"
}
},
"type": "object"
},
"NodePool": {
- "description": "Provides GKE Node Pool information.",
+ "description": "Provides GKE node pool information.",
"id": "NodePool",
"properties": {
"name": {
- "description": "Kubernetes Node pool name.",
+ "description": "Kubernetes node pool name.",
"type": "string"
},
"nodes": {
@@ -6785,7 +6799,7 @@
"type": "object"
},
"Pod": {
- "description": "Kubernetes Pod.",
+ "description": "A Kubernetes Pod.",
"id": "Pod",
"properties": {
"containers": {
@@ -6882,22 +6896,22 @@
"type": "array"
},
"name": {
- "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
+ "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
"type": "string"
},
"parentPid": {
- "description": "The parent process id.",
+ "description": "The parent process ID.",
"format": "int64",
"type": "string"
},
"pid": {
- "description": "The process id.",
+ "description": "The process ID.",
"format": "int64",
"type": "string"
},
"script": {
"$ref": "File",
- "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter."
+ "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter."
}
},
"type": "object"
@@ -7222,11 +7236,11 @@
"type": "object"
},
"Subject": {
- "description": "Represents a Kubernetes Subject.",
+ "description": "Represents a Kubernetes subject.",
"id": "Subject",
"properties": {
"kind": {
- "description": "Authentication type for subject.",
+ "description": "Authentication type for the subject.",
"enum": [
"AUTH_TYPE_UNSPECIFIED",
"USER",
@@ -7236,17 +7250,17 @@
"enumDescriptions": [
"Authentication is not specified.",
"User with valid certificate.",
- "Users managed by Kubernetes API with credentials stored as Secrets.",
+ "Users managed by Kubernetes API with credentials stored as secrets.",
"Collection of users."
],
"type": "string"
},
"name": {
- "description": "Name for subject.",
+ "description": "Name for the subject.",
"type": "string"
},
"ns": {
- "description": "Namespace for subject.",
+ "description": "Namespace for the subject.",
"type": "string"
}
},
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
index 3a78275f718..ed3ab441c63 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
@@ -896,7 +896,7 @@
}
}
},
- "revision": "20230410",
+ "revision": "20230515",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -916,22 +916,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
"type": "string"
},
"principalSubject": {
- "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "description": "A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.",
"type": "string"
},
"serviceAccountDelegationInfo": {
- "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "description": "The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
"items": {
"$ref": "ServiceAccountDelegationInfo"
},
"type": "array"
},
"serviceAccountKeyName": {
- "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
+ "description": "The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\". ",
"type": "string"
},
"serviceName": {
@@ -939,26 +939,26 @@
"type": "string"
},
"userAgentFamily": {
- "description": "What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.",
+ "description": "Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.",
"type": "string"
},
"userName": {
- "description": "A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.",
+ "description": "A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.",
"type": "string"
}
},
"type": "object"
},
"AccessReview": {
- "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.",
+ "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.",
"id": "AccessReview",
"properties": {
"group": {
- "description": "Group is the API Group of the Resource. \"*\" means all.",
+ "description": "The API group of the resource. \"*\" means all.",
"type": "string"
},
"name": {
- "description": "Name is the name of the resource being requested. Empty means all.",
+ "description": "The name of the resource being requested. Empty means all.",
"type": "string"
},
"ns": {
@@ -966,19 +966,19 @@
"type": "string"
},
"resource": {
- "description": "Resource is the optional resource type requested. \"*\" means all.",
+ "description": "The optional resource type requested. \"*\" means all.",
"type": "string"
},
"subresource": {
- "description": "Subresource is the optional subresource type.",
+ "description": "The optional subresource type.",
"type": "string"
},
"verb": {
- "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.",
+ "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.",
"type": "string"
},
"version": {
- "description": "Version is the API Version of the Resource. \"*\" means all.",
+ "description": "The API version of the resource. \"*\" means all.",
"type": "string"
}
},
@@ -1131,6 +1131,20 @@
"dataProfile": {
"description": "Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.",
"type": "string"
+ },
+ "parentType": {
+ "description": "The resource hierarchy level at which the data profile was generated.",
+ "enum": [
+ "PARENT_TYPE_UNSPECIFIED",
+ "ORGANIZATION",
+ "PROJECT"
+ ],
+ "enumDescriptions": [
+ "Unspecified parent type.",
+ "Organization-level configurations.",
+ "Project-level configurations."
+ ],
+ "type": "string"
}
},
"type": "object"
@@ -1144,7 +1158,7 @@
"type": "boolean"
},
"infoType": {
- "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
+ "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
"type": "string"
},
"infoTypeCount": {
@@ -1164,18 +1178,18 @@
"id": "Compliance",
"properties": {
"ids": {
- "description": "Policies within the standard/benchmark e.g. A.12.4.1",
+ "description": "Policies within the standard or benchmark, for example, A.12.4.1",
"items": {
"type": "string"
},
"type": "array"
},
"standard": {
- "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.",
+ "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.",
"type": "string"
},
"version": {
- "description": "Version of the standard/benchmark e.g. 1.1",
+ "description": "Version of the standard or benchmark, for example, 1.1",
"type": "string"
}
},
@@ -1238,7 +1252,7 @@
"type": "object"
},
"ContactDetails": {
- "description": "The details pertaining to specific contacts",
+ "description": "Details about specific contacts",
"id": "ContactDetails",
"properties": {
"contacts": {
@@ -1256,7 +1270,7 @@
"id": "Container",
"properties": {
"imageId": {
- "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
+ "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
"type": "string"
},
"labels": {
@@ -1267,11 +1281,11 @@
"type": "array"
},
"name": {
- "description": "Container name.",
+ "description": "Name of the container.",
"type": "string"
},
"uri": {
- "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.",
+ "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.",
"type": "string"
}
},
@@ -1440,30 +1454,30 @@
"type": "object"
},
"Database": {
- "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.",
"id": "Database",
"properties": {
"displayName": {
- "description": "The human readable name of the database the user connected to.",
+ "description": "The human-readable name of the database that the user connected to.",
"type": "string"
},
"grantees": {
- "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.",
"type": "string"
},
"query": {
- "description": "The SQL statement associated with the relevant access.",
+ "description": "The SQL statement that is associated with the database access.",
"type": "string"
},
"userName": {
- "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.",
"type": "string"
}
},
@@ -1492,7 +1506,7 @@
"type": "object"
},
"EnvironmentVariable": {
- "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.",
+ "description": "A name-value pair representing an environment variable used in an operating system process.",
"id": "EnvironmentVariable",
"properties": {
"name": {
@@ -1507,25 +1521,25 @@
"type": "object"
},
"ExfilResource": {
- "description": "Resource that has been exfiltrated or exfiltrated_to.",
+ "description": "Resource where data was exfiltrated from or exfiltrated to.",
"id": "ExfilResource",
"properties": {
"components": {
- "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.",
+ "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)",
+ "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).",
"type": "string"
}
},
"type": "object"
},
"Exfiltration": {
- "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.",
+ "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.",
"id": "Exfiltration",
"properties": {
"sources": {
@@ -1573,7 +1587,7 @@
"id": "File",
"properties": {
"contents": {
- "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)",
+ "description": "Prefix of the file contents as a JSON-encoded string.",
"type": "string"
},
"hashedSize": {
@@ -1607,7 +1621,7 @@
"properties": {
"access": {
"$ref": "Access",
- "description": "Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc."
+ "description": "Access details associated with the finding, such as more information on the caller, which method was accessed, and from where."
},
"canonicalName": {
"description": "The canonical name of the finding. It's either \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\" or \"projects/{project_number}/sources/{source_id}/findings/{finding_id}\", depending on the closest CRM ancestor of the resource associated with the finding.",
@@ -1619,11 +1633,11 @@
},
"cloudDlpDataProfile": {
"$ref": "CloudDlpDataProfile",
- "description": "Cloud DLP data profile associated with the finding."
+ "description": "Cloud DLP data profile that is associated with the finding."
},
"cloudDlpInspection": {
"$ref": "CloudDlpInspection",
- "description": "Cloud DLP inspection associated with the finding."
+ "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
},
"compliances": {
"description": "Contains compliance information for security standards associated to the finding.",
@@ -1648,7 +1662,7 @@
"type": "object"
},
"containers": {
- "description": "Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.",
+ "description": "Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.",
"items": {
"$ref": "Container"
},
@@ -1664,7 +1678,7 @@
"description": "Database associated with the finding."
},
"description": {
- "description": "Contains more detail about the finding.",
+ "description": "Contains more details about the finding.",
"type": "string"
},
"eventTime": {
@@ -1674,7 +1688,7 @@
},
"exfiltration": {
"$ref": "Exfiltration",
- "description": "Represents exfiltration associated with the Finding."
+ "description": "Represents exfiltrations associated with the finding."
},
"externalSystems": {
"additionalProperties": {
@@ -1716,7 +1730,7 @@
"type": "string"
},
"iamBindings": {
- "description": "Represents IAM bindings associated with the Finding.",
+ "description": "Represents IAM bindings associated with the finding.",
"items": {
"$ref": "IamBinding"
},
@@ -1724,11 +1738,11 @@
},
"indicator": {
"$ref": "Indicator",
- "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise"
+ "description": "Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise)."
},
"kernelRootkit": {
"$ref": "KernelRootkit",
- "description": "Kernel Rootkit signature."
+ "description": "Signature of the kernel rootkit."
},
"kubernetes": {
"$ref": "Kubernetes",
@@ -1759,7 +1773,7 @@
"type": "string"
},
"muteInitiator": {
- "description": "First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.",
+ "description": "Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.",
"type": "string"
},
"muteUpdateTime": {
@@ -1769,11 +1783,11 @@
"type": "string"
},
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"type": "string"
},
"nextSteps": {
- "description": "Next steps associate to the finding.",
+ "description": "Steps to address the finding.",
"type": "string"
},
"parent": {
@@ -1812,7 +1826,7 @@
],
"enumDescriptions": [
"This value is used for findings when a source doesn't write a severity value.",
- "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data, public SSH access with weak or no passwords, etc. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
+ "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data and public SSH access with weak or no passwords. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
"Vulnerability: A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities in order to gain direct access and the ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. An example is a database with weak or no passwords that is only accessible internally. This database could easily be compromised by an actor that had access to the internal network. Threat: Indicates a threat that is able to create new computational resources in an environment but not able to access data or execute code in existing resources.",
"Vulnerability: A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually (through multiple steps or a complex exploit) gain access and the ability to execute arbitrary code or exfiltrate data. An example is a service account with access to more projects than it should have. If an actor gains access to the service account, they could potentially use that access to manipulate a project the service account was not intended to. Threat: Indicates a threat that is able to cause operational impact but may not access data or execute unauthorized code.",
"Vulnerability: A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment, or prevents the root cause investigation of security issues. An example is monitoring and logs being disabled for resource configurations and access. Threat: Indicates a threat that has obtained minimal access to an environment but is not able to access data, execute code, or create resources."
@@ -1946,11 +1960,11 @@
"id": "GoogleCloudSecuritycenterV1Binding",
"properties": {
"name": {
- "description": "Name for binding.",
+ "description": "Name for the binding.",
"type": "string"
},
"ns": {
- "description": "Namespace for binding.",
+ "description": "Namespace for the binding.",
"type": "string"
},
"role": {
@@ -2770,7 +2784,7 @@
"type": "string"
},
"member": {
- "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".",
+ "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".",
"type": "string"
},
"role": {
@@ -2820,39 +2834,39 @@
"id": "KernelRootkit",
"properties": {
"name": {
- "description": "Rootkit name when available.",
+ "description": "Rootkit name, when available.",
"type": "string"
},
"unexpectedCodeModification": {
- "description": "True when unexpected modifications of kernel code memory are present.",
+ "description": "True if unexpected modifications of kernel code memory are present.",
"type": "boolean"
},
"unexpectedFtraceHandler": {
- "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedInterruptHandler": {
- "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKernelCodePages": {
- "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.",
+ "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKprobeHandler": {
- "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedProcessesInRunqueue": {
- "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
+ "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
"type": "boolean"
},
"unexpectedReadOnlyDataModification": {
- "description": "True when unexpected modifications of kernel read-only data memory are present.",
+ "description": "True if unexpected modifications of kernel read-only data memory are present.",
"type": "boolean"
},
"unexpectedSystemCallHandler": {
- "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
}
},
@@ -2863,42 +2877,42 @@
"id": "Kubernetes",
"properties": {
"accessReviews": {
- "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.",
+ "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.",
"items": {
"$ref": "AccessReview"
},
"type": "array"
},
"bindings": {
- "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.",
+ "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "GoogleCloudSecuritycenterV1Binding"
},
"type": "array"
},
"nodePools": {
- "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.",
+ "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.",
"items": {
"$ref": "NodePool"
},
"type": "array"
},
"nodes": {
- "description": "Provides Kubernetes Node information.",
+ "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.",
"items": {
"$ref": "Node"
},
"type": "array"
},
"pods": {
- "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.",
+ "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.",
"items": {
"$ref": "Pod"
},
"type": "array"
},
"roles": {
- "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.",
+ "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "Role"
},
@@ -2908,15 +2922,15 @@
"type": "object"
},
"Label": {
- "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().",
+ "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).",
"id": "Label",
"properties": {
"name": {
- "description": "Label name.",
+ "description": "Name of the label.",
"type": "string"
},
"value": {
- "description": "Label value.",
+ "description": "Value that corresponds to the label's name.",
"type": "string"
}
},
@@ -3318,22 +3332,22 @@
"type": "object"
},
"Node": {
- "description": "Kubernetes Nodes associated with the finding.",
+ "description": "Kubernetes nodes associated with the finding.",
"id": "Node",
"properties": {
"name": {
- "description": "Full Resource name of the Compute Engine VM running the cluster node.",
+ "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.",
"type": "string"
}
},
"type": "object"
},
"NodePool": {
- "description": "Provides GKE Node Pool information.",
+ "description": "Provides GKE node pool information.",
"id": "NodePool",
"properties": {
"name": {
- "description": "Kubernetes Node pool name.",
+ "description": "Kubernetes node pool name.",
"type": "string"
},
"nodes": {
@@ -3401,7 +3415,7 @@
"type": "object"
},
"Pod": {
- "description": "Kubernetes Pod.",
+ "description": "A Kubernetes Pod.",
"id": "Pod",
"properties": {
"containers": {
@@ -3498,22 +3512,22 @@
"type": "array"
},
"name": {
- "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
+ "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
"type": "string"
},
"parentPid": {
- "description": "The parent process id.",
+ "description": "The parent process ID.",
"format": "int64",
"type": "string"
},
"pid": {
- "description": "The process id.",
+ "description": "The process ID.",
"format": "int64",
"type": "string"
},
"script": {
"$ref": "File",
- "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter."
+ "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter."
}
},
"type": "object"
@@ -3739,11 +3753,11 @@
"type": "object"
},
"Subject": {
- "description": "Represents a Kubernetes Subject.",
+ "description": "Represents a Kubernetes subject.",
"id": "Subject",
"properties": {
"kind": {
- "description": "Authentication type for subject.",
+ "description": "Authentication type for the subject.",
"enum": [
"AUTH_TYPE_UNSPECIFIED",
"USER",
@@ -3753,17 +3767,17 @@
"enumDescriptions": [
"Authentication is not specified.",
"User with valid certificate.",
- "Users managed by Kubernetes API with credentials stored as Secrets.",
+ "Users managed by Kubernetes API with credentials stored as secrets.",
"Collection of users."
],
"type": "string"
},
"name": {
- "description": "Name for subject.",
+ "description": "Name for the subject.",
"type": "string"
},
"ns": {
- "description": "Namespace for subject.",
+ "description": "Namespace for the subject.",
"type": "string"
}
},
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
index a697d2526f4..7272dfbb67f 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
@@ -1981,7 +1981,7 @@
}
}
},
- "revision": "20230410",
+ "revision": "20230515",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -2001,22 +2001,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user or a service account acting on behalf of a third party principal making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
"type": "string"
},
"principalSubject": {
- "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subjects/{subject}` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "description": "A string that represents the principal_subject that is associated with the identity. Unlike `principal_email`, `principal_subject` supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format is `principal://iam.googleapis.com/{identity pool name}/subject/{subject}`. Some GKE identities, such as GKE_WORKLOAD, FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:{identity pool name}[{subject}]`.",
"type": "string"
},
"serviceAccountDelegationInfo": {
- "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "description": "The identity delegation history of an authenticated service account that made the request. The `serviceAccountDelegationInfo[]` object contains information about the real authorities that try to access Google Cloud resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
"items": {
"$ref": "ServiceAccountDelegationInfo"
},
"type": "array"
},
"serviceAccountKeyName": {
- "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
+ "description": "The name of the service account key that was used to create or exchange credentials when authenticating the service account that made the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\". ",
"type": "string"
},
"serviceName": {
@@ -2024,26 +2024,26 @@
"type": "string"
},
"userAgentFamily": {
- "description": "What kind of user agent is associated, for example operating system shells, embedded or stand-alone applications, etc.",
+ "description": "Type of user agent associated with the finding. For example, an operating system shell or an embedded or standalone application.",
"type": "string"
},
"userName": {
- "description": "A string that represents the username of a user, user account, or other entity involved in the access event. What the entity is and what its role in the access event is depends on the finding that this field appears in. The entity is likely not an IAM principal, but could be a user that is logged into an operating system, if the finding is VM-related, or a user that is logged into some type of application that is involved in the access event.",
+ "description": "A string that represents a username. The username provided depends on the type of the finding and is likely not an IAM principal. For example, this can be a system username if the finding is related to a virtual machine, or it can be an application login username.",
"type": "string"
}
},
"type": "object"
},
"AccessReview": {
- "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.",
+ "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.",
"id": "AccessReview",
"properties": {
"group": {
- "description": "Group is the API Group of the Resource. \"*\" means all.",
+ "description": "The API group of the resource. \"*\" means all.",
"type": "string"
},
"name": {
- "description": "Name is the name of the resource being requested. Empty means all.",
+ "description": "The name of the resource being requested. Empty means all.",
"type": "string"
},
"ns": {
@@ -2051,19 +2051,19 @@
"type": "string"
},
"resource": {
- "description": "Resource is the optional resource type requested. \"*\" means all.",
+ "description": "The optional resource type requested. \"*\" means all.",
"type": "string"
},
"subresource": {
- "description": "Subresource is the optional subresource type.",
+ "description": "The optional subresource type.",
"type": "string"
},
"verb": {
- "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.",
+ "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.",
"type": "string"
},
"version": {
- "description": "Version is the API Version of the Resource. \"*\" means all.",
+ "description": "The API version of the resource. \"*\" means all.",
"type": "string"
}
},
@@ -2076,6 +2076,20 @@
"dataProfile": {
"description": "Name of the data profile, for example, `projects/123/locations/europe/tableProfiles/8383929`.",
"type": "string"
+ },
+ "parentType": {
+ "description": "The resource hierarchy level at which the data profile was generated.",
+ "enum": [
+ "PARENT_TYPE_UNSPECIFIED",
+ "ORGANIZATION",
+ "PROJECT"
+ ],
+ "enumDescriptions": [
+ "Unspecified parent type.",
+ "Organization-level configurations.",
+ "Project-level configurations."
+ ],
+ "type": "string"
}
},
"type": "object"
@@ -2089,7 +2103,7 @@
"type": "boolean"
},
"infoType": {
- "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
+ "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.",
"type": "string"
},
"infoTypeCount": {
@@ -2109,18 +2123,18 @@
"id": "Compliance",
"properties": {
"ids": {
- "description": "Policies within the standard/benchmark e.g. A.12.4.1",
+ "description": "Policies within the standard or benchmark, for example, A.12.4.1",
"items": {
"type": "string"
},
"type": "array"
},
"standard": {
- "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.",
+ "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.",
"type": "string"
},
"version": {
- "description": "Version of the standard/benchmark e.g. 1.1",
+ "description": "Version of the standard or benchmark, for example, 1.1",
"type": "string"
}
},
@@ -2214,7 +2228,7 @@
"type": "object"
},
"ContactDetails": {
- "description": "The details pertaining to specific contacts",
+ "description": "Details about specific contacts",
"id": "ContactDetails",
"properties": {
"contacts": {
@@ -2232,7 +2246,7 @@
"id": "Container",
"properties": {
"imageId": {
- "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
+ "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.",
"type": "string"
},
"labels": {
@@ -2243,11 +2257,11 @@
"type": "array"
},
"name": {
- "description": "Container name.",
+ "description": "Name of the container.",
"type": "string"
},
"uri": {
- "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.",
+ "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.",
"type": "string"
}
},
@@ -2461,30 +2475,30 @@
"type": "object"
},
"Database": {
- "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.",
"id": "Database",
"properties": {
"displayName": {
- "description": "The human readable name of the database the user connected to.",
+ "description": "The human-readable name of the database that the user connected to.",
"type": "string"
},
"grantees": {
- "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.",
"type": "string"
},
"query": {
- "description": "The SQL statement associated with the relevant access.",
+ "description": "The SQL statement that is associated with the database access.",
"type": "string"
},
"userName": {
- "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.",
"type": "string"
}
},
@@ -2544,7 +2558,7 @@
"type": "object"
},
"EnvironmentVariable": {
- "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.",
+ "description": "A name-value pair representing an environment variable used in an operating system process.",
"id": "EnvironmentVariable",
"properties": {
"name": {
@@ -2599,25 +2613,25 @@
"type": "object"
},
"ExfilResource": {
- "description": "Resource that has been exfiltrated or exfiltrated_to.",
+ "description": "Resource where data was exfiltrated from or exfiltrated to.",
"id": "ExfilResource",
"properties": {
"components": {
- "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.",
+ "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
- "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)",
+ "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).",
"type": "string"
}
},
"type": "object"
},
"Exfiltration": {
- "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.",
+ "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.",
"id": "Exfiltration",
"properties": {
"sources": {
@@ -2665,7 +2679,7 @@
"id": "File",
"properties": {
"contents": {
- "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)",
+ "description": "Prefix of the file contents as a JSON-encoded string.",
"type": "string"
},
"hashedSize": {
@@ -2699,7 +2713,7 @@
"properties": {
"access": {
"$ref": "Access",
- "description": "Access details associated to the Finding, such as more information on the caller, which method was accessed, from where, etc."
+ "description": "Access details associated with the finding, such as more information on the caller, which method was accessed, and from where."
},
"canonicalName": {
"description": "The canonical name of the finding. It's either \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\" or \"projects/{project_number}/sources/{source_id}/findings/{finding_id}\", depending on the closest CRM ancestor of the resource associated with the finding.",
@@ -2711,11 +2725,11 @@
},
"cloudDlpDataProfile": {
"$ref": "CloudDlpDataProfile",
- "description": "Cloud DLP data profile associated with the finding."
+ "description": "Cloud DLP data profile that is associated with the finding."
},
"cloudDlpInspection": {
"$ref": "CloudDlpInspection",
- "description": "Cloud DLP inspection associated with the finding."
+ "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
},
"compliances": {
"description": "Contains compliance information for security standards associated to the finding.",
@@ -2740,7 +2754,7 @@
"type": "object"
},
"containers": {
- "description": "Containers associated with the finding. containers provides information for both Kubernetes and non-Kubernetes containers.",
+ "description": "Containers associated with the finding. This field provides information for both Kubernetes and non-Kubernetes containers.",
"items": {
"$ref": "Container"
},
@@ -2756,7 +2770,7 @@
"description": "Database associated with the finding."
},
"description": {
- "description": "Contains more detail about the finding.",
+ "description": "Contains more details about the finding.",
"type": "string"
},
"eventTime": {
@@ -2766,7 +2780,7 @@
},
"exfiltration": {
"$ref": "Exfiltration",
- "description": "Represents exfiltration associated with the Finding."
+ "description": "Represents exfiltrations associated with the finding."
},
"externalSystems": {
"additionalProperties": {
@@ -2808,7 +2822,7 @@
"type": "string"
},
"iamBindings": {
- "description": "Represents IAM bindings associated with the Finding.",
+ "description": "Represents IAM bindings associated with the finding.",
"items": {
"$ref": "IamBinding"
},
@@ -2816,11 +2830,11 @@
},
"indicator": {
"$ref": "Indicator",
- "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise"
+ "description": "Represents what's commonly known as an *indicator of compromise* (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. For more information, see [Indicator of compromise](https://en.wikipedia.org/wiki/Indicator_of_compromise)."
},
"kernelRootkit": {
"$ref": "KernelRootkit",
- "description": "Kernel Rootkit signature."
+ "description": "Signature of the kernel rootkit."
},
"kubernetes": {
"$ref": "Kubernetes",
@@ -2851,7 +2865,7 @@
"type": "string"
},
"muteInitiator": {
- "description": "First known as mute_annotation. Records additional information about the mute operation e.g. mute config that muted the finding, user who muted the finding, etc. Unlike other attributes of a finding, a finding provider shouldn't set the value of mute.",
+ "description": "Records additional information about the mute operation, for example, the [mute configuration](/security-command-center/docs/how-to-mute-findings) that muted the finding and the user who muted the finding.",
"type": "string"
},
"muteUpdateTime": {
@@ -2861,11 +2875,11 @@
"type": "string"
},
"name": {
- "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"",
+ "description": "The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\", \"folders/{folder_id}/sources/{source_id}/findings/{finding_id}\", \"projects/{project_id}/sources/{source_id}/findings/{finding_id}\".",
"type": "string"
},
"nextSteps": {
- "description": "Next steps associate to the finding.",
+ "description": "Steps to address the finding.",
"type": "string"
},
"parent": {
@@ -2904,7 +2918,7 @@
],
"enumDescriptions": [
"This value is used for findings when a source doesn't write a severity value.",
- "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data, public SSH access with weak or no passwords, etc. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
+ "Vulnerability: A critical vulnerability is easily discoverable by an external actor, exploitable, and results in the direct ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. Examples include publicly accessible unprotected user data and public SSH access with weak or no passwords. Threat: Indicates a threat that is able to access, modify, or delete data or execute unauthorized code within existing resources.",
"Vulnerability: A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities in order to gain direct access and the ability to execute arbitrary code, exfiltrate data, and otherwise gain additional access and privileges to cloud resources and workloads. An example is a database with weak or no passwords that is only accessible internally. This database could easily be compromised by an actor that had access to the internal network. Threat: Indicates a threat that is able to create new computational resources in an environment but not able to access data or execute code in existing resources.",
"Vulnerability: A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually (through multiple steps or a complex exploit) gain access and the ability to execute arbitrary code or exfiltrate data. An example is a service account with access to more projects than it should have. If an actor gains access to the service account, they could potentially use that access to manipulate a project the service account was not intended to. Threat: Indicates a threat that is able to cause operational impact but may not access data or execute unauthorized code.",
"Vulnerability: A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment, or prevents the root cause investigation of security issues. An example is monitoring and logs being disabled for resource configurations and access. Threat: Indicates a threat that has obtained minimal access to an environment but is not able to access data, execute code, or create resources."
@@ -3015,11 +3029,11 @@
"id": "GoogleCloudSecuritycenterV1Binding",
"properties": {
"name": {
- "description": "Name for binding.",
+ "description": "Name for the binding.",
"type": "string"
},
"ns": {
- "description": "Namespace for binding.",
+ "description": "Namespace for the binding.",
"type": "string"
},
"role": {
@@ -3630,7 +3644,7 @@
"type": "string"
},
"member": {
- "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".",
+ "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".",
"type": "string"
},
"role": {
@@ -3680,39 +3694,39 @@
"id": "KernelRootkit",
"properties": {
"name": {
- "description": "Rootkit name when available.",
+ "description": "Rootkit name, when available.",
"type": "string"
},
"unexpectedCodeModification": {
- "description": "True when unexpected modifications of kernel code memory are present.",
+ "description": "True if unexpected modifications of kernel code memory are present.",
"type": "boolean"
},
"unexpectedFtraceHandler": {
- "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedInterruptHandler": {
- "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKernelCodePages": {
- "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.",
+ "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.",
"type": "boolean"
},
"unexpectedKprobeHandler": {
- "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
+ "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.",
"type": "boolean"
},
"unexpectedProcessesInRunqueue": {
- "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
+ "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.",
"type": "boolean"
},
"unexpectedReadOnlyDataModification": {
- "description": "True when unexpected modifications of kernel read-only data memory are present.",
+ "description": "True if unexpected modifications of kernel read-only data memory are present.",
"type": "boolean"
},
"unexpectedSystemCallHandler": {
- "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.",
+ "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.",
"type": "boolean"
}
},
@@ -3723,42 +3737,42 @@
"id": "Kubernetes",
"properties": {
"accessReviews": {
- "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.",
+ "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.",
"items": {
"$ref": "AccessReview"
},
"type": "array"
},
"bindings": {
- "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.",
+ "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "GoogleCloudSecuritycenterV1Binding"
},
"type": "array"
},
"nodePools": {
- "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.",
+ "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.",
"items": {
"$ref": "NodePool"
},
"type": "array"
},
"nodes": {
- "description": "Provides Kubernetes Node information.",
+ "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.",
"items": {
"$ref": "Node"
},
"type": "array"
},
"pods": {
- "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.",
+ "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.",
"items": {
"$ref": "Pod"
},
"type": "array"
},
"roles": {
- "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.",
+ "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).",
"items": {
"$ref": "Role"
},
@@ -3768,15 +3782,15 @@
"type": "object"
},
"Label": {
- "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().",
+ "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).",
"id": "Label",
"properties": {
"name": {
- "description": "Label name.",
+ "description": "Name of the label.",
"type": "string"
},
"value": {
- "description": "Label value.",
+ "description": "Value that corresponds to the label's name.",
"type": "string"
}
},
@@ -4057,22 +4071,22 @@
"type": "object"
},
"Node": {
- "description": "Kubernetes Nodes associated with the finding.",
+ "description": "Kubernetes nodes associated with the finding.",
"id": "Node",
"properties": {
"name": {
- "description": "Full Resource name of the Compute Engine VM running the cluster node.",
+ "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.",
"type": "string"
}
},
"type": "object"
},
"NodePool": {
- "description": "Provides GKE Node Pool information.",
+ "description": "Provides GKE node pool information.",
"id": "NodePool",
"properties": {
"name": {
- "description": "Kubernetes Node pool name.",
+ "description": "Kubernetes node pool name.",
"type": "string"
},
"nodes": {
@@ -4111,7 +4125,7 @@
"type": "object"
},
"Pod": {
- "description": "Kubernetes Pod.",
+ "description": "A Kubernetes Pod.",
"id": "Pod",
"properties": {
"containers": {
@@ -4177,22 +4191,22 @@
"type": "array"
},
"name": {
- "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
+ "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.",
"type": "string"
},
"parentPid": {
- "description": "The parent process id.",
+ "description": "The parent process ID.",
"format": "int64",
"type": "string"
},
"pid": {
- "description": "The process id.",
+ "description": "The process ID.",
"format": "int64",
"type": "string"
},
"script": {
"$ref": "File",
- "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter."
+ "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter."
}
},
"type": "object"
@@ -4405,11 +4419,11 @@
"type": "object"
},
"Subject": {
- "description": "Represents a Kubernetes Subject.",
+ "description": "Represents a Kubernetes subject.",
"id": "Subject",
"properties": {
"kind": {
- "description": "Authentication type for subject.",
+ "description": "Authentication type for the subject.",
"enum": [
"AUTH_TYPE_UNSPECIFIED",
"USER",
@@ -4419,17 +4433,17 @@
"enumDescriptions": [
"Authentication is not specified.",
"User with valid certificate.",
- "Users managed by Kubernetes API with credentials stored as Secrets.",
+ "Users managed by Kubernetes API with credentials stored as secrets.",
"Collection of users."
],
"type": "string"
},
"name": {
- "description": "Name for subject.",
+ "description": "Name for the subject.",
"type": "string"
},
"ns": {
- "description": "Namespace for subject.",
+ "description": "Namespace for the subject.",
"type": "string"
}
},