mirror of
https://github.com/edgelesssys/constellation.git
synced 2025-05-31 12:04:27 -04:00
rfc: define measurements v2
The old measurements.json (v1) was contain one set of measurements and had a path scoped for every CSP. The new version is less structured, allowing for future extensions.
This commit is contained in:
parent
45e67d9d22
commit
7d8e36a853
1 changed files with 30 additions and 0 deletions
|
@ -74,6 +74,11 @@ The following HTTP endpoints are available:
|
||||||
|
|
||||||
- `GET /constellation/v2/ref/<REF>/stream/<STREAM>/<VERSION>/image/`
|
- `GET /constellation/v2/ref/<REF>/stream/<STREAM>/<VERSION>/image/`
|
||||||
- [`info.json` returns the lookup table for the given image version.](#image-lookup-table-v2)
|
- [`info.json` returns the lookup table for the given image version.](#image-lookup-table-v2)
|
||||||
|
- `measurements.json` contains the measurements for the given image version.
|
||||||
|
- `measurements.json.sig` returns the signature of the measurements file.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- `GET /constellation/v1/ref/<REF>/stream/<STREAM>/<VERSION>/image/`
|
- `GET /constellation/v1/ref/<REF>/stream/<STREAM>/<VERSION>/image/`
|
||||||
- [`info.json` returns the lookup table for the given image version.](#image-lookup-table-v1)
|
- [`info.json` returns the lookup table for the given image version.](#image-lookup-table-v1)
|
||||||
- `sbom.<format>.json` contains SBOM files for the given image version. The exact formats and file names are TBD.
|
- `sbom.<format>.json` contains SBOM files for the given image version. The exact formats and file names are TBD.
|
||||||
|
@ -163,6 +168,31 @@ This document is not signed and can be extended in the future to include more im
|
||||||
The same document can be used to identify old images that are no longer used and can be deleted for cost optimization.
|
The same document can be used to identify old images that are no longer used and can be deleted for cost optimization.
|
||||||
|
|
||||||
|
|
||||||
|
## Image measurements (v2)
|
||||||
|
|
||||||
|
The image measurements are a JSON file that contains sets of measurements for the given image version:
|
||||||
|
|
||||||
|
```
|
||||||
|
/constellation/v2/ref/<REF>/stream/<STREAM>/<VERSION>/image/measurements.json
|
||||||
|
```
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"version": "<VERSION>",
|
||||||
|
"ref": "<REF>",
|
||||||
|
"stream": "<STREAM>",
|
||||||
|
"list": [
|
||||||
|
"csp": "<CSP>",
|
||||||
|
"attestationVariant": "<ATTESTATION_VARIANT>",
|
||||||
|
"measurements": {"<PCR_INDEX>": {<MEASUREMENT>}}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
If required, the fields in the `.list` array can be extended in the future to include additional information while maintaining backwards compatibility.
|
||||||
|
|
||||||
|
This document has a detached signature that can be retrieved from `measurements.json.sig`.
|
||||||
|
|
||||||
## Image lookup table (v1)
|
## Image lookup table (v1)
|
||||||
|
|
||||||
The image lookup table is a JSON file that maps the image name consisting of `ref`, `stream` and `version` to the CSP-specific image references:
|
The image lookup table is a JSON file that maps the image name consisting of `ref`, `stream` and `version` to the CSP-specific image references:
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue