Skip to content

Conversation

@reivilibre
Copy link
Contributor

We had some questions about what these were used for; I gave answers along these lines. I have now reworded a little for the docs.
@sandhose Please check you agree with them :D

A relevant issue that I haven't addressed is #4806, which asks about the significance of the order of keys.
I didn't want to commit to any specific behaviour except the ranking based on claim matching, because the fact we do a stable sort and pick the last key in the list seems like an implementation detail and anything relying on it seems brittle.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Nov 25, 2025

Deploying matrix-authentication-service-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: f662b0b
Status: ✅  Deploy successful!
Preview URL: https://caf306f4.matrix-authentication-service-docs.pages.dev
Branch Preview URL: https://rei-doc-keys.matrix-authentication-service-docs.pages.dev

View logs

@reivilibre reivilibre changed the title Explain the purpose and reasons of keys in the config documentation. Explain the purpose of keys in the config documentation. Nov 25, 2025
@reivilibre reivilibre changed the title Explain the purpose of keys in the config documentation. Explain the purpose of signing keys in the config documentation. Nov 25, 2025
@reivilibre reivilibre marked this pull request as ready for review November 25, 2025 17:12
@reivilibre reivilibre requested a review from a team as a code owner November 25, 2025 17:12
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.

2 participants