google-cloud-security_center-v1 0.1.0 → 0.3.0

data/lib/google/cloud/security_center/v1/security_center/paths.rb

@@ -35,10 +35,10 @@ module Google
             # @param source [String]
             # @param finding [String]
             #
-            # @return [String]
+            # @return [::String]
             def finding_path organization:, source:, finding:
-              raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
-              raise ArgumentError, "source cannot contain /" if source.to_s.include? "/"
+              raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+              raise ::ArgumentError, "source cannot contain /" if source.to_s.include? "/"
 
               "organizations/#{organization}/sources/#{source}/findings/#{finding}"
             end
@@ -53,9 +53,9 @@ module Google
             # @param organization [String]
             # @param notification_config [String]
             #
-            # @return [String]
+            # @return [::String]
             def notification_config_path organization:, notification_config:
-              raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+              raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
 
               "organizations/#{organization}/notificationConfigs/#{notification_config}"
             end
@@ -69,7 +69,7 @@ module Google
             #
             # @param organization [String]
             #
-            # @return [String]
+            # @return [::String]
             def organization_path organization:
               "organizations/#{organization}"
             end
@@ -83,7 +83,7 @@ module Google
             #
             # @param organization [String]
             #
-            # @return [String]
+            # @return [::String]
             def organization_settings_path organization:
               "organizations/#{organization}/organizationSettings"
             end
@@ -108,24 +108,24 @@ module Google
             #   @param source [String]
             #   @param finding [String]
             #
-            # @return [String]
+            # @return [::String]
             def security_marks_path **args
               resources = {
                 "asset:organization"          => (proc do |organization:, asset:|
-                  raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
 
                   "organizations/#{organization}/assets/#{asset}/securityMarks"
                 end),
                 "finding:organization:source" => (proc do |organization:, source:, finding:|
-                  raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
-                  raise ArgumentError, "source cannot contain /" if source.to_s.include? "/"
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+                  raise ::ArgumentError, "source cannot contain /" if source.to_s.include? "/"
 
                   "organizations/#{organization}/sources/#{source}/findings/#{finding}/securityMarks"
                 end)
               }
 
               resource = resources[args.keys.sort.join(":")]
-              raise ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
               resource.call(**args)
             end
 
@@ -139,9 +139,9 @@ module Google
             # @param organization [String]
             # @param source [String]
             #
-            # @return [String]
+            # @return [::String]
             def source_path organization:, source:
-              raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+              raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
 
               "organizations/#{organization}/sources/#{source}"
             end
@@ -156,9 +156,9 @@ module Google
             # @param project [String]
             # @param topic [String]
             #
-            # @return [String]
+            # @return [::String]
             def topic_path project:, topic:
-              raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
               "projects/#{project}/topics/#{topic}"
             end

data/lib/google/cloud/security_center/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module SecurityCenter
       module V1
-        VERSION = "0.1.0"
+        VERSION = "0.3.0"
       end
     end
   end

data/lib/google/cloud/securitycenter/v1/notification_message_pb.rb

@@ -5,10 +5,12 @@ require 'google/protobuf'
 
 require 'google/api/annotations_pb'
 require 'google/cloud/securitycenter/v1/finding_pb'
+require 'google/cloud/securitycenter/v1/resource_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/securitycenter/v1/notification_message.proto", :syntax => :proto3) do
     add_message "google.cloud.securitycenter.v1.NotificationMessage" do
       optional :notification_config_name, :string, 1
+      optional :resource, :message, 3, "google.cloud.securitycenter.v1.Resource"
       oneof :event do
         optional :finding, :message, 2, "google.cloud.securitycenter.v1.Finding"
       end

data/lib/google/cloud/securitycenter/v1/resource_pb.rb

@@ -0,0 +1,27 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter/v1/resource.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/securitycenter/v1/resource.proto", :syntax => :proto3) do
+    add_message "google.cloud.securitycenter.v1.Resource" do
+      optional :name, :string, 1
+      optional :project, :string, 2
+      optional :project_display_name, :string, 3
+      optional :parent, :string, 4
+      optional :parent_display_name, :string, 5
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module SecurityCenter
+      module V1
+        Resource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.securitycenter.v1.Resource").msgclass
+      end
+    end
+  end
+end

data/proto_docs/google/api/resource.rb

@@ -128,7 +128,7 @@ module Google
     #         - pattern: "shelves/{shelf}"
     #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
     # @!attribute [rw] type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type. It must be in the format of
     #     \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
     #     singular and must not include version numbers.
@@ -140,7 +140,7 @@ module Google
     #     should use PascalCase (UpperCamelCase). The maximum number of
     #     characters allowed for the `resource_type_kind` is 100.
     # @!attribute [rw] pattern
-    #   @return [Array<String>]
+    #   @return [::Array<::String>]
     #     Optional. The relative resource name pattern associated with this resource
     #     type. The DNS prefix of the full resource name shouldn't be specified here.
     #
@@ -161,11 +161,11 @@ module Google
     #     the same component name (e.g. "project") refers to IDs of the same
     #     type of resource.
     # @!attribute [rw] name_field
-    #   @return [String]
+    #   @return [::String]
     #     Optional. The field on the resource that designates the resource name
     #     field. If omitted, this is assumed to be "name".
     # @!attribute [rw] history
-    #   @return [Google::Api::ResourceDescriptor::History]
+    #   @return [::Google::Api::ResourceDescriptor::History]
     #     Optional. The historical or future-looking state of the resource pattern.
     #
     #     Example:
@@ -182,19 +182,19 @@ module Google
     #           };
     #         }
     # @!attribute [rw] plural
-    #   @return [String]
+    #   @return [::String]
     #     The plural name used in the resource name, such as 'projects' for
     #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
     #     field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     # @!attribute [rw] singular
-    #   @return [String]
+    #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
     class ResourceDescriptor
-      include Google::Protobuf::MessageExts
-      extend Google::Protobuf::MessageExts::ClassMethods
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
 
       # A description of the historical or future-looking state of the
       # resource pattern.
@@ -216,7 +216,7 @@ module Google
     # Defines a proto annotation that describes a string field that refers to
     # an API resource.
     # @!attribute [rw] type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type that the annotated field references.
     #
     #     Example:
@@ -227,7 +227,7 @@ module Google
     #           }];
     #         }
     # @!attribute [rw] child_type
-    #   @return [String]
+    #   @return [::String]
     #     The resource type of a child collection that the annotated field
     #     references. This is useful for annotating the `parent` field that
     #     doesn't have a fixed resource type.
@@ -240,8 +240,8 @@ module Google
     #         };
     #       }
     class ResourceReference
-      include Google::Protobuf::MessageExts
-      extend Google::Protobuf::MessageExts::ClassMethods
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
     end
   end
 end

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

@@ -21,104 +21,107 @@ module Google
   module Cloud
     module SecurityCenter
       module V1
-        # Cloud Security Command Center's (Cloud SCC) representation of a Google Cloud
-        # Platform (GCP) resource.
+        # Security Command Center representation of a Google Cloud
+        # resource.
         #
-        # The Asset is a Cloud SCC resource that captures information about a single
-        # GCP resource. All modifications to an Asset are only within the context of
-        # Cloud SCC and don't affect the referenced GCP 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 context of Security Command Center and don't affect the referenced
+        # Google Cloud resource.
         # @!attribute [rw] name
-        #   @return [String]
+        #   @return [::String]
         #     The relative resource name of this asset. See:
         #     https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #     Example:
         #     "organizations/\\{organization_id}/assets/\\{asset_id}".
         # @!attribute [rw] security_center_properties
-        #   @return [Google::Cloud::SecurityCenter::V1::Asset::SecurityCenterProperties]
-        #     Cloud SCC managed properties. These properties are managed by
-        #     Cloud SCC and cannot be modified by the user.
+        #   @return [::Google::Cloud::SecurityCenter::V1::Asset::SecurityCenterProperties]
+        #     Security Command Center managed properties. These properties are managed by
+        #     Security Command Center and cannot be modified by the user.
         # @!attribute [rw] resource_properties
-        #   @return [Google::Protobuf::Map{String => Google::Protobuf::Value}]
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
         #     Resource managed properties. These properties are managed and defined by
-        #     the GCP resource and cannot be modified by the user.
+        #     the Google Cloud resource and cannot be modified by the user.
         # @!attribute [rw] security_marks
-        #   @return [Google::Cloud::SecurityCenter::V1::SecurityMarks]
+        #   @return [::Google::Cloud::SecurityCenter::V1::SecurityMarks]
         #     User specified security marks. These marks are entirely managed by the user
         #     and come from the SecurityMarks resource that belongs to the asset.
         # @!attribute [rw] create_time
-        #   @return [Google::Protobuf::Timestamp]
-        #     The time at which the asset was created in Cloud SCC.
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which the asset was created in Security Command Center.
         # @!attribute [rw] update_time
-        #   @return [Google::Protobuf::Timestamp]
-        #     The time at which the asset was last updated, added, or deleted in Cloud
-        #     SCC.
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which the asset was last updated, added, or deleted in Security
+        #     Command Center.
         # @!attribute [rw] iam_policy
-        #   @return [Google::Cloud::SecurityCenter::V1::Asset::IamPolicy]
-        #     IAM Policy information associated with the GCP resource described by the
-        #     Cloud SCC asset. This information is managed and defined by the GCP
-        #     resource and cannot be modified by the user.
+        #   @return [::Google::Cloud::SecurityCenter::V1::Asset::IamPolicy]
+        #     Cloud IAM Policy information associated with the Google Cloud resource
+        #     described by the Security Command Center asset. This information is managed
+        #     and defined by the Google Cloud resource and cannot be modified by the
+        #     user.
         class Asset
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Cloud SCC managed properties. These properties are managed by Cloud SCC and
-          # cannot be modified by the user.
+          # Security Command Center managed properties. These properties are managed by
+          # Security Command Center and cannot be modified by the user.
           # @!attribute [rw] resource_name
-          #   @return [String]
-          #     The full resource name of the GCP resource this asset
+          #   @return [::String]
+          #     The full resource name of the Google Cloud resource this asset
           #     represents. This field is immutable after create time. See:
           #     https://cloud.google.com/apis/design/resource_names#full_resource_name
           # @!attribute [rw] resource_type
-          #   @return [String]
-          #     The type of the GCP resource. Examples include: APPLICATION,
+          #   @return [::String]
+          #     The type of the Google Cloud resource. Examples include: APPLICATION,
           #     PROJECT, and ORGANIZATION. This is a case insensitive field defined by
-          #     Cloud SCC and/or the producer of the resource and is immutable
-          #     after create time.
+          #     Security Command Center and/or the producer of the resource and is
+          #     immutable after create time.
           # @!attribute [rw] resource_parent
-          #   @return [String]
+          #   @return [::String]
           #     The full resource name of the immediate parent of the resource. See:
           #     https://cloud.google.com/apis/design/resource_names#full_resource_name
           # @!attribute [rw] resource_project
-          #   @return [String]
+          #   @return [::String]
           #     The full resource name of the project the resource belongs to. See:
           #     https://cloud.google.com/apis/design/resource_names#full_resource_name
           # @!attribute [rw] resource_owners
-          #   @return [Array<String>]
+          #   @return [::Array<::String>]
           #     Owners of the Google Cloud resource.
           # @!attribute [rw] resource_display_name
-          #   @return [String]
+          #   @return [::String]
           #     The user defined display name for this resource.
           # @!attribute [rw] resource_parent_display_name
-          #   @return [String]
+          #   @return [::String]
           #     The user defined display name for the parent of this resource.
           # @!attribute [rw] resource_project_display_name
-          #   @return [String]
+          #   @return [::String]
           #     The user defined display name for the project of this resource.
           class SecurityCenterProperties
-            include Google::Protobuf::MessageExts
-            extend Google::Protobuf::MessageExts::ClassMethods
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # IAM Policy information associated with the GCP resource described by the
-          # Cloud SCC asset. This information is managed and defined by the GCP
-          # resource and cannot be modified by the user.
+          # Cloud IAM Policy information associated with the Google Cloud resource
+          # described by the Security Command Center asset. This information is managed
+          # and defined by the Google Cloud resource and cannot be modified by the
+          # user.
           # @!attribute [rw] policy_blob
-          #   @return [String]
+          #   @return [::String]
           #     The JSON representation of the Policy associated with the asset.
           #     See https://cloud.google.com/iam/reference/rest/v1/Policy for format
           #     details.
           class IamPolicy
-            include Google::Protobuf::MessageExts
-            extend Google::Protobuf::MessageExts::ClassMethods
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
           # @!attribute [rw] key
-          #   @return [String]
+          #   @return [::String]
           # @!attribute [rw] value
-          #   @return [Google::Protobuf::Value]
+          #   @return [::Google::Protobuf::Value]
           class ResourcePropertiesEntry
-            include Google::Protobuf::MessageExts
-            extend Google::Protobuf::MessageExts::ClassMethods
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
       end

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

@@ -21,77 +21,77 @@ module Google
   module Cloud
     module SecurityCenter
       module V1
-        # Cloud Security Command Center (Cloud SCC) finding.
+        # Security Command Center finding.
         #
         # A finding is a record of assessment data like security, risk, health, or
-        # privacy, that is ingested into Cloud SCC for presentation, notification,
-        # analysis, policy testing, and enforcement. For example, a
+        # privacy, that is ingested into Security Command Center for presentation,
+        # notification, analysis, policy testing, and enforcement. For example, a
         # cross-site scripting (XSS) vulnerability in an App Engine application is a
         # finding.
         # @!attribute [rw] name
-        #   @return [String]
+        #   @return [::String]
         #     The relative resource name of this finding. See:
         #     https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #     Example:
         #     "organizations/\\{organization_id}/sources/\\{source_id}/findings/\\{finding_id}"
         # @!attribute [rw] parent
-        #   @return [String]
+        #   @return [::String]
         #     The relative resource name of the source the finding belongs to. See:
         #     https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #     This field is immutable after creation time.
         #     For example:
         #     "organizations/\\{organization_id}/sources/\\{source_id}"
         # @!attribute [rw] resource_name
-        #   @return [String]
-        #     For findings on Google Cloud Platform (GCP) resources, the full resource
-        #     name of the GCP resource this finding is for. See:
+        #   @return [::String]
+        #     For findings on Google Cloud resources, the full resource
+        #     name of the Google Cloud resource this finding is for. See:
         #     https://cloud.google.com/apis/design/resource_names#full_resource_name
-        #     When the finding is for a non-GCP resource, the resourceName can be a
-        #     customer or partner defined string.
-        #     This field is immutable after creation time.
+        #     When the finding is for a non-Google Cloud resource, the resourceName can
+        #     be a customer or partner defined string. This field is immutable after
+        #     creation time.
         # @!attribute [rw] state
-        #   @return [Google::Cloud::SecurityCenter::V1::Finding::State]
+        #   @return [::Google::Cloud::SecurityCenter::V1::Finding::State]
         #     The state of the finding.
         # @!attribute [rw] category
-        #   @return [String]
+        #   @return [::String]
         #     The additional taxonomy group within findings from a given source.
         #     This field is immutable after creation time.
         #     Example: "XSS_FLASH_INJECTION"
         # @!attribute [rw] external_uri
-        #   @return [String]
-        #     The URI that, if available, points to a web page outside of Cloud SCC
-        #     where additional information about the finding can be found. This field is
-        #     guaranteed to be either empty or a well formed URL.
+        #   @return [::String]
+        #     The URI that, if available, points to a web page outside of Security
+        #     Command Center where additional information about the finding can be found.
+        #     This field is guaranteed to be either empty or a well formed URL.
         # @!attribute [rw] source_properties
-        #   @return [Google::Protobuf::Map{String => Google::Protobuf::Value}]
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
         #     Source specific properties. These properties are managed by the source
         #     that writes the finding. The key names in the source_properties map must be
         #     between 1 and 255 characters, and must start with a letter and contain
         #     alphanumeric characters or underscores only.
         # @!attribute [r] security_marks
-        #   @return [Google::Cloud::SecurityCenter::V1::SecurityMarks]
+        #   @return [::Google::Cloud::SecurityCenter::V1::SecurityMarks]
         #     Output only. User specified security marks. These marks are entirely
         #     managed by the user and come from the SecurityMarks resource that belongs
         #     to the finding.
         # @!attribute [rw] event_time
-        #   @return [Google::Protobuf::Timestamp]
+        #   @return [::Google::Protobuf::Timestamp]
         #     The time at which the event took place. 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.
         # @!attribute [rw] create_time
-        #   @return [Google::Protobuf::Timestamp]
-        #     The time at which the finding was created in Cloud SCC.
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which the finding was created in Security Command Center.
         class Finding
-          include Google::Protobuf::MessageExts
-          extend Google::Protobuf::MessageExts::ClassMethods
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # @!attribute [rw] key
-          #   @return [String]
+          #   @return [::String]
           # @!attribute [rw] value
-          #   @return [Google::Protobuf::Value]
+          #   @return [::Google::Protobuf::Value]
           class SourcePropertiesEntry
-            include Google::Protobuf::MessageExts
-            extend Google::Protobuf::MessageExts::ClassMethods
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
           # The state of the finding.