From fc19945bdc9c898cd69b1d2eb2a5bd0b8dbf3cd1 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Tue, 17 Mar 2026 13:51:51 -0600 Subject: [PATCH] Add cross references throughout the spec --- content/server-server-api.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/server-server-api.md b/content/server-server-api.md index 55ca5da3..54157e25 100644 --- a/content/server-server-api.md +++ b/content/server-server-api.md @@ -473,6 +473,9 @@ server must ensure that the event: otherwise it is rejected. 6. Passes authorization rules based on the current state of the room, otherwise it is "soft failed". +7. {{% added-in v="1.18" %}} Is [validated](#validating-policy-server-signatures) + by the Policy Server, if the room is [using a Policy Server](#determining-if-a-policy-server-is-enabled-in-a-room), + otherwise it is "soft failed". Further details of these checks, and how to handle failures, are described below. @@ -689,6 +692,11 @@ then any new event `D'` will not reference `C`: | D' +{{% boxes/note %}} +{{% added-in v="1.18" %}} +Events can also be soft failed if they fail [Policy Server checks](#validating-policy-server-signatures). +{{% /boxes/note %}} + #### Retrieving event authorization information The homeserver may be missing event authorization information, or wish @@ -1465,6 +1473,12 @@ The signature is then copied back to the original event object. For an example of a signed event, see the [room version specification](/rooms). +{{% boxes/note %}} +{{% added-in v="1.18" %}} +Events sent in rooms with [Policy Servers](#policy-servers) MUST [ask](#asking-for-a-policy-server-signature-on-an-event) +the Policy Server for a signature too. +{{% /boxes/note %}} + ### Validating hashes and signatures on received events When a server receives an event over federation from another server, the @@ -1499,6 +1513,12 @@ only been given a redacted version of the event. To enforce this, the receiving server should use the redacted copy it calculated rather than the full copy it received. +{{% boxes/note %}} +{{% added-in v="1.18" %}} +Events sent in rooms with [Policy Servers](#policy-servers) have [additional](#validating-policy-server-signatures) +signature validation requirements. +{{% /boxes/note %}} + ### Calculating the reference hash for an event The *reference hash* of an event covers the essential fields of an