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.		2018-07-26 08:41:00 -06:00
..
appendices	basic spec for group IDs, mostly copied from User IDs as they share grammar	2018-06-11 12:40:04 +01:00
modules	update links which used to point to docs/spec/intro	2018-07-24 11:41:03 +01:00
appendices.rst	Split appendices up	2016-10-31 12:01:37 +00:00
application_service_api.rst	s/user/username/ typo	2016-08-10 18:09:44 -05:00
client_server_api.rst	update links which used to point to docs/spec/intro	2018-07-24 11:41:03 +01:00
events.rst	fix inter-spec link	2017-10-15 23:42:05 +01:00
feature_profiles.rst	Third party lookup module. Fix wording	2018-07-12 16:59:30 +01:00
identity_service_api.rst	Add IS ping endpoint	2018-02-27 17:54:42 +01:00
index.rst	avoid .rst link conflict warnings	2018-07-20 15:30:58 +01:00
modules.rst	Add a license to the spec	2016-07-12 17:28:30 +01:00
proposals.rst	Use $ref, clean up, fix errors, AS is now a C-S module.	2018-07-12 14:31:34 +01:00
proposals_intro.rst	Add more strength to the suggestion to find existing issues	2018-06-18 13:20:42 -06:00
push_gateway.rst	Add a license to the spec	2016-07-12 17:28:30 +01:00
server_server_api.rst	Improve the server key exchange portion of the s2s specification	2018-07-26 08:41:00 -06:00
targets.yaml	naively move content from intro.rst to index.rst	2018-07-20 14:15:47 +01:00