Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2025-12-21 00:48:38 +01:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Add a short summary of how the v2 key api is supposed to be used

Browse source
This commit is contained in:
Mark Haines 2015-04-23 15:30:57 +01:00
parent ed21f50cc3
commit 4422e9ca2b
1 changed files with 12 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
specification/30_server_server_api.rst
View file

@ -73,6 +73,14 @@ Retrieving Server Keys
Version 2 Version 2
+++++++++ +++++++++
Each home server publishes its public keys under ``/_matrix/key/v2/server/``.
Home servers query for keys by either getting ``/_matrix/key/v2/server/``
directly or by querying an intermediate perspective server using a
``/_matrix/key/v2/query`` API. Intermediate perspective servers query the
``/_matrix/key/v2/server/`` API on behalf of another server and sign the
response with their own key. A server may query multiple perspective servers
to ensure that they all report the same public keys.
Publishing Keys Publishing Keys
_______________ _______________
@ -103,10 +111,10 @@ the key has expired.
The ``old_verify_keys`` can be used to sign events with an ``origin_server_ts`` The ``old_verify_keys`` can be used to sign events with an ``origin_server_ts``
before the ``expired_ts``. before the ``expired_ts``.
Intermediate servers should cache a response for half of its remaining life Intermediate perspective servers should cache a response for half of its
time to avoid serving a stale response. Servers should avoid querying for remaining life time to avoid serving a stale response. Servers should avoid
certificates more frequently than once an hour to avoid flooding a server querying for certificates more frequently than once an hour to avoid flooding
with requests. a server with requests.
==================== =================== ====================================== ==================== =================== ======================================
Key Type Description Key Type Description