Skip to content

Commit

Permalink
Update bundle.md
Browse files Browse the repository at this point in the history
Update payload information in the dsse type

Signed-off-by: Appu <[email protected]>
  • Loading branch information
loosebazooka authored Jan 15, 2025
1 parent ad31e90 commit 4e71982
Showing 1 changed file with 8 additions and 6 deletions.
14 changes: 8 additions & 6 deletions content/en/about/bundle.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ title: Sigstore Bundle Format
weight: 4
---

Last updated October 31, 2024
Last updated January 14, 2025

Version 0.3.2

Expand Down Expand Up @@ -136,15 +136,13 @@ artifact at verification time.

#### DSSE

A DSSE envelope can contain arbitrary payloads. Currently Sigstore clients only process the
payload type `"application/vnd.in-toto+json"`. Verifiers must verify that the payload type is a
supported and expected type. DSSE envelopes contained in a Sigstore Bundle must only contain a
single signature (the DSSE spec allows multiple).
The DSSE envelope in a Sigstore Bundle must conform to the [in-toto Envelope layer specification](https://github.com/in-toto/attestation/blob/main/spec/v1/envelope.md) where

Check failure on line 139 in content/en/about/bundle.md

View workflow job for this annotation

GitHub Actions / markdownlint

Trailing spaces

content/en/about/bundle.md:139:174 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.29.0/doc/md009.md
`payloadType` is `"application/vnd.in-toto+json"` and the payload is an [in-toto statement](https://github.com/in-toto/attestation/blob/main/spec/v1/statement.md). DSSE envelopes in a Sigstore Bundle must also contain only a single signature (the DSSE spec allows multiple).

```json
"dsseEnvelope": {
{
"payload": "<Base64(JSON_PAYLOAD)>",
"payload": "<Base64(JSON_IN_TOTO_STATEMENT)>",
"payloadType": "application/vnd.in-toto+json",
"signatures": [{
"keyid": "<KEY_ID>",
Expand All @@ -154,6 +152,10 @@ single signature (the DSSE spec allows multiple).
}
```

where `payload` should would decode to
```json

Check failure on line 156 in content/en/about/bundle.md

View workflow job for this annotation

GitHub Actions / markdownlint

Fenced code blocks should be surrounded by blank lines

content/en/about/bundle.md:156 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```json"] https://github.com/DavidAnson/markdownlint/blob/v0.29.0/doc/md031.md
```

### Examples

Here are some example bundles from the Sigstore public infrastructure.
Expand Down

0 comments on commit 4e71982

Please sign in to comment.