google-apis-securitycenter_v1beta1 0.50.0 → 0.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5f99c2fb6d42b8e2f1517d53abfa7b08a3b1e370f81704dd0b5cf00da13b0d6
-  data.tar.gz: 01f7d6b22a99d3fa1015b1edffcad8bbceae210e7ff1261c035663a5d3255919
+  metadata.gz: 8bac438667e70c3bd0661af12ce737a3916cd35051eb8c00c8dc8cedc5363114
+  data.tar.gz: 5dc521fb8f3b64f1c2c33fb45e5018ccb7d356f39754efbfcc2d705cfd4461c0
 SHA512:
-  metadata.gz: 65c175e8781de4a5a35fe59e8eafbd528d70e8dff3f45981be51e971106867393d2ba1256a0e9e0e49e780f02702b0a6a58a43435ea0a4774a95d592e4c700ce
-  data.tar.gz: 92cf6a3ecdc740bb739baf44edccd01e1acf7bde43ba9053845ed8ac24edaedca42592334bc164669ce4d82fdad7ee01878f9e14c0be08e2d1d86ad14bd7eb53
+  metadata.gz: 6a34fe6540a79e046eccb8d74a159442d71fb87652fb7caa86b54e00bd929c47401271a44ef626b90e3218cbe3102779d43f78a93c4e96e4a7a0988aa91a0b81
+  data.tar.gz: 95539d492a4e179580c91e386f2cc5a2a95dad9d676c7ecb56ece9e5ba94004fb12a1f2b114b5d628ceccac2f11635a473bfbcb11bf8e133ffb41f5ec8abeb20

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-securitycenter_v1beta1
 
+### v0.51.0 (2023-04-16)
+
+* Regenerated from discovery document revision 20230406
+
 ### v0.50.0 (2023-04-02)
 
 * Regenerated from discovery document revision 20230329

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

@@ -1571,6 +1571,156 @@ module Google
         end
       end
       
+      # 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.
+      class GoogleCloudSecuritycenterV1CustomConfig
+        include Google::Apis::Core::Hashable
+      
+        # A set of optional name-value pairs that define custom source properties to
+        # return with each finding that is generated by the custom module. The custom
+        # source properties that are defined here are included in the finding JSON under
+        # `sourceProperties`.
+        # Corresponds to the JSON property `customOutput`
+        # @return [Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomOutputSpec]
+        attr_accessor :custom_output
+      
+        # Text that describes the vulnerability or misconfiguration that the custom
+        # module detects. This explanation is returned with each finding instance to
+        # help investigators understand the detected issue. The text must be enclosed in
+        # quotation marks.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+        # "Summary size limit" description: "Determines if a summary is less than 100
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+        # Requestor is owner" description: "Determines if requestor is the document
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
+        # Logic): title: "Public documents" description: "Determine whether the document
+        # should be publicly visible" expression: "document.type != 'private' &&
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+        # string" description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)" The
+        # exact variables and functions that may be referenced within an expression are
+        # determined by the service that evaluates it. See the service documentation for
+        # additional information.
+        # Corresponds to the JSON property `predicate`
+        # @return [Google::Apis::SecuritycenterV1beta1::Expr]
+        attr_accessor :predicate
+      
+        # An explanation of the recommended steps that security teams can take to
+        # resolve the detected issue. This explanation is returned with each finding
+        # generated by this module in the `nextSteps` property of the finding JSON.
+        # Corresponds to the JSON property `recommendation`
+        # @return [String]
+        attr_accessor :recommendation
+      
+        # Resource for selecting resource type.
+        # Corresponds to the JSON property `resourceSelector`
+        # @return [Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1ResourceSelector]
+        attr_accessor :resource_selector
+      
+        # The severity to assign to findings generated by the module.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @custom_output = args[:custom_output] if args.key?(:custom_output)
+          @description = args[:description] if args.key?(:description)
+          @predicate = args[:predicate] if args.key?(:predicate)
+          @recommendation = args[:recommendation] if args.key?(:recommendation)
+          @resource_selector = args[:resource_selector] if args.key?(:resource_selector)
+          @severity = args[:severity] if args.key?(:severity)
+        end
+      end
+      
+      # A set of optional name-value pairs that define custom source properties to
+      # return with each finding that is generated by the custom module. The custom
+      # source properties that are defined here are included in the finding JSON under
+      # `sourceProperties`.
+      class GoogleCloudSecuritycenterV1CustomOutputSpec
+        include Google::Apis::Core::Hashable
+      
+        # A list of custom output properties to add to the finding.
+        # Corresponds to the JSON property `properties`
+        # @return [Array<Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1Property>]
+        attr_accessor :properties
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @properties = args[:properties] if args.key?(:properties)
+        end
+      end
+      
+      # 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.
+      class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
+        include Google::Apis::Core::Hashable
+      
+        # 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.
+        # Corresponds to the JSON property `customConfig`
+        # @return [Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig]
+        attr_accessor :custom_config
+      
+        # Output only. The display name for the custom module. The name must be between
+        # 1 and 128 characters, start with a lowercase letter, and contain alphanumeric
+        # characters or underscores only.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Output only. The effective state of enablement for the module at the given
+        # level of the hierarchy.
+        # Corresponds to the JSON property `enablementState`
+        # @return [String]
+        attr_accessor :enablement_state
+      
+        # Output only. The resource name of the custom module. Its format is "
+        # organizations/`organization`/securityHealthAnalyticsSettings/
+        # effectiveCustomModules/`customModule`", or "folders/`folder`/
+        # securityHealthAnalyticsSettings/effectiveCustomModules/`customModule`", or "
+        # projects/`project`/securityHealthAnalyticsSettings/effectiveCustomModules/`
+        # customModule`"
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @custom_config = args[:custom_config] if args.key?(:custom_config)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @enablement_state = args[:enablement_state] if args.key?(:enablement_state)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Representation of third party SIEM/SOAR fields within SCC.
       class GoogleCloudSecuritycenterV1ExternalSystem
         include Google::Apis::Core::Hashable
@@ -1726,6 +1876,45 @@ module Google
         end
       end
       
+      # An individual name-value pair that defines a custom source property.
+      class GoogleCloudSecuritycenterV1Property
+        include Google::Apis::Core::Hashable
+      
+        # Name of the property for the custom output.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+        # "Summary size limit" description: "Determines if a summary is less than 100
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+        # Requestor is owner" description: "Determines if requestor is the document
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
+        # Logic): title: "Public documents" description: "Determine whether the document
+        # should be publicly visible" expression: "document.type != 'private' &&
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+        # string" description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)" The
+        # exact variables and functions that may be referenced within an expression are
+        # determined by the service that evaluates it. See the service documentation for
+        # additional information.
+        # Corresponds to the JSON property `valueExpression`
+        # @return [Google::Apis::SecuritycenterV1beta1::Expr]
+        attr_accessor :value_expression
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @value_expression = args[:value_expression] if args.key?(:value_expression)
+        end
+      end
+      
       # Information related to the Google Cloud resource.
       class GoogleCloudSecuritycenterV1Resource
         include Google::Apis::Core::Hashable
@@ -1790,6 +1979,25 @@ module Google
         end
       end
       
+      # Resource for selecting resource type.
+      class GoogleCloudSecuritycenterV1ResourceSelector
+        include Google::Apis::Core::Hashable
+      
+        # The resource types to run the detector on.
+        # Corresponds to the JSON property `resourceTypes`
+        # @return [Array<String>]
+        attr_accessor :resource_types
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_types = args[:resource_types] if args.key?(:resource_types)
+        end
+      end
+      
       # Response of asset discovery run
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         include Google::Apis::Core::Hashable
@@ -1815,6 +2023,80 @@ module Google
         end
       end
       
+      # 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.
+      class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
+        include Google::Apis::Core::Hashable
+      
+        # Output only. If empty, indicates that the custom module was created in the
+        # organization, folder, or project in which you are viewing the custom module.
+        # Otherwise, `ancestor_module` specifies the organization or folder from which
+        # the custom module is inherited.
+        # Corresponds to the JSON property `ancestorModule`
+        # @return [String]
+        attr_accessor :ancestor_module
+      
+        # 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.
+        # Corresponds to the JSON property `customConfig`
+        # @return [Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig]
+        attr_accessor :custom_config
+      
+        # The display name of the Security Health Analytics custom module. This display
+        # name becomes the finding category for all findings that are returned by this
+        # custom module. The display name must be between 1 and 128 characters, start
+        # with a lowercase letter, and contain alphanumeric characters or underscores
+        # only.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The enablement state of the custom module.
+        # Corresponds to the JSON property `enablementState`
+        # @return [String]
+        attr_accessor :enablement_state
+      
+        # Output only. The editor that last updated the custom module.
+        # Corresponds to the JSON property `lastEditor`
+        # @return [String]
+        attr_accessor :last_editor
+      
+        # 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.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The time at which the custom module was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ancestor_module = args[:ancestor_module] if args.key?(:ancestor_module)
+          @custom_config = args[:custom_config] if args.key?(:custom_config)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @enablement_state = args[:enablement_state] if args.key?(:enablement_state)
+          @last_editor = args[:last_editor] if args.key?(:last_editor)
+          @name = args[:name] if args.key?(:name)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # Security Command Center finding. A finding is a record of assessment data (
       # security, risk, health or privacy) ingested into Security Command Center for
       # presentation, notification, analysis, policy testing, and enforcement. For

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.50.0"
+      GEM_VERSION = "0.51.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230329"
+      REVISION = "20230406"
     end
   end
 end

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

@@ -220,6 +220,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1CustomConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1CustomOutputSpec
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1ExternalSystem
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -238,18 +256,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1Property
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1Resource
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1ResourceSelector
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1beta1Finding
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -918,6 +954,40 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1CustomConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :custom_output, as: 'customOutput', class: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomOutputSpec, decorator: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomOutputSpec::Representation
+      
+          property :description, as: 'description'
+          property :predicate, as: 'predicate', class: Google::Apis::SecuritycenterV1beta1::Expr, decorator: Google::Apis::SecuritycenterV1beta1::Expr::Representation
+      
+          property :recommendation, as: 'recommendation'
+          property :resource_selector, as: 'resourceSelector', class: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1ResourceSelector, decorator: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1ResourceSelector::Representation
+      
+          property :severity, as: 'severity'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1CustomOutputSpec
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :properties, as: 'properties', class: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1Property, decorator: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1Property::Representation
+      
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :custom_config, as: 'customConfig', class: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig, decorator: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig::Representation
+      
+          property :display_name, as: 'displayName'
+          property :enablement_state, as: 'enablementState'
+          property :name, as: 'name'
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1ExternalSystem
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -953,6 +1023,15 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1Property
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :value_expression, as: 'valueExpression', class: Google::Apis::SecuritycenterV1beta1::Expr, decorator: Google::Apis::SecuritycenterV1beta1::Expr::Representation
+      
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1Resource
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -968,6 +1047,13 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1ResourceSelector
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :resource_types, as: 'resourceTypes'
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -976,6 +1062,20 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ancestor_module, as: 'ancestorModule'
+          property :custom_config, as: 'customConfig', class: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig, decorator: Google::Apis::SecuritycenterV1beta1::GoogleCloudSecuritycenterV1CustomConfig::Representation
+      
+          property :display_name, as: 'displayName'
+          property :enablement_state, as: 'enablementState'
+          property :last_editor, as: 'lastEditor'
+          property :name, as: 'name'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1beta1Finding
         # @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.50.0
+  version: 0.51.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-02 00:00:00.000000000 Z
+date: 2023-04-16 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.50.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1beta1/v0.51.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1beta1
 post_install_message: 
 rdoc_options: []