tweak wording to spell out that handling legacy/noncompliant servers.

pull/1550/head
Matthew Hodgson 6 years ago committed by GitHub
parent d7397ccd56
commit 313e6de48b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -34,12 +34,14 @@ description: |-
permit the use of the ``deny`` list without losing the room. permit the use of the ``deny`` list without losing the room.
.. WARNING:: .. WARNING::
Servers that do not uphold the ACLs MUST be manually appended to the denied hosts All compliant servers must implement server ACLs. However, legacy or noncompliant
list. To accomplish this, events should have their ``prev_events`` inspected for servers exist which do not uphold ACLs, and these MUST be manually appended to
denied hosts, therefore detecting servers which are not upholding the ACLs. Server the denied hosts list when setting an ACL to prevent them from leaking events from
versions can also be used to detect hosts that will not uphold the ACLs, although banned servers into a room. Currently, the only way to determine noncompliant hosts is
this is less effective. Server ACLs were added in Synapse v0.32.0 although other to check the ``prev_events`` of leaked events, therefore detecting servers which
server implementations and versions exist in the world. are not upholding the ACLs. Server versions can also be used to try to detect hosts that
will not uphold the ACLs, although this is not comprehensive. Server ACLs were added
in Synapse v0.32.0, although other server implementations and versions exist in the world.
allOf: allOf:
- $ref: core-event-schema/state_event.yaml - $ref: core-event-schema/state_event.yaml
type: object type: object

Loading…
Cancel
Save