Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Provenance v1.0: initial draft #525

Merged
merged 47 commits into from
Jan 20, 2023
Merged
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
b20437c
WIP
MarkLodato Oct 20, 2022
2a3eb61
WIP: finished proto for v1.0
MarkLodato Oct 21, 2022
ad7e823
WIP: inputArtifacts, parameters
MarkLodato Oct 21, 2022
cdecf52
WIP
MarkLodato Oct 25, 2022
2ef3659
WIP: apply feedback
MarkLodato Oct 27, 2022
e7dd1e0
WIP: replace proto extension with Markdown link
MarkLodato Oct 27, 2022
c3089de
Update example to use latest version of proto
MarkLodato Oct 28, 2022
25c78c3
artifacts: go back to map, uri
MarkLodato Oct 28, 2022
1015166
WIP: topLevelInputs and buildDependencies
MarkLodato Oct 31, 2022
861d844
WIP: make examples more realistic
MarkLodato Oct 31, 2022
f499fad
WIP: add cue file
MarkLodato Oct 31, 2022
cec3785
WIP: add Tekton example and TODO
MarkLodato Oct 31, 2022
82a3c28
WIP: merge everything into markdown file
MarkLodato Nov 1, 2022
df6bec9
WIP: remove extra divs
MarkLodato Nov 1, 2022
668f41a
WIP: rewrite intro
MarkLodato Nov 1, 2022
5a96d3a
WIP: rename Artifact to ArtifactReference
MarkLodato Nov 1, 2022
c397e76
Use headings in change history
MarkLodato Nov 1, 2022
f1adaf3
Make draft URL work
MarkLodato Nov 1, 2022
f5a4b06
fix lint errors
MarkLodato Nov 1, 2022
b661ee1
Address PR feedback
MarkLodato Nov 4, 2022
5aab59b
Add builderDependencies
MarkLodato Nov 7, 2022
78ae06f
WIP: lowercase purl, move TODO
MarkLodato Nov 9, 2022
11459e6
WIP
MarkLodato Nov 11, 2022
5d1e791
WIP: refactor - external vs system parameters
MarkLodato Nov 14, 2022
32f9d2f
Merge branch 'main' into provenance-refactor
MarkLodato Nov 15, 2022
d044c3d
WIP: fix typo in URL
MarkLodato Nov 15, 2022
3ae85a9
WIP: add todo
MarkLodato Nov 15, 2022
e60f742
Use the generic SLSA generator for the example.
MarkLodato Nov 15, 2022
479b7b3
Make builder.version a map
MarkLodato Nov 30, 2022
9ca7346
Replace .artifacts[name] with [name].artifact.
MarkLodato Nov 30, 2022
d63f6ba
Replace map with array of name/value pairs
MarkLodato Nov 30, 2022
03a0660
Revert "Replace map with array of name/value pairs"
MarkLodato Dec 8, 2022
0ca0d69
Update provenance build model
MarkLodato Jan 4, 2023
8b32358
Merge branch 'main' into provenance-refactor
MarkLodato Jan 4, 2023
622c0b5
Disable lint for blank lines betwen blockqutoes
MarkLodato Jan 4, 2023
77d5814
proto nits: consistent required/optional syntax
MarkLodato Jan 4, 2023
a18326b
More iteration on model
MarkLodato Jan 5, 2023
3b728b4
Move github actions to separate file; revise text
MarkLodato Jan 6, 2023
a4494fb
Only include major version in provenance URL.
MarkLodato Jan 6, 2023
31094f7
WIP: move to Markdown
MarkLodato Jan 18, 2023
472ba94
Finish Markdown conversion, add other param types
MarkLodato Jan 18, 2023
fdce758
address comments
MarkLodato Jan 18, 2023
268a64d
Merge branch 'main' into provenance-refactor
MarkLodato Jan 18, 2023
aba878e
fix mdlint
MarkLodato Jan 18, 2023
1987abf
add TODO about creating other build types
MarkLodato Jan 19, 2023
40aeb77
Fix typos in provenance v1.0
MarkLodato Jan 20, 2023
4210074
drop .md from link
MarkLodato Jan 20, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/_data/versions.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,9 @@ provenance:
name: Version 0.1
v0.2:
name: Version 0.2
v1.0:
MarkLodato marked this conversation as resolved.
Show resolved Hide resolved
name: Version 1.0 (DRAFT)
draft: true
current: v0.2

verification_summary:
Expand Down
51 changes: 51 additions & 0 deletions docs/provenance/v1.0.cue
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
{
// Standard attestation fields:
"_type": "https://in-toto.io/Statement/v0.1",
"subject": [...],

// Predicate:
"predicateType": "https://slsa.dev/provenance/v1.0?draft",
"predicate": {
"buildDefinition": {
"topLevelInputs": {
"buildType": string,
"inputArtifacts": {
[string]: #ArtifactReference
},
"entryPoint": string,
"parameters": {...}
},
"buildDependencies": {
"resolvedDependencies": [...#ArtifactReference],
"environment": {...}
}
},
"runDetails": {
"builder": {
"id": string,
"version": string,
"builderDependencies": [...#ArtifactReference]
},
"metadata": {
"invocationId": string,
"startedOn": string, // timestamp
"finishedOn": string // timestamp
},
"byproducts": [...#ArtifactReference]
}
}
}

#ArtifactReference: {
"uri": string,
MarkLodato marked this conversation as resolved.
Show resolved Hide resolved
"digest": {
"sha256": string,
"sha512": string,
"sha1": string,
// TODO: list the other standard algorithms
[string]: string
},
"localName": string,
"downloadLocation": string,
"mediaType": string
}
Loading