You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec/specification
Travis Ralston 8e97b0ca81 Improve the server key exchange portion of the s2s specification
Most of the text has been shuffled into the swagger definitions to bring it closer to where it matters.

This also attempts to clarify what is out in the wild. Most importantly, the first version of the key exchange is outright removed from the specification. Other research points/questions are:

* What is a "Key ID"?
  * 1241156c82/synapse/rest/key/v2/local_key_resource.py (L81-L83)
  * 1241156c82/synapse/rest/key/v2/local_key_resource.py (L88-L91)
* Returning a cached response if the server throws a 400, 500, or otherwise not-offline status code
  * 1241156c82/synapse/rest/key/v2/remote_key_resource.py (L227-L229)
* `minimum_valid_until_ts` default
  * This branch of the ladder: 1241156c82/synapse/rest/key/v2/remote_key_resource.py (L192)
* Returning empty arrays when querying offline/no servers
  * Queried by hand against matrix.org as a notary server with a fake domain name to query
* Returning all keys even when querying for specific keys
  * Queried by hand using matrix.org as a notary server against a server publishing multiple keys.

The examples and descriptions were also improved as part of this commit.
6 years ago
..
appendices basic spec for group IDs, mostly copied from User IDs as they share grammar 6 years ago
modules update links which used to point to docs/spec/intro 6 years ago
appendices.rst Split appendices up 8 years ago
application_service_api.rst s/user/username/ typo 8 years ago
client_server_api.rst update links which used to point to docs/spec/intro 6 years ago
events.rst fix inter-spec link 7 years ago
feature_profiles.rst Third party lookup module. Fix wording 6 years ago
identity_service_api.rst Add IS ping endpoint 7 years ago
index.rst avoid .rst link conflict warnings 6 years ago
modules.rst Add a license to the spec 8 years ago
proposals.rst Use $ref, clean up, fix errors, AS is now a C-S module. 6 years ago
proposals_intro.rst Add more strength to the suggestion to find existing issues 6 years ago
push_gateway.rst Add a license to the spec 8 years ago
server_server_api.rst Improve the server key exchange portion of the s2s specification 6 years ago
targets.yaml naively move content from intro.rst to index.rst 6 years ago