google-apis-securitycenter_v1 0.16.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e244c14c7e418d1b0bc02795994e1b96f3f70ea30bb763cadbb50857e43c1ce
-  data.tar.gz: a683ea1c2bc8e55b6d8ea0f7001d5565f584b6a6dc4deada1eabdeffcb847b3d
+  metadata.gz: a865ebda4ef7fbadba18b6645b1223aa124aa8cfe260ed858fe514fa30bc6add
+  data.tar.gz: fa9760839312eaf7707b7934d1a29f3c193d9fd2b33904968fce184878da2051
 SHA512:
-  metadata.gz: 15e284d06998a8aec1005d7c73c359a78bf4471bcd2f00b3c6c8ef4374701baad81b5d7b0ac90e40b8077d77a06054758c4e026c7932366c9ecba015cb4f7c1c
-  data.tar.gz: ee4cc74c1dd5d61b1aadeb9572a08f3c477ab3b423d6f9b706e536dbf74eab466c4aa28d841330d3030dfe1cfdcb364b1454c00948fcbf042c1291106da24543
+  metadata.gz: f0715bb59fa0e3804b2ec59f52382c57eef994c803ac6435c7b298d879e78a3b8362972830518f32305d201ba4c11534fdfa960c066e4c556461afc374b10436
+  data.tar.gz: 6f1fdd17f2bb2e04da2166870d30e3de6dd5222f45233c8424b4da13edca494365b20df9e7cbd7c8f940ba01fab3032193eca94a8545bfd5c699773fa174c2eb

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-securitycenter_v1
 
+### v0.20.0 (2022-02-01)
+
+* Regenerated from discovery document revision 20220127
+
+### v0.19.0 (2022-01-19)
+
+* Regenerated from discovery document revision 20220113
+* Regenerated using generator version 0.4.1
+
+### v0.18.0 (2021-12-16)
+
+* Unspecified changes
+
+### v0.17.0 (2021-12-09)
+
+* Regenerated from discovery document revision 20211207
+
 ### v0.16.0 (2021-11-16)
 
 * Regenerated from discovery document revision 20211112

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/securitycenter_v1"
 client = Google::Apis::SecuritycenterV1::SecurityCommandCenterService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.

data/lib/google/apis/securitycenter_v1/classes.rb

@@ -22,6 +22,57 @@ module Google
   module Apis
     module SecuritycenterV1
       
+      # Represents an access event.
+      class Access
+        include Google::Apis::Core::Hashable
+      
+        # Caller's IP address, such as "1.1.1.1".
+        # Corresponds to the JSON property `callerIp`
+        # @return [String]
+        attr_accessor :caller_ip
+      
+        # Represents a geographical location for a given access.
+        # Corresponds to the JSON property `callerIpGeo`
+        # @return [Google::Apis::SecuritycenterV1::Geolocation]
+        attr_accessor :caller_ip_geo
+      
+        # The method that the service account called, e.g. "SetIamPolicy".
+        # Corresponds to the JSON property `methodName`
+        # @return [String]
+        attr_accessor :method_name
+      
+        # Associated email, such as "foo@google.com".
+        # Corresponds to the JSON property `principalEmail`
+        # @return [String]
+        attr_accessor :principal_email
+      
+        # This is the API service that the service account made a call to, e.g. "iam.
+        # googleapis.com"
+        # Corresponds to the JSON property `serviceName`
+        # @return [String]
+        attr_accessor :service_name
+      
+        # What kind of user agent is associated, e.g. operating system shells, embedded
+        # or stand-alone applications, etc.
+        # Corresponds to the JSON property `userAgentFamily`
+        # @return [String]
+        attr_accessor :user_agent_family
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @caller_ip = args[:caller_ip] if args.key?(:caller_ip)
+          @caller_ip_geo = args[:caller_ip_geo] if args.key?(:caller_ip_geo)
+          @method_name = args[:method_name] if args.key?(:method_name)
+          @principal_email = args[:principal_email] if args.key?(:principal_email)
+          @service_name = args[:service_name] if args.key?(:service_name)
+          @user_agent_family = args[:user_agent_family] if args.key?(:user_agent_family)
+        end
+      end
+      
       # Security Command Center representation of a Google Cloud resource. The Asset
       # is a Security Command Center resource that captures information about a single
       # Google Cloud resource. All modifications to an Asset are only within the
@@ -498,6 +549,11 @@ module Google
       class Finding
         include Google::Apis::Core::Hashable
       
