Skip to content

Commit 2f57d2f

Browse files
authored
Merge pull request #172 from oauth-wg/pb/considerations2
add implementation consideration for Default Values and Double Alloca…
2 parents 28065cb + d37cabf commit 2f57d2f

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

draft-ietf-oauth-status-list.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -692,10 +692,22 @@ TODO evaluate definition of Status List Provider?
692692

693693
The lifetime of a Status List (and the Status List Token) depends on the lifetime of its Referenced Tokens. Once all Referenced Tokens are expired, the Issuer may stop serving the Status List (and the Status List Token).
694694

695-
Referenced Tokens may be regularly re-issued to increase security or to mitigate linkability and prevent tracking by Relying Parties. In this case, every Referenced Token MUST have a fresh Status List entry.
695+
Referenced Tokens may be regularly re-issued to mitigate linkability of presentations to Relying Parties. In this case, every re-issued Referenced Token MUST have a fresh Status List entry in order to prevent this becoming possible source of correlation.
696696

697697
Referenced Tokens may also be issued in batches, such that Holders can use individual tokens for every transaction. In this case, every Referenced Token MUST have a dedicated Status List entry. Revoking batch issued Referenced Tokens might reveal this correlation later on.
698698

699+
## Default Values and Double Allocation
700+
701+
Implementations producing Status Lists are RECOMMENDED to initialize the Status List byte array with a default value and provide this as an initialization parameter to the Issuer. The Issuer is RECOMMENDED to use a default value that represents the most common value for its Referenced Tokens to avoid an update during issuance.
702+
703+
Implementations producing Status Lists are RECOMMENDED to prevent double allocation, i.e. re-using the same `uri` and `index` for multiple Referenced Tokens. The Issuer MUST prevent any unintended double allocation by using the Status List.
704+
705+
## Status List Size
706+
707+
The Status List Issuer may increase the size of a Status List if it requires indices for additional Referenced Tokens. It is RECOMMENDED that the size of a Status List in bits is divisible in bytes (8 bits) without a remainder, i.e. `size-in-bits` % 8 = 0.
708+
709+
The Status List Issuer may chunk its Referenced Tokens into multiple Status Lists to reduce the transmission size of an individual Status List Token. This may be useful for setups where some entities operate in constrained environments, e.g. for mobile internet or embedded devices.
710+
699711
# IANA Considerations
700712

701713
## JSON Web Token Claims Registration
@@ -927,6 +939,7 @@ for their valuable contributions, discussions and feedback to this specification
927939

928940
-04
929941

942+
* add implementation consideration for Default Values, Double Allocation and Status List Size
930943
* add privacy consideration on using private relay protocols
931944
* add privacy consideration on observability of outsiders
932945
* add security considerations on correct parsing and decoding

0 commit comments

Comments
 (0)