2019-01-09 00:36:31 +00:00
|
|
|
# Copyright 2015 Google Inc.
|
|
|
|
#
|
|
|
|
# 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
|
|
|
|
#
|
|
|
|
# http://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.
|
|
|
|
|
|
|
|
require 'date'
|
|
|
|
require 'google/apis/core/base_service'
|
|
|
|
require 'google/apis/core/json_representation'
|
|
|
|
require 'google/apis/core/hashable'
|
|
|
|
require 'google/apis/errors'
|
|
|
|
|
|
|
|
module Google
|
|
|
|
module Apis
|
|
|
|
module ContaineranalysisV1beta1
|
|
|
|
|
|
|
|
# An alias to a repo revision.
|
|
|
|
class AliasContext
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The alias kind.
|
|
|
|
# Corresponds to the JSON property `kind`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :kind
|
|
|
|
|
|
|
|
# The alias name.
|
|
|
|
# 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)
|
|
|
|
@kind = args[:kind] if args.key?(:kind)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Artifact describes a build product.
|
|
|
|
class Artifact
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Hash or checksum value of a binary, or Docker Registry 2.0 digest of a
|
|
|
|
# container.
|
|
|
|
# Corresponds to the JSON property `checksum`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :checksum
|
|
|
|
|
|
|
|
# Artifact ID, if any; for container images, this will be a URL by digest
|
|
|
|
# like `gcr.io/projectID/imagename@sha256:123456`.
|
|
|
|
# Corresponds to the JSON property `id`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :id
|
|
|
|
|
|
|
|
# Related artifact names. This may be the path to a binary or jar file, or in
|
|
|
|
# the case of a container build, the name used to push the container image to
|
|
|
|
# Google Container Registry, as presented to `docker push`. Note that a
|
|
|
|
# single Artifact ID can have multiple names, for example if two tags are
|
|
|
|
# applied to one image.
|
|
|
|
# Corresponds to the JSON property `names`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :names
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@checksum = args[:checksum] if args.key?(:checksum)
|
|
|
|
@id = args[:id] if args.key?(:id)
|
|
|
|
@names = args[:names] if args.key?(:names)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# Defines a hash object for use in Materials and Products.
|
|
|
|
class ArtifactHashes
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `sha256`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :sha256
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@sha256 = args[:sha256] if args.key?(:sha256)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Defines an object to declare an in-toto artifact rule
|
|
|
|
class ArtifactRule
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `artifactRule`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :artifact_rule
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@artifact_rule = args[:artifact_rule] if args.key?(:artifact_rule)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Occurrence that represents a single "attestation". The authenticity of an
|
|
|
|
# attestation can be verified using the attached signature. If the verifier
|
|
|
|
# trusts the public key of the signer, then verifying the signature is
|
|
|
|
# sufficient to establish trust. In this circumstance, the authority to which
|
|
|
|
# this attestation is attached is primarily useful for look-up (how to find
|
|
|
|
# this attestation if you already know the authority and artifact to be
|
|
|
|
# verified) and intent (which authority was this attestation intended to sign
|
|
|
|
# for).
|
|
|
|
class Attestation
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-03-21 00:37:30 +00:00
|
|
|
# An attestation wrapper that uses the Grafeas `Signature` message.
|
2019-04-25 00:37:02 +00:00
|
|
|
# This attestation must define the `serialized_payload` that the `signatures`
|
|
|
|
# verify and any metadata necessary to interpret that plaintext. The
|
|
|
|
# signatures should always be over the `serialized_payload` bytestring.
|
2019-03-21 00:37:30 +00:00
|
|
|
# Corresponds to the JSON property `genericSignedAttestation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GenericSignedAttestation]
|
|
|
|
attr_accessor :generic_signed_attestation
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# An attestation wrapper with a PGP-compatible signature. This message only
|
|
|
|
# supports `ATTACHED` signatures, where the payload that is signed is included
|
|
|
|
# alongside the signature itself in the same file.
|
|
|
|
# Corresponds to the JSON property `pgpSignedAttestation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::PgpSignedAttestation]
|
|
|
|
attr_accessor :pgp_signed_attestation
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
2019-03-21 00:37:30 +00:00
|
|
|
@generic_signed_attestation = args[:generic_signed_attestation] if args.key?(:generic_signed_attestation)
|
2019-01-09 00:36:31 +00:00
|
|
|
@pgp_signed_attestation = args[:pgp_signed_attestation] if args.key?(:pgp_signed_attestation)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Note kind that represents a logical attestation "role" or "authority". For
|
|
|
|
# example, an organization might have one `Authority` for "QA" and one for
|
|
|
|
# "build". This note is intended to act strictly as a grouping mechanism for
|
|
|
|
# the attached occurrences (Attestations). This grouping mechanism also
|
|
|
|
# provides a security boundary, since IAM ACLs gate the ability for a principle
|
|
|
|
# to attach an occurrence to a given note. It also provides a single point of
|
|
|
|
# lookup to find all attached attestation occurrences, even if they don't all
|
|
|
|
# live in the same project.
|
|
|
|
class Authority
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# This submessage provides human-readable hints about the purpose of the
|
|
|
|
# authority. Because the name of a note acts as its resource reference, it is
|
|
|
|
# important to disambiguate the canonical name of the Note (which might be a
|
|
|
|
# UUID for security purposes) from "readable" names more suitable for debug
|
|
|
|
# output. Note that these hints should not be used to look up authorities in
|
|
|
|
# security sensitive contexts, such as when looking up attestations to
|
|
|
|
# verify.
|
|
|
|
# Corresponds to the JSON property `hint`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Hint]
|
|
|
|
attr_accessor :hint
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@hint = args[:hint] if args.key?(:hint)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Basis describes the base image portion (Note) of the DockerImage
|
|
|
|
# relationship. Linked occurrences are derived from this or an
|
|
|
|
# equivalent image via:
|
|
|
|
# FROM <Basis.resource_url>
|
|
|
|
# Or an equivalent reference, e.g. a tag of the resource_url.
|
|
|
|
class Basis
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# A set of properties that uniquely identify a given Docker image.
|
|
|
|
# Corresponds to the JSON property `fingerprint`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Fingerprint]
|
|
|
|
attr_accessor :fingerprint
|
|
|
|
|
|
|
|
# Required. Immutable. The resource_url for the resource representing the
|
|
|
|
# basis of associated occurrence images.
|
|
|
|
# Corresponds to the JSON property `resourceUrl`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :resource_url
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@fingerprint = args[:fingerprint] if args.key?(:fingerprint)
|
|
|
|
@resource_url = args[:resource_url] if args.key?(:resource_url)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Request to create notes in batch.
|
|
|
|
class BatchCreateNotesRequest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-12-12 00:37:33 +00:00
|
|
|
# Required. The notes to create. Max allowed length is 1000.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `notes`
|
|
|
|
# @return [Hash<String,Google::Apis::ContaineranalysisV1beta1::Note>]
|
|
|
|
attr_accessor :notes
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@notes = args[:notes] if args.key?(:notes)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response for creating notes in batch.
|
|
|
|
class BatchCreateNotesResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The notes that were created.
|
|
|
|
# Corresponds to the JSON property `notes`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Note>]
|
|
|
|
attr_accessor :notes
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@notes = args[:notes] if args.key?(:notes)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Request to create occurrences in batch.
|
|
|
|
class BatchCreateOccurrencesRequest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-12-12 00:37:33 +00:00
|
|
|
# Required. The occurrences to create. Max allowed length is 1000.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `occurrences`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Occurrence>]
|
|
|
|
attr_accessor :occurrences
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@occurrences = args[:occurrences] if args.key?(:occurrences)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response for creating occurrences in batch.
|
|
|
|
class BatchCreateOccurrencesResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The occurrences that were created.
|
|
|
|
# Corresponds to the JSON property `occurrences`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Occurrence>]
|
|
|
|
attr_accessor :occurrences
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@occurrences = args[:occurrences] if args.key?(:occurrences)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Associates `members` with a `role`.
|
|
|
|
class Binding
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# 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.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `condition`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Expr]
|
|
|
|
attr_accessor :condition
|
|
|
|
|
|
|
|
# Specifies the identities requesting access for a Cloud Platform resource.
|
|
|
|
# `members` can have the following values:
|
|
|
|
# * `allUsers`: A special identifier that represents anyone who is
|
|
|
|
# on the internet; with or without a Google account.
|
|
|
|
# * `allAuthenticatedUsers`: A special identifier that represents anyone
|
|
|
|
# who is authenticated with a Google account or a service account.
|
|
|
|
# * `user:`emailid``: An email address that represents a specific Google
|
2019-08-10 00:38:10 +00:00
|
|
|
# account. For example, `alice@example.com` .
|
2019-01-09 00:36:31 +00:00
|
|
|
# * `serviceAccount:`emailid``: An email address that represents a service
|
|
|
|
# account. For example, `my-other-app@appspot.gserviceaccount.com`.
|
|
|
|
# * `group:`emailid``: An email address that represents a Google group.
|
|
|
|
# For example, `admins@example.com`.
|
2019-12-12 00:37:33 +00:00
|
|
|
# * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
|
|
|
|
# identifier) representing a user that has been recently deleted. For
|
|
|
|
# example, `alice@example.com?uid=123456789012345678901`. If the user is
|
|
|
|
# recovered, this value reverts to `user:`emailid`` and the recovered user
|
|
|
|
# retains the role in the binding.
|
|
|
|
# * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
|
|
|
|
# unique identifier) representing a service account that has been recently
|
|
|
|
# deleted. For example,
|
|
|
|
# `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
|
|
|
|
# If the service account is undeleted, this value reverts to
|
|
|
|
# `serviceAccount:`emailid`` and the undeleted service account retains the
|
|
|
|
# role in the binding.
|
|
|
|
# * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
|
|
|
|
# identifier) representing a Google group that has been recently
|
|
|
|
# deleted. For example, `admins@example.com?uid=123456789012345678901`. If
|
|
|
|
# the group is recovered, this value reverts to `group:`emailid`` and the
|
|
|
|
# recovered group retains the role in the binding.
|
2019-03-01 00:37:10 +00:00
|
|
|
# * `domain:`domain``: The G Suite domain (primary) that represents all the
|
2019-01-09 00:36:31 +00:00
|
|
|
# users of that domain. For example, `google.com` or `example.com`.
|
|
|
|
# Corresponds to the JSON property `members`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :members
|
|
|
|
|
|
|
|
# Role that is assigned to `members`.
|
|
|
|
# For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
|
|
|
|
# Corresponds to the JSON property `role`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :role
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@condition = args[:condition] if args.key?(:condition)
|
|
|
|
@members = args[:members] if args.key?(:members)
|
|
|
|
@role = args[:role] if args.key?(:role)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Note holding the version of the provider's builder and the signature of the
|
|
|
|
# provenance message in the build details occurrence.
|
|
|
|
class Build
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. Immutable. Version of the builder which produced this build.
|
|
|
|
# Corresponds to the JSON property `builderVersion`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :builder_version
|
|
|
|
|
|
|
|
# Message encapsulating the signature of the verified build.
|
|
|
|
# Corresponds to the JSON property `signature`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::BuildSignature]
|
|
|
|
attr_accessor :signature
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@builder_version = args[:builder_version] if args.key?(:builder_version)
|
|
|
|
@signature = args[:signature] if args.key?(:signature)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Provenance of a build. Contains all information needed to verify the full
|
|
|
|
# details about the build from source to completion.
|
|
|
|
class BuildProvenance
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Special options applied to this build. This is a catch-all field where
|
|
|
|
# build providers can enter any desired additional details.
|
|
|
|
# Corresponds to the JSON property `buildOptions`
|
|
|
|
# @return [Hash<String,String>]
|
|
|
|
attr_accessor :build_options
|
|
|
|
|
|
|
|
# Version string of the builder at the time this build was executed.
|
|
|
|
# Corresponds to the JSON property `builderVersion`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :builder_version
|
|
|
|
|
|
|
|
# Output of the build.
|
|
|
|
# Corresponds to the JSON property `builtArtifacts`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Artifact>]
|
|
|
|
attr_accessor :built_artifacts
|
|
|
|
|
|
|
|
# Commands requested by the build.
|
|
|
|
# Corresponds to the JSON property `commands`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Command>]
|
|
|
|
attr_accessor :commands
|
|
|
|
|
|
|
|
# Time at which the build was created.
|
|
|
|
# Corresponds to the JSON property `createTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :create_time
|
|
|
|
|
|
|
|
# E-mail address of the user who initiated this build. Note that this was the
|
|
|
|
# user's e-mail address at the time the build was initiated; this address may
|
|
|
|
# not represent the same end-user for all time.
|
|
|
|
# Corresponds to the JSON property `creator`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :creator
|
|
|
|
|
|
|
|
# Time at which execution of the build was finished.
|
|
|
|
# Corresponds to the JSON property `endTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :end_time
|
|
|
|
|
|
|
|
# Required. Unique identifier of the build.
|
|
|
|
# Corresponds to the JSON property `id`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :id
|
|
|
|
|
|
|
|
# URI where any logs for this provenance were written.
|
|
|
|
# Corresponds to the JSON property `logsUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :logs_uri
|
|
|
|
|
|
|
|
# ID of the project.
|
|
|
|
# Corresponds to the JSON property `projectId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :project_id
|
|
|
|
|
|
|
|
# Source describes the location of the source used for the build.
|
|
|
|
# Corresponds to the JSON property `sourceProvenance`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Source]
|
|
|
|
attr_accessor :source_provenance
|
|
|
|
|
|
|
|
# Time at which execution of the build was started.
|
|
|
|
# Corresponds to the JSON property `startTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :start_time
|
|
|
|
|
|
|
|
# Trigger identifier if the build was triggered automatically; empty if not.
|
|
|
|
# Corresponds to the JSON property `triggerId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :trigger_id
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@build_options = args[:build_options] if args.key?(:build_options)
|
|
|
|
@builder_version = args[:builder_version] if args.key?(:builder_version)
|
|
|
|
@built_artifacts = args[:built_artifacts] if args.key?(:built_artifacts)
|
|
|
|
@commands = args[:commands] if args.key?(:commands)
|
|
|
|
@create_time = args[:create_time] if args.key?(:create_time)
|
|
|
|
@creator = args[:creator] if args.key?(:creator)
|
|
|
|
@end_time = args[:end_time] if args.key?(:end_time)
|
|
|
|
@id = args[:id] if args.key?(:id)
|
|
|
|
@logs_uri = args[:logs_uri] if args.key?(:logs_uri)
|
|
|
|
@project_id = args[:project_id] if args.key?(:project_id)
|
|
|
|
@source_provenance = args[:source_provenance] if args.key?(:source_provenance)
|
|
|
|
@start_time = args[:start_time] if args.key?(:start_time)
|
|
|
|
@trigger_id = args[:trigger_id] if args.key?(:trigger_id)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Message encapsulating the signature of the verified build.
|
|
|
|
class BuildSignature
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# An ID for the key used to sign. This could be either an ID for the key
|
|
|
|
# stored in `public_key` (such as the ID or fingerprint for a PGP key, or the
|
|
|
|
# CN for a cert), or a reference to an external key (such as a reference to a
|
|
|
|
# key in Cloud Key Management Service).
|
|
|
|
# Corresponds to the JSON property `keyId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :key_id
|
|
|
|
|
|
|
|
# The type of the key, either stored in `public_key` or referenced in
|
|
|
|
# `key_id`.
|
|
|
|
# Corresponds to the JSON property `keyType`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :key_type
|
|
|
|
|
|
|
|
# Public key of the builder which can be used to verify that the related
|
|
|
|
# findings are valid and unchanged. If `key_type` is empty, this defaults
|
|
|
|
# to PEM encoded public keys.
|
|
|
|
# This field may be empty if `key_id` references an external key.
|
|
|
|
# For Cloud Build based signatures, this is a PEM encoded public
|
|
|
|
# key. To verify the Cloud Build signature, place the contents of
|
|
|
|
# this field into a file (public.pem). The signature field is base64-decoded
|
|
|
|
# into its binary representation in signature.bin, and the provenance bytes
|
|
|
|
# from `BuildDetails` are base64-decoded into a binary representation in
|
|
|
|
# signed.bin. OpenSSL can then verify the signature:
|
|
|
|
# `openssl sha256 -verify public.pem -signature signature.bin signed.bin`
|
|
|
|
# Corresponds to the JSON property `publicKey`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :public_key
|
|
|
|
|
|
|
|
# Required. Signature of the related `BuildProvenance`. In JSON, this is
|
|
|
|
# base-64 encoded.
|
|
|
|
# Corresponds to the JSON property `signature`
|
|
|
|
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :signature
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@key_id = args[:key_id] if args.key?(:key_id)
|
|
|
|
@key_type = args[:key_type] if args.key?(:key_type)
|
|
|
|
@public_key = args[:public_key] if args.key?(:public_key)
|
|
|
|
@signature = args[:signature] if args.key?(:signature)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# Defines an object for the byproducts field in in-toto links. The suggested
|
|
|
|
# fields are "stderr", "stdout", and "return-value".
|
|
|
|
class ByProducts
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `customValues`
|
|
|
|
# @return [Hash<String,String>]
|
|
|
|
attr_accessor :custom_values
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@custom_values = args[:custom_values] if args.key?(:custom_values)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-04-25 00:37:02 +00:00
|
|
|
# Common Vulnerability Scoring System version 3.
|
|
|
|
# For details, see https://www.first.org/cvss/specification-document
|
|
|
|
class CvsSv3
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `attackComplexity`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :attack_complexity
|
|
|
|
|
|
|
|
# Base Metrics
|
|
|
|
# Represents the intrinsic characteristics of a vulnerability that are
|
|
|
|
# constant over time and across user environments.
|
|
|
|
# Corresponds to the JSON property `attackVector`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :attack_vector
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `availabilityImpact`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :availability_impact
|
|
|
|
|
|
|
|
# The base score is a function of the base metric scores.
|
|
|
|
# Corresponds to the JSON property `baseScore`
|
|
|
|
# @return [Float]
|
|
|
|
attr_accessor :base_score
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `confidentialityImpact`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :confidentiality_impact
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `exploitabilityScore`
|
|
|
|
# @return [Float]
|
|
|
|
attr_accessor :exploitability_score
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `impactScore`
|
|
|
|
# @return [Float]
|
|
|
|
attr_accessor :impact_score
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `integrityImpact`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :integrity_impact
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `privilegesRequired`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :privileges_required
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `scope`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :scope
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `userInteraction`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :user_interaction
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@attack_complexity = args[:attack_complexity] if args.key?(:attack_complexity)
|
|
|
|
@attack_vector = args[:attack_vector] if args.key?(:attack_vector)
|
|
|
|
@availability_impact = args[:availability_impact] if args.key?(:availability_impact)
|
|
|
|
@base_score = args[:base_score] if args.key?(:base_score)
|
|
|
|
@confidentiality_impact = args[:confidentiality_impact] if args.key?(:confidentiality_impact)
|
|
|
|
@exploitability_score = args[:exploitability_score] if args.key?(:exploitability_score)
|
|
|
|
@impact_score = args[:impact_score] if args.key?(:impact_score)
|
|
|
|
@integrity_impact = args[:integrity_impact] if args.key?(:integrity_impact)
|
|
|
|
@privileges_required = args[:privileges_required] if args.key?(:privileges_required)
|
|
|
|
@scope = args[:scope] if args.key?(:scope)
|
|
|
|
@user_interaction = args[:user_interaction] if args.key?(:user_interaction)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# A CloudRepoSourceContext denotes a particular revision in a Google Cloud
|
|
|
|
# Source Repo.
|
|
|
|
class CloudRepoSourceContext
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# An alias to a repo revision.
|
|
|
|
# Corresponds to the JSON property `aliasContext`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::AliasContext]
|
|
|
|
attr_accessor :alias_context
|
|
|
|
|
|
|
|
# A unique identifier for a Cloud Repo.
|
|
|
|
# Corresponds to the JSON property `repoId`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::RepoId]
|
|
|
|
attr_accessor :repo_id
|
|
|
|
|
|
|
|
# A revision ID.
|
|
|
|
# Corresponds to the JSON property `revisionId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :revision_id
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@alias_context = args[:alias_context] if args.key?(:alias_context)
|
|
|
|
@repo_id = args[:repo_id] if args.key?(:repo_id)
|
|
|
|
@revision_id = args[:revision_id] if args.key?(:revision_id)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Command describes a step performed as part of the build pipeline.
|
|
|
|
class Command
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Command-line arguments used when executing this command.
|
|
|
|
# Corresponds to the JSON property `args`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :args
|
|
|
|
|
|
|
|
# Working directory (relative to project source root) used when running this
|
|
|
|
# command.
|
|
|
|
# Corresponds to the JSON property `dir`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :dir
|
|
|
|
|
|
|
|
# Environment variables set before running this command.
|
|
|
|
# Corresponds to the JSON property `env`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :env
|
|
|
|
|
|
|
|
# Optional unique identifier for this command, used in wait_for to reference
|
|
|
|
# this command as a dependency.
|
|
|
|
# Corresponds to the JSON property `id`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :id
|
|
|
|
|
|
|
|
# Required. Name of the command, as presented on the command line, or if the
|
|
|
|
# command is packaged as a Docker container, as presented to `docker pull`.
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# The ID(s) of the command(s) that this command depends on.
|
|
|
|
# Corresponds to the JSON property `waitFor`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :wait_for
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@args = args[:args] if args.key?(:args)
|
|
|
|
@dir = args[:dir] if args.key?(:dir)
|
|
|
|
@env = args[:env] if args.key?(:env)
|
|
|
|
@id = args[:id] if args.key?(:id)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@wait_for = args[:wait_for] if args.key?(:wait_for)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# An artifact that can be deployed in some runtime.
|
|
|
|
class Deployable
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. Resource URI for the artifact being deployed.
|
|
|
|
# Corresponds to the JSON property `resourceUri`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :resource_uri
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@resource_uri = args[:resource_uri] if args.key?(:resource_uri)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# The period during which some deployable was active in a runtime.
|
|
|
|
class Deployment
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Address of the runtime element hosting this deployment.
|
|
|
|
# Corresponds to the JSON property `address`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :address
|
|
|
|
|
|
|
|
# Configuration used to create this deployment.
|
|
|
|
# Corresponds to the JSON property `config`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :config
|
|
|
|
|
|
|
|
# Required. Beginning of the lifetime of this deployment.
|
|
|
|
# Corresponds to the JSON property `deployTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :deploy_time
|
|
|
|
|
|
|
|
# Platform hosting this deployment.
|
|
|
|
# Corresponds to the JSON property `platform`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :platform
|
|
|
|
|
|
|
|
# Output only. Resource URI for the artifact being deployed taken from
|
|
|
|
# the deployable field with the same name.
|
|
|
|
# Corresponds to the JSON property `resourceUri`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :resource_uri
|
|
|
|
|
|
|
|
# End of the lifetime of this deployment.
|
|
|
|
# Corresponds to the JSON property `undeployTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :undeploy_time
|
|
|
|
|
|
|
|
# Identity of the user that triggered this deployment.
|
|
|
|
# Corresponds to the JSON property `userEmail`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :user_email
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@address = args[:address] if args.key?(:address)
|
|
|
|
@config = args[:config] if args.key?(:config)
|
|
|
|
@deploy_time = args[:deploy_time] if args.key?(:deploy_time)
|
|
|
|
@platform = args[:platform] if args.key?(:platform)
|
|
|
|
@resource_uri = args[:resource_uri] if args.key?(:resource_uri)
|
|
|
|
@undeploy_time = args[:undeploy_time] if args.key?(:undeploy_time)
|
|
|
|
@user_email = args[:user_email] if args.key?(:user_email)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Derived describes the derived image portion (Occurrence) of the DockerImage
|
|
|
|
# relationship. This image would be produced from a Dockerfile with FROM
|
|
|
|
# <DockerImage.Basis in attached Note>.
|
|
|
|
class Derived
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Output only. This contains the base image URL for the derived image
|
|
|
|
# occurrence.
|
|
|
|
# Corresponds to the JSON property `baseResourceUrl`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :base_resource_url
|
|
|
|
|
|
|
|
# Output only. The number of layers by which this image differs from the
|
|
|
|
# associated image basis.
|
|
|
|
# Corresponds to the JSON property `distance`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :distance
|
|
|
|
|
|
|
|
# A set of properties that uniquely identify a given Docker image.
|
|
|
|
# Corresponds to the JSON property `fingerprint`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Fingerprint]
|
|
|
|
attr_accessor :fingerprint
|
|
|
|
|
|
|
|
# This contains layer-specific metadata, if populated it has length
|
|
|
|
# "distance" and is ordered with [distance] being the layer immediately
|
|
|
|
# following the base image and [1] being the final layer.
|
|
|
|
# Corresponds to the JSON property `layerInfo`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Layer>]
|
|
|
|
attr_accessor :layer_info
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@base_resource_url = args[:base_resource_url] if args.key?(:base_resource_url)
|
|
|
|
@distance = args[:distance] if args.key?(:distance)
|
|
|
|
@fingerprint = args[:fingerprint] if args.key?(:fingerprint)
|
|
|
|
@layer_info = args[:layer_info] if args.key?(:layer_info)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Identifies all appearances of this vulnerability in the package for a
|
|
|
|
# specific distro/location. For example: glibc in
|
|
|
|
# cpe:/o:debian:debian_linux:8 for versions 2.1 - 2.2
|
|
|
|
class Detail
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The CPE URI in
|
|
|
|
# [cpe format](https://cpe.mitre.org/specification/) in which the
|
|
|
|
# vulnerability manifests. Examples include distro or storage location for
|
|
|
|
# vulnerable jar.
|
|
|
|
# Corresponds to the JSON property `cpeUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :cpe_uri
|
|
|
|
|
|
|
|
# A vendor-specific description of this note.
|
|
|
|
# Corresponds to the JSON property `description`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :description
|
|
|
|
|
|
|
|
# The location of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `fixedLocation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::VulnerabilityLocation]
|
|
|
|
attr_accessor :fixed_location
|
|
|
|
|
|
|
|
# Whether this detail is obsolete. Occurrences are expected not to point to
|
|
|
|
# obsolete details.
|
|
|
|
# Corresponds to the JSON property `isObsolete`
|
|
|
|
# @return [Boolean]
|
|
|
|
attr_accessor :is_obsolete
|
|
|
|
alias_method :is_obsolete?, :is_obsolete
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
# Corresponds to the JSON property `maxAffectedVersion`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Version]
|
|
|
|
attr_accessor :max_affected_version
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
# Corresponds to the JSON property `minAffectedVersion`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Version]
|
|
|
|
attr_accessor :min_affected_version
|
|
|
|
|
|
|
|
# Required. The name of the package where the vulnerability was found.
|
|
|
|
# Corresponds to the JSON property `package`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :package
|
|
|
|
|
|
|
|
# The type of package; whether native or non native(ruby gems, node.js
|
|
|
|
# packages etc).
|
|
|
|
# Corresponds to the JSON property `packageType`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :package_type
|
|
|
|
|
|
|
|
# The severity (eg: distro assigned severity) for this vulnerability.
|
|
|
|
# Corresponds to the JSON property `severityName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :severity_name
|
|
|
|
|
2019-08-10 00:38:10 +00:00
|
|
|
# The time this information was last changed at the source. This is an
|
|
|
|
# upstream timestamp from the underlying information source - e.g. Ubuntu
|
|
|
|
# security tracker.
|
|
|
|
# Corresponds to the JSON property `sourceUpdateTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :source_update_time
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cpe_uri = args[:cpe_uri] if args.key?(:cpe_uri)
|
|
|
|
@description = args[:description] if args.key?(:description)
|
|
|
|
@fixed_location = args[:fixed_location] if args.key?(:fixed_location)
|
|
|
|
@is_obsolete = args[:is_obsolete] if args.key?(:is_obsolete)
|
|
|
|
@max_affected_version = args[:max_affected_version] if args.key?(:max_affected_version)
|
|
|
|
@min_affected_version = args[:min_affected_version] if args.key?(:min_affected_version)
|
|
|
|
@package = args[:package] if args.key?(:package)
|
|
|
|
@package_type = args[:package_type] if args.key?(:package_type)
|
|
|
|
@severity_name = args[:severity_name] if args.key?(:severity_name)
|
2019-08-10 00:38:10 +00:00
|
|
|
@source_update_time = args[:source_update_time] if args.key?(:source_update_time)
|
2019-01-09 00:36:31 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of an attestation occurrence.
|
|
|
|
class Details
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Occurrence that represents a single "attestation". The authenticity of an
|
|
|
|
# attestation can be verified using the attached signature. If the verifier
|
|
|
|
# trusts the public key of the signer, then verifying the signature is
|
|
|
|
# sufficient to establish trust. In this circumstance, the authority to which
|
|
|
|
# this attestation is attached is primarily useful for look-up (how to find
|
|
|
|
# this attestation if you already know the authority and artifact to be
|
|
|
|
# verified) and intent (which authority was this attestation intended to sign
|
|
|
|
# for).
|
|
|
|
# Corresponds to the JSON property `attestation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Attestation]
|
|
|
|
attr_accessor :attestation
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@attestation = args[:attestation] if args.key?(:attestation)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Provides information about the analysis status of a discovered resource.
|
|
|
|
class Discovered
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The status of discovery for the resource.
|
|
|
|
# Corresponds to the JSON property `analysisStatus`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :analysis_status
|
|
|
|
|
2019-03-13 00:37:11 +00:00
|
|
|
# The `Status` type defines a logical error model that is suitable for
|
|
|
|
# different programming environments, including REST APIs and RPC APIs. It is
|
2019-06-06 00:40:37 +00:00
|
|
|
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
|
|
|
|
# three pieces of data: error code, error message, and error details.
|
|
|
|
# You can find out more about this error model and how to work with it in the
|
|
|
|
# [API Design Guide](https://cloud.google.com/apis/design/errors).
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `analysisStatusError`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Status]
|
|
|
|
attr_accessor :analysis_status_error
|
|
|
|
|
|
|
|
# Whether the resource is continuously analyzed.
|
|
|
|
# Corresponds to the JSON property `continuousAnalysis`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :continuous_analysis
|
|
|
|
|
|
|
|
# The last time continuous analysis was done for this resource.
|
|
|
|
# Deprecated, do not use.
|
|
|
|
# Corresponds to the JSON property `lastAnalysisTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :last_analysis_time
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@analysis_status = args[:analysis_status] if args.key?(:analysis_status)
|
|
|
|
@analysis_status_error = args[:analysis_status_error] if args.key?(:analysis_status_error)
|
|
|
|
@continuous_analysis = args[:continuous_analysis] if args.key?(:continuous_analysis)
|
|
|
|
@last_analysis_time = args[:last_analysis_time] if args.key?(:last_analysis_time)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A note that indicates a type of analysis a provider would perform. This note
|
|
|
|
# exists in a provider's project. A `Discovery` occurrence is created in a
|
|
|
|
# consumer's project at the start of analysis.
|
|
|
|
class Discovery
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. Immutable. The kind of analysis that is handled by this
|
|
|
|
# discovery.
|
|
|
|
# Corresponds to the JSON property `analysisKind`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :analysis_kind
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@analysis_kind = args[:analysis_kind] if args.key?(:analysis_kind)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# This represents a particular channel of distribution for a given package.
|
|
|
|
# E.g., Debian's jessie-backports dpkg mirror.
|
|
|
|
class Distribution
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The CPU architecture for which packages in this distribution channel were
|
|
|
|
# built.
|
|
|
|
# Corresponds to the JSON property `architecture`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :architecture
|
|
|
|
|
|
|
|
# Required. The cpe_uri in [CPE format](https://cpe.mitre.org/specification/)
|
|
|
|
# denoting the package manager version distributing a package.
|
|
|
|
# Corresponds to the JSON property `cpeUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :cpe_uri
|
|
|
|
|
|
|
|
# The distribution channel-specific description of this package.
|
|
|
|
# Corresponds to the JSON property `description`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :description
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
# Corresponds to the JSON property `latestVersion`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Version]
|
|
|
|
attr_accessor :latest_version
|
|
|
|
|
|
|
|
# A freeform string denoting the maintainer of this package.
|
|
|
|
# Corresponds to the JSON property `maintainer`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :maintainer
|
|
|
|
|
|
|
|
# The distribution channel-specific homepage for this package.
|
|
|
|
# Corresponds to the JSON property `url`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :url
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@architecture = args[:architecture] if args.key?(:architecture)
|
|
|
|
@cpe_uri = args[:cpe_uri] if args.key?(:cpe_uri)
|
|
|
|
@description = args[:description] if args.key?(:description)
|
|
|
|
@latest_version = args[:latest_version] if args.key?(:latest_version)
|
|
|
|
@maintainer = args[:maintainer] if args.key?(:maintainer)
|
|
|
|
@url = args[:url] if args.key?(:url)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A generic empty message that you can re-use to avoid defining duplicated
|
|
|
|
# empty messages in your APIs. A typical example is to use it as the request
|
|
|
|
# or the response type of an API method. For instance:
|
|
|
|
# service Foo `
|
|
|
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
|
|
# `
|
|
|
|
# The JSON representation for `Empty` is empty JSON object ````.
|
|
|
|
class Empty
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# Defines an object for the environment field in in-toto links. The suggested
|
|
|
|
# fields are "variables", "filesystem", and "workdir".
|
|
|
|
class Environment
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `customValues`
|
|
|
|
# @return [Hash<String,String>]
|
|
|
|
attr_accessor :custom_values
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@custom_values = args[:custom_values] if args.key?(:custom_values)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# 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.
|
2019-01-09 00:36:31 +00:00
|
|
|
class Expr
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# Optional. Description of the expression. This is a longer text which
|
2019-01-09 00:36:31 +00:00
|
|
|
# describes the expression, e.g. when hovered over it in a UI.
|
|
|
|
# Corresponds to the JSON property `description`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :description
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# Textual representation of an expression in Common Expression Language
|
|
|
|
# syntax.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `expression`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :expression
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# Optional. String indicating the location of the expression for error
|
2019-01-09 00:36:31 +00:00
|
|
|
# reporting, e.g. a file name and a position in the file.
|
|
|
|
# Corresponds to the JSON property `location`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :location
|
|
|
|
|
2020-01-23 00:37:29 +00:00
|
|
|
# Optional. Title for the expression, i.e. a short string describing
|
2019-01-09 00:36:31 +00:00
|
|
|
# its purpose. This can be used e.g. in UIs which allow to enter the
|
|
|
|
# expression.
|
|
|
|
# Corresponds to the JSON property `title`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :title
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@description = args[:description] if args.key?(:description)
|
|
|
|
@expression = args[:expression] if args.key?(:expression)
|
|
|
|
@location = args[:location] if args.key?(:location)
|
|
|
|
@title = args[:title] if args.key?(:title)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Container message for hashes of byte content of files, used in source
|
|
|
|
# messages to verify integrity of source input to the build.
|
|
|
|
class FileHashes
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. Collection of file hashes.
|
|
|
|
# Corresponds to the JSON property `fileHash`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::HashProp>]
|
|
|
|
attr_accessor :file_hash
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@file_hash = args[:file_hash] if args.key?(:file_hash)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A set of properties that uniquely identify a given Docker image.
|
|
|
|
class Fingerprint
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The layer ID of the final layer in the Docker image's v1
|
|
|
|
# representation.
|
|
|
|
# Corresponds to the JSON property `v1Name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :v1_name
|
|
|
|
|
|
|
|
# Required. The ordered list of v2 blobs that represent a given image.
|
|
|
|
# Corresponds to the JSON property `v2Blob`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :v2_blob
|
|
|
|
|
|
|
|
# Output only. The name of the image's v2 blobs computed via:
|
|
|
|
# [bottom] := v2_blobbottom := sha256(v2_blob[N] + " " + v2_name[N+1])
|
|
|
|
# Only the name of the final blob is kept.
|
|
|
|
# Corresponds to the JSON property `v2Name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :v2_name
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@v1_name = args[:v1_name] if args.key?(:v1_name)
|
|
|
|
@v2_blob = args[:v2_blob] if args.key?(:v2_blob)
|
|
|
|
@v2_name = args[:v2_name] if args.key?(:v2_name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-03-01 00:37:10 +00:00
|
|
|
# Per resource and severity counts of fixable and total vulnerabilities.
|
2019-01-09 00:36:31 +00:00
|
|
|
class FixableTotalByDigest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The number of fixable vulnerabilities associated with this resource.
|
|
|
|
# Corresponds to the JSON property `fixableCount`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :fixable_count
|
|
|
|
|
|
|
|
# An entity that can have metadata. For example, a Docker image.
|
|
|
|
# Corresponds to the JSON property `resource`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Resource]
|
|
|
|
attr_accessor :resource
|
|
|
|
|
|
|
|
# The severity for this count. SEVERITY_UNSPECIFIED indicates total across
|
|
|
|
# all severities.
|
|
|
|
# Corresponds to the JSON property `severity`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :severity
|
|
|
|
|
|
|
|
# The total number of vulnerabilities associated with this resource.
|
|
|
|
# Corresponds to the JSON property `totalCount`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :total_count
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@fixable_count = args[:fixable_count] if args.key?(:fixable_count)
|
|
|
|
@resource = args[:resource] if args.key?(:resource)
|
|
|
|
@severity = args[:severity] if args.key?(:severity)
|
|
|
|
@total_count = args[:total_count] if args.key?(:total_count)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-03-21 00:37:30 +00:00
|
|
|
# An attestation wrapper that uses the Grafeas `Signature` message.
|
2019-04-25 00:37:02 +00:00
|
|
|
# This attestation must define the `serialized_payload` that the `signatures`
|
|
|
|
# verify and any metadata necessary to interpret that plaintext. The
|
|
|
|
# signatures should always be over the `serialized_payload` bytestring.
|
2019-03-21 00:37:30 +00:00
|
|
|
class GenericSignedAttestation
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Type (for example schema) of the attestation payload that was signed.
|
|
|
|
# The verifier must ensure that the provided type is one that the verifier
|
|
|
|
# supports, and that the attestation payload is a valid instantiation of that
|
|
|
|
# type (for example by validating a JSON schema).
|
|
|
|
# Corresponds to the JSON property `contentType`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :content_type
|
|
|
|
|
|
|
|
# The serialized payload that is verified by one or more `signatures`.
|
|
|
|
# The encoding and semantic meaning of this payload must match what is set in
|
|
|
|
# `content_type`.
|
|
|
|
# Corresponds to the JSON property `serializedPayload`
|
|
|
|
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :serialized_payload
|
|
|
|
|
|
|
|
# One or more signatures over `serialized_payload`. Verifier implementations
|
|
|
|
# should consider this attestation message verified if at least one
|
|
|
|
# `signature` verifies `serialized_payload`. See `Signature` in common.proto
|
|
|
|
# for more details on signature structure and verification.
|
|
|
|
# Corresponds to the JSON property `signatures`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Signature>]
|
|
|
|
attr_accessor :signatures
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@content_type = args[:content_type] if args.key?(:content_type)
|
|
|
|
@serialized_payload = args[:serialized_payload] if args.key?(:serialized_payload)
|
|
|
|
@signatures = args[:signatures] if args.key?(:signatures)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# A SourceContext referring to a Gerrit project.
|
|
|
|
class GerritSourceContext
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# An alias to a repo revision.
|
|
|
|
# Corresponds to the JSON property `aliasContext`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::AliasContext]
|
|
|
|
attr_accessor :alias_context
|
|
|
|
|
|
|
|
# The full project name within the host. Projects may be nested, so
|
|
|
|
# "project/subproject" is a valid project name. The "repo name" is the
|
|
|
|
# hostURI/project.
|
|
|
|
# Corresponds to the JSON property `gerritProject`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :gerrit_project
|
|
|
|
|
|
|
|
# The URI of a running Gerrit instance.
|
|
|
|
# Corresponds to the JSON property `hostUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :host_uri
|
|
|
|
|
|
|
|
# A revision (commit) ID.
|
|
|
|
# Corresponds to the JSON property `revisionId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :revision_id
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@alias_context = args[:alias_context] if args.key?(:alias_context)
|
|
|
|
@gerrit_project = args[:gerrit_project] if args.key?(:gerrit_project)
|
|
|
|
@host_uri = args[:host_uri] if args.key?(:host_uri)
|
|
|
|
@revision_id = args[:revision_id] if args.key?(:revision_id)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Request message for `GetIamPolicy` method.
|
|
|
|
class GetIamPolicyRequest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-07-12 00:38:14 +00:00
|
|
|
# Encapsulates settings provided to GetIamPolicy.
|
|
|
|
# Corresponds to the JSON property `options`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GetPolicyOptions]
|
|
|
|
attr_accessor :options
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@options = args[:options] if args.key?(:options)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Encapsulates settings provided to GetIamPolicy.
|
|
|
|
class GetPolicyOptions
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Optional. The policy format version to be returned.
|
2019-09-19 00:37:15 +00:00
|
|
|
# Valid values are 0, 1, and 3. Requests specifying an invalid value will be
|
|
|
|
# rejected.
|
|
|
|
# Requests for policies with any conditional bindings must specify version 3.
|
|
|
|
# Policies without any conditional bindings may specify any valid value or
|
|
|
|
# leave the field unset.
|
2020-05-07 20:07:42 +00:00
|
|
|
# To learn which resources support conditions in their IAM policies, see the
|
|
|
|
# [IAM
|
|
|
|
# documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
|
2019-07-12 00:38:14 +00:00
|
|
|
# Corresponds to the JSON property `requestedPolicyVersion`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :requested_policy_version
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
2019-07-12 00:38:14 +00:00
|
|
|
@requested_policy_version = args[:requested_policy_version] if args.key?(:requested_policy_version)
|
2019-01-09 00:36:31 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A GitSourceContext denotes a particular revision in a third party Git
|
|
|
|
# repository (e.g., GitHub).
|
|
|
|
class GitSourceContext
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Git commit hash.
|
|
|
|
# Corresponds to the JSON property `revisionId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :revision_id
|
|
|
|
|
|
|
|
# Git repository URL.
|
|
|
|
# Corresponds to the JSON property `url`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :url
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@revision_id = args[:revision_id] if args.key?(:revision_id)
|
|
|
|
@url = args[:url] if args.key?(:url)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Metadata for all operations used and required for all operations
|
|
|
|
# that created by Container Analysis Providers
|
|
|
|
class GoogleDevtoolsContaineranalysisV1alpha1OperationMetadata
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Output only. The time this operation was created.
|
|
|
|
# Corresponds to the JSON property `createTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :create_time
|
|
|
|
|
|
|
|
# Output only. The time that this operation was marked completed or failed.
|
|
|
|
# Corresponds to the JSON property `endTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :end_time
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@create_time = args[:create_time] if args.key?(:create_time)
|
|
|
|
@end_time = args[:end_time] if args.key?(:end_time)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of a build occurrence.
|
|
|
|
class GrafeasV1beta1BuildDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Provenance of a build. Contains all information needed to verify the full
|
|
|
|
# details about the build from source to completion.
|
|
|
|
# Corresponds to the JSON property `provenance`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::BuildProvenance]
|
|
|
|
attr_accessor :provenance
|
|
|
|
|
|
|
|
# Serialized JSON representation of the provenance, used in generating the
|
|
|
|
# build signature in the corresponding build note. After verifying the
|
|
|
|
# signature, `provenance_bytes` can be unmarshalled and compared to the
|
|
|
|
# provenance to confirm that it is unchanged. A base64-encoded string
|
|
|
|
# representation of the provenance bytes is used for the signature in order
|
|
|
|
# to interoperate with openssl which expects this format for signature
|
|
|
|
# verification.
|
|
|
|
# The serialized form is captured both to avoid ambiguity in how the
|
|
|
|
# provenance is marshalled to json as well to prevent incompatibilities with
|
|
|
|
# future changes.
|
|
|
|
# Corresponds to the JSON property `provenanceBytes`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :provenance_bytes
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@provenance = args[:provenance] if args.key?(:provenance)
|
|
|
|
@provenance_bytes = args[:provenance_bytes] if args.key?(:provenance_bytes)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of a deployment occurrence.
|
|
|
|
class GrafeasV1beta1DeploymentDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The period during which some deployable was active in a runtime.
|
|
|
|
# Corresponds to the JSON property `deployment`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Deployment]
|
|
|
|
attr_accessor :deployment
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@deployment = args[:deployment] if args.key?(:deployment)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of a discovery occurrence.
|
|
|
|
class GrafeasV1beta1DiscoveryDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Provides information about the analysis status of a discovered resource.
|
|
|
|
# Corresponds to the JSON property `discovered`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Discovered]
|
|
|
|
attr_accessor :discovered
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@discovered = args[:discovered] if args.key?(:discovered)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of an image occurrence.
|
|
|
|
class GrafeasV1beta1ImageDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Derived describes the derived image portion (Occurrence) of the DockerImage
|
|
|
|
# relationship. This image would be produced from a Dockerfile with FROM
|
|
|
|
# <DockerImage.Basis in attached Note>.
|
|
|
|
# Corresponds to the JSON property `derivedImage`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Derived]
|
|
|
|
attr_accessor :derived_image
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@derived_image = args[:derived_image] if args.key?(:derived_image)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
#
|
|
|
|
class GrafeasV1beta1IntotoArtifact
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Defines a hash object for use in Materials and Products.
|
|
|
|
# Corresponds to the JSON property `hashes`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::ArtifactHashes]
|
|
|
|
attr_accessor :hashes
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `resourceUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :resource_uri
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@hashes = args[:hashes] if args.key?(:hashes)
|
|
|
|
@resource_uri = args[:resource_uri] if args.key?(:resource_uri)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# This corresponds to a signed in-toto link - it is made up of one or more
|
|
|
|
# signatures and the in-toto link itself. This is used for occurrences of a
|
|
|
|
# Grafeas in-toto note.
|
|
|
|
class GrafeasV1beta1IntotoDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `signatures`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1IntotoSignature>]
|
|
|
|
attr_accessor :signatures
|
|
|
|
|
|
|
|
# This corresponds to an in-toto link.
|
|
|
|
# Corresponds to the JSON property `signed`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Link]
|
|
|
|
attr_accessor :signed
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@signatures = args[:signatures] if args.key?(:signatures)
|
|
|
|
@signed = args[:signed] if args.key?(:signed)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A signature object consists of the KeyID used and the signature itself.
|
|
|
|
class GrafeasV1beta1IntotoSignature
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `keyid`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :keyid
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `sig`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :sig
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@keyid = args[:keyid] if args.key?(:keyid)
|
|
|
|
@sig = args[:sig] if args.key?(:sig)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Details of a package occurrence.
|
|
|
|
class GrafeasV1beta1PackageDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# This represents how a particular software package may be installed on a
|
|
|
|
# system.
|
|
|
|
# Corresponds to the JSON property `installation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Installation]
|
|
|
|
attr_accessor :installation
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@installation = args[:installation] if args.key?(:installation)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Details of a vulnerability Occurrence.
|
|
|
|
class GrafeasV1beta1VulnerabilityDetails
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Output only. The CVSS score of this vulnerability. CVSS score is on a
|
|
|
|
# scale of 0-10 where 0 indicates low severity and 10 indicates high
|
|
|
|
# severity.
|
|
|
|
# Corresponds to the JSON property `cvssScore`
|
|
|
|
# @return [Float]
|
|
|
|
attr_accessor :cvss_score
|
|
|
|
|
2019-03-01 00:37:10 +00:00
|
|
|
# The distro assigned severity for this vulnerability when it is
|
|
|
|
# available, and note provider assigned severity when distro has not yet
|
|
|
|
# assigned a severity for this vulnerability.
|
|
|
|
# Corresponds to the JSON property `effectiveSeverity`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :effective_severity
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Output only. A detailed description of this vulnerability.
|
|
|
|
# Corresponds to the JSON property `longDescription`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :long_description
|
|
|
|
|
|
|
|
# Required. The set of affected locations and their fixes (if available)
|
|
|
|
# within the associated resource.
|
|
|
|
# Corresponds to the JSON property `packageIssue`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::PackageIssue>]
|
|
|
|
attr_accessor :package_issue
|
|
|
|
|
|
|
|
# Output only. URLs related to this vulnerability.
|
|
|
|
# Corresponds to the JSON property `relatedUrls`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::RelatedUrl>]
|
|
|
|
attr_accessor :related_urls
|
|
|
|
|
|
|
|
# Output only. The note provider assigned Severity of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `severity`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :severity
|
|
|
|
|
|
|
|
# Output only. A one sentence description of this vulnerability.
|
|
|
|
# Corresponds to the JSON property `shortDescription`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :short_description
|
|
|
|
|
|
|
|
# The type of package; whether native or non native(ruby gems, node.js
|
|
|
|
# packages etc)
|
|
|
|
# Corresponds to the JSON property `type`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :type
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cvss_score = args[:cvss_score] if args.key?(:cvss_score)
|
2019-03-01 00:37:10 +00:00
|
|
|
@effective_severity = args[:effective_severity] if args.key?(:effective_severity)
|
2019-01-09 00:36:31 +00:00
|
|
|
@long_description = args[:long_description] if args.key?(:long_description)
|
|
|
|
@package_issue = args[:package_issue] if args.key?(:package_issue)
|
|
|
|
@related_urls = args[:related_urls] if args.key?(:related_urls)
|
|
|
|
@severity = args[:severity] if args.key?(:severity)
|
|
|
|
@short_description = args[:short_description] if args.key?(:short_description)
|
|
|
|
@type = args[:type] if args.key?(:type)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Container message for hash values.
|
|
|
|
class HashProp
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The type of hash that was performed.
|
|
|
|
# Corresponds to the JSON property `type`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :type
|
|
|
|
|
|
|
|
# Required. The hash value.
|
|
|
|
# Corresponds to the JSON property `value`
|
|
|
|
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :value
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@type = args[:type] if args.key?(:type)
|
|
|
|
@value = args[:value] if args.key?(:value)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# This submessage provides human-readable hints about the purpose of the
|
|
|
|
# authority. Because the name of a note acts as its resource reference, it is
|
|
|
|
# important to disambiguate the canonical name of the Note (which might be a
|
|
|
|
# UUID for security purposes) from "readable" names more suitable for debug
|
|
|
|
# output. Note that these hints should not be used to look up authorities in
|
|
|
|
# security sensitive contexts, such as when looking up attestations to
|
|
|
|
# verify.
|
|
|
|
class Hint
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The human readable name of this attestation authority, for
|
|
|
|
# example "qa".
|
|
|
|
# Corresponds to the JSON property `humanReadableName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :human_readable_name
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@human_readable_name = args[:human_readable_name] if args.key?(:human_readable_name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# This contains the fields corresponding to the definition of a software supply
|
|
|
|
# chain step in an in-toto layout. This information goes into a Grafeas note.
|
|
|
|
class InToto
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# This field contains the expected command used to perform the step.
|
|
|
|
# Corresponds to the JSON property `expectedCommand`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :expected_command
|
|
|
|
|
|
|
|
# The following fields contain in-toto artifact rules identifying the
|
|
|
|
# artifacts that enter this supply chain step, and exit the supply chain
|
|
|
|
# step, i.e. materials and products of the step.
|
|
|
|
# Corresponds to the JSON property `expectedMaterials`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::ArtifactRule>]
|
|
|
|
attr_accessor :expected_materials
|
|
|
|
|
|
|
|
#
|
|
|
|
# Corresponds to the JSON property `expectedProducts`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::ArtifactRule>]
|
|
|
|
attr_accessor :expected_products
|
|
|
|
|
|
|
|
# This field contains the public keys that can be used to verify the
|
|
|
|
# signatures on the step metadata.
|
|
|
|
# Corresponds to the JSON property `signingKeys`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::SigningKey>]
|
|
|
|
attr_accessor :signing_keys
|
|
|
|
|
|
|
|
# This field identifies the name of the step in the supply chain.
|
|
|
|
# Corresponds to the JSON property `stepName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :step_name
|
|
|
|
|
|
|
|
# This field contains a value that indicates the minimum number of keys that
|
|
|
|
# need to be used to sign the step's in-toto link.
|
|
|
|
# Corresponds to the JSON property `threshold`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :threshold
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@expected_command = args[:expected_command] if args.key?(:expected_command)
|
|
|
|
@expected_materials = args[:expected_materials] if args.key?(:expected_materials)
|
|
|
|
@expected_products = args[:expected_products] if args.key?(:expected_products)
|
|
|
|
@signing_keys = args[:signing_keys] if args.key?(:signing_keys)
|
|
|
|
@step_name = args[:step_name] if args.key?(:step_name)
|
|
|
|
@threshold = args[:threshold] if args.key?(:threshold)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# This represents how a particular software package may be installed on a
|
|
|
|
# system.
|
|
|
|
class Installation
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. All of the places within the filesystem versions of this package
|
|
|
|
# have been found.
|
|
|
|
# Corresponds to the JSON property `location`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Location>]
|
|
|
|
attr_accessor :location
|
|
|
|
|
|
|
|
# Output only. The name of the installed package.
|
|
|
|
# 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)
|
|
|
|
@location = args[:location] if args.key?(:location)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-23 00:36:37 +00:00
|
|
|
#
|
|
|
|
class KnowledgeBase
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The KB name (generally of the form KB[0-9]+ i.e. KB123456).
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# A link to the KB in the Windows update catalog -
|
|
|
|
# https://www.catalog.update.microsoft.com/
|
|
|
|
# Corresponds to the JSON property `url`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :url
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@url = args[:url] if args.key?(:url)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Layer holds metadata specific to a layer of a Docker image.
|
|
|
|
class Layer
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The recovered arguments to the Dockerfile directive.
|
|
|
|
# Corresponds to the JSON property `arguments`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :arguments
|
|
|
|
|
|
|
|
# Required. The recovered Dockerfile directive used to construct this layer.
|
|
|
|
# Corresponds to the JSON property `directive`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :directive
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@arguments = args[:arguments] if args.key?(:arguments)
|
|
|
|
@directive = args[:directive] if args.key?(:directive)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# This corresponds to an in-toto link.
|
|
|
|
class Link
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Defines an object for the byproducts field in in-toto links. The suggested
|
|
|
|
# fields are "stderr", "stdout", and "return-value".
|
|
|
|
# Corresponds to the JSON property `byproducts`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::ByProducts]
|
|
|
|
attr_accessor :byproducts
|
|
|
|
|
|
|
|
# This field contains the full command executed for the step. This can also
|
|
|
|
# be empty if links are generated for operations that aren't directly mapped
|
|
|
|
# to a specific command. Each term in the command is an independent string
|
|
|
|
# in the list. An example of a command in the in-toto metadata field is:
|
|
|
|
# "command": ["git", "clone", "https://github.com/in-toto/demo-project.git"]
|
|
|
|
# Corresponds to the JSON property `command`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :command
|
|
|
|
|
|
|
|
# Defines an object for the environment field in in-toto links. The suggested
|
|
|
|
# fields are "variables", "filesystem", and "workdir".
|
|
|
|
# Corresponds to the JSON property `environment`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Environment]
|
|
|
|
attr_accessor :environment
|
|
|
|
|
|
|
|
# Materials are the supply chain artifacts that go into the step and are used
|
|
|
|
# for the operation performed. The key of the map is the path of the artifact
|
|
|
|
# and the structure contains the recorded hash information. An example is:
|
|
|
|
# "materials": [
|
|
|
|
# `
|
|
|
|
# "resource_uri": "foo/bar",
|
|
|
|
# "hashes": `
|
|
|
|
# "sha256": "ebebf...",
|
|
|
|
# <OTHER HASH ALGORITHMS>: <HASH VALUE>
|
|
|
|
# `
|
|
|
|
# `
|
|
|
|
# ]
|
|
|
|
# Corresponds to the JSON property `materials`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1IntotoArtifact>]
|
|
|
|
attr_accessor :materials
|
|
|
|
|
|
|
|
# Products are the supply chain artifacts generated as a result of the step.
|
|
|
|
# The structure is identical to that of materials.
|
|
|
|
# Corresponds to the JSON property `products`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1IntotoArtifact>]
|
|
|
|
attr_accessor :products
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@byproducts = args[:byproducts] if args.key?(:byproducts)
|
|
|
|
@command = args[:command] if args.key?(:command)
|
|
|
|
@environment = args[:environment] if args.key?(:environment)
|
|
|
|
@materials = args[:materials] if args.key?(:materials)
|
|
|
|
@products = args[:products] if args.key?(:products)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Response for listing occurrences for a note.
|
|
|
|
class ListNoteOccurrencesResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Token to provide to skip to a particular spot in the list.
|
|
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :next_page_token
|
|
|
|
|
|
|
|
# The occurrences attached to the specified note.
|
|
|
|
# Corresponds to the JSON property `occurrences`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Occurrence>]
|
|
|
|
attr_accessor :occurrences
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
|
|
@occurrences = args[:occurrences] if args.key?(:occurrences)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response for listing notes.
|
|
|
|
class ListNotesResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The next pagination token in the list response. It should be used as
|
|
|
|
# `page_token` for the following request. An empty value means no more
|
|
|
|
# results.
|
|
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :next_page_token
|
|
|
|
|
|
|
|
# The notes requested.
|
|
|
|
# Corresponds to the JSON property `notes`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Note>]
|
|
|
|
attr_accessor :notes
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
|
|
@notes = args[:notes] if args.key?(:notes)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response for listing occurrences.
|
|
|
|
class ListOccurrencesResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The next pagination token in the list response. It should be used as
|
|
|
|
# `page_token` for the following request. An empty value means no more
|
|
|
|
# results.
|
|
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :next_page_token
|
|
|
|
|
|
|
|
# The occurrences requested.
|
|
|
|
# Corresponds to the JSON property `occurrences`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Occurrence>]
|
|
|
|
attr_accessor :occurrences
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
|
|
@occurrences = args[:occurrences] if args.key?(:occurrences)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response for listing scan configurations.
|
|
|
|
class ListScanConfigsResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The next pagination token in the list response. It should be used as
|
|
|
|
# `page_token` for the following request. An empty value means no more
|
|
|
|
# results.
|
|
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :next_page_token
|
|
|
|
|
|
|
|
# The scan configurations requested.
|
|
|
|
# Corresponds to the JSON property `scanConfigs`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::ScanConfig>]
|
|
|
|
attr_accessor :scan_configs
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
|
|
@scan_configs = args[:scan_configs] if args.key?(:scan_configs)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# An occurrence of a particular package installation found within a system's
|
|
|
|
# filesystem. E.g., glibc was found in `/var/lib/dpkg/status`.
|
|
|
|
class Location
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The CPE URI in [CPE format](https://cpe.mitre.org/specification/)
|
|
|
|
# denoting the package manager version distributing a package.
|
|
|
|
# Corresponds to the JSON property `cpeUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :cpe_uri
|
|
|
|
|
|
|
|
# The path from which we gathered that this package/version is installed.
|
|
|
|
# Corresponds to the JSON property `path`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :path
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
# Corresponds to the JSON property `version`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Version]
|
|
|
|
attr_accessor :version
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cpe_uri = args[:cpe_uri] if args.key?(:cpe_uri)
|
|
|
|
@path = args[:path] if args.key?(:path)
|
|
|
|
@version = args[:version] if args.key?(:version)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A type of analysis that can be done for a resource.
|
|
|
|
class Note
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Note kind that represents a logical attestation "role" or "authority". For
|
|
|
|
# example, an organization might have one `Authority` for "QA" and one for
|
|
|
|
# "build". This note is intended to act strictly as a grouping mechanism for
|
|
|
|
# the attached occurrences (Attestations). This grouping mechanism also
|
|
|
|
# provides a security boundary, since IAM ACLs gate the ability for a principle
|
|
|
|
# to attach an occurrence to a given note. It also provides a single point of
|
|
|
|
# lookup to find all attached attestation occurrences, even if they don't all
|
|
|
|
# live in the same project.
|
|
|
|
# Corresponds to the JSON property `attestationAuthority`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Authority]
|
|
|
|
attr_accessor :attestation_authority
|
|
|
|
|
|
|
|
# Basis describes the base image portion (Note) of the DockerImage
|
|
|
|
# relationship. Linked occurrences are derived from this or an
|
|
|
|
# equivalent image via:
|
|
|
|
# FROM <Basis.resource_url>
|
|
|
|
# Or an equivalent reference, e.g. a tag of the resource_url.
|
|
|
|
# Corresponds to the JSON property `baseImage`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Basis]
|
|
|
|
attr_accessor :base_image
|
|
|
|
|
|
|
|
# Note holding the version of the provider's builder and the signature of the
|
|
|
|
# provenance message in the build details occurrence.
|
|
|
|
# Corresponds to the JSON property `build`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Build]
|
|
|
|
attr_accessor :build
|
|
|
|
|
|
|
|
# Output only. The time this note was created. This field can be used as a
|
|
|
|
# filter in list requests.
|
|
|
|
# Corresponds to the JSON property `createTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :create_time
|
|
|
|
|
|
|
|
# An artifact that can be deployed in some runtime.
|
|
|
|
# Corresponds to the JSON property `deployable`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Deployable]
|
|
|
|
attr_accessor :deployable
|
|
|
|
|
|
|
|
# A note that indicates a type of analysis a provider would perform. This note
|
|
|
|
# exists in a provider's project. A `Discovery` occurrence is created in a
|
|
|
|
# consumer's project at the start of analysis.
|
|
|
|
# Corresponds to the JSON property `discovery`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Discovery]
|
|
|
|
attr_accessor :discovery
|
|
|
|
|
|
|
|
# Time of expiration for this note. Empty if note does not expire.
|
|
|
|
# Corresponds to the JSON property `expirationTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :expiration_time
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# This contains the fields corresponding to the definition of a software supply
|
|
|
|
# chain step in an in-toto layout. This information goes into a Grafeas note.
|
|
|
|
# Corresponds to the JSON property `intoto`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::InToto]
|
|
|
|
attr_accessor :intoto
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Output only. The type of analysis. This field can be used as a filter in
|
|
|
|
# list requests.
|
|
|
|
# Corresponds to the JSON property `kind`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :kind
|
|
|
|
|
|
|
|
# A detailed description of this note.
|
|
|
|
# Corresponds to the JSON property `longDescription`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :long_description
|
|
|
|
|
|
|
|
# Output only. The name of the note in the form of
|
|
|
|
# `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# This represents a particular package that is distributed over various
|
|
|
|
# channels. E.g., glibc (aka libc6) is distributed by many, at various
|
|
|
|
# versions.
|
|
|
|
# Corresponds to the JSON property `package`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Package]
|
|
|
|
attr_accessor :package
|
|
|
|
|
|
|
|
# Other notes related to this note.
|
|
|
|
# Corresponds to the JSON property `relatedNoteNames`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :related_note_names
|
|
|
|
|
|
|
|
# URLs associated with this note.
|
|
|
|
# Corresponds to the JSON property `relatedUrl`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::RelatedUrl>]
|
|
|
|
attr_accessor :related_url
|
|
|
|
|
|
|
|
# A one sentence description of this note.
|
|
|
|
# Corresponds to the JSON property `shortDescription`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :short_description
|
|
|
|
|
|
|
|
# Output only. The time this note was last updated. This field can be used as
|
|
|
|
# a filter in list requests.
|
|
|
|
# Corresponds to the JSON property `updateTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :update_time
|
|
|
|
|
|
|
|
# Vulnerability provides metadata about a security vulnerability in a Note.
|
|
|
|
# Corresponds to the JSON property `vulnerability`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Vulnerability]
|
|
|
|
attr_accessor :vulnerability
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@attestation_authority = args[:attestation_authority] if args.key?(:attestation_authority)
|
|
|
|
@base_image = args[:base_image] if args.key?(:base_image)
|
|
|
|
@build = args[:build] if args.key?(:build)
|
|
|
|
@create_time = args[:create_time] if args.key?(:create_time)
|
|
|
|
@deployable = args[:deployable] if args.key?(:deployable)
|
|
|
|
@discovery = args[:discovery] if args.key?(:discovery)
|
|
|
|
@expiration_time = args[:expiration_time] if args.key?(:expiration_time)
|
2020-05-07 20:07:42 +00:00
|
|
|
@intoto = args[:intoto] if args.key?(:intoto)
|
2019-01-09 00:36:31 +00:00
|
|
|
@kind = args[:kind] if args.key?(:kind)
|
|
|
|
@long_description = args[:long_description] if args.key?(:long_description)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@package = args[:package] if args.key?(:package)
|
|
|
|
@related_note_names = args[:related_note_names] if args.key?(:related_note_names)
|
|
|
|
@related_url = args[:related_url] if args.key?(:related_url)
|
|
|
|
@short_description = args[:short_description] if args.key?(:short_description)
|
|
|
|
@update_time = args[:update_time] if args.key?(:update_time)
|
|
|
|
@vulnerability = args[:vulnerability] if args.key?(:vulnerability)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# An instance of an analysis type that has been found on a resource.
|
|
|
|
class Occurrence
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Details of an attestation occurrence.
|
|
|
|
# Corresponds to the JSON property `attestation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Details]
|
|
|
|
attr_accessor :attestation
|
|
|
|
|
|
|
|
# Details of a build occurrence.
|
|
|
|
# Corresponds to the JSON property `build`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1BuildDetails]
|
|
|
|
attr_accessor :build
|
|
|
|
|
|
|
|
# Output only. The time this occurrence was created.
|
|
|
|
# Corresponds to the JSON property `createTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :create_time
|
|
|
|
|
|
|
|
# Details of a deployment occurrence.
|
|
|
|
# Corresponds to the JSON property `deployment`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1DeploymentDetails]
|
|
|
|
attr_accessor :deployment
|
|
|
|
|
|
|
|
# Details of an image occurrence.
|
|
|
|
# Corresponds to the JSON property `derivedImage`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1ImageDetails]
|
|
|
|
attr_accessor :derived_image
|
|
|
|
|
|
|
|
# Details of a discovery occurrence.
|
|
|
|
# Corresponds to the JSON property `discovered`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1DiscoveryDetails]
|
|
|
|
attr_accessor :discovered
|
|
|
|
|
|
|
|
# Details of a package occurrence.
|
|
|
|
# Corresponds to the JSON property `installation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1PackageDetails]
|
|
|
|
attr_accessor :installation
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# This corresponds to a signed in-toto link - it is made up of one or more
|
|
|
|
# signatures and the in-toto link itself. This is used for occurrences of a
|
|
|
|
# Grafeas in-toto note.
|
|
|
|
# Corresponds to the JSON property `intoto`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1IntotoDetails]
|
|
|
|
attr_accessor :intoto
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Output only. This explicitly denotes which of the occurrence details are
|
|
|
|
# specified. This field can be used as a filter in list requests.
|
|
|
|
# Corresponds to the JSON property `kind`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :kind
|
|
|
|
|
|
|
|
# Output only. The name of the occurrence in the form of
|
|
|
|
# `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# Required. Immutable. The analysis note associated with this occurrence, in
|
|
|
|
# the form of `projects/[PROVIDER_ID]/notes/[NOTE_ID]`. This field can be
|
|
|
|
# used as a filter in list requests.
|
|
|
|
# Corresponds to the JSON property `noteName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :note_name
|
|
|
|
|
|
|
|
# A description of actions that can be taken to remedy the note.
|
|
|
|
# Corresponds to the JSON property `remediation`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :remediation
|
|
|
|
|
|
|
|
# An entity that can have metadata. For example, a Docker image.
|
|
|
|
# Corresponds to the JSON property `resource`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Resource]
|
|
|
|
attr_accessor :resource
|
|
|
|
|
|
|
|
# Output only. The time this occurrence was last updated.
|
|
|
|
# Corresponds to the JSON property `updateTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :update_time
|
|
|
|
|
|
|
|
# Details of a vulnerability Occurrence.
|
|
|
|
# Corresponds to the JSON property `vulnerability`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GrafeasV1beta1VulnerabilityDetails]
|
|
|
|
attr_accessor :vulnerability
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@attestation = args[:attestation] if args.key?(:attestation)
|
|
|
|
@build = args[:build] if args.key?(:build)
|
|
|
|
@create_time = args[:create_time] if args.key?(:create_time)
|
|
|
|
@deployment = args[:deployment] if args.key?(:deployment)
|
|
|
|
@derived_image = args[:derived_image] if args.key?(:derived_image)
|
|
|
|
@discovered = args[:discovered] if args.key?(:discovered)
|
|
|
|
@installation = args[:installation] if args.key?(:installation)
|
2020-05-07 20:07:42 +00:00
|
|
|
@intoto = args[:intoto] if args.key?(:intoto)
|
2019-01-09 00:36:31 +00:00
|
|
|
@kind = args[:kind] if args.key?(:kind)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@note_name = args[:note_name] if args.key?(:note_name)
|
|
|
|
@remediation = args[:remediation] if args.key?(:remediation)
|
|
|
|
@resource = args[:resource] if args.key?(:resource)
|
|
|
|
@update_time = args[:update_time] if args.key?(:update_time)
|
|
|
|
@vulnerability = args[:vulnerability] if args.key?(:vulnerability)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# This represents a particular package that is distributed over various
|
|
|
|
# channels. E.g., glibc (aka libc6) is distributed by many, at various
|
|
|
|
# versions.
|
|
|
|
class Package
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The various channels by which a package is distributed.
|
|
|
|
# Corresponds to the JSON property `distribution`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Distribution>]
|
|
|
|
attr_accessor :distribution
|
|
|
|
|
|
|
|
# Required. Immutable. The name of the package.
|
|
|
|
# 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)
|
|
|
|
@distribution = args[:distribution] if args.key?(:distribution)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# This message wraps a location affected by a vulnerability and its
|
|
|
|
# associated fix (if one is available).
|
|
|
|
class PackageIssue
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The location of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `affectedLocation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::VulnerabilityLocation]
|
|
|
|
attr_accessor :affected_location
|
|
|
|
|
|
|
|
# The location of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `fixedLocation`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::VulnerabilityLocation]
|
|
|
|
attr_accessor :fixed_location
|
|
|
|
|
2019-03-01 00:37:10 +00:00
|
|
|
# Deprecated, use Details.effective_severity instead
|
2019-01-09 00:36:31 +00:00
|
|
|
# The severity (e.g., distro assigned severity) for this vulnerability.
|
|
|
|
# Corresponds to the JSON property `severityName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :severity_name
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@affected_location = args[:affected_location] if args.key?(:affected_location)
|
|
|
|
@fixed_location = args[:fixed_location] if args.key?(:fixed_location)
|
|
|
|
@severity_name = args[:severity_name] if args.key?(:severity_name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# An attestation wrapper with a PGP-compatible signature. This message only
|
|
|
|
# supports `ATTACHED` signatures, where the payload that is signed is included
|
|
|
|
# alongside the signature itself in the same file.
|
|
|
|
class PgpSignedAttestation
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Type (for example schema) of the attestation payload that was signed.
|
|
|
|
# The verifier must ensure that the provided type is one that the verifier
|
|
|
|
# supports, and that the attestation payload is a valid instantiation of that
|
|
|
|
# type (for example by validating a JSON schema).
|
|
|
|
# Corresponds to the JSON property `contentType`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :content_type
|
|
|
|
|
|
|
|
# The cryptographic fingerprint of the key used to generate the signature,
|
|
|
|
# as output by, e.g. `gpg --list-keys`. This should be the version 4, full
|
|
|
|
# 160-bit fingerprint, expressed as a 40 character hexidecimal string. See
|
|
|
|
# https://tools.ietf.org/html/rfc4880#section-12.2 for details.
|
|
|
|
# Implementations may choose to acknowledge "LONG", "SHORT", or other
|
|
|
|
# abbreviated key IDs, but only the full fingerprint is guaranteed to work.
|
|
|
|
# In gpg, the full fingerprint can be retrieved from the `fpr` field
|
|
|
|
# returned when calling --list-keys with --with-colons. For example:
|
|
|
|
# ```
|
|
|
|
# gpg --with-colons --with-fingerprint --force-v4-certs \
|
|
|
|
# --list-keys attester@example.com
|
|
|
|
# tru::1:1513631572:0:3:1:5
|
|
|
|
# pub:...<SNIP>...
|
|
|
|
# fpr:::::::::24FF6481B76AC91E66A00AC657A93A81EF3AE6FB:
|
|
|
|
# ```
|
|
|
|
# Above, the fingerprint is `24FF6481B76AC91E66A00AC657A93A81EF3AE6FB`.
|
|
|
|
# Corresponds to the JSON property `pgpKeyId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :pgp_key_id
|
|
|
|
|
|
|
|
# Required. The raw content of the signature, as output by GNU Privacy Guard
|
|
|
|
# (GPG) or equivalent. Since this message only supports attached signatures,
|
|
|
|
# the payload that was signed must be attached. While the signature format
|
|
|
|
# supported is dependent on the verification implementation, currently only
|
|
|
|
# ASCII-armored (`--armor` to gpg), non-clearsigned (`--sign` rather than
|
|
|
|
# `--clearsign` to gpg) are supported. Concretely, `gpg --sign --armor
|
|
|
|
# --output=signature.gpg payload.json` will create the signature content
|
|
|
|
# expected in this field in `signature.gpg` for the `payload.json`
|
|
|
|
# attestation payload.
|
|
|
|
# Corresponds to the JSON property `signature`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :signature
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@content_type = args[:content_type] if args.key?(:content_type)
|
|
|
|
@pgp_key_id = args[:pgp_key_id] if args.key?(:pgp_key_id)
|
|
|
|
@signature = args[:signature] if args.key?(:signature)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-12-12 00:37:33 +00:00
|
|
|
# An Identity and Access Management (IAM) policy, which specifies access
|
|
|
|
# controls for Google Cloud resources.
|
2019-10-03 00:37:42 +00:00
|
|
|
# A `Policy` is a collection of `bindings`. A `binding` binds one or more
|
|
|
|
# `members` to a single `role`. Members can be user accounts, service accounts,
|
|
|
|
# Google groups, and domains (such as G Suite). A `role` is a named list of
|
2019-12-12 00:37:33 +00:00
|
|
|
# permissions; each `role` can be an IAM predefined role or a user-created
|
|
|
|
# custom role.
|
2020-05-07 20:07:42 +00:00
|
|
|
# For some types of Google Cloud resources, a `binding` can also specify a
|
|
|
|
# `condition`, which is a logical expression that allows access to a resource
|
|
|
|
# only if the expression evaluates to `true`. A condition can add constraints
|
|
|
|
# based on attributes of the request, the resource, or both. To learn which
|
|
|
|
# resources support conditions in their IAM policies, see the
|
|
|
|
# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
|
|
|
|
# policies).
|
2019-12-12 00:37:33 +00:00
|
|
|
# **JSON example:**
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
|
|
|
# "bindings": [
|
|
|
|
# `
|
2019-10-03 00:37:42 +00:00
|
|
|
# "role": "roles/resourcemanager.organizationAdmin",
|
2019-01-09 00:36:31 +00:00
|
|
|
# "members": [
|
|
|
|
# "user:mike@example.com",
|
|
|
|
# "group:admins@example.com",
|
|
|
|
# "domain:google.com",
|
2019-10-03 00:37:42 +00:00
|
|
|
# "serviceAccount:my-project-id@appspot.gserviceaccount.com"
|
2019-01-09 00:36:31 +00:00
|
|
|
# ]
|
|
|
|
# `,
|
|
|
|
# `
|
2019-10-03 00:37:42 +00:00
|
|
|
# "role": "roles/resourcemanager.organizationViewer",
|
2020-05-07 20:07:42 +00:00
|
|
|
# "members": [
|
|
|
|
# "user:eve@example.com"
|
|
|
|
# ],
|
2019-10-03 00:37:42 +00:00
|
|
|
# "condition": `
|
|
|
|
# "title": "expirable access",
|
|
|
|
# "description": "Does not grant access after Sep 2020",
|
2019-12-12 00:37:33 +00:00
|
|
|
# "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
|
|
|
|
# ",
|
2019-10-03 00:37:42 +00:00
|
|
|
# `
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
2019-12-12 00:37:33 +00:00
|
|
|
# ],
|
|
|
|
# "etag": "BwWWja0YfJA=",
|
|
|
|
# "version": 3
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
2019-12-12 00:37:33 +00:00
|
|
|
# **YAML example:**
|
2019-01-09 00:36:31 +00:00
|
|
|
# bindings:
|
|
|
|
# - members:
|
|
|
|
# - user:mike@example.com
|
|
|
|
# - group:admins@example.com
|
|
|
|
# - domain:google.com
|
2019-10-03 00:37:42 +00:00
|
|
|
# - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
|
|
|
# role: roles/resourcemanager.organizationAdmin
|
2019-01-09 00:36:31 +00:00
|
|
|
# - members:
|
2019-10-03 00:37:42 +00:00
|
|
|
# - user:eve@example.com
|
|
|
|
# role: roles/resourcemanager.organizationViewer
|
|
|
|
# condition:
|
|
|
|
# title: expirable access
|
|
|
|
# description: Does not grant access after Sep 2020
|
|
|
|
# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
|
2019-12-12 00:37:33 +00:00
|
|
|
# - etag: BwWWja0YfJA=
|
|
|
|
# - version: 3
|
2019-01-09 00:36:31 +00:00
|
|
|
# For a description of IAM and its features, see the
|
2019-12-12 00:37:33 +00:00
|
|
|
# [IAM documentation](https://cloud.google.com/iam/docs/).
|
2019-01-09 00:36:31 +00:00
|
|
|
class Policy
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-12-12 00:37:33 +00:00
|
|
|
# Associates a list of `members` to a `role`. Optionally, may specify a
|
|
|
|
# `condition` that determines how and when the `bindings` are applied. Each
|
|
|
|
# of the `bindings` must contain at least one member.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `bindings`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Binding>]
|
|
|
|
attr_accessor :bindings
|
|
|
|
|
|
|
|
# `etag` is used for optimistic concurrency control as a way to help
|
|
|
|
# prevent simultaneous updates of a policy from overwriting each other.
|
|
|
|
# It is strongly suggested that systems make use of the `etag` in the
|
|
|
|
# read-modify-write cycle to perform policy updates in order to avoid race
|
|
|
|
# conditions: An `etag` is returned in the response to `getIamPolicy`, and
|
|
|
|
# systems are expected to put that etag in the request to `setIamPolicy` to
|
|
|
|
# ensure that their change will be applied to the same version of the policy.
|
2019-12-12 00:37:33 +00:00
|
|
|
# **Important:** If you use IAM Conditions, you must include the `etag` field
|
|
|
|
# whenever you call `setIamPolicy`. If you omit this field, then IAM allows
|
|
|
|
# you to overwrite a version `3` policy with a version `1` policy, and all of
|
|
|
|
# the conditions in the version `3` policy are lost.
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `etag`
|
|
|
|
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :etag
|
|
|
|
|
2019-09-19 00:37:15 +00:00
|
|
|
# Specifies the format of the policy.
|
2019-12-12 00:37:33 +00:00
|
|
|
# Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
|
|
|
|
# are rejected.
|
|
|
|
# Any operation that affects conditional role bindings must specify version
|
|
|
|
# `3`. This requirement applies to the following operations:
|
|
|
|
# * Getting a policy that includes a conditional role binding
|
|
|
|
# * Adding a conditional role binding to a policy
|
|
|
|
# * Changing a conditional role binding in a policy
|
|
|
|
# * Removing any role binding, with or without a condition, from a policy
|
|
|
|
# that includes conditions
|
|
|
|
# **Important:** If you use IAM Conditions, you must include the `etag` field
|
|
|
|
# whenever you call `setIamPolicy`. If you omit this field, then IAM allows
|
|
|
|
# you to overwrite a version `3` policy with a version `1` policy, and all of
|
|
|
|
# the conditions in the version `3` policy are lost.
|
|
|
|
# If a policy does not include any conditions, operations on that policy may
|
|
|
|
# specify any valid version or leave the field unset.
|
2020-05-07 20:07:42 +00:00
|
|
|
# To learn which resources support conditions in their IAM policies, see the
|
|
|
|
# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
|
|
|
|
# policies).
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `version`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :version
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@bindings = args[:bindings] if args.key?(:bindings)
|
|
|
|
@etag = args[:etag] if args.key?(:etag)
|
|
|
|
@version = args[:version] if args.key?(:version)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Selects a repo using a Google Cloud Platform project ID (e.g.,
|
|
|
|
# winged-cargo-31) and a repo name within that project.
|
|
|
|
class ProjectRepoId
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The ID of the project.
|
|
|
|
# Corresponds to the JSON property `projectId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :project_id
|
|
|
|
|
|
|
|
# The name of the repo. Leave empty for the default repo.
|
|
|
|
# Corresponds to the JSON property `repoName`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :repo_name
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@project_id = args[:project_id] if args.key?(:project_id)
|
|
|
|
@repo_name = args[:repo_name] if args.key?(:repo_name)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Metadata for any related URL information.
|
|
|
|
class RelatedUrl
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Label to describe usage of the URL.
|
|
|
|
# Corresponds to the JSON property `label`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :label
|
|
|
|
|
|
|
|
# Specific URL associated with the resource.
|
|
|
|
# Corresponds to the JSON property `url`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :url
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@label = args[:label] if args.key?(:label)
|
|
|
|
@url = args[:url] if args.key?(:url)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A unique identifier for a Cloud Repo.
|
|
|
|
class RepoId
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Selects a repo using a Google Cloud Platform project ID (e.g.,
|
|
|
|
# winged-cargo-31) and a repo name within that project.
|
|
|
|
# Corresponds to the JSON property `projectRepoId`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::ProjectRepoId]
|
|
|
|
attr_accessor :project_repo_id
|
|
|
|
|
|
|
|
# A server-assigned, globally unique identifier.
|
|
|
|
# Corresponds to the JSON property `uid`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :uid
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@project_repo_id = args[:project_repo_id] if args.key?(:project_repo_id)
|
|
|
|
@uid = args[:uid] if args.key?(:uid)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# An entity that can have metadata. For example, a Docker image.
|
|
|
|
class Resource
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Container message for hash values.
|
|
|
|
# Corresponds to the JSON property `contentHash`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::HashProp]
|
|
|
|
attr_accessor :content_hash
|
|
|
|
|
2019-05-31 00:37:37 +00:00
|
|
|
# Deprecated, do not use. Use uri instead.
|
2019-01-09 00:36:31 +00:00
|
|
|
# The name of the resource. For example, the name of a Docker image -
|
|
|
|
# "Debian".
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# Required. The unique URI of the resource. For example,
|
|
|
|
# `https://gcr.io/project/image@sha256:foo` for a Docker image.
|
|
|
|
# Corresponds to the JSON property `uri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :uri
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@content_hash = args[:content_hash] if args.key?(:content_hash)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@uri = args[:uri] if args.key?(:uri)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A scan configuration specifies whether Cloud components in a project have a
|
|
|
|
# particular type of analysis being run. For example, it can configure whether
|
|
|
|
# vulnerability scanning is being done on Docker images or not.
|
|
|
|
class ScanConfig
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Output only. The time this scan config was created.
|
|
|
|
# Corresponds to the JSON property `createTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :create_time
|
|
|
|
|
|
|
|
# Output only. A human-readable description of what the scan configuration
|
|
|
|
# does.
|
|
|
|
# Corresponds to the JSON property `description`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :description
|
|
|
|
|
|
|
|
# Whether the scan is enabled.
|
|
|
|
# Corresponds to the JSON property `enabled`
|
|
|
|
# @return [Boolean]
|
|
|
|
attr_accessor :enabled
|
|
|
|
alias_method :enabled?, :enabled
|
|
|
|
|
|
|
|
# Output only. The name of the scan configuration in the form of
|
|
|
|
# `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# Output only. The time this scan config 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)
|
|
|
|
@create_time = args[:create_time] if args.key?(:create_time)
|
|
|
|
@description = args[:description] if args.key?(:description)
|
|
|
|
@enabled = args[:enabled] if args.key?(:enabled)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@update_time = args[:update_time] if args.key?(:update_time)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Request message for `SetIamPolicy` method.
|
|
|
|
class SetIamPolicyRequest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2019-12-12 00:37:33 +00:00
|
|
|
# An Identity and Access Management (IAM) policy, which specifies access
|
|
|
|
# controls for Google Cloud resources.
|
2019-10-03 00:37:42 +00:00
|
|
|
# A `Policy` is a collection of `bindings`. A `binding` binds one or more
|
|
|
|
# `members` to a single `role`. Members can be user accounts, service accounts,
|
|
|
|
# Google groups, and domains (such as G Suite). A `role` is a named list of
|
2019-12-12 00:37:33 +00:00
|
|
|
# permissions; each `role` can be an IAM predefined role or a user-created
|
|
|
|
# custom role.
|
2020-05-07 20:07:42 +00:00
|
|
|
# For some types of Google Cloud resources, a `binding` can also specify a
|
|
|
|
# `condition`, which is a logical expression that allows access to a resource
|
|
|
|
# only if the expression evaluates to `true`. A condition can add constraints
|
|
|
|
# based on attributes of the request, the resource, or both. To learn which
|
|
|
|
# resources support conditions in their IAM policies, see the
|
|
|
|
# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
|
|
|
|
# policies).
|
2019-12-12 00:37:33 +00:00
|
|
|
# **JSON example:**
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
|
|
|
# "bindings": [
|
|
|
|
# `
|
2019-10-03 00:37:42 +00:00
|
|
|
# "role": "roles/resourcemanager.organizationAdmin",
|
2019-01-09 00:36:31 +00:00
|
|
|
# "members": [
|
|
|
|
# "user:mike@example.com",
|
|
|
|
# "group:admins@example.com",
|
|
|
|
# "domain:google.com",
|
2019-10-03 00:37:42 +00:00
|
|
|
# "serviceAccount:my-project-id@appspot.gserviceaccount.com"
|
2019-01-09 00:36:31 +00:00
|
|
|
# ]
|
|
|
|
# `,
|
|
|
|
# `
|
2019-10-03 00:37:42 +00:00
|
|
|
# "role": "roles/resourcemanager.organizationViewer",
|
2020-05-07 20:07:42 +00:00
|
|
|
# "members": [
|
|
|
|
# "user:eve@example.com"
|
|
|
|
# ],
|
2019-10-03 00:37:42 +00:00
|
|
|
# "condition": `
|
|
|
|
# "title": "expirable access",
|
|
|
|
# "description": "Does not grant access after Sep 2020",
|
2019-12-12 00:37:33 +00:00
|
|
|
# "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
|
|
|
|
# ",
|
2019-10-03 00:37:42 +00:00
|
|
|
# `
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
2019-12-12 00:37:33 +00:00
|
|
|
# ],
|
|
|
|
# "etag": "BwWWja0YfJA=",
|
|
|
|
# "version": 3
|
2019-01-09 00:36:31 +00:00
|
|
|
# `
|
2019-12-12 00:37:33 +00:00
|
|
|
# **YAML example:**
|
2019-01-09 00:36:31 +00:00
|
|
|
# bindings:
|
|
|
|
# - members:
|
|
|
|
# - user:mike@example.com
|
|
|
|
# - group:admins@example.com
|
|
|
|
# - domain:google.com
|
2019-10-03 00:37:42 +00:00
|
|
|
# - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
|
|
|
# role: roles/resourcemanager.organizationAdmin
|
2019-01-09 00:36:31 +00:00
|
|
|
# - members:
|
2019-10-03 00:37:42 +00:00
|
|
|
# - user:eve@example.com
|
|
|
|
# role: roles/resourcemanager.organizationViewer
|
|
|
|
# condition:
|
|
|
|
# title: expirable access
|
|
|
|
# description: Does not grant access after Sep 2020
|
|
|
|
# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
|
2019-12-12 00:37:33 +00:00
|
|
|
# - etag: BwWWja0YfJA=
|
|
|
|
# - version: 3
|
2019-01-09 00:36:31 +00:00
|
|
|
# For a description of IAM and its features, see the
|
2019-12-12 00:37:33 +00:00
|
|
|
# [IAM documentation](https://cloud.google.com/iam/docs/).
|
2019-01-09 00:36:31 +00:00
|
|
|
# Corresponds to the JSON property `policy`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Policy]
|
|
|
|
attr_accessor :policy
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@policy = args[:policy] if args.key?(:policy)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-03-21 00:37:30 +00:00
|
|
|
# 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).
|
|
|
|
class Signature
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The identifier for the public key that verifies this signature.
|
|
|
|
# * The `public_key_id` is required.
|
2020-06-25 00:37:57 +00:00
|
|
|
# * The `public_key_id` SHOULD be an RFC3986 conformant URI.
|
2019-03-21 00:37:30 +00:00
|
|
|
# * 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"
|
|
|
|
# Corresponds to the JSON property `publicKeyId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :public_key_id
|
|
|
|
|
|
|
|
# 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.
|
|
|
|
# Corresponds to the JSON property `signature`
|
|
|
|
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :signature
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@public_key_id = args[:public_key_id] if args.key?(:public_key_id)
|
|
|
|
@signature = args[:signature] if args.key?(:signature)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2020-05-07 20:07:42 +00:00
|
|
|
# This defines the format used to record keys used in the software supply
|
|
|
|
# chain. An in-toto link is attested using one or more keys defined in the
|
|
|
|
# in-toto layout. An example of this is:
|
|
|
|
# `
|
|
|
|
# "key_id": "776a00e29f3559e0141b3b096f696abc6cfb0c657ab40f441132b345b0...",
|
|
|
|
# "key_type": "rsa",
|
|
|
|
# "public_key_value": "-----BEGIN PUBLIC KEY-----\nMIIBojANBgkqhkiG9w0B...",
|
|
|
|
# "key_scheme": "rsassa-pss-sha256"
|
|
|
|
# `
|
|
|
|
# The format for in-toto's key definition can be found in section 4.2 of the
|
|
|
|
# in-toto specification.
|
|
|
|
class SigningKey
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# key_id is an identifier for the signing key.
|
|
|
|
# Corresponds to the JSON property `keyId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :key_id
|
|
|
|
|
|
|
|
# This field contains the corresponding signature scheme.
|
|
|
|
# Eg: "rsassa-pss-sha256".
|
|
|
|
# Corresponds to the JSON property `keyScheme`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :key_scheme
|
|
|
|
|
|
|
|
# This field identifies the specific signing method. Eg: "rsa", "ed25519",
|
|
|
|
# and "ecdsa".
|
|
|
|
# Corresponds to the JSON property `keyType`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :key_type
|
|
|
|
|
|
|
|
# This field contains the actual public key.
|
|
|
|
# Corresponds to the JSON property `publicKeyValue`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :public_key_value
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@key_id = args[:key_id] if args.key?(:key_id)
|
|
|
|
@key_scheme = args[:key_scheme] if args.key?(:key_scheme)
|
|
|
|
@key_type = args[:key_type] if args.key?(:key_type)
|
|
|
|
@public_key_value = args[:public_key_value] if args.key?(:public_key_value)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# Source describes the location of the source used for the build.
|
|
|
|
class Source
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# If provided, some of the source code used for the build may be found in
|
|
|
|
# these locations, in the case where the source repository had multiple
|
|
|
|
# remotes or submodules. This list will not include the context specified in
|
|
|
|
# the context field.
|
|
|
|
# Corresponds to the JSON property `additionalContexts`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::SourceContext>]
|
|
|
|
attr_accessor :additional_contexts
|
|
|
|
|
|
|
|
# If provided, the input binary artifacts for the build came from this
|
|
|
|
# location.
|
|
|
|
# Corresponds to the JSON property `artifactStorageSourceUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :artifact_storage_source_uri
|
|
|
|
|
|
|
|
# A SourceContext is a reference to a tree of files. A SourceContext together
|
|
|
|
# with a path point to a unique revision of a single file or directory.
|
|
|
|
# Corresponds to the JSON property `context`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::SourceContext]
|
|
|
|
attr_accessor :context
|
|
|
|
|
|
|
|
# Hash(es) of the build source, which can be used to verify that the original
|
|
|
|
# source integrity was maintained in the build.
|
|
|
|
# The keys to this map are file paths used as build source and the values
|
|
|
|
# contain the hash values for those files.
|
|
|
|
# If the build source came in a single package such as a gzipped tarfile
|
|
|
|
# (.tar.gz), the FileHash will be for the single path to that file.
|
|
|
|
# Corresponds to the JSON property `fileHashes`
|
|
|
|
# @return [Hash<String,Google::Apis::ContaineranalysisV1beta1::FileHashes>]
|
|
|
|
attr_accessor :file_hashes
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@additional_contexts = args[:additional_contexts] if args.key?(:additional_contexts)
|
|
|
|
@artifact_storage_source_uri = args[:artifact_storage_source_uri] if args.key?(:artifact_storage_source_uri)
|
|
|
|
@context = args[:context] if args.key?(:context)
|
|
|
|
@file_hashes = args[:file_hashes] if args.key?(:file_hashes)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A SourceContext is a reference to a tree of files. A SourceContext together
|
|
|
|
# with a path point to a unique revision of a single file or directory.
|
|
|
|
class SourceContext
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# A CloudRepoSourceContext denotes a particular revision in a Google Cloud
|
|
|
|
# Source Repo.
|
|
|
|
# Corresponds to the JSON property `cloudRepo`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::CloudRepoSourceContext]
|
|
|
|
attr_accessor :cloud_repo
|
|
|
|
|
|
|
|
# A SourceContext referring to a Gerrit project.
|
|
|
|
# Corresponds to the JSON property `gerrit`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GerritSourceContext]
|
|
|
|
attr_accessor :gerrit
|
|
|
|
|
|
|
|
# A GitSourceContext denotes a particular revision in a third party Git
|
|
|
|
# repository (e.g., GitHub).
|
|
|
|
# Corresponds to the JSON property `git`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::GitSourceContext]
|
|
|
|
attr_accessor :git
|
|
|
|
|
|
|
|
# Labels with user defined metadata.
|
|
|
|
# Corresponds to the JSON property `labels`
|
|
|
|
# @return [Hash<String,String>]
|
|
|
|
attr_accessor :labels
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cloud_repo = args[:cloud_repo] if args.key?(:cloud_repo)
|
|
|
|
@gerrit = args[:gerrit] if args.key?(:gerrit)
|
|
|
|
@git = args[:git] if args.key?(:git)
|
|
|
|
@labels = args[:labels] if args.key?(:labels)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2019-03-13 00:37:11 +00:00
|
|
|
# The `Status` type defines a logical error model that is suitable for
|
|
|
|
# different programming environments, including REST APIs and RPC APIs. It is
|
2019-06-06 00:40:37 +00:00
|
|
|
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
|
|
|
|
# three pieces of data: error code, error message, and error details.
|
|
|
|
# You can find out more about this error model and how to work with it in the
|
|
|
|
# [API Design Guide](https://cloud.google.com/apis/design/errors).
|
2019-01-09 00:36:31 +00:00
|
|
|
class Status
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The status code, which should be an enum value of google.rpc.Code.
|
|
|
|
# Corresponds to the JSON property `code`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :code
|
|
|
|
|
|
|
|
# A list of messages that carry the error details. There is a common set of
|
|
|
|
# message types for APIs to use.
|
|
|
|
# Corresponds to the JSON property `details`
|
|
|
|
# @return [Array<Hash<String,Object>>]
|
|
|
|
attr_accessor :details
|
|
|
|
|
|
|
|
# A developer-facing error message, which should be in English. Any
|
|
|
|
# user-facing error message should be localized and sent in the
|
|
|
|
# google.rpc.Status.details field, or localized by the client.
|
|
|
|
# Corresponds to the JSON property `message`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :message
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@code = args[:code] if args.key?(:code)
|
|
|
|
@details = args[:details] if args.key?(:details)
|
|
|
|
@message = args[:message] if args.key?(:message)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Request message for `TestIamPermissions` method.
|
|
|
|
class TestIamPermissionsRequest
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The set of permissions to check for the `resource`. Permissions with
|
|
|
|
# wildcards (such as '*' or 'storage.*') are not allowed. For more
|
|
|
|
# information see
|
|
|
|
# [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
|
|
|
|
# Corresponds to the JSON property `permissions`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :permissions
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@permissions = args[:permissions] if args.key?(:permissions)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Response message for `TestIamPermissions` method.
|
|
|
|
class TestIamPermissionsResponse
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# A subset of `TestPermissionsRequest.permissions` that the caller is
|
|
|
|
# allowed.
|
|
|
|
# Corresponds to the JSON property `permissions`
|
|
|
|
# @return [Array<String>]
|
|
|
|
attr_accessor :permissions
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@permissions = args[:permissions] if args.key?(:permissions)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
class Version
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Used to correct mistakes in the version numbering scheme.
|
|
|
|
# Corresponds to the JSON property `epoch`
|
|
|
|
# @return [Fixnum]
|
|
|
|
attr_accessor :epoch
|
|
|
|
|
|
|
|
# Required. Distinguishes between sentinel MIN/MAX versions and normal
|
|
|
|
# versions.
|
|
|
|
# Corresponds to the JSON property `kind`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :kind
|
|
|
|
|
|
|
|
# Required only when version kind is NORMAL. The main part of the version
|
|
|
|
# name.
|
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
# The iteration of the package build from the above version.
|
|
|
|
# Corresponds to the JSON property `revision`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :revision
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@epoch = args[:epoch] if args.key?(:epoch)
|
|
|
|
@kind = args[:kind] if args.key?(:kind)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
@revision = args[:revision] if args.key?(:revision)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Vulnerability provides metadata about a security vulnerability in a Note.
|
|
|
|
class Vulnerability
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# The CVSS score for this vulnerability.
|
|
|
|
# Corresponds to the JSON property `cvssScore`
|
|
|
|
# @return [Float]
|
|
|
|
attr_accessor :cvss_score
|
|
|
|
|
2019-04-25 00:37:02 +00:00
|
|
|
# Common Vulnerability Scoring System version 3.
|
|
|
|
# For details, see https://www.first.org/cvss/specification-document
|
|
|
|
# Corresponds to the JSON property `cvssV3`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::CvsSv3]
|
|
|
|
attr_accessor :cvss_v3
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
# All information about the package to specifically identify this
|
|
|
|
# vulnerability. One entry per (version range and cpe_uri) the package
|
|
|
|
# vulnerability has manifested in.
|
|
|
|
# Corresponds to the JSON property `details`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::Detail>]
|
|
|
|
attr_accessor :details
|
|
|
|
|
|
|
|
# Note provider assigned impact of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `severity`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :severity
|
|
|
|
|
2019-08-10 00:38:10 +00:00
|
|
|
# The time this information was last changed at the source. This is an
|
|
|
|
# upstream timestamp from the underlying information source - e.g. Ubuntu
|
|
|
|
# security tracker.
|
|
|
|
# Corresponds to the JSON property `sourceUpdateTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :source_update_time
|
|
|
|
|
2019-01-23 00:36:37 +00:00
|
|
|
# Windows details get their own format because the information format and
|
|
|
|
# model don't match a normal detail. Specifically Windows updates are done as
|
|
|
|
# patches, thus Windows vulnerabilities really are a missing package, rather
|
|
|
|
# than a package being at an incorrect version.
|
|
|
|
# Corresponds to the JSON property `windowsDetails`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::WindowsDetail>]
|
|
|
|
attr_accessor :windows_details
|
|
|
|
|
2019-01-09 00:36:31 +00:00
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cvss_score = args[:cvss_score] if args.key?(:cvss_score)
|
2019-04-25 00:37:02 +00:00
|
|
|
@cvss_v3 = args[:cvss_v3] if args.key?(:cvss_v3)
|
2019-01-09 00:36:31 +00:00
|
|
|
@details = args[:details] if args.key?(:details)
|
|
|
|
@severity = args[:severity] if args.key?(:severity)
|
2019-08-10 00:38:10 +00:00
|
|
|
@source_update_time = args[:source_update_time] if args.key?(:source_update_time)
|
2019-01-23 00:36:37 +00:00
|
|
|
@windows_details = args[:windows_details] if args.key?(:windows_details)
|
2019-01-09 00:36:31 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# The location of the vulnerability.
|
|
|
|
class VulnerabilityLocation
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The CPE URI in [cpe format](https://cpe.mitre.org/specification/)
|
|
|
|
# format. Examples include distro or storage location for vulnerable jar.
|
|
|
|
# Corresponds to the JSON property `cpeUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :cpe_uri
|
|
|
|
|
|
|
|
# Required. The package being described.
|
|
|
|
# Corresponds to the JSON property `package`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :package
|
|
|
|
|
|
|
|
# Version contains structured information about the version of a package.
|
|
|
|
# Corresponds to the JSON property `version`
|
|
|
|
# @return [Google::Apis::ContaineranalysisV1beta1::Version]
|
|
|
|
attr_accessor :version
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@cpe_uri = args[:cpe_uri] if args.key?(:cpe_uri)
|
|
|
|
@package = args[:package] if args.key?(:package)
|
|
|
|
@version = args[:version] if args.key?(:version)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# A summary of how many vulnerability occurrences there are per resource and
|
|
|
|
# severity type.
|
|
|
|
class VulnerabilityOccurrencesSummary
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# A listing by resource of the number of fixable and total vulnerabilities.
|
|
|
|
# Corresponds to the JSON property `counts`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::FixableTotalByDigest>]
|
|
|
|
attr_accessor :counts
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@counts = args[:counts] if args.key?(:counts)
|
|
|
|
end
|
|
|
|
end
|
2019-01-23 00:36:37 +00:00
|
|
|
|
|
|
|
#
|
|
|
|
class WindowsDetail
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Required. The CPE URI in
|
|
|
|
# [cpe format](https://cpe.mitre.org/specification/) in which the
|
|
|
|
# vulnerability manifests. Examples include distro or storage location for
|
|
|
|
# vulnerable jar.
|
|
|
|
# Corresponds to the JSON property `cpeUri`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :cpe_uri
|
|
|
|
|
|
|
|
# The description of the vulnerability.
|
|
|
|
# Corresponds to the JSON property `description`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :description
|
|
|
|
|
|
|
|
# Required. The names of the KBs which have hotfixes to mitigate this
|
|
|
|
# vulnerability. Note that there may be multiple hotfixes (and thus
|
|
|
|
# multiple KBs) that mitigate a given vulnerability. Currently any listed
|
|
|
|
# kb's presence is considered a fix.
|
|
|
|
# Corresponds to the JSON property `fixingKbs`
|
|
|
|
# @return [Array<Google::Apis::ContaineranalysisV1beta1::KnowledgeBase>]
|
|
|
|
attr_accessor :fixing_kbs
|
|
|
|
|
|
|
|
# Required. The name of the vulnerability.
|
|
|
|
# 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)
|
|
|
|
@cpe_uri = args[:cpe_uri] if args.key?(:cpe_uri)
|
|
|
|
@description = args[:description] if args.key?(:description)
|
|
|
|
@fixing_kbs = args[:fixing_kbs] if args.key?(:fixing_kbs)
|
|
|
|
@name = args[:name] if args.key?(:name)
|
|
|
|
end
|
|
|
|
end
|
2019-01-09 00:36:31 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|