+        # Represents an access event.
+        # Corresponds to the JSON property `access`
+        # @return [Google::Apis::SecuritycenterV1::Access]
+        attr_accessor :access
+      
         # 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/`
@@ -518,12 +574,12 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # 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 be set to a
-        # value greater than the current timestamp.
+        # 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.
         # Corresponds to the JSON property `eventTime`
         # @return [String]
         attr_accessor :event_time
@@ -554,15 +610,23 @@ module Google
         # @return [Google::Apis::SecuritycenterV1::Indicator]
         attr_accessor :indicator
       
+        # MITRE ATT&CK tactics and techniques related to this finding. See: https://
+        # attack.mitre.org
+        # Corresponds to the JSON property `mitreAttack`
+        # @return [Google::Apis::SecuritycenterV1::MitreAttack]
+        attr_accessor :mitre_attack
+      
         # Indicates the mute state of a finding (either unspecified, muted, unmuted or
-        # undefined).
+        # undefined). Unlike other attributes of a finding, a finding provider shouldn't
+        # set the value of mute.
         # Corresponds to the JSON property `mute`
         # @return [String]
         attr_accessor :mute
       
         # 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.
+        # etc. Unlike other attributes of a finding, a finding provider shouldn't set
+        # the value of mute.
         # Corresponds to the JSON property `muteInitiator`
         # @return [String]
         attr_accessor :mute_initiator
@@ -634,6 +698,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @access = args[:access] if args.key?(:access)
           @canonical_name = args[:canonical_name] if args.key?(:canonical_name)
           @category = args[:category] if args.key?(:category)
           @create_time = args[:create_time] if args.key?(:create_time)
@@ -642,6 +707,7 @@ module Google
           @external_uri = args[:external_uri] if args.key?(:external_uri)
           @finding_class = args[:finding_class] if args.key?(:finding_class)
           @indicator = args[:indicator] if args.key?(:indicator)
+          @mitre_attack = args[:mitre_attack] if args.key?(:mitre_attack)
           @mute = args[:mute] if args.key?(:mute)
           @mute_initiator = args[:mute_initiator] if args.key?(:mute_initiator)
           @mute_update_time = args[:mute_update_time] if args.key?(:mute_update_time)
@@ -682,6 +748,25 @@ module Google
         end
       end
       
+      # Represents a geographical location for a given access.
+      class Geolocation
+        include Google::Apis::Core::Hashable
+      
+        # A CLDR.
+        # Corresponds to the JSON property `regionCode`
+        # @return [String]
+        attr_accessor :region_code
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @region_code = args[:region_code] if args.key?(:region_code)
+        end
+      end
+      
       # Request message for `GetIamPolicy` method.
       class GetIamPolicyRequest
         include Google::Apis::Core::Hashable
@@ -729,6 +814,19 @@ module Google
         end
       end
       
+      # The response to a BulkMute request. Contains the LRO information.
+      class GoogleCloudSecuritycenterV1BulkMuteFindingsResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Representation of third party SIEM/SOAR fields within SCC.
       class GoogleCloudSecuritycenterV1ExternalSystem
         include Google::Apis::Core::Hashable
@@ -1909,6 +2007,56 @@ module Google
         end
       end
       
+      # MITRE ATT&CK tactics and techniques related to this finding. See: https://
+      # attack.mitre.org
+      class MitreAttack
+        include Google::Apis::Core::Hashable
+      
+        # Additional MITRE ATT&CK tactics related to this finding, if any.
+        # Corresponds to the JSON property `additionalTactics`
+        # @return [Array<String>]
+        attr_accessor :additional_tactics
+      
+        # Additional MITRE ATT&CK techniques related to this finding, if any, along with
+        # any of their respective parent techniques.
+        # Corresponds to the JSON property `additionalTechniques`
+        # @return [Array<String>]
+        attr_accessor :additional_techniques
+      
+        # The MITRE ATT&CK tactic most closely represented by this finding, if any.
+        # Corresponds to the JSON property `primaryTactic`
+        # @return [String]
+        attr_accessor :primary_tactic
+      
+        # The MITRE ATT&CK technique most closely represented by this finding, if any.
+        # primary_techniques is a repeated field because there are multiple levels of
+        # MITRE ATT&CK techniques. If the technique most closely represented by this
+        # finding is a sub-technique (e.g. SCANNING_IP_BLOCKS), both the sub-technique
+        # and its parent technique(s) will be listed (e.g. SCANNING_IP_BLOCKS,
+        # ACTIVE_SCANNING).
+        # Corresponds to the JSON property `primaryTechniques`
+        # @return [Array<String>]
+        attr_accessor :primary_techniques
+      
+        # The MITRE ATT&CK version referenced by the above fields. E.g. "8".
+        # Corresponds to the JSON property `version`
+        # @return [String]
+        attr_accessor :version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_tactics = args[:additional_tactics] if args.key?(:additional_tactics)
+          @additional_techniques = args[:additional_techniques] if args.key?(:additional_techniques)
+          @primary_tactic = args[:primary_tactic] if args.key?(:primary_tactic)
+          @primary_techniques = args[:primary_techniques] if args.key?(:primary_techniques)
+          @version = args[:version] if args.key?(:version)
+        end
+      end
+      
       # Cloud Security Command Center (Cloud SCC) notification configs. A notification
       # config is a Cloud SCC resource that contains the configuration to send
       # notifications for create/update events of findings, assets and etc.

data/lib/google/apis/securitycenter_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SecuritycenterV1
       # Version of the google-apis-securitycenter_v1 gem
-      GEM_VERSION = "0.16.0"
+      GEM_VERSION = "0.20.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.4.0"
+      GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211112"
+      REVISION = "20220127"
     end
   end
 end

data/lib/google/apis/securitycenter_v1/representations.rb

@@ -22,6 +22,12 @@ module Google
   module Apis
     module SecuritycenterV1
       
+      class Access
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Asset
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -94,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Geolocation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GetIamPolicyRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -106,6 +118,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1BulkMuteFindingsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1ExternalSystem
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -268,6 +286,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MitreAttack
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class NotificationConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -376,6 +400,19 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Access
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :caller_ip, as: 'callerIp'
+          property :caller_ip_geo, as: 'callerIpGeo', class: Google::Apis::SecuritycenterV1::Geolocation, decorator: Google::Apis::SecuritycenterV1::Geolocation::Representation
+      
+          property :method_name, as: 'methodName'
+          property :principal_email, as: 'principalEmail'
+          property :service_name, as: 'serviceName'
+          property :user_agent_family, as: 'userAgentFamily'
+        end
+      end
+      
       class Asset
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -482,6 +519,8 @@ module Google
       class Finding
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :access, as: 'access', class: Google::Apis::SecuritycenterV1::Access, decorator: Google::Apis::SecuritycenterV1::Access::Representation
+      
           property :canonical_name, as: 'canonicalName'
           property :category, as: 'category'
           property :create_time, as: 'createTime'
@@ -492,6 +531,8 @@ module Google
           property :finding_class, as: 'findingClass'
           property :indicator, as: 'indicator', class: Google::Apis::SecuritycenterV1::Indicator, decorator: Google::Apis::SecuritycenterV1::Indicator::Representation
       
+          property :mitre_attack, as: 'mitreAttack', class: Google::Apis::SecuritycenterV1::MitreAttack, decorator: Google::Apis::SecuritycenterV1::MitreAttack::Representation
+      
           property :mute, as: 'mute'
           property :mute_initiator, as: 'muteInitiator'
           property :mute_update_time, as: 'muteUpdateTime'
@@ -516,6 +557,13 @@ module Google
         end
       end
       
+      class Geolocation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :region_code, as: 'regionCode'
+        end
+      end
+      
       class GetIamPolicyRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -531,6 +579,12 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1BulkMuteFindingsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1ExternalSystem
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -812,6 +866,17 @@ module Google
         end
       end
       
+      class MitreAttack
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :additional_tactics, as: 'additionalTactics'
+          collection :additional_techniques, as: 'additionalTechniques'
+          property :primary_tactic, as: 'primaryTactic'
+          collection :primary_techniques, as: 'primaryTechniques'
+          property :version, as: 'version'
+        end
+      end
+      
       class NotificationConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/securitycenter_v1/service.rb

@@ -211,7 +211,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will
@@ -789,7 +790,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will
@@ -1132,7 +1134,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will
@@ -2284,7 +2287,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will
@@ -2521,7 +2525,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will
@@ -3099,7 +3104,8 @@ module Google
         # @param [String] start_time
         #   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.
+        #   active immediately preceding this time. Must be smaller or equal to the server
+        #   time.
         # @param [String] update_mask
         #   The FieldMask to use when updating the security marks resource. The field mask
         #   must not contain duplicate fields. If empty or set to "marks", all marks will

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-securitycenter_v1
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-06 00:00:00.000000000 Z
+date: 2022-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1/v0.16.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1/v0.20.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,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: Simple REST client for Security Command Center API V1