API ReferenceMeasured Boot Trusted Machine

Create Measured Boot Trusted Machine Approval

View as Markdown

Approve a Machine, or all Machines using *, for automatic promotion of its next measured-boot report.

Org must have an Infrastructure Provider entity that owns the Site. User must have authorization role with PROVIDER_ADMIN suffix.

Authentication

AuthorizationBearer
``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired
Name of the Org

Request

This endpoint expects an object.
siteIdstringRequiredformat: "uuid"
ID of the Site where the approval applies.
machineIdstringRequired

Machine UUID, or * to approve all Machines at the Site.

approvalTypeenumRequired
Whether the approval is consumed once or persists for future reports.
pcrRegistersstringOptional

Optional comma-separated PCR register selector. All registers are used when omitted.

commentsstringOptional
Optional operator comments about the approval.

Response

Measured Boot trusted Machine approval was created
approvalIdstringformat: "uuid"
Unique approval ID.
machineIdstring

Machine UUID, or * when the approval applies to all Machines.

approvalTypeenum
Whether the approval is consumed once or persists for future reports.
pcrRegistersstring

Optional comma-separated PCR register selector.

commentsstring
Optional operator comments about the approval.
createddatetime or null
Time when the approval was created, or null when Core did not return a timestamp.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error