You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: draft-ietf-oauth-status-list.md
+10-6Lines changed: 10 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -73,7 +73,7 @@ informative:
73
73
RFC7800: RFC7800
74
74
RFC8414: RFC8414
75
75
RFC9458: RFC9458
76
-
SD-JWT.VC: I-D.ietf-oauth-sd-jwt-vc
76
+
RFC9901: RFC9901
77
77
IANA.MediaTypes:
78
78
author:
79
79
org: "IANA"
@@ -135,7 +135,7 @@ This specification defines a status mechanism called Token Status List (TSL), da
135
135
136
136
# Introduction
137
137
138
-
Token formats secured by JOSE {{RFC7515}} or COSE {{RFC9052}}, such as JWTs {{RFC7519}}, SD-JWT VCs {{SD-JWT.VC}}, CWTs {{RFC8392}} and ISO mdoc {{ISO.mdoc}}, have vast possible applications. Some of these applications can involve issuing a token whereby certain semantics about the token or its validity may change over time. Communicating these changes to relying parties in an interoperable manner, such as whether the token is considered invalidated or suspended by its issuer is important for many of these applications.
138
+
Token formats secured by JOSE {{RFC7515}} or COSE {{RFC9052}}, such as JWTs {{RFC7519}}, SD-JWT VCs {{RFC9901}, CWTs {{RFC8392}} and ISO mdoc {{ISO.mdoc}}, have vast possible applications. Some of these applications can involve issuing a token whereby certain semantics about the token or its validity may change over time. Communicating these changes to relying parties in an interoperable manner, such as whether the token is considered invalidated or suspended by its issuer is important for many of these applications.
139
139
140
140
This document defines a Status List data structure that describes the individual statuses of multiple Referenced Tokens. A Referenced Token may be of any format, but is most commonly a data structure secured by JOSE or COSE. The Referenced Token is referenced by the Status List, which describes the status of the Referenced Token. 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 index corresponds to the Referenced Token's status. A Status List is provided within a Status List Token protected by cryptographic signature or MAC and this document defines its representations in JWT and CWT format.
141
141
@@ -161,7 +161,7 @@ An Issuer issues Referenced Tokens to a Holder, the Holder uses and presents tho
161
161
162
162
The roles of the Issuer (of the Referenced Token), the Status Issuer and the Status Provider may be fulfilled by the same entity. If not further specified, the term Issuer may refer to an entity acting for all three roles. This document describes how an Issuer references a Status List Token and how a Relying Party fetches and validates Status Lists.
163
163
164
-
The following diagram depicts the relationship between the involved roles (Relying Party is equivalent to Verifier of {{SD-JWT.VC}}):
164
+
The following diagram depicts the relationship between the involved roles (Relying Party is equivalent to Verifier of {{RFC9901}}):
165
165
166
166
~~~ ascii-art
167
167
@@ -189,7 +189,7 @@ Furthermore, the document creates an extension point and an IANA registry that e
189
189
190
190
An example of the usage of a Status List is to manage the statuses of issued access tokens as defined in {{Section 1.4 of RFC6749}}. Token Introspection {{RFC7662}} provides a method to determine the status of an issued access token, but it necessitates the party attempting to validate the state of access tokens to directly contact the Issuer of each token for validation. In contrast, the mechanism defined in this specification allows a party to retrieve the statuses for many tokens, reducing interactions with the Issuer substantially. This not only improves scalability but also enhances privacy by preventing the Issuer from gaining knowledge of access tokens being verified (herd anonymity).
191
191
192
-
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 {{SD-JWT.VC}}.
192
+
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 {{RFC9901}}.
193
193
194
194
## Rationale
195
195
@@ -518,7 +518,7 @@ The following is a non-normative example of a decoded header and payload of a Re
518
518
}
519
519
~~~
520
520
521
-
SD-JWT-based Verifiable Credentials (Section 3.2.2.2 of {{SD-JWT.VC}}) introduces the usage of the status mechanism defined in this section. Therefore, an SD-JWT VC can be considered a Referenced Token. The following is a non-normative example of a Referenced Token in SD-JWT VC serialized form as received from an Issuer:
521
+
Also SD-JWTs defined in {{RFC9901}} may utilize the status mechanism defined in this section and can be considered a Referenced Token. The following is a non-normative example of a Referenced Token in SD-JWT serialized form as received from an Issuer:
522
522
523
523
~~~ ascii-art
524
524
@@ -874,7 +874,7 @@ This specification allows both, digital signatures using asymmetric cryptography
874
874
875
875
## Observability of Issuers {#privacy-issuer}
876
876
877
-
The main privacy consideration for a Status List, especially in the context of the Issuer-Holder-Verifier model {{SD-JWT.VC}}, is to prevent the Issuer from tracking the usage of the Referenced Token when the status is being checked. If an Issuer offers status information by referencing a specific token, this would enable the Issuer to create a profile for the issued token by correlating the date and identity of Relying Parties, that are requesting the status.
877
+
The main privacy consideration for a Status List, especially in the context of the Issuer-Holder-Verifier model {{RFC9901}}, is to prevent the Issuer from tracking the usage of the Referenced Token when the status is being checked. If an Issuer offers status information by referencing a specific token, this would enable the Issuer to create a profile for the issued token by correlating the date and identity of Relying Parties, that are requesting the status.
878
878
879
879
The Status List approaches these privacy implications by integrating the status information of many Referenced Tokens into the same list. Therefore, the Issuer does not learn for which Referenced Token the Relying Party is requesting the Status List. The privacy of the Holder is protected by the anonymity within the set of Referenced Tokens in the Status List, also called herd privacy. This limits the possibilities of tracking by the Issuer.
880
880
@@ -1821,6 +1821,10 @@ CBOR encoding:
1821
1821
1822
1822
\[\[ To be removed from the final specification \]\]
1823
1823
1824
+
-17
1825
+
1826
+
* change SD-JWT VC reference to SD-JWT
1827
+
1824
1828
-16
1825
1829
1826
1830
* change http status codes & query parameter wording for the historical resolution
0 commit comments