You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Remove duplicate Additional resources section from metadata index (#438)
- Remove second Additional resources heading
- Remove self-referential link to metadata:index.adoc
- Consolidate Conforma tool information into single resources section
Fixes#436
Copy file name to clipboardExpand all lines: modules/metadata/pages/index.adoc
+9-13Lines changed: 9 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ The SLSA Build (v1.0) specification assigns two primary responsibilities to buil
21
21
22
22
SLSA also includes three Build Levels, which provide you with increasing guarantees about how build platforms fulfill these responsibilities. Any build platform that generates provenance conforms to the SLSA framework’s Build Level 1 (L1) specifications. Build platforms produce artifacts with higher Build Levels by hardening provenance against forgery and by isolating the build process. As of the v1.0 specification, Build Level 3 (L3) is the highest Build Level. {ProductName} produces Build L3 artifacts.
23
23
24
-
The rest of this document further explains our key responsibilities, provenance and build isolation, and how we fulfill those responsibilities. It concludes with a table summarizing how {ProductName} meets the requirements for SLSA Build L3.
24
+
The rest of this document further explains our key responsibilities, provenance and build isolation, and how we fulfill those responsibilities. It concludes with a table summarizing how {ProductName} meets the requirements for SLSA Build L3.
25
25
26
26
27
27
=== SLSA Provenance
@@ -30,11 +30,11 @@ In the context of its framework, link:https://slsa.dev/spec/v1.0/provenance[SLSA
30
30
31
31
==== Attestation
32
32
33
-
You can think of attestation like a recipe: a recipe tells you how someone made a certain dish, and attestation tells you how a build platform created a software artifact. SLSA provenance is a form of attestation. The SLSA provenance that {ProductName} provides includes a subject that tells you which artifact the attestation belongs to, and a predicate that explains how {ProductName} built each artifact, including relevant links.
33
+
You can think of attestation like a recipe: a recipe tells you how someone made a certain dish, and attestation tells you how a build platform created a software artifact. SLSA provenance is a form of attestation. The SLSA provenance that {ProductName} provides includes a subject that tells you which artifact the attestation belongs to, and a predicate that explains how {ProductName} built each artifact, including relevant links.
34
34
35
35
==== Signing the attestation
36
36
37
-
At higher Build Levels, SLSA directs build platforms to harden their provenance by signing each attestation. With the signature, you can verify that no one tampered with the attestation for your artifacts. Currently, {ProductName} signs attestations using a private key.
37
+
At higher Build Levels, SLSA directs build platforms to harden their provenance by signing each attestation. With the signature, you can verify that no one tampered with the attestation for your artifacts. Currently, {ProductName} signs attestations using a private key.
38
38
39
39
==== Evaluating provenance
40
40
@@ -44,9 +44,9 @@ In its Build Levels, SLSA evaluates provenance based on three questions:
44
44
* Authenticity: How certain are you that the provenance came from the builder?
45
45
* Accuracy: How difficult is it to tamper with provenance during the build process?
46
46
47
-
Completeness of provenance comes from its attestation format, and authenticity derives from the signature.
47
+
Completeness of provenance comes from its attestation format, and authenticity derives from the signature.
48
48
49
-
Accuracy is where provenance and build isolation intersect. To generate unforgeable provenance, build platforms must store those secret materials in a secure management system that platform users cannot access. In {ProductName}, only Tekton Chains, which generates and signs provenance, has access to the private key.
49
+
Accuracy is where provenance and build isolation intersect. To generate unforgeable provenance, build platforms must store those secret materials in a secure management system that platform users cannot access. In {ProductName}, only Tekton Chains, which generates and signs provenance, has access to the private key.
50
50
51
51
52
52
== Build isolation
@@ -55,25 +55,25 @@ According to the SLSA framework, our other primary responsibility is to guarante
55
55
56
56
=== Hosted
57
57
58
-
If builds run on an individual’s workstation, they become inconsistent. This inconsistency can cause mundane technical issues, but it also introduces security risks. What if undetected malware is lurking on that person’s machine?
58
+
If builds run on an individual’s workstation, they become inconsistent. This inconsistency can cause mundane technical issues, but it also introduces security risks. What if undetected malware is lurking on that person’s machine?
59
59
60
60
To shrink the attack plane, SLSA dictates that builds should execute “using a hosted build platform on shared or dedicated infrastructure, not on an individual’s workstation.” By using an environment that comes from a known, auditable state, build platforms can largely ensure that they generate artifacts in the same way every time.
61
61
62
-
{ProductName} is a hosted build platform. We execute builds on Amazon Web Services (AWS) through Red Hat OpenShift Service on AWS (ROSA).
62
+
{ProductName} is a hosted build platform. We execute builds on Amazon Web Services (AWS) through Red Hat OpenShift Service on AWS (ROSA).
63
63
64
64
65
65
=== Internally isolated
66
66
67
67
Running builds in a hosted environment can protect your builds from malware installed on an individual’s workstation. But an attacker could gain access to your instance of a hosted build platform. What if they inject a malicious payload into one of your artifacts during the build process, and falsify the provenance to cover their tracks? Or what if they use one build to poison an environment that another build uses?
68
68
69
-
To mitigate these threats, and others, SLSA instructs build platforms to execute builds in an environment that, within the larger hosted environment, is internally isolated from other builds, users, and the control plane. The only external influence that is permissible is influence that the build itself requests, such as dependencies.
69
+
To mitigate these threats, and others, SLSA instructs build platforms to execute builds in an environment that, within the larger hosted environment, is internally isolated from other builds, users, and the control plane. The only external influence that is permissible is influence that the build itself requests, such as dependencies.
70
70
71
71
{ProductName} internally isolates builds within ROSA using several different tactics. For example, Tekton Chains generates and signs provenance in its own namespace, separate from the one that runs user-defined build steps, so attackers cannot forge provenance. And builds themselves run in their own ephemeral pods, so they cannot persist or influence the build environment of subsequent builds.
72
72
73
73
74
74
== How we meet the requirements for SLSA Build L3
75
75
76
-
The following table summarizes how {ProductName} conforms to the specification for producing SLSA Build L3 software artifacts.
76
+
The following table summarizes how {ProductName} conforms to the specification for producing SLSA Build L3 software artifacts.
77
77
78
78
[cols="1,1, 1"]
79
79
|===
@@ -153,9 +153,5 @@ a|In {ProductName}:
153
153
154
154
== Additional resources
155
155
156
-
* Learn xref:metadata:index.adoc[how to inspect the SLSA] provenance for your components.
157
156
* Visit the link:https://slsa.dev/spec/v1.0/[SLSA overview page], the link:https://slsa.dev/spec/v1.0/levels[Build Levels] page, or the link:https://slsa.dev/spec/v1.0/verifying-systems[verifying build platforms] page.
158
-
159
-
== Additional resources
160
-
* Learn about the SLSA framework and xref:metadata:index.adoc#supply-chain-security-through-slsa-conformity[how {ProductName} meets the requirements of SLSA Build Level 3].
161
157
* Conforma is a powerful tool that you can also use to verify your SLSA provenance; visit link:https://conforma.dev/docs/user-guide/cli.html#_validating_an_image[this page] to learn how to use the EC CLI tool to verify your provenance. You will need the public key used by Tekton Chains, which you can find by following link:https://conforma.dev/docs/user-guide/cli.html#_finding_the_public_key[these instructions].
0 commit comments