google-cloud-security_center-v1 0.10.0 → 0.12.1

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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 V1
+        # Representation of third party SIEM/SOAR fields within SCC.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     External System Name e.g. jira, demisto, etc.
+        #      e.g.: `organizations/1234/sources/5678/findings/123456/externalSystems/jira`
+        #     `folders/1234/sources/5678/findings/123456/externalSystems/jira`
+        #     `projects/1234/sources/5678/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]
+        #     Identifier that's used to track the given finding in the external system.
+        # @!attribute [rw] status
+        #   @return [::String]
+        #     Most recent status of the corresponding finding's ticket/tracker in the
+        #     external system.
+        # @!attribute [rw] external_system_update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The most recent time when the corresponding finding's ticket/tracker was
+        #     updated in the external system.
+        class ExternalSystem
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v1/finding.rb

@@ -75,11 +75,12 @@ module Google
         #     to the finding.
         # @!attribute [rw] event_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The time at which the event took place, or when an update to the finding
-        #     occurred. For example, if the finding represents an open firewall it would
-        #     capture the time the detector believes the firewall became open. The
-        #     accuracy is determined by the detector. If the finding were to be resolved
-        #     afterward, this time would reflect when the finding was resolved. Must not
+        #     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.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
@@ -96,6 +97,11 @@ module Google
         #     "projects/\\{project_number}/sources/\\{source_id}/findings/\\{finding_id}",
         #     depending on the closest CRM ancestor of the resource associated with the
         #     finding.
+        # @!attribute [rw] mute
+        #   @return [::Google::Cloud::SecurityCenter::V1::Finding::Mute]
+        #     Indicates the mute state of a finding (either unspecified, muted, unmuted
+        #     or undefined). Unlike other attributes of a finding, a finding provider
+        #     shouldn't set the value of mute.
         # @!attribute [rw] finding_class
         #   @return [::Google::Cloud::SecurityCenter::V1::Finding::FindingClass]
         #     The class of the finding.
@@ -111,6 +117,23 @@ module Google
         #     Represents vulnerability specific fields like cve, cvss scores etc.
         #     CVE stands for Common Vulnerabilities and Exposures
         #     (https://cve.mitre.org/about/)
+        # @!attribute [r] mute_update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The most recent time this finding was muted or unmuted.
+        # @!attribute [r] external_systems
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::SecurityCenter::V1::ExternalSystem}]
+        #     Output only. Third party SIEM/SOAR fields within SCC, contains external system
+        #     information and external system finding fields.
+        # @!attribute [rw] access
+        #   @return [::Google::Cloud::SecurityCenter::V1::Access]
+        #     Access details associated to the Finding, such as more information on the
+        #     caller, which method was accessed, from where, etc.
+        # @!attribute [rw] mute_initiator
+        #   @return [::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.
         class Finding
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -124,6 +147,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::SecurityCenter::V1::ExternalSystem]
+          class ExternalSystemsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The state of the finding.
           module State
             # Unspecified state.
@@ -196,6 +228,21 @@ module Google
             LOW = 4
           end
 
+          # Mute state a finding can be in.
+          module Mute
+            # Unspecified.
+            MUTE_UNSPECIFIED = 0
+
+            # Finding has been muted.
+            MUTED = 1
+
+            # Finding has been unmuted.
+            UNMUTED = 2
+
+            # Finding has never been muted/unmuted.
+            UNDEFINED = 4
+          end
+
           # Represents what kind of Finding it is.
           module FindingClass
             # Unspecified finding class.

data/proto_docs/google/cloud/securitycenter/v1/mute_config.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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 V1
+        # A mute config is a Cloud SCC resource that contains the configuration
+        # to mute create/update events of findings.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     This field will be ignored if provided on config creation. Format
+        #     "organizations/\\{organization}/muteConfigs/\\{mute_config}"
+        #     "folders/\\{folder}/muteConfigs/\\{mute_config}"
+        #     "projects/\\{project}/muteConfigs/\\{mute_config}"
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     The human readable name to be displayed for the mute config.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     A description of the mute config.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Required. An expression that defines the filter to apply across create/update events
+        #     of findings. While creating a filter string, be mindful of the
+        #     scope in which the mute configuration is being created. E.g., If a filter
+        #     contains project = X but is created under the project = Y scope, it might
+        #     not match any findings.
+        #
+        #     The following field and operator combinations are supported:
+        #
+        #     * severity: `=`, `:`
+        #     * category: `=`, `:`
+        #     * resource.name: `=`, `:`
+        #     * resource.project_name: `=`, `:`
+        #     * resource.project_display_name: `=`, `:`
+        #     * resource.folders.resource_folder: `=`, `:`
+        #     * resource.parent_name: `=`, `:`
+        #     * resource.parent_display_name: `=`, `:`
+        #     * resource.type: `=`, `:`
+        #     * finding_class: `=`, `:`
+        #     * indicator.ip_addresses: `=`, `:`
+        #     * indicator.domains: `=`, `:`
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time at which the mute config was created.
+        #     This field is set by the server and will be ignored if provided on config
+        #     creation.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     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.
+        # @!attribute [r] most_recent_editor
+        #   @return [::String]
+        #     Output only. Email address of the user who last edited the mute config.
+        #     This field is set by the server and will be ignored if provided on config
+        #     creation or update.
+        class MuteConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/securitycenter/v1/resource.rb

@@ -31,7 +31,7 @@ module Google
         #     The full resource name of project that the resource belongs to.
         # @!attribute [rw] project_display_name
         #   @return [::String]
-        #     The human readable name of project that the resource belongs to.
+        #     The project id that the resource belongs to.
         # @!attribute [rw] parent
         #   @return [::String]
         #     The full resource name of resource's parent.

data/proto_docs/google/cloud/securitycenter/v1/securitycenter_service.rb

@@ -21,6 +21,54 @@ module Google
   module Cloud
     module SecurityCenter
       module V1
+        # Request message for bulk findings update.
+        #
+        # Note:
+        # 1. If multiple bulk update requests match the same resource, the order in
+        # which they get executed is not defined.
+        # 2. Once a bulk operation is started, there is no way to stop it.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, at which bulk action needs to be applied. Its format is
+        #     "organizations/[organization_id]", "folders/[folder_id]",
+        #     "projects/[project_id]".
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Expression that identifies findings that should be updated.
+        #     The expression is a list of zero or more restrictions combined
+        #     via logical operators `AND` and `OR`. Parentheses are supported, and `OR`
+        #     has higher precedence than `AND`.
+        #
+        #     Restrictions have the form `<field> <operator> <value>` and may have a
+        #     `-` character in front of them to indicate negation. The fields map to
+        #     those defined in the corresponding resource.
+        #
+        #     The supported operators are:
+        #
+        #     * `=` for all value types.
+        #     * `>`, `<`, `>=`, `<=` for integer values.
+        #     * `:`, meaning substring matching, for strings.
+        #
+        #     The supported value types are:
+        #
+        #     * string literals in quotes.
+        #     * integer literals without quotes.
+        #     * boolean literals `true` and `false` without quotes.
+        # @!attribute [rw] mute_annotation
+        #   @return [::String]
+        #     This can be a mute configuration name or any identifier for mute/unmute
+        #     of findings based on the filter.
+        class BulkMuteFindingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response to a BulkMute request. Contains the LRO information.
+        class BulkMuteFindingsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for creating a finding.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -40,6 +88,26 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for creating a mute config.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Resource name of the new mute configs's parent. Its format is
+        #     "organizations/[organization_id]", "folders/[folder_id]", or
+        #     "projects/[project_id]".
+        # @!attribute [rw] mute_config
+        #   @return [::Google::Cloud::SecurityCenter::V1::MuteConfig]
+        #     Required. The mute config being created.
+        # @!attribute [rw] mute_config_id
+        #   @return [::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.
+        class CreateMuteConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for creating a notification config.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -74,6 +142,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for deleting a mute config.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the mute config to delete. Its format is
+        #     organizations/\\{organization}/muteConfigs/\\{config_id},
+        #     folders/\\{folder}/muteConfigs/\\{config_id}, or
+        #     projects/\\{project}/muteConfigs/\\{config_id}
+        class DeleteMuteConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for deleting a notification config.
         # @!attribute [rw] name
         #   @return [::String]
@@ -84,6 +164,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for retrieving a mute config.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the mute config to retrieve. Its format is
+        #     organizations/\\{organization}/muteConfigs/\\{config_id},
+        #     folders/\\{folder}/muteConfigs/\\{config_id}, or
+        #     projects/\\{project}/muteConfigs/\\{config_id}
+        class GetMuteConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for getting a notification config.
         # @!attribute [rw] name
         #   @return [::String]
@@ -458,6 +550,44 @@ module Google
           end
         end
 
+        # Request message for listing  mute configs at a given scope e.g. organization,
+        # folder or project.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns the collection of mute configs. Its format is
+        #     "organizations/[organization_id]", "folders/[folder_id]",
+        #     "projects/[project_id]".
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of configs to return. The service may return fewer than
+        #     this value.
+        #     If unspecified, at most 10 configs will be returned.
+        #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `ListMuteConfigs` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListMuteConfigs` must
+        #     match the call that provided the page token.
+        class ListMuteConfigsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for listing mute configs.
+        # @!attribute [rw] mute_configs
+        #   @return [::Array<::Google::Cloud::SecurityCenter::V1::MuteConfig>]
+        #     The mute configs from the specified parent.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class ListMuteConfigsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for listing notification configs.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -910,7 +1040,7 @@ module Google
             #     The full resource name of project that the resource belongs to.
             # @!attribute [rw] project_display_name
             #   @return [::String]
-            #     The human readable name of project that the resource belongs to.
+            #     The project id that the resource belongs to.
             # @!attribute [rw] parent_name
             #   @return [::String]
             #     The full resource name of resource's parent.
@@ -981,6 +1111,23 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for updating a finding's mute status.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The relative resource name of the finding. See:
+        #     https://cloud.google.com/apis/design/resource_names#relative_resource_name
+        #     Example:
+        #     "organizations/\\{organization_id}/sources/\\{source_id}/finding/\\{finding_id}",
+        #     "folders/\\{folder_id}/sources/\\{source_id}/finding/\\{finding_id}",
+        #     "projects/\\{project_id}/sources/\\{source_id}/finding/\\{finding_id}".
+        # @!attribute [rw] mute
+        #   @return [::Google::Cloud::SecurityCenter::V1::Finding::Mute]
+        #     Required. The desired state of the Mute.
+        class SetMuteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for running asset discovery for an organization.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -991,6 +1138,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for updating a ExternalSystem resource.
+        # @!attribute [rw] external_system
+        #   @return [::Google::Cloud::SecurityCenter::V1::ExternalSystem]
+        #     Required. The external system resource to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The FieldMask to use when updating the external system resource.
+        #
+        #     If empty all mutable fields will be updated.
+        class UpdateExternalSystemRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for updating or creating a finding.
         # @!attribute [rw] finding
         #   @return [::Google::Cloud::SecurityCenter::V1::Finding]
@@ -1014,6 +1175,19 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for updating a mute config.
+        # @!attribute [rw] mute_config
+        #   @return [::Google::Cloud::SecurityCenter::V1::MuteConfig]
+        #     Required. The mute config being updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of fields to be updated.
+        #     If empty all mutable fields will be updated.
+        class UpdateMuteConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for updating a notification config.
         # @!attribute [rw] notification_config
         #   @return [::Google::Cloud::SecurityCenter::V1::NotificationConfig]
@@ -1071,7 +1245,8 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     The time at which the updated SecurityMarks take effect.
         #     If not set uses current server time.  Updates will be applied to the
-        #     SecurityMarks that are active immediately preceding this time.
+        #     SecurityMarks that are active immediately preceding this time. Must be
+        #     smaller or equal to the server time.
         class UpdateSecurityMarksRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-security_center-v1
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-11 00:00:00.000000000 Z
+date: 2022-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -197,10 +197,13 @@ files:
 - lib/google/cloud/security_center/v1/security_center/operations.rb
 - lib/google/cloud/security_center/v1/security_center/paths.rb
 - lib/google/cloud/security_center/v1/version.rb
+- lib/google/cloud/securitycenter/v1/access_pb.rb
 - lib/google/cloud/securitycenter/v1/asset_pb.rb
+- lib/google/cloud/securitycenter/v1/external_system_pb.rb
 - lib/google/cloud/securitycenter/v1/finding_pb.rb
 - lib/google/cloud/securitycenter/v1/folder_pb.rb
 - lib/google/cloud/securitycenter/v1/indicator_pb.rb
+- lib/google/cloud/securitycenter/v1/mute_config_pb.rb
 - lib/google/cloud/securitycenter/v1/notification_config_pb.rb
 - lib/google/cloud/securitycenter/v1/notification_message_pb.rb
 - lib/google/cloud/securitycenter/v1/organization_settings_pb.rb
@@ -214,10 +217,13 @@ files:
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
+- proto_docs/google/cloud/securitycenter/v1/access.rb
 - proto_docs/google/cloud/securitycenter/v1/asset.rb
+- proto_docs/google/cloud/securitycenter/v1/external_system.rb
 - proto_docs/google/cloud/securitycenter/v1/finding.rb
 - proto_docs/google/cloud/securitycenter/v1/folder.rb
 - proto_docs/google/cloud/securitycenter/v1/indicator.rb
+- proto_docs/google/cloud/securitycenter/v1/mute_config.rb
 - proto_docs/google/cloud/securitycenter/v1/notification_config.rb
 - proto_docs/google/cloud/securitycenter/v1/notification_message.rb
 - proto_docs/google/cloud/securitycenter/v1/organization_settings.rb
@@ -258,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Security Command Center V1 API