google-cloud-security_center-v2 0.a → 0.2.0

data/proto_docs/google/cloud/securitycenter/v2/compliance.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # Contains compliance information about a security standard indicating unmet
+        # recommendations.
+        # @!attribute [rw] standard
+        #   @return [::String]
+        #     Industry-wide compliance standards or benchmarks, such as CIS, PCI, and
+        #     OWASP.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Version of the standard or benchmark, for example, 1.1
+        # @!attribute [rw] ids
+        #   @return [::Array<::String>]
+        #     Policies within the standard or benchmark, for example, A.12.4.1
+        class Compliance
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/connection.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # Contains information about the IP connection associated with the finding.
+        # @!attribute [rw] destination_ip
+        #   @return [::String]
+        #     Destination IP address. Not present for sockets that are listening and not
+        #     connected.
+        # @!attribute [rw] destination_port
+        #   @return [::Integer]
+        #     Destination port. Not present for sockets that are listening and not
+        #     connected.
+        # @!attribute [rw] source_ip
+        #   @return [::String]
+        #     Source IP address.
+        # @!attribute [rw] source_port
+        #   @return [::Integer]
+        #     Source port.
+        # @!attribute [rw] protocol
+        #   @return [::Google::Cloud::SecurityCenter::V2::Connection::Protocol]
+        #     IANA Internet Protocol Number such as TCP(6) and UDP(17).
+        class Connection
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # IANA Internet Protocol Number such as TCP(6) and UDP(17).
+          module Protocol
+            # Unspecified protocol (not HOPOPT).
+            PROTOCOL_UNSPECIFIED = 0
+
+            # Internet Control Message Protocol.
+            ICMP = 1
+
+            # Transmission Control Protocol.
+            TCP = 6
+
+            # User Datagram Protocol.
+            UDP = 17
+
+            # Generic Routing Encapsulation.
+            GRE = 47
+
+            # Encap Security Payload.
+            ESP = 50
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/contact_details.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # Details about specific contacts
+        # @!attribute [rw] contacts
+        #   @return [::Array<::Google::Cloud::SecurityCenter::V2::Contact>]
+        #     A list of contacts
+        class ContactDetails
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The email address of a contact.
+        # @!attribute [rw] email
+        #   @return [::String]
+        #     An email address. For example, "`person123@company.com`".
+        class Contact
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/container.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # Container associated with the finding.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Name of the container.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     Container image URI provided when configuring a pod or container. This
+        #     string can identify a container image version using mutable tags.
+        # @!attribute [rw] image_id
+        #   @return [::String]
+        #     Optional container image ID, if provided by the container runtime. Uniquely
+        #     identifies the container image launched using a container image digest.
+        # @!attribute [rw] labels
+        #   @return [::Array<::Google::Cloud::SecurityCenter::V2::Label>]
+        #     Container labels, as provided by the container runtime.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time that the container was created.
+        class Container
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/database.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # 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.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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.
+        #     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.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     The human-readable name of the database that the user connected to.
+        # @!attribute [rw] user_name
+        #   @return [::String]
+        #     The username used to connect to the database. The username might not be an
+        #     IAM principal and does not have a set format.
+        # @!attribute [rw] query
+        #   @return [::String]
+        #     The SQL statement that is associated with the database access.
+        # @!attribute [rw] grantees
+        #   @return [::Array<::String>]
+        #     The target usernames, roles, or groups of an SQL privilege grant, which is
+        #     not an IAM policy change.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     The version of the database, for example, POSTGRES_14.
+        #     See [the complete
+        #     list](https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1/SqlDatabaseVersion).
+        class Database
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/exfiltration.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # 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.
+        # @!attribute [rw] sources
+        #   @return [::Array<::Google::Cloud::SecurityCenter::V2::ExfilResource>]
+        #     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.
+        # @!attribute [rw] targets
+        #   @return [::Array<::Google::Cloud::SecurityCenter::V2::ExfilResource>]
+        #     If there are multiple targets, each target would get a complete copy of the
+        #     "joined" source data.
+        # @!attribute [rw] total_exfiltrated_bytes
+        #   @return [::Integer]
+        #     Total exfiltrated bytes processed for the entire job.
+        class Exfiltration
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Resource where data was exfiltrated from or exfiltrated to.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource's [full resource
+        #     name](https://cloud.google.com/apis/design/resource_names#full_resource_name).
+        # @!attribute [rw] components
+        #   @return [::Array<::String>]
+        #     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.
+        class ExfilResource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/external_system.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # Representation of third party SIEM/SOAR fields within SCC.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Full resource name of the external system. The following list
+        #     shows some examples:
+        #
+        #     + `organizations/1234/sources/5678/findings/123456/externalSystems/jira`
+        #     +
+        #     `organizations/1234/sources/5678/locations/us/findings/123456/externalSystems/jira`
+        #     + `folders/1234/sources/5678/findings/123456/externalSystems/jira`
+        #     +
+        #     `folders/1234/sources/5678/locations/us/findings/123456/externalSystems/jira`
+        #     + `projects/1234/sources/5678/findings/123456/externalSystems/jira`
+        #     +
+        #     `projects/1234/sources/5678/locations/us/findings/123456/externalSystems/jira`
+        # @!attribute [rw] assignees
+        #   @return [::Array<::String>]
+        #     References primary/secondary etc assignees in the external system.
+        # @!attribute [rw] external_uid
+        #   @return [::String]
+        #     The identifier that's used to track the finding's corresponding case in the
+        #     external system.
+        # @!attribute [rw] status
+        #   @return [::String]
+        #     The most recent status of the finding's corresponding case, as reported by
+        #     the external system.
+        # @!attribute [rw] external_system_update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the case was last updated, as reported by the external
+        #     system.
+        # @!attribute [rw] case_uri
+        #   @return [::String]
+        #     The link to the finding's corresponding case in the external system.
+        # @!attribute [rw] case_priority
+        #   @return [::String]
+        #     The priority of the finding's corresponding case in the external system.
+        # @!attribute [rw] case_sla
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The SLA of the finding's corresponding case in the external system.
+        # @!attribute [rw] case_create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the case was created, as reported by the external system.
+        # @!attribute [rw] case_close_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when the case was closed, as reported by the external system.
+        # @!attribute [rw] ticket_info
+        #   @return [::Google::Cloud::SecurityCenter::V2::ExternalSystem::TicketInfo]
+        #     Information about the ticket, if any, that is being used to track the
+        #     resolution of the issue that is identified by this finding.
+        class ExternalSystem
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Information about the ticket, if any, that is being used to track the
+          # resolution of the issue that is identified by this finding.
+          # @!attribute [rw] id
+          #   @return [::String]
+          #     The identifier of the ticket in the ticket system.
+          # @!attribute [rw] assignee
+          #   @return [::String]
+          #     The assignee of the ticket in the ticket system.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     The description of the ticket in the ticket system.
+          # @!attribute [rw] uri
+          #   @return [::String]
+          #     The link to the ticket in the ticket system.
+          # @!attribute [rw] status
+          #   @return [::String]
+          #     The latest status of the ticket, as reported by the ticket system.
+          # @!attribute [rw] update_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time when the ticket was last updated, as reported by the ticket
+          #     system.
+          class TicketInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v2/file.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V2
+        # File information about the related binary/library used by an executable, or
+        # the script used by a script interpreter
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Absolute path of the file as a JSON encoded string.
+        # @!attribute [rw] size
+        #   @return [::Integer]
+        #     Size of the file in bytes.
+        # @!attribute [rw] sha256
+        #   @return [::String]
+        #     SHA256 hash of the first hashed_size bytes of the file encoded as a
+        #     hex string.  If hashed_size == size, sha256 represents the SHA256 hash
+        #     of the entire file.
+        # @!attribute [rw] hashed_size
+        #   @return [::Integer]
+        #     The length in bytes of the file prefix that was hashed.  If
+        #     hashed_size == size, any hashes reported represent the entire
+        #     file.
+        # @!attribute [rw] partially_hashed
+        #   @return [::Boolean]
+        #     True when the hash covers only a prefix of the file.
+        # @!attribute [rw] contents
+        #   @return [::String]
+        #     Prefix of the file contents as a JSON-encoded string.
+        # @!attribute [rw] disk_path
+        #   @return [::Google::Cloud::SecurityCenter::V2::File::DiskPath]
+        #     Path of the file in terms of underlying disk/partition identifiers.
+        class File
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Path of the file in terms of underlying disk/partition identifiers.
+          # @!attribute [rw] partition_uuid
+          #   @return [::String]
+          #     UUID of the partition (format
+          #     https://wiki.archlinux.org/title/persistent_block_device_naming#by-uuid)
+          # @!attribute [rw] relative_path
+          #   @return [::String]
+          #     Relative path of the file in the partition as a JSON encoded string.
+          #     Example: /home/user1/executable_file.sh
+          class DiskPath
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end