2021-01-19 23:15:46 +01:00
|
|
|
---
|
|
|
|
|
title: Room Version 5
|
|
|
|
|
type: docs
|
|
|
|
|
weight: 50
|
|
|
|
|
---
|
2021-01-20 00:14:52 +01:00
|
|
|
|
2021-01-21 06:45:35 +01:00
|
|
|
This room version builds on [version 4](/rooms/v4) while enforcing signing
|
2021-01-20 00:14:52 +01:00
|
|
|
key validity periods for events.
|
|
|
|
|
|
|
|
|
|
## Client considerations
|
|
|
|
|
|
|
|
|
|
There are no specific requirements for clients in this room version.
|
|
|
|
|
Clients should be aware of event ID changes in [room version
|
2021-01-21 06:45:35 +01:00
|
|
|
4](/rooms/v4), however.
|
2021-01-20 00:14:52 +01:00
|
|
|
|
|
|
|
|
## Server implementation components
|
|
|
|
|
|
2021-01-20 21:34:49 +01:00
|
|
|
{{% boxes/warning %}}
|
2021-01-20 00:14:52 +01:00
|
|
|
The information contained in this section is strictly for server
|
|
|
|
|
implementors. Applications which use the Client-Server API are generally
|
|
|
|
|
unaffected by the intricacies contained here. The section above
|
|
|
|
|
regarding client considerations is the resource that Client-Server API
|
|
|
|
|
use cases should reference.
|
2021-01-20 21:34:49 +01:00
|
|
|
{{% /boxes/warning %}}
|
2021-01-20 00:14:52 +01:00
|
|
|
|
|
|
|
|
Room version 5 uses the same algorithms defined in [room version
|
2021-01-21 06:45:35 +01:00
|
|
|
4](/rooms/v4), ensuring that signing key validity is respected.
|
2021-01-20 00:14:52 +01:00
|
|
|
|
|
|
|
|
### Signing key validity period
|
|
|
|
|
|
|
|
|
|
When validating event signatures, servers MUST enforce the
|
|
|
|
|
`valid_until_ts` property from a key request is at least as large as the
|
|
|
|
|
`origin_server_ts` for the event being validated. Servers missing a copy
|
|
|
|
|
of the signing key MUST try to obtain one via the [GET
|
2021-01-21 06:45:35 +01:00
|
|
|
/\_matrix/key/v2/server](/server-server-api#get_matrixkeyv2serverkeyid)
|
2021-01-20 00:14:52 +01:00
|
|
|
or [POST
|
2021-01-21 06:45:35 +01:00
|
|
|
/\_matrix/key/v2/query](/server-server-api#post_matrixkeyv2query)
|
2021-01-20 00:14:52 +01:00
|
|
|
APIs. When using the `/query` endpoint, servers MUST set the
|
|
|
|
|
`minimum_valid_until_ts` property to prompt the notary server to attempt
|
|
|
|
|
to refresh the key if appropriate.
|
|
|
|
|
|
|
|
|
|
Servers MUST use the lesser of `valid_until_ts` and 7 days into the
|
|
|
|
|
future when determining if a key is valid. This is to avoid a situation
|
|
|
|
|
where an attacker publishes a key which is valid for a significant
|
|
|
|
|
amount of time without a way for the homeserver owner to revoke it.
|
