Skip to content

Commit 98406e2

Browse files
authored
Merge pull request #7 from tfpauly/tfpauly-patch-2
Explain not being able to generate tokens
2 parents 89f75e8 + d2dec33 commit 98406e2

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

draft-pauly-privacypass-for-tls.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,26 @@ The `privacy_pass_token` extension has the following format:
160160

161161
The `token` field uses the `Token` structure defined in {{PPAUTH, Section 2.1.1}}.
162162

163+
Tokens are generally presented after receiving a challenge, but a client MAY
164+
include a token without having received a challenge if it has other out-of-band
165+
configuration to do so.
166+
167+
## Handling Inability to Present Tokens
168+
169+
Servers need to be able to detect when clients are unable to present a token after
170+
receiving a challenge. A client might be unable to present tokens because it
171+
has reached a token rate limit, because it does not have a way to generate tokens
172+
for the required token issuer, or simply because it does not support this
173+
specification.
174+
175+
The RECOMMENDED approach to handle such cases is for the server to include a
176+
`cookie` extension ({{TLS13, Section 4.2.2}}) along with the challenge, and
177+
for clients to retry the handshake including the `cookie` extension, but
178+
not including the `privacy_pass_token` extension. Servers can then assume
179+
that the client received the challenge and was unable to generate a valid
180+
token. The policy for what servers do in such cases will be specific
181+
to the overall use case, and beyond the scope of this document.
182+
163183
# Applicable Token Types {#applicable-types}
164184

165185
This document is defined such that any Privacy Pass token type would be possible

0 commit comments

Comments
 (0)