Skip to content

Clarify that the message sequence may change with extensions#1401

Open
davidben wants to merge 1 commit intotlswg:mainfrom
davidben:transcript
Open

Clarify that the message sequence may change with extensions#1401
davidben wants to merge 1 commit intotlswg:mainfrom
davidben:transcript

Conversation

@davidben
Copy link
Contributor

As previously written, it suggests the message sequence does not change at all, but it is actually (as the text suggests), the transcript of everything sent or received.

This still doesn't quite make us robust to extensions. The CertificateVerify and Finished messages are defined in terms of this "Handshake Context" that is written using phrases like

  • "later of EncryptedExtensions/CertificateRequest"
  • "later of server Finished/EndOfEarlyData"
  • "ClientHello ... client Finished + CertificateRequest"

And then sometimes Certificate and CertificateVerify are explicitly appended to it. Interestingly, that is also a bit goofy because we don't always account for those messages not existing in the prose.

This PR leaves all that alone for now, because I haven't quite written something down for that yet. (I think the right wording is to say "hash all the messages up to but not including Finished/CertificateVerify.)

As previously written, it suggests the message sequence does not change
at all, but it is actually (as the text suggests), the transcript of
everything sent or received.

This still doesn't quite make us robust to extensions. The
CertificateVerify and Finished messages are defined in terms of this
"Handshake Context" that is written using phrases like

* "later of EncryptedExtensions/CertificateRequest"
* "later of server Finished/EndOfEarlyData"
* "ClientHello ... client Finished + CertificateRequest"

And then sometimes Certificate and CertificateVerify are explicitly
appended to it. Interestingly, that is also a bit goofy because we don't
always account for those messages not existing in the prose.

This PR leaves all that alone for now, because I haven't quite written
something down for that yet. (I think the right wording is to say "hash
all the messages up to but not including Finished/CertificateVerify.)
@davidben davidben requested a review from ekr as a code owner February 11, 2026 18:52
@davidben
Copy link
Contributor Author

davidben commented Feb 11, 2026

(I think the right wording is to say "hash all the messages up to but not including Finished/CertificateVerify.)

Ah hmmf. Except we kinda made a mess of post-handshake messages. That's a little awkward to describe. (Not relevant for this PR.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant