grafeas-client 0.1.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.yardopts +11 -0
- data/AUTHENTICATION.md +199 -0
- data/LICENSE +201 -0
- data/README.md +69 -0
- data/lib/grafeas-client.rb +16 -0
- data/lib/grafeas.rb +150 -0
- data/lib/grafeas/v1.rb +147 -0
- data/lib/grafeas/v1/attestation_pb.rb +27 -0
- data/lib/grafeas/v1/build_pb.rb +23 -0
- data/lib/grafeas/v1/common_pb.rb +34 -0
- data/lib/grafeas/v1/credentials.rb +37 -0
- data/lib/grafeas/v1/cvss_pb.rb +67 -0
- data/lib/grafeas/v1/deployment_pb.rb +35 -0
- data/lib/grafeas/v1/discovery_pb.rb +40 -0
- data/lib/grafeas/v1/doc/google/protobuf/any.rb +131 -0
- data/lib/grafeas/v1/doc/google/protobuf/empty.rb +29 -0
- data/lib/grafeas/v1/doc/google/protobuf/field_mask.rb +222 -0
- data/lib/grafeas/v1/doc/google/protobuf/timestamp.rb +111 -0
- data/lib/grafeas/v1/doc/google/rpc/status.rb +87 -0
- data/lib/grafeas/v1/doc/grafeas/v1/attestation.rb +64 -0
- data/lib/grafeas/v1/doc/grafeas/v1/build.rb +44 -0
- data/lib/grafeas/v1/doc/grafeas/v1/common.rb +105 -0
- data/lib/grafeas/v1/doc/grafeas/v1/cvss.rb +104 -0
- data/lib/grafeas/v1/doc/grafeas/v1/deployment.rb +64 -0
- data/lib/grafeas/v1/doc/grafeas/v1/discovery.rb +76 -0
- data/lib/grafeas/v1/doc/grafeas/v1/grafeas.rb +322 -0
- data/lib/grafeas/v1/doc/grafeas/v1/image.rb +79 -0
- data/lib/grafeas/v1/doc/grafeas/v1/package.rb +125 -0
- data/lib/grafeas/v1/doc/grafeas/v1/provenance.rb +248 -0
- data/lib/grafeas/v1/doc/grafeas/v1/vulnerability.rb +197 -0
- data/lib/grafeas/v1/grafeas_client.rb +955 -0
- data/lib/grafeas/v1/grafeas_client_config.json +96 -0
- data/lib/grafeas/v1/grafeas_pb.rb +163 -0
- data/lib/grafeas/v1/grafeas_services_pb.rb +86 -0
- data/lib/grafeas/v1/image_pb.rb +36 -0
- data/lib/grafeas/v1/package_pb.rb +59 -0
- data/lib/grafeas/v1/provenance_pb.rb +116 -0
- data/lib/grafeas/v1/vulnerability_pb.rb +80 -0
- data/lib/grafeas/version.rb +18 -0
- metadata +179 -0
@@ -0,0 +1,111 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Google
|
17
|
+
module Protobuf
|
18
|
+
# A Timestamp represents a point in time independent of any time zone or local
|
19
|
+
# calendar, encoded as a count of seconds and fractions of seconds at
|
20
|
+
# nanosecond resolution. The count is relative to an epoch at UTC midnight on
|
21
|
+
# January 1, 1970, in the proleptic Gregorian calendar which extends the
|
22
|
+
# Gregorian calendar backwards to year one.
|
23
|
+
#
|
24
|
+
# All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
|
25
|
+
# second table is needed for interpretation, using a [24-hour linear
|
26
|
+
# smear](https://developers.google.com/time/smear).
|
27
|
+
#
|
28
|
+
# The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
|
29
|
+
# restricting to that range, we ensure that we can convert to and from [RFC
|
30
|
+
# 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
|
31
|
+
#
|
32
|
+
# = Examples
|
33
|
+
#
|
34
|
+
# Example 1: Compute Timestamp from POSIX `time()`.
|
35
|
+
#
|
36
|
+
# Timestamp timestamp;
|
37
|
+
# timestamp.set_seconds(time(NULL));
|
38
|
+
# timestamp.set_nanos(0);
|
39
|
+
#
|
40
|
+
# Example 2: Compute Timestamp from POSIX `gettimeofday()`.
|
41
|
+
#
|
42
|
+
# struct timeval tv;
|
43
|
+
# gettimeofday(&tv, NULL);
|
44
|
+
#
|
45
|
+
# Timestamp timestamp;
|
46
|
+
# timestamp.set_seconds(tv.tv_sec);
|
47
|
+
# timestamp.set_nanos(tv.tv_usec * 1000);
|
48
|
+
#
|
49
|
+
# Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
|
50
|
+
#
|
51
|
+
# FILETIME ft;
|
52
|
+
# GetSystemTimeAsFileTime(&ft);
|
53
|
+
# UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
|
54
|
+
#
|
55
|
+
# // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
|
56
|
+
# // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
|
57
|
+
# Timestamp timestamp;
|
58
|
+
# timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
|
59
|
+
# timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
|
60
|
+
#
|
61
|
+
# Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
|
62
|
+
#
|
63
|
+
# long millis = System.currentTimeMillis();
|
64
|
+
#
|
65
|
+
# Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
|
66
|
+
# .setNanos((int) ((millis % 1000) * 1000000)).build();
|
67
|
+
#
|
68
|
+
#
|
69
|
+
# Example 5: Compute Timestamp from current time in Python.
|
70
|
+
#
|
71
|
+
# timestamp = Timestamp()
|
72
|
+
# timestamp.GetCurrentTime()
|
73
|
+
#
|
74
|
+
# = JSON Mapping
|
75
|
+
#
|
76
|
+
# In JSON format, the Timestamp type is encoded as a string in the
|
77
|
+
# [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
|
78
|
+
# format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
|
79
|
+
# where \\{year} is always expressed using four digits while \\{month}, \\{day},
|
80
|
+
# \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
|
81
|
+
# seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
|
82
|
+
# are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
|
83
|
+
# is required. A proto3 JSON serializer should always use UTC (as indicated by
|
84
|
+
# "Z") when printing the Timestamp type and a proto3 JSON parser should be
|
85
|
+
# able to accept both UTC and other timezones (as indicated by an offset).
|
86
|
+
#
|
87
|
+
# For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
|
88
|
+
# 01:30 UTC on January 15, 2017.
|
89
|
+
#
|
90
|
+
# In JavaScript, one can convert a Date object to this format using the
|
91
|
+
# standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
|
92
|
+
# method. In Python, a standard `datetime.datetime` object can be converted
|
93
|
+
# to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
|
94
|
+
# with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
|
95
|
+
# can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
|
96
|
+
# http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
|
97
|
+
# ) to obtain a formatter capable of generating timestamps in this format.
|
98
|
+
# @!attribute [rw] seconds
|
99
|
+
# @return [Integer]
|
100
|
+
# Represents seconds of UTC time since Unix epoch
|
101
|
+
# 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
|
102
|
+
# 9999-12-31T23:59:59Z inclusive.
|
103
|
+
# @!attribute [rw] nanos
|
104
|
+
# @return [Integer]
|
105
|
+
# Non-negative fractions of a second at nanosecond resolution. Negative
|
106
|
+
# second values with fractions must still have non-negative nanos values
|
107
|
+
# that count forward in time. Must be from 0 to 999,999,999
|
108
|
+
# inclusive.
|
109
|
+
class Timestamp; end
|
110
|
+
end
|
111
|
+
end
|
@@ -0,0 +1,87 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Google
|
17
|
+
module Rpc
|
18
|
+
# The `Status` type defines a logical error model that is suitable for
|
19
|
+
# different programming environments, including REST APIs and RPC APIs. It is
|
20
|
+
# used by [gRPC](https://github.com/grpc). The error model is designed to be:
|
21
|
+
#
|
22
|
+
# * Simple to use and understand for most users
|
23
|
+
# * Flexible enough to meet unexpected needs
|
24
|
+
#
|
25
|
+
# = Overview
|
26
|
+
#
|
27
|
+
# The `Status` message contains three pieces of data: error code, error
|
28
|
+
# message, and error details. The error code should be an enum value of
|
29
|
+
# {Google::Rpc::Code}, but it may accept additional error codes
|
30
|
+
# if needed. The error message should be a developer-facing English message
|
31
|
+
# that helps developers *understand* and *resolve* the error. If a localized
|
32
|
+
# user-facing error message is needed, put the localized message in the error
|
33
|
+
# details or localize it in the client. The optional error details may contain
|
34
|
+
# arbitrary information about the error. There is a predefined set of error
|
35
|
+
# detail types in the package `google.rpc` that can be used for common error
|
36
|
+
# conditions.
|
37
|
+
#
|
38
|
+
# = Language mapping
|
39
|
+
#
|
40
|
+
# The `Status` message is the logical representation of the error model, but it
|
41
|
+
# is not necessarily the actual wire format. When the `Status` message is
|
42
|
+
# exposed in different client libraries and different wire protocols, it can be
|
43
|
+
# mapped differently. For example, it will likely be mapped to some exceptions
|
44
|
+
# in Java, but more likely mapped to some error codes in C.
|
45
|
+
#
|
46
|
+
# = Other uses
|
47
|
+
#
|
48
|
+
# The error model and the `Status` message can be used in a variety of
|
49
|
+
# environments, either with or without APIs, to provide a
|
50
|
+
# consistent developer experience across different environments.
|
51
|
+
#
|
52
|
+
# Example uses of this error model include:
|
53
|
+
#
|
54
|
+
# * Partial errors. If a service needs to return partial errors to the client,
|
55
|
+
# it may embed the `Status` in the normal response to indicate the partial
|
56
|
+
# errors.
|
57
|
+
#
|
58
|
+
# * Workflow errors. A typical workflow has multiple steps. Each step may
|
59
|
+
# have a `Status` message for error reporting.
|
60
|
+
#
|
61
|
+
# * Batch operations. If a client uses batch request and batch response, the
|
62
|
+
# `Status` message should be used directly inside batch response, one for
|
63
|
+
# each error sub-response.
|
64
|
+
#
|
65
|
+
# * Asynchronous operations. If an API call embeds asynchronous operation
|
66
|
+
# results in its response, the status of those operations should be
|
67
|
+
# represented directly using the `Status` message.
|
68
|
+
#
|
69
|
+
# * Logging. If some API errors are stored in logs, the message `Status` could
|
70
|
+
# be used directly after any stripping needed for security/privacy reasons.
|
71
|
+
# @!attribute [rw] code
|
72
|
+
# @return [Integer]
|
73
|
+
# The status code, which should be an enum value of
|
74
|
+
# {Google::Rpc::Code}.
|
75
|
+
# @!attribute [rw] message
|
76
|
+
# @return [String]
|
77
|
+
# A developer-facing error message, which should be in English. Any
|
78
|
+
# user-facing error message should be localized and sent in the
|
79
|
+
# {Google::Rpc::Status#details} field, or localized
|
80
|
+
# by the client.
|
81
|
+
# @!attribute [rw] details
|
82
|
+
# @return [Array<Google::Protobuf::Any>]
|
83
|
+
# A list of messages that carry the error details. There is a common set of
|
84
|
+
# message types for APIs to use.
|
85
|
+
class Status; end
|
86
|
+
end
|
87
|
+
end
|
@@ -0,0 +1,64 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Grafeas
|
17
|
+
module V1
|
18
|
+
# Note kind that represents a logical attestation "role" or "authority". For
|
19
|
+
# example, an organization might have one `Authority` for "QA" and one for
|
20
|
+
# "build". This note is intended to act strictly as a grouping mechanism for
|
21
|
+
# the attached occurrences (Attestations). This grouping mechanism also
|
22
|
+
# provides a security boundary, since IAM ACLs gate the ability for a principle
|
23
|
+
# to attach an occurrence to a given note. It also provides a single point of
|
24
|
+
# lookup to find all attached attestation occurrences, even if they don't all
|
25
|
+
# live in the same project.
|
26
|
+
# @!attribute [rw] hint
|
27
|
+
# @return [Grafeas::V1::AttestationNote::Hint]
|
28
|
+
# Hint hints at the purpose of the attestation authority.
|
29
|
+
class AttestationNote
|
30
|
+
# This submessage provides human-readable hints about the purpose of the
|
31
|
+
# authority. Because the name of a note acts as its resource reference, it is
|
32
|
+
# important to disambiguate the canonical name of the Note (which might be a
|
33
|
+
# UUID for security purposes) from "readable" names more suitable for debug
|
34
|
+
# output. Note that these hints should not be used to look up authorities in
|
35
|
+
# security sensitive contexts, such as when looking up attestations to
|
36
|
+
# verify.
|
37
|
+
# @!attribute [rw] human_readable_name
|
38
|
+
# @return [String]
|
39
|
+
# Required. The human readable name of this attestation authority, for
|
40
|
+
# example "qa".
|
41
|
+
class Hint; end
|
42
|
+
end
|
43
|
+
|
44
|
+
# Occurrence that represents a single "attestation". The authenticity of an
|
45
|
+
# attestation can be verified using the attached signature. If the verifier
|
46
|
+
# trusts the public key of the signer, then verifying the signature is
|
47
|
+
# sufficient to establish trust. In this circumstance, the authority to which
|
48
|
+
# this attestation is attached is primarily useful for lookup (how to find
|
49
|
+
# this attestation if you already know the authority and artifact to be
|
50
|
+
# verified) and intent (for which authority this attestation was intended to
|
51
|
+
# sign.
|
52
|
+
# @!attribute [rw] serialized_payload
|
53
|
+
# @return [String]
|
54
|
+
# Required. The serialized payload that is verified by one or more
|
55
|
+
# `signatures`.
|
56
|
+
# @!attribute [rw] signatures
|
57
|
+
# @return [Array<Grafeas::V1::Signature>]
|
58
|
+
# One or more signatures over `serialized_payload`. Verifier implementations
|
59
|
+
# should consider this attestation message verified if at least one
|
60
|
+
# `signature` verifies `serialized_payload`. See `Signature` in common.proto
|
61
|
+
# for more details on signature structure and verification.
|
62
|
+
class AttestationOccurrence; end
|
63
|
+
end
|
64
|
+
end
|
@@ -0,0 +1,44 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Grafeas
|
17
|
+
module V1
|
18
|
+
# Note holding the version of the provider's builder and the signature of the
|
19
|
+
# provenance message in the build details occurrence.
|
20
|
+
# @!attribute [rw] builder_version
|
21
|
+
# @return [String]
|
22
|
+
# Required. Immutable. Version of the builder which produced this build.
|
23
|
+
class BuildNote; end
|
24
|
+
|
25
|
+
# Details of a build occurrence.
|
26
|
+
# @!attribute [rw] provenance
|
27
|
+
# @return [Grafeas::V1::BuildProvenance]
|
28
|
+
# Required. The actual provenance for the build.
|
29
|
+
# @!attribute [rw] provenance_bytes
|
30
|
+
# @return [String]
|
31
|
+
# Serialized JSON representation of the provenance, used in generating the
|
32
|
+
# build signature in the corresponding build note. After verifying the
|
33
|
+
# signature, `provenance_bytes` can be unmarshalled and compared to the
|
34
|
+
# provenance to confirm that it is unchanged. A base64-encoded string
|
35
|
+
# representation of the provenance bytes is used for the signature in order
|
36
|
+
# to interoperate with openssl which expects this format for signature
|
37
|
+
# verification.
|
38
|
+
#
|
39
|
+
# The serialized form is captured both to avoid ambiguity in how the
|
40
|
+
# provenance is marshalled to json as well to prevent incompatibilities with
|
41
|
+
# future changes.
|
42
|
+
class BuildOccurrence; end
|
43
|
+
end
|
44
|
+
end
|
@@ -0,0 +1,105 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Grafeas
|
17
|
+
module V1
|
18
|
+
# Metadata for any related URL information.
|
19
|
+
# @!attribute [rw] url
|
20
|
+
# @return [String]
|
21
|
+
# Specific URL associated with the resource.
|
22
|
+
# @!attribute [rw] label
|
23
|
+
# @return [String]
|
24
|
+
# Label to describe usage of the URL.
|
25
|
+
class RelatedUrl; end
|
26
|
+
|
27
|
+
# Verifiers (e.g. Kritis implementations) MUST verify signatures
|
28
|
+
# with respect to the trust anchors defined in policy (e.g. a Kritis policy).
|
29
|
+
# Typically this means that the verifier has been configured with a map from
|
30
|
+
# `public_key_id` to public key material (and any required parameters, e.g.
|
31
|
+
# signing algorithm).
|
32
|
+
#
|
33
|
+
# In particular, verification implementations MUST NOT treat the signature
|
34
|
+
# `public_key_id` as anything more than a key lookup hint. The `public_key_id`
|
35
|
+
# DOES NOT validate or authenticate a public key; it only provides a mechanism
|
36
|
+
# for quickly selecting a public key ALREADY CONFIGURED on the verifier through
|
37
|
+
# a trusted channel. Verification implementations MUST reject signatures in any
|
38
|
+
# of the following circumstances:
|
39
|
+
# * The `public_key_id` is not recognized by the verifier.
|
40
|
+
# * The public key that `public_key_id` refers to does not verify the
|
41
|
+
# signature with respect to the payload.
|
42
|
+
#
|
43
|
+
# The `signature` contents SHOULD NOT be "attached" (where the payload is
|
44
|
+
# included with the serialized `signature` bytes). Verifiers MUST ignore any
|
45
|
+
# "attached" payload and only verify signatures with respect to explicitly
|
46
|
+
# provided payload (e.g. a `payload` field on the proto message that holds
|
47
|
+
# this Signature, or the canonical serialization of the proto message that
|
48
|
+
# holds this signature).
|
49
|
+
# @!attribute [rw] signature
|
50
|
+
# @return [String]
|
51
|
+
# The content of the signature, an opaque bytestring.
|
52
|
+
# The payload that this signature verifies MUST be unambiguously provided
|
53
|
+
# with the Signature during verification. A wrapper message might provide
|
54
|
+
# the payload explicitly. Alternatively, a message might have a canonical
|
55
|
+
# serialization that can always be unambiguously computed to derive the
|
56
|
+
# payload.
|
57
|
+
# @!attribute [rw] public_key_id
|
58
|
+
# @return [String]
|
59
|
+
# The identifier for the public key that verifies this signature.
|
60
|
+
# * The `public_key_id` is required.
|
61
|
+
# * The `public_key_id` MUST be an RFC3986 conformant URI.
|
62
|
+
# * When possible, the `public_key_id` SHOULD be an immutable reference,
|
63
|
+
# such as a cryptographic digest.
|
64
|
+
#
|
65
|
+
# Examples of valid `public_key_id`s:
|
66
|
+
#
|
67
|
+
# OpenPGP V4 public key fingerprint:
|
68
|
+
# * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
|
69
|
+
# See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
|
70
|
+
# details on this scheme.
|
71
|
+
#
|
72
|
+
# RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
|
73
|
+
# serialization):
|
74
|
+
# * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
|
75
|
+
# * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
|
76
|
+
class Signature; end
|
77
|
+
|
78
|
+
# Kind represents the kinds of notes supported.
|
79
|
+
module NoteKind
|
80
|
+
# Unknown.
|
81
|
+
NOTE_KIND_UNSPECIFIED = 0
|
82
|
+
|
83
|
+
# The note and occurrence represent a package vulnerability.
|
84
|
+
VULNERABILITY = 1
|
85
|
+
|
86
|
+
# The note and occurrence assert build provenance.
|
87
|
+
BUILD = 2
|
88
|
+
|
89
|
+
# This represents an image basis relationship.
|
90
|
+
IMAGE = 3
|
91
|
+
|
92
|
+
# This represents a package installed via a package manager.
|
93
|
+
PACKAGE = 4
|
94
|
+
|
95
|
+
# The note and occurrence track deployment events.
|
96
|
+
DEPLOYMENT = 5
|
97
|
+
|
98
|
+
# The note and occurrence track the initial discovery status of a resource.
|
99
|
+
DISCOVERY = 6
|
100
|
+
|
101
|
+
# This represents a logical "role" that can attest to artifacts.
|
102
|
+
ATTESTATION = 7
|
103
|
+
end
|
104
|
+
end
|
105
|
+
end
|
@@ -0,0 +1,104 @@
|
|
1
|
+
# Copyright 2019 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
|
16
|
+
module Grafeas
|
17
|
+
module V1
|
18
|
+
# Common Vulnerability Scoring System version 3.
|
19
|
+
# For details, see https://www.first.org/cvss/specification-document
|
20
|
+
# @!attribute [rw] base_score
|
21
|
+
# @return [Float]
|
22
|
+
# The base score is a function of the base metric scores.
|
23
|
+
# @!attribute [rw] exploitability_score
|
24
|
+
# @return [Float]
|
25
|
+
# @!attribute [rw] impact_score
|
26
|
+
# @return [Float]
|
27
|
+
# @!attribute [rw] attack_vector
|
28
|
+
# @return [Grafeas::V1::CVSSv3::AttackVector]
|
29
|
+
# Base Metrics
|
30
|
+
# Represents the intrinsic characteristics of a vulnerability that are
|
31
|
+
# constant over time and across user environments.
|
32
|
+
# @!attribute [rw] attack_complexity
|
33
|
+
# @return [Grafeas::V1::CVSSv3::AttackComplexity]
|
34
|
+
# @!attribute [rw] privileges_required
|
35
|
+
# @return [Grafeas::V1::CVSSv3::PrivilegesRequired]
|
36
|
+
# @!attribute [rw] user_interaction
|
37
|
+
# @return [Grafeas::V1::CVSSv3::UserInteraction]
|
38
|
+
# @!attribute [rw] scope
|
39
|
+
# @return [Grafeas::V1::CVSSv3::Scope]
|
40
|
+
# @!attribute [rw] confidentiality_impact
|
41
|
+
# @return [Grafeas::V1::CVSSv3::Impact]
|
42
|
+
# @!attribute [rw] integrity_impact
|
43
|
+
# @return [Grafeas::V1::CVSSv3::Impact]
|
44
|
+
# @!attribute [rw] availability_impact
|
45
|
+
# @return [Grafeas::V1::CVSSv3::Impact]
|
46
|
+
class CVSSv3
|
47
|
+
module AttackComplexity
|
48
|
+
ATTACK_COMPLEXITY_UNSPECIFIED = 0
|
49
|
+
|
50
|
+
ATTACK_COMPLEXITY_LOW = 1
|
51
|
+
|
52
|
+
ATTACK_COMPLEXITY_HIGH = 2
|
53
|
+
end
|
54
|
+
|
55
|
+
module AttackVector
|
56
|
+
ATTACK_VECTOR_UNSPECIFIED = 0
|
57
|
+
|
58
|
+
ATTACK_VECTOR_NETWORK = 1
|
59
|
+
|
60
|
+
ATTACK_VECTOR_ADJACENT = 2
|
61
|
+
|
62
|
+
ATTACK_VECTOR_LOCAL = 3
|
63
|
+
|
64
|
+
ATTACK_VECTOR_PHYSICAL = 4
|
65
|
+
end
|
66
|
+
|
67
|
+
module Impact
|
68
|
+
IMPACT_UNSPECIFIED = 0
|
69
|
+
|
70
|
+
IMPACT_HIGH = 1
|
71
|
+
|
72
|
+
IMPACT_LOW = 2
|
73
|
+
|
74
|
+
IMPACT_NONE = 3
|
75
|
+
end
|
76
|
+
|
77
|
+
module PrivilegesRequired
|
78
|
+
PRIVILEGES_REQUIRED_UNSPECIFIED = 0
|
79
|
+
|
80
|
+
PRIVILEGES_REQUIRED_NONE = 1
|
81
|
+
|
82
|
+
PRIVILEGES_REQUIRED_LOW = 2
|
83
|
+
|
84
|
+
PRIVILEGES_REQUIRED_HIGH = 3
|
85
|
+
end
|
86
|
+
|
87
|
+
module Scope
|
88
|
+
SCOPE_UNSPECIFIED = 0
|
89
|
+
|
90
|
+
SCOPE_UNCHANGED = 1
|
91
|
+
|
92
|
+
SCOPE_CHANGED = 2
|
93
|
+
end
|
94
|
+
|
95
|
+
module UserInteraction
|
96
|
+
USER_INTERACTION_UNSPECIFIED = 0
|
97
|
+
|
98
|
+
USER_INTERACTION_NONE = 1
|
99
|
+
|
100
|
+
USER_INTERACTION_REQUIRED = 2
|
101
|
+
end
|
102
|
+
end
|
103
|
+
end
|
104
|
+
end
|