Skip to content

Commit a596f9e

Browse files
committed
payloadType: promote media type; use ITE-5 value
Media Type is the conventional way to indicate the content type of a payload. Therefore, we no longer suggest that URL is preferred over Media Type. This puts signing-spec in line with other envelopes, such as JWS. Also, use in-toto media type from [ITE-5](in-toto/ITE#17) and switch the URL example to a dummy value.
1 parent 57592f2 commit a596f9e

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

protocol.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,19 +31,19 @@ KEYID | string | No | No
3131
(JSON, CBOR, etc.) as well as the meaning/schema. To prevent collisions, the
3232
value SHOULD be either:
3333

34-
* [URI](https://tools.ietf.org/html/rfc3986) (recommended)
35-
* Example: `https://in-toto.io/Statement/v1-json`.
36-
* SHOULD resolve to a human-readable description but MAY be
37-
unresolvable.
38-
* SHOULD be case-normalized (section 6.2.2.1)
3934
* [Media Type](https://www.iana.org/assignments/media-types/), a.k.a. MIME
4035
type or Content Type
41-
* Example: `application/vnd.in-toto.statement.v1+json`.
36+
* Example: `application/vnd.in-toto+json`.
4237
* IMPORTANT: SHOULD NOT be a generic type that only represents
4338
encoding but not schema. For example, `application/json` is almost
4439
always WRONG. Instead, invent a media type specific for your
4540
application in the `application/vnd` namespace.
4641
* SHOULD be lowercase.
42+
* [URI](https://tools.ietf.org/html/rfc3986)
43+
* Example: `https://example.com/MyMessage/v1-json`.
44+
* SHOULD resolve to a human-readable description but MAY be
45+
unresolvable.
46+
* SHOULD be case-normalized (section 6.2.2.1)
4747

4848
* KEYID: Optional, unauthenticated hint indicating what key and algorithm was
4949
used to sign the message. As with Sign(), details are agreed upon

0 commit comments

Comments
 (0)