Skip to content

Conversation

zecakeh
Copy link
Contributor

@zecakeh zecakeh commented Feb 22, 2025

There are a lot of small commits to make changes easy to justify and to review.

I have tried to add more links to other APIs of the spec since this spans across 3 APIs and the links were not obvious unless we read each section. A couple of commits are about formatting the files to wrap lines that were way too long before making actual changes to the files.

The main motivation for this PR is to clarify the base64 encoding of the public keys of the identity server (#2060). Currently Sydent encodes the long-term public key using standard base64, but ephemeral public keys using URL-safe base64. Synapse uses the same python library as Sydent that decodes both indifferently.

Even if we deem that Sydent's behavior is wrong (matrix-org/sydent#593), we still need to document the current behavior, because public keys in m.room.third_party_event are used in the authorization rules to validate m.room.member invites with a third_party_invite property, so homeservers must be able to handle it.

Note that I did not touch the third_party_signed of /join because it is unclear how or when it is used (#2082).

Closes #2060.

Pull Request Checklist

Preview: https://pr2083--matrix-spec-previews.netlify.app

… standard or URL-safe base64.

Sydent has been using both alphabets.

Signed-off-by: Kévin Commaille <[email protected]>
The exact same thing is said two paragraphs before.

Signed-off-by: Kévin Commaille <[email protected]>
Wrap lines at around 100 characters

Signed-off-by: Kévin Commaille <[email protected]>
@zecakeh zecakeh requested a review from a team as a code owner February 22, 2025 19:17
Signed-off-by: Kévin Commaille <[email protected]>
Signed-off-by: Kévin Commaille <[email protected]>
Copy link
Member

@richvdh richvdh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few editorial comments, but generally looks good. Thank you for your attempts to untangle this mess.

@zecakeh zecakeh requested a review from richvdh April 22, 2025 12:45
Copy link
Member

@richvdh richvdh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@richvdh richvdh merged commit fca1714 into matrix-org:main Apr 22, 2025
12 checks passed
@zecakeh zecakeh deleted the clarify-third-party-invite branch May 6, 2025 08:35
Johennes pushed a commit to Johennes/matrix-spec that referenced this pull request May 30, 2025
tcpipuk pushed a commit to tcpipuk/matrix-spec that referenced this pull request Jul 30, 2025
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.

Identity servers public_key(s) base64 format needs to be clarified
2 participants