google-apis-securitycenter_v1beta1 0.13.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 976c2cf747e62d64df7b40f81f44f41beabff9cd09b6b0bc2bd3e6acaea7bd61
-  data.tar.gz: 921852a1093f36a1f5b7ffaf8ed9c3237903b3b3a475e5446cbd42aa145b8209
+  metadata.gz: 0c2ec615e85a04f0562a72157d75f8b7a41788533a630c5b7939571476f26123
+  data.tar.gz: bfcc5732c35ff8424133660517af5da17f7a940a2ac22cd343ace88323e2e87c
 SHA512:
-  metadata.gz: 995daf6a49cfe646b2dfed59978cdbab9295da1e810eddadd0b769605881e33d82965dca40c2074f32c734903073318e7bf9b3cd31b3c7b9296ac00a519313c4
-  data.tar.gz: 06c4908416cef753420c6d52f8d0d6e7dba6ec454e3034f6e5285553dd70eef7f8df4283cd090335ea067a7d37d656a5df2d92de92dbda2f8b3d00422be02f46
+  metadata.gz: 18038bf9fa82cc40170a77d23e6556be1c89adaad910fa96b629137036d03b85fe392b5182ad16bfd9946ffd5d0001b1ad7ec7a88e71107c11fc8695095cb156
+  data.tar.gz: '09f882d60b0c4070e739a3ec8485f382c7aeeae3714df3940becc6f9aaf1b8a0705aca2aaa29af6a2bdc8f3c47fb993b5008a84fcca395c70638ed9be3898c1e'

data/CHANGELOG.md

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

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/securitycenter_v1beta1"
 client = Google::Apis::SecuritycenterV1beta1::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_v1beta1/classes.rb

@@ -22,6 +22,57 @@ module Google
   module Apis
     module SecuritycenterV1beta1
       
+      # 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::SecuritycenterV1beta1::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
@@ -452,6 +503,11 @@ module Google
       class Finding
         include Google::Apis::Core::Hashable
       
+        # Represents an access event.
+        # Corresponds to the JSON property `access`
+        # @return [Google::Apis::SecuritycenterV1beta1::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/`
@@ -472,12 +528,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
@@ -508,15 +564,23 @@ module Google
         # @return [Google::Apis::SecuritycenterV1beta1::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::SecuritycenterV1beta1::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
@@ -588,6 +652,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)
@@ -596,6 +661,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)
@@ -636,6 +702,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
@@ -683,6 +768,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
@@ -1808,6 +1906,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
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SecuritycenterV1beta1
       # Version of the google-apis-securitycenter_v1beta1 gem
-      GEM_VERSION = "0.13.0"
+      GEM_VERSION = "0.17.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_v1beta1/representations.rb

@@ -22,6 +22,12 @@ module Google
   module Apis
     module SecuritycenterV1beta1
       
+      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
       
@@ -256,6 +274,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 Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -340,6 +364,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::SecuritycenterV1beta1::Geolocation, decorator: Google::Apis::SecuritycenterV1beta1::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
@@ -440,6 +477,8 @@ module Google
       class Finding
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :access, as: 'access', class: Google::Apis::SecuritycenterV1beta1::Access, decorator: Google::Apis::SecuritycenterV1beta1::Access::Representation
+      
           property :canonical_name, as: 'canonicalName'
           property :category, as: 'category'
           property :create_time, as: 'createTime'
@@ -450,6 +489,8 @@ module Google
           property :finding_class, as: 'findingClass'
           property :indicator, as: 'indicator', class: Google::Apis::SecuritycenterV1beta1::Indicator, decorator: Google::Apis::SecuritycenterV1beta1::Indicator::Representation
       
+          property :mitre_attack, as: 'mitreAttack', class: Google::Apis::SecuritycenterV1beta1::MitreAttack, decorator: Google::Apis::SecuritycenterV1beta1::MitreAttack::Representation
+      
           property :mute, as: 'mute'
           property :mute_initiator, as: 'muteInitiator'
           property :mute_update_time, as: 'muteUpdateTime'
@@ -474,6 +515,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
@@ -489,6 +537,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
@@ -756,6 +810,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 Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-securitycenter_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.17.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_v1beta1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1beta1/v0.13.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1beta1/v0.17.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1beta1
 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 V1beta1