Skip to content

Commit 8fd32b7

Browse files
paulbastianc2bo
andauthored
change SD-JWT VC reference to SD-JWT (#349)
* change SD-JWT VC reference to SD-JWT * Update draft-ietf-oauth-status-list.md Co-authored-by: Christian Bormann <chris.bormann@gmx.de> * removed other mentions of SD-JWT VC --------- Co-authored-by: Christian Bormann <chris.bormann@gmx.de>
1 parent 57a13e8 commit 8fd32b7

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

draft-ietf-oauth-status-list.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ informative:
7373
RFC7800: RFC7800
7474
RFC8414: RFC8414
7575
RFC9458: RFC9458
76-
SD-JWT.VC: I-D.ietf-oauth-sd-jwt-vc
76+
RFC9901: RFC9901
7777
IANA.MediaTypes:
7878
author:
7979
org: "IANA"
@@ -129,13 +129,13 @@ informative:
129129

130130
--- abstract
131131

132-
This specification defines a status mechanism called Token Status List (TSL), data structures and processing rules for representing the status of tokens secured by JSON Object Signing and Encryption (JOSE) or CBOR Object Signing and Encryption (COSE), such as JWT, SD-JWT VC, CBOR Web Token, and ISO mdoc. It also defines an extension point and a registry for future status mechanisms.
132+
This specification defines a status mechanism called Token Status List (TSL), data structures and processing rules for representing the status of tokens secured by JSON Object Signing and Encryption (JOSE) or CBOR Object Signing and Encryption (COSE), such as JWT, SD-JWT, CBOR Web Token, and ISO mdoc. It also defines an extension point and a registry for future status mechanisms.
133133

134134
--- middle
135135

136136
# Introduction
137137

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-JWTs {{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.
139139

140140
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.
141141

@@ -161,7 +161,7 @@ An Issuer issues Referenced Tokens to a Holder, the Holder uses and presents tho
161161

162162
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.
163163

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}}):
165165

166166
~~~ ascii-art
167167

@@ -189,7 +189,7 @@ Furthermore, the document creates an extension point and an IANA registry that e
189189

190190
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).
191191

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}}.
193193

194194
## Rationale
195195

@@ -250,7 +250,7 @@ Status List Token:
250250
: A token in JWT (as defined in {{RFC7519}}) or CWT (as defined in {{RFC8392}}) representation that contains a cryptographically secured Status List.
251251

252252
Referenced Token:
253-
: A cryptographically secured data structure that contains a "status" claim that references a mechanism to retrieve status information about this Referenced Token. This document defines the Status List mechanism in which case the Referenced Token contains a reference to an entry in a Status List Token. It is RECOMMENDED to use JSON {{RFC8259}} with JOSE as defined in {{RFC7515}} or CBOR {{RFC8949}} with COSE as defined in {{RFC9052}}. Examples for Referenced Tokens are SD-JWT VC and ISO mdoc.
253+
: A cryptographically secured data structure that contains a "status" claim that references a mechanism to retrieve status information about this Referenced Token. This document defines the Status List mechanism in which case the Referenced Token contains a reference to an entry in a Status List Token. It is RECOMMENDED to use JSON {{RFC8259}} with JOSE as defined in {{RFC7515}} or CBOR {{RFC8949}} with COSE as defined in {{RFC9052}}. Examples for Referenced Tokens are SD-JWT and ISO mdoc.
254254

255255
Client:
256256
: An application that fetches information, such as a Status List Token, from the Status List Provider on behalf of the Holder or Relying Party.
@@ -518,7 +518,7 @@ The following is a non-normative example of a decoded header and payload of a Re
518518
}
519519
~~~
520520

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:
522522

523523
~~~ ascii-art
524524

@@ -874,7 +874,7 @@ This specification allows both, digital signatures using asymmetric cryptography
874874

875875
## Observability of Issuers {#privacy-issuer}
876876

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.
878878

879879
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.
880880

@@ -1823,6 +1823,7 @@ CBOR encoding:
18231823

18241824
-17
18251825

1826+
* change SD-JWT VC reference to SD-JWT
18261827
* clarify that Status List validation MUST not be performed if Referenced Token validation is deemed invalid already
18271828

18281829
-16

0 commit comments

Comments
 (0)