Skip to content

Commit

Permalink
Merge pull request #88 from vcstuff/c2bo/access-token
Browse files Browse the repository at this point in the history
add access token example
  • Loading branch information
paulbastian authored Jan 9, 2024
2 parents bad9ef3 + 92fa63a commit 28e2ea6
Showing 1 changed file with 7 additions and 1 deletion.
8 changes: 7 additions & 1 deletion draft-ietf-oauth-status-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ normative:
RFC9110: RFC9110
RFC9111: RFC9111
informative:
RFC6749: RFC6749
RFC7662: RFC7662

--- abstract

Expand All @@ -46,8 +48,11 @@ The status list data structures themselves are also represented as JWTs or CWTs.

JSON Web Tokens (JWTs) {{RFC7519}} and CBOR Web Tokens (CWTs) {{RFC8392}} as secure token formats, have vast possible applications. Some of these applications can involve issuing a token whereby certain semantics about the token can change over time, which are important to be able to communicate to relying parties in an interoperable manner, such as whether the token is considered invalidated or suspended by its issuer.

This document defines Status List representations in JWT and CWT formats that describe the individual statuses of multiple Referenced Tokens, which themselves are also JWTs or CWTs. The statuses of all Referenced Tokens are conveyed via a bit array in the Status List. Each Referenced Token is allocated an index during issuance that represents its position within this bit array. The value of the bit(s) at this position correspond to the Referenced Token's status. The document also defines how an issuer of a Referenced Token references a Status List Token. Status Lists may be composed for expressing a range of Status Types. This document defines basic Status Types for the most common use cases as well as an extensibility mechanism for custom Status Types. The Status List Token may be used by an issuer in the Issuer-Holder-Verifier model to express the status of verifiable credentials (Referenced Tokens) issued by an issuer.
This document defines Status List representations in JWT and CWT formats that describe the individual statuses of multiple Referenced Tokens, which themselves are also JWTs or CWTs. The statuses of all Referenced Tokens are conveyed via a bit array in the Status List. Each Referenced Token is allocated an index during issuance that represents its position within this bit array. The value of the bit(s) at this position correspond to the Referenced Token's status. The document also defines how an issuer of a Referenced Token references a Status List Token. Status Lists may be composed for expressing a range of Status Types. This document defines basic Status Types for the most common use cases as well as an extensibility mechanism for custom Status Types.

An example for the usage of a Status List is to manage the status of issued access tokens as defined in section 1.4 of {{RFC6749}}. Token Introspection {{RFC7662}} defines another way to determine the status of an issued access token, but it requires the party trying to validate an access tokens status to directly contact the token issuer, whereas the mechanism defined in this specification does not have this limitation.

Another possible use case for the Status List is to express the status of verifiable credentials (Referenced Tokens) issued by an issuer in the Issuer-Holder-Verifier model.
The following diagram depicts the basic conceptual relationship.

~~~ ascii-art
Expand Down Expand Up @@ -469,6 +474,7 @@ for their valuable contributions, discussions and feedback to this specification

* Changing compression from gzip to zlib
* Change typo in Status List Token sub claim description
* Add access token as an example use-case

-00

Expand Down

0 comments on commit 28e2ea6

Please sign in to comment.