google-cloud-container_analysis-v1 0.1.0 → 0.3.0

data/proto_docs/google/devtools/containeranalysis/v1/containeranalysis.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ContainerAnalysis
+      module V1
+        # Request to get a vulnerability summary for some set of occurrences.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     The name of the project to get a vulnerability summary for in the form of
+        #     `projects/[PROJECT_ID]`.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     The filter expression.
+        class GetVulnerabilityOccurrencesSummaryRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A summary of how many vulnerability occurrences there are per resource and
+        # severity type.
+        # @!attribute [rw] counts
+        #   @return [::Array<::Google::Cloud::ContainerAnalysis::V1::VulnerabilityOccurrencesSummary::FixableTotalByDigest>]
+        #     A listing by resource of the number of fixable and total vulnerabilities.
+        class VulnerabilityOccurrencesSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Per resource and severity counts of fixable and total vulnerabilities.
+          # @!attribute [rw] resource_uri
+          #   @return [::String]
+          #     The affected resource.
+          # @!attribute [rw] severity
+          #   @return [::Grafeas::V1::Severity]
+          #     The severity for this count. SEVERITY_UNSPECIFIED indicates total across
+          #     all severities.
+          # @!attribute [rw] fixable_count
+          #   @return [::Integer]
+          #     The number of fixable vulnerabilities associated with this resource.
+          # @!attribute [rw] total_count
+          #   @return [::Integer]
+          #     The total number of vulnerabilities associated with this resource.
+          class FixableTotalByDigest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/protobuf/timestamp.rb

@@ -70,7 +70,16 @@ module Google
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
     #
-    # Example 5: Compute Timestamp from current time in Python.
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    #
+    # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
     #     timestamp.GetCurrentTime()

data/proto_docs/grafeas/v1/common.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Grafeas
+  module V1
+    # Metadata for any related URL information.
+    # @!attribute [rw] url
+    #   @return [::String]
+    #     Specific URL associated with the resource.
+    # @!attribute [rw] label
+    #   @return [::String]
+    #     Label to describe usage of the URL.
+    class RelatedUrl
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Verifiers (e.g. Kritis implementations) MUST verify signatures
+    # with respect to the trust anchors defined in policy (e.g. a Kritis policy).
+    # Typically this means that the verifier has been configured with a map from
+    # `public_key_id` to public key material (and any required parameters, e.g.
+    # signing algorithm).
+    #
+    # In particular, verification implementations MUST NOT treat the signature
+    # `public_key_id` as anything more than a key lookup hint. The `public_key_id`
+    # DOES NOT validate or authenticate a public key; it only provides a mechanism
+    # for quickly selecting a public key ALREADY CONFIGURED on the verifier through
+    # a trusted channel. Verification implementations MUST reject signatures in any
+    # of the following circumstances:
+    #   * The `public_key_id` is not recognized by the verifier.
+    #   * The public key that `public_key_id` refers to does not verify the
+    #     signature with respect to the payload.
+    #
+    # The `signature` contents SHOULD NOT be "attached" (where the payload is
+    # included with the serialized `signature` bytes). Verifiers MUST ignore any
+    # "attached" payload and only verify signatures with respect to explicitly
+    # provided payload (e.g. a `payload` field on the proto message that holds
+    # this Signature, or the canonical serialization of the proto message that
+    # holds this signature).
+    # @!attribute [rw] signature
+    #   @return [::String]
+    #     The content of the signature, an opaque bytestring.
+    #     The payload that this signature verifies MUST be unambiguously provided
+    #     with the Signature during verification. A wrapper message might provide
+    #     the payload explicitly. Alternatively, a message might have a canonical
+    #     serialization that can always be unambiguously computed to derive the
+    #     payload.
+    # @!attribute [rw] public_key_id
+    #   @return [::String]
+    #     The identifier for the public key that verifies this signature.
+    #       * The `public_key_id` is required.
+    #       * The `public_key_id` MUST be an RFC3986 conformant URI.
+    #       * When possible, the `public_key_id` SHOULD be an immutable reference,
+    #         such as a cryptographic digest.
+    #
+    #     Examples of valid `public_key_id`s:
+    #
+    #     OpenPGP V4 public key fingerprint:
+    #       * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
+    #     See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
+    #     details on this scheme.
+    #
+    #     RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
+    #     serialization):
+    #       * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
+    #       * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
+    class Signature
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Kind represents the kinds of notes supported.
+    module NoteKind
+      # Unknown.
+      NOTE_KIND_UNSPECIFIED = 0
+
+      # The note and occurrence represent a package vulnerability.
+      VULNERABILITY = 1
+
+      # The note and occurrence assert build provenance.
+      BUILD = 2
+
+      # This represents an image basis relationship.
+      IMAGE = 3
+
+      # This represents a package installed via a package manager.
+      PACKAGE = 4
+
+      # The note and occurrence track deployment events.
+      DEPLOYMENT = 5
+
+      # The note and occurrence track the initial discovery status of a resource.
+      DISCOVERY = 6
+
+      # This represents a logical "role" that can attest to artifacts.
+      ATTESTATION = 7
+
+      # This represents an available package upgrade.
+      UPGRADE = 8
+    end
+  end
+end

data/proto_docs/grafeas/v1/cvss.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Grafeas
+  module V1
+    # Common Vulnerability Scoring System version 3.
+    # For details, see https://www.first.org/cvss/specification-document
+    # @!attribute [rw] base_score
+    #   @return [::Float]
+    #     The base score is a function of the base metric scores.
+    # @!attribute [rw] exploitability_score
+    #   @return [::Float]
+    # @!attribute [rw] impact_score
+    #   @return [::Float]
+    # @!attribute [rw] attack_vector
+    #   @return [::Grafeas::V1::CVSSv3::AttackVector]
+    #     Base Metrics
+    #     Represents the intrinsic characteristics of a vulnerability that are
+    #     constant over time and across user environments.
+    # @!attribute [rw] attack_complexity
+    #   @return [::Grafeas::V1::CVSSv3::AttackComplexity]
+    # @!attribute [rw] privileges_required
+    #   @return [::Grafeas::V1::CVSSv3::PrivilegesRequired]
+    # @!attribute [rw] user_interaction
+    #   @return [::Grafeas::V1::CVSSv3::UserInteraction]
+    # @!attribute [rw] scope
+    #   @return [::Grafeas::V1::CVSSv3::Scope]
+    # @!attribute [rw] confidentiality_impact
+    #   @return [::Grafeas::V1::CVSSv3::Impact]
+    # @!attribute [rw] integrity_impact
+    #   @return [::Grafeas::V1::CVSSv3::Impact]
+    # @!attribute [rw] availability_impact
+    #   @return [::Grafeas::V1::CVSSv3::Impact]
+    class CVSSv3
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      module AttackVector
+        ATTACK_VECTOR_UNSPECIFIED = 0
+
+        ATTACK_VECTOR_NETWORK = 1
+
+        ATTACK_VECTOR_ADJACENT = 2
+
+        ATTACK_VECTOR_LOCAL = 3
+
+        ATTACK_VECTOR_PHYSICAL = 4
+      end
+
+      module AttackComplexity
+        ATTACK_COMPLEXITY_UNSPECIFIED = 0
+
+        ATTACK_COMPLEXITY_LOW = 1
+
+        ATTACK_COMPLEXITY_HIGH = 2
+      end
+
+      module PrivilegesRequired
+        PRIVILEGES_REQUIRED_UNSPECIFIED = 0
+
+        PRIVILEGES_REQUIRED_NONE = 1
+
+        PRIVILEGES_REQUIRED_LOW = 2
+
+        PRIVILEGES_REQUIRED_HIGH = 3
+      end
+
+      module UserInteraction
+        USER_INTERACTION_UNSPECIFIED = 0
+
+        USER_INTERACTION_NONE = 1
+
+        USER_INTERACTION_REQUIRED = 2
+      end
+
+      module Scope
+        SCOPE_UNSPECIFIED = 0
+
+        SCOPE_UNCHANGED = 1
+
+        SCOPE_CHANGED = 2
+      end
+
+      module Impact
+        IMPACT_UNSPECIFIED = 0
+
+        IMPACT_HIGH = 1
+
+        IMPACT_LOW = 2
+
+        IMPACT_NONE = 3
+      end
+    end
+  end
+end

data/proto_docs/grafeas/v1/package.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Grafeas
+  module V1
+    # This represents a particular channel of distribution for a given package.
+    # E.g., Debian's jessie-backports dpkg mirror.
+    # @!attribute [rw] cpe_uri
+    #   @return [::String]
+    #     Required. The cpe_uri in [CPE format](https://cpe.mitre.org/specification/)
+    #     denoting the package manager version distributing a package.
+    # @!attribute [rw] architecture
+    #   @return [::Grafeas::V1::Architecture]
+    #     The CPU architecture for which packages in this distribution channel were
+    #     built.
+    # @!attribute [rw] latest_version
+    #   @return [::Grafeas::V1::Version]
+    #     The latest available version of this package in this distribution channel.
+    # @!attribute [rw] maintainer
+    #   @return [::String]
+    #     A freeform string denoting the maintainer of this package.
+    # @!attribute [rw] url
+    #   @return [::String]
+    #     The distribution channel-specific homepage for this package.
+    # @!attribute [rw] description
+    #   @return [::String]
+    #     The distribution channel-specific description of this package.
+    class Distribution
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # An occurrence of a particular package installation found within a system's
+    # filesystem. E.g., glibc was found in `/var/lib/dpkg/status`.
+    # @!attribute [rw] cpe_uri
+    #   @return [::String]
+    #     Required. The CPE URI in [CPE format](https://cpe.mitre.org/specification/)
+    #     denoting the package manager version distributing a package.
+    # @!attribute [rw] version
+    #   @return [::Grafeas::V1::Version]
+    #     The version installed at this location.
+    # @!attribute [rw] path
+    #   @return [::String]
+    #     The path from which we gathered that this package/version is installed.
+    class Location
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # This represents a particular package that is distributed over various
+    # channels. E.g., glibc (aka libc6) is distributed by many, at various
+    # versions.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     Required. Immutable. The name of the package.
+    # @!attribute [rw] distribution
+    #   @return [::Array<::Grafeas::V1::Distribution>]
+    #     The various channels by which a package is distributed.
+    class PackageNote
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Details on how a particular software package was installed on a system.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     Output only. The name of the installed package.
+    # @!attribute [rw] location
+    #   @return [::Array<::Grafeas::V1::Location>]
+    #     Required. All of the places within the filesystem versions of this package
+    #     have been found.
+    class PackageOccurrence
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Version contains structured information about the version of a package.
+    # @!attribute [rw] epoch
+    #   @return [::Integer]
+    #     Used to correct mistakes in the version numbering scheme.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     Required only when version kind is NORMAL. The main part of the version
+    #     name.
+    # @!attribute [rw] revision
+    #   @return [::String]
+    #     The iteration of the package build from the above version.
+    # @!attribute [rw] kind
+    #   @return [::Grafeas::V1::Version::VersionKind]
+    #     Required. Distinguishes between sentinel MIN/MAX versions and normal
+    #     versions.
+    # @!attribute [rw] full_name
+    #   @return [::String]
+    #     Human readable version string. This string is of the form
+    #     <epoch>:<name>-<revision> and is only set when kind is NORMAL.
+    class Version
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Whether this is an ordinary package version or a sentinel MIN/MAX version.
+      module VersionKind
+        # Unknown.
+        VERSION_KIND_UNSPECIFIED = 0
+
+        # A standard package version.
+        NORMAL = 1
+
+        # A special version representing negative infinity.
+        MINIMUM = 2
+
+        # A special version representing positive infinity.
+        MAXIMUM = 3
+      end
+    end
+
+    # Instruction set architectures supported by various package managers.
+    module Architecture
+      # Unknown architecture.
+      ARCHITECTURE_UNSPECIFIED = 0
+
+      # X86 architecture.
+      X86 = 1
+
+      # X64 architecture.
+      X64 = 2
+    end
+  end
+end