Skip to content

Commit

Permalink
clarify what Media Type is used for
Browse files Browse the repository at this point in the history
  • Loading branch information
mcr committed Sep 10, 2024
1 parent 5a1ffad commit 650a066
Showing 1 changed file with 10 additions and 3 deletions.
13 changes: 10 additions & 3 deletions draft-ietf-anima-rfc8366bis.md
Original file line number Diff line number Diff line change
Expand Up @@ -450,7 +450,7 @@ owner.
The voucher informs the pledge which entity it should consider to be
its owner.

This document defines a voucher that is a JSON-encoded or CBOR-encoded instance of the
This document defines a voucher that is JSON-encoded, and CMS signed encoding of the
YANG module defined in {{voucher-yang-module}}.

This format is described here as a practical basis for some uses (such
Expand All @@ -460,8 +460,15 @@ This description also serves to validate the YANG data model.

{{RFC8366}} defined a media type and a filename extension for the
CMS-encoded JSON type.
Which type of voucher is expected is signaled (where possible) in the form of a MIME
Content-Type, an HTTP Accept: header, or more mundane methods like use of a filename extension when a voucher is transferred on a USB key.
The media types for JOSE format vouchers is defined in {{jBRSKI}} and the COSE format voucher is defined in {{cBRSKI}}.

The Media Type is used by the Pledge (to the Registrar) and from the Registrar (to the MASA) to signal what format of voucher is expected.
Other aspects of the voucher, such as it being nonce-less or which kind of pinned anchor is used is not part of the Media type.

Only the format of voucher that is expected is signaled in the form of a (MIME) Media
Content-Type in the HTTP Accept: header.

For vouchers stored/transferred via methods like a USB storage device (USB key), then the voucher format is usually signaled by a filename extension.

## Tree Diagram {#voucher-tree-diagram}

Expand Down

0 comments on commit 650a066

Please sign in to comment.