From 008bcca5f51059762c2ba8b7602633d105bd880d Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Mon, 26 Sep 2022 21:34:25 +0200 Subject: [PATCH 1/7] Rename 2019-04-29-moderation.mdx to moderation-guide.mdx --- .../docs/{2019-04-29-moderation.mdx => moderation-guide.mdx} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename gatsby/content/docs/{2019-04-29-moderation.mdx => moderation-guide.mdx} (100%) diff --git a/gatsby/content/docs/2019-04-29-moderation.mdx b/gatsby/content/docs/moderation-guide.mdx similarity index 100% rename from gatsby/content/docs/2019-04-29-moderation.mdx rename to gatsby/content/docs/moderation-guide.mdx From 40aefc98e3bbff0dc5b06a1de7902b746a783185 Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Mon, 26 Sep 2022 21:36:16 +0200 Subject: [PATCH 2/7] Mention latest spec version --- gatsby/content/docs/moderation-guide.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index 9532ae91b..f06dbc59c 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -147,7 +147,7 @@ In the early days of Matrix we proposed the concept of ‘active application ser * Support for bulk redactions (looping over individual redactions is a viable workaround however) * Ability for room moderators to delete content from the media repository when redacting the event which refers to it. (this can be improved in future) -* UI for setting server ACLs ([https://github.com/vector-im/Element-web/issues/7084](https://github.com/vector-im/Element-web/issues/7084)) +* UI for setting server ACLs ([https://github.com/vector-im/element-web/issues/7084](https://github.com/vector-im/element-web/issues/7084)) ### Moderation tooling @@ -264,7 +264,7 @@ Each Matrix server maintains a publicly viewable directory of rooms. By default The server admin can limit which users are allowed to publish rooms to the public room directory via the `room_list_publication_rules` config option in Synapse. -The server admin can moderate the directory by delisting rooms by calling the /directory/list/room API with visibility: private ([https://matrix.org/docs/spec/client_server/r0.4.0.html#put-matrix-client-r0-directory-list-room-roomid](https://matrix.org/docs/spec/client_server/r0.4.0.html#put-matrix-client-r0-directory-list-room-roomid)). +The server admin can moderate the directory by delisting rooms by calling the /directory/list/room API with visibility: private ([https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-directory-list-room-roomid](https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-directory-list-room-roomid)). ### Moderating room aliases @@ -275,7 +275,7 @@ By default, any user can create room aliases, which can be an abuse vector - par The server admin can limit which users are allowed to create room aliases via the `alias_creation_rules` config option in Synapse. -The server admin can moderate the aliases that exist on their server by calling the /directory/room API with DELETE: ([https://matrix.org/docs/spec/client_server/r0.4.0.html#delete-matrix-client-r0-directory-room-roomalias](https://matrix.org/docs/spec/client_server/r0.4.0.html#delete-matrix-client-r0-directory-room-roomalias)). +The server admin can moderate the aliases that exist on their server by calling the /directory/room API with DELETE: ([https://matrix.org/docs/spec/client_server/latest.html#delete-matrix-client-r0-directory-room-roomalias](https://matrix.org/docs/spec/client_server/latest.html#delete-matrix-client-r0-directory-room-roomalias)). Element/Web also exposes the ability to delete a room alias from the Room Directory view as an easter egg for server administrators - shift-clicking on the entry in the Room Directory will call the above API to remove the alias and the room from the directory. From e2302fdcb0799729f007c61289c36b505d5d6306 Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Mon, 26 Sep 2022 21:44:01 +0200 Subject: [PATCH 3/7] Change the synapse old /delete_room API to the new /DELETE API --- gatsby/content/docs/moderation-guide.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index f06dbc59c..7d3e1987a 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -190,12 +190,12 @@ If you're using Element, when you go to view more information about a particular ![Element-deactivate-btn](/docs/projects/images/moderation8.png) -Removing abusive rooms is done by calling the /shutdown_room API, e.g: +Removing abusive rooms is done by calling the /DELETE API, e.g: ``` -curl 'https://matrix.org/_synapse/admin/v1/shutdown_room/!roomid:matrix.org' \ --H "Authorization: Bearer $token" -XPOST \ +curl 'https://matrix.org/_synapse/admin/v2/rooms/!roomid:matrix.org' \ +-H "Authorization: Bearer $token" -X DELETE \ -d'{"new_room_user_id": "@abuse:matrix.org", "message": "This room has been removed from the matrix.org homeserver due to violating the terms of use.", "room_name": "Room unavailable"}' ``` @@ -253,9 +253,9 @@ Synapse does not currently provide tools to block connections by IP - instead we Synapse supports a module-like system which can be used to block servers from doing certain actions, such as sending invites to your users. [t2bot/synapse-simple-antispam](https://github.com/t2bot/synapse-simple-antispam) is one example of how this works - see the code for a bit more information on what is possible. Although this won't prevent servers from interacting with your server, it can help with reducing the amount of spam/malicious content. -“Defederating” your server from another server is currently done on a room by room basis - either using server ACLs if you have control of the room in question, or by using the /shutdown_room API if you do not. +“Defederating” your server from another server is currently done on a room by room basis - either using server ACLs if you have control of the room in question, or by using the /DELETE API if you do not. -In future, this may be refined to let servers automatically implement /shutdown_room semantics on any room which matches a given pattern (e.g. whose room admins are on a given server). +In future, this may be refined to let servers automatically implement /DELETE semantics on any room which matches a given pattern (e.g. whose room admins are on a given server). ### Moderating the room directory From 3c6790b9783b2b83ba19c8f4df5f568942292fd4 Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Wed, 5 Oct 2022 17:08:11 +0200 Subject: [PATCH 4/7] Update gatsby/content/docs/moderation-guide.mdx Co-authored-by: Thibault Martin --- gatsby/content/docs/moderation-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index 7d3e1987a..6f637e217 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -190,7 +190,7 @@ If you're using Element, when you go to view more information about a particular ![Element-deactivate-btn](/docs/projects/images/moderation8.png) -Removing abusive rooms is done by calling the /DELETE API, e.g: +Removing abusive rooms is done by calling the delete room API, e.g: ``` From b1f69b2749264f993a23334c2723c979b68b0fbc Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Wed, 5 Oct 2022 17:08:34 +0200 Subject: [PATCH 5/7] Update gatsby/content/docs/moderation-guide.mdx Co-authored-by: Thibault Martin --- gatsby/content/docs/moderation-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index 6f637e217..0332d5b32 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -264,7 +264,7 @@ Each Matrix server maintains a publicly viewable directory of rooms. By default The server admin can limit which users are allowed to publish rooms to the public room directory via the `room_list_publication_rules` config option in Synapse. -The server admin can moderate the directory by delisting rooms by calling the /directory/list/room API with visibility: private ([https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-directory-list-room-roomid](https://matrix.org/docs/spec/client_server/latest.html#put-matrix-client-r0-directory-list-room-roomid)). +The server admin can moderate the directory by delisting rooms by calling the [`/directory/list/room/{roomId}` API](https://spec.matrix.org/latest/client-server-api/#put_matrixclientv3directorylistroomroomid) with `visibility: private`). ### Moderating room aliases From 431b8250f15da23f480b7160b93a8ac21c9fd2f8 Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Wed, 5 Oct 2022 17:08:49 +0200 Subject: [PATCH 6/7] Update gatsby/content/docs/moderation-guide.mdx Co-authored-by: Thibault Martin --- gatsby/content/docs/moderation-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index 0332d5b32..b3222d8a1 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -255,7 +255,7 @@ Synapse supports a module-like system which can be used to block servers from do “Defederating” your server from another server is currently done on a room by room basis - either using server ACLs if you have control of the room in question, or by using the /DELETE API if you do not. -In future, this may be refined to let servers automatically implement /DELETE semantics on any room which matches a given pattern (e.g. whose room admins are on a given server). +In future, this may be refined to let servers automatically implement delete room API semantics on any room which matches a given pattern (e.g. whose room admins are on a given server). ### Moderating the room directory From 18d092265fc6ba84540cde64eaeb1200b6d493f6 Mon Sep 17 00:00:00 2001 From: uranuspucksaxophone <84784521+uranuspucksaxophone@users.noreply.github.com> Date: Wed, 5 Oct 2022 17:09:10 +0200 Subject: [PATCH 7/7] Update gatsby/content/docs/moderation-guide.mdx Co-authored-by: Thibault Martin --- gatsby/content/docs/moderation-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gatsby/content/docs/moderation-guide.mdx b/gatsby/content/docs/moderation-guide.mdx index b3222d8a1..c3afb0a29 100644 --- a/gatsby/content/docs/moderation-guide.mdx +++ b/gatsby/content/docs/moderation-guide.mdx @@ -275,7 +275,7 @@ By default, any user can create room aliases, which can be an abuse vector - par The server admin can limit which users are allowed to create room aliases via the `alias_creation_rules` config option in Synapse. -The server admin can moderate the aliases that exist on their server by calling the /directory/room API with DELETE: ([https://matrix.org/docs/spec/client_server/latest.html#delete-matrix-client-r0-directory-room-roomalias](https://matrix.org/docs/spec/client_server/latest.html#delete-matrix-client-r0-directory-room-roomalias)). +The server admin can moderate the aliases that exist on their server by calling the [room API](https://spec.matrix.org/latest/client-server-api/#delete_matrixclientv3directoryroomroomalias). Element/Web also exposes the ability to delete a room alias from the Room Directory view as an easter egg for server administrators - shift-clicking on the entry in the Room Directory will call the above API to remove the alias and the room from the directory.