Attestation Lifecyle Management

Get a one-time token

The endpoint creates an update token, which is a one-time token that allows the update of a specific image. Administrators use the token to perform an automatic update.

post

Body

imagestringOptional

allow_measurementbooleanOptional

Responses

200

Create OTT

application/json

post

HTTPcURLJavaScriptPython

POST /v1/auth/ratls/update/create HTTP/1.1
Host: localhost:8200
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "image": "text",
  "allow_measurement": true
}

200

Create OTT

{
  "data": {
    "ott": "text"
  }
}

Ask for challenge nonce

The endpoint creates a nonce used in the challenge response with the security platform. This endpoint is identical to the attestation nonce.

post

Body

imagestringRequired

Responses

200

Created Nonce

application/json

post

HTTPcURLJavaScriptPython

POST /v1/auth/ratls/update/nonce HTTP/1.1
Host: localhost:8200
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "image": "text"
}

200

Created Nonce

{
  "data": {
    "nonce": "text"
  }
}

Verify attestation report

This endpoint verifies an update quote where possible and stores differing values for the image specified during token creation. Measurements and Image values can be updated at the same time or separately.

post

Body

quotestringRequired

ottstringRequired

Responses

200

No required information

application/json

post

HTTPcURLJavaScriptPython

POST /v1/auth/ratls/update/verify HTTP/1.1
Host: localhost:8200
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "quote": "text",
  "ott": "text"
}

200

No required information

{
  "data": {}
}