Skip to content

Commit

Permalink
Add exchange receipt (#31)
Browse files Browse the repository at this point in the history
* Add exchange receipt
* Update draft-ietf-scitt-scrapi.md
Co-authored-by: Orie Steele <orie@or13.io>
Co-authored-by: Steve Lasker <stevenlasker@hotmail.com>
  • Loading branch information
OR13 authored Sep 3, 2024
1 parent 9a6e48c commit 27c7019
Showing 1 changed file with 46 additions and 0 deletions.
46 changes: 46 additions & 0 deletions draft-ietf-scitt-scrapi.md
Original file line number Diff line number Diff line change
Expand Up @@ -576,6 +576,52 @@ Retry-After: <seconds>
For all responses additional eventually consistent operation details MAY be present.
Support for eventually consistent Receipts is implementation specific, and out of scope for this specification.

### Exchange Receipt

This endpoint is used to exchange old or expiring receipts for fresh ones.

The `iat`, `exp` and `kid` claims can change each time a receipt is exchanged.

This means that fresh receipts can have more recent issued at times, further in the future expiration times, and be signed with new signature algorithms.

Authentication SHOULD be implemented for this endpoint.

Request:

~~~ http-message
POST /exchange/receipt HTTP/1.1
Host: transparency.example
Accept: application/cose
Content-Type: application/cose
Payload (in CBOR diagnostic notation)

18([ / COSE Sign1 /
h'a1013822', / Protected Header /
{}, / Unprotected Header /
null, / Detached Payload /
h'269cd68f4211dffc...0dcb29c' / Signature /
])
~~~

#### Status 200

A new receipt:

~~~ http-message
HTTP/1.1 200 Ok
Location: https://transparency.example/receipts/urn...qnGmr1o
Content-Type: application/cose

Payload (in CBOR diagnostic notation)

18([ / COSE Sign1 /
h'a1013822', / Protected Header /
{}, / Unprotected Header /
null, / Detached Payload /
h'269cd68f4211dffc...0dcb29c' / Signature /
])
~~~

### Resolve Issuer

This endpoint is inspired by {{-SD-JWT-VC}}.
Expand Down

0 comments on commit 27c7019

Please sign in to comment.