2021-09-20 12:56:23 +00:00
# Copyright 2016-2021 The Matrix.org Foundation C.I.C.
2014-08-12 14:10:52 +00:00
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
2014-08-13 02:14:34 +00:00
2021-11-09 13:11:47 +00:00
""" Contains functions for performing actions on rooms. """
2018-07-27 14:12:50 +00:00
import itertools
2018-07-09 06:09:20 +00:00
import logging
import math
2020-08-20 19:07:42 +00:00
import random
2018-07-09 06:09:20 +00:00
import string
from collections import OrderedDict
2021-09-21 17:34:26 +00:00
from typing import (
TYPE_CHECKING ,
Any ,
Awaitable ,
Collection ,
Dict ,
List ,
Optional ,
Tuple ,
)
2014-08-12 14:10:52 +00:00
2022-01-26 13:27:04 +00:00
import attr
2021-11-09 13:11:47 +00:00
from typing_extensions import TypedDict
2022-05-16 13:06:04 +00:00
import synapse . events . snapshot
2020-06-10 16:44:34 +00:00
from synapse . api . constants import (
2021-09-06 11:17:16 +00:00
EventContentFields ,
2020-06-10 16:44:34 +00:00
EventTypes ,
2021-09-06 11:17:16 +00:00
GuestAccess ,
2020-12-16 13:46:37 +00:00
HistoryVisibility ,
2020-06-10 16:44:34 +00:00
JoinRules ,
2020-07-14 11:36:23 +00:00
Membership ,
2020-06-10 16:44:34 +00:00
RoomCreationPreset ,
RoomEncryptionAlgorithms ,
2021-09-10 11:30:05 +00:00
RoomTypes ,
2020-06-10 16:44:34 +00:00
)
2021-05-12 14:05:28 +00:00
from synapse . api . errors import (
AuthError ,
Codes ,
2021-12-02 07:02:20 +00:00
HttpResponseException ,
2021-05-12 14:05:28 +00:00
LimitExceededError ,
NotFoundError ,
StoreError ,
SynapseError ,
)
2020-08-14 13:47:53 +00:00
from synapse . api . filtering import Filter
2020-01-27 14:30:57 +00:00
from synapse . api . room_versions import KNOWN_ROOM_VERSIONS , RoomVersion
Split `event_auth.check` into two parts (#10940)
Broadly, the existing `event_auth.check` function has two parts:
* a validation section: checks that the event isn't too big, that it has the rught signatures, etc.
This bit is independent of the rest of the state in the room, and so need only be done once
for each event.
* an auth section: ensures that the event is allowed, given the rest of the state in the room.
This gets done multiple times, against various sets of room state, because it forms part of
the state res algorithm.
Currently, this is implemented with `do_sig_check` and `do_size_check` parameters, but I think
that makes everything hard to follow. Instead, we split the function in two and call each part
separately where it is needed.
2021-09-29 17:59:15 +00:00
from synapse . event_auth import validate_event_for_room_version
2020-08-14 13:47:53 +00:00
from synapse . events import EventBase
2022-05-07 12:37:29 +00:00
from synapse . events . utils import copy_and_fixup_power_levels_contents
2021-12-02 07:02:20 +00:00
from synapse . federation . federation_client import InvalidResponseError
from synapse . handlers . federation import get_domains_from_state
2022-03-18 17:49:32 +00:00
from synapse . handlers . relations import BundledAggregations
2021-01-28 11:27:30 +00:00
from synapse . rest . admin . _base import assert_user_is_admin
2018-10-25 16:49:55 +00:00
from synapse . storage . state import StateFilter
2021-09-21 17:34:26 +00:00
from synapse . streams import EventSource
2020-01-16 13:31:22 +00:00
from synapse . types import (
2020-08-14 13:47:53 +00:00
JsonDict ,
2020-08-28 11:28:53 +00:00
MutableStateMap ,
2020-01-16 13:31:22 +00:00
Requester ,
RoomAlias ,
RoomID ,
RoomStreamToken ,
StateMap ,
2022-05-16 15:35:31 +00:00
StreamKeyType ,
2020-01-16 13:31:22 +00:00
StreamToken ,
UserID ,
2020-07-14 11:36:23 +00:00
create_requester ,
2020-01-16 13:31:22 +00:00
)
2016-04-01 13:06:00 +00:00
from synapse . util import stringutils
2019-06-25 13:19:21 +00:00
from synapse . util . caches . response_cache import ResponseCache
2021-01-20 13:15:14 +00:00
from synapse . util . stringutils import parse_and_validate_server_name
2016-05-11 12:42:37 +00:00
from synapse . visibility import filter_events_for_client
2014-08-12 14:10:52 +00:00
2020-08-14 13:47:53 +00:00
if TYPE_CHECKING :
from synapse . server import HomeServer
2014-08-12 14:10:52 +00:00
logger = logging . getLogger ( __name__ )
2015-11-05 16:43:19 +00:00
id_server_scheme = " https:// "
2019-06-25 13:19:21 +00:00
FIVE_MINUTES_IN_MS = 5 * 60 * 1000
2014-08-12 14:10:52 +00:00
2022-01-26 13:27:04 +00:00
@attr.s ( slots = True , frozen = True , auto_attribs = True )
class EventContext :
events_before : List [ EventBase ]
event : EventBase
events_after : List [ EventBase ]
state : List [ EventBase ]
aggregations : Dict [ str , BundledAggregations ]
start : str
end : str
2021-10-08 11:44:43 +00:00
class RoomCreationHandler :
2020-08-14 13:47:53 +00:00
def __init__ ( self , hs : " HomeServer " ) :
2022-02-23 11:04:02 +00:00
self . store = hs . get_datastores ( ) . main
2021-10-08 11:44:43 +00:00
self . auth = hs . get_auth ( )
self . clock = hs . get_clock ( )
self . hs = hs
2017-10-04 09:47:54 +00:00
self . spam_checker = hs . get_spam_checker ( )
2018-01-15 16:52:07 +00:00
self . event_creation_handler = hs . get_event_creation_handler ( )
2018-10-25 16:42:37 +00:00
self . room_member_handler = hs . get_room_member_handler ( )
2021-07-01 18:25:37 +00:00
self . _event_auth_handler = hs . get_event_auth_handler ( )
2019-05-23 14:00:20 +00:00
self . config = hs . config
2021-10-08 11:44:43 +00:00
self . request_ratelimiter = hs . get_request_ratelimiter ( )
2017-10-04 09:47:54 +00:00
2020-06-10 16:44:34 +00:00
# Room state based off defined presets
2021-07-16 17:22:36 +00:00
self . _presets_dict : Dict [ str , Dict [ str , Any ] ] = {
2020-06-10 16:44:34 +00:00
RoomCreationPreset . PRIVATE_CHAT : {
" join_rules " : JoinRules . INVITE ,
2020-12-16 13:46:37 +00:00
" history_visibility " : HistoryVisibility . SHARED ,
2020-06-10 16:44:34 +00:00
" original_invitees_have_ops " : False ,
" guest_can_join " : True ,
" power_level_content_override " : { " invite " : 0 } ,
} ,
RoomCreationPreset . TRUSTED_PRIVATE_CHAT : {
" join_rules " : JoinRules . INVITE ,
2020-12-16 13:46:37 +00:00
" history_visibility " : HistoryVisibility . SHARED ,
2020-06-10 16:44:34 +00:00
" original_invitees_have_ops " : True ,
" guest_can_join " : True ,
" power_level_content_override " : { " invite " : 0 } ,
} ,
RoomCreationPreset . PUBLIC_CHAT : {
" join_rules " : JoinRules . PUBLIC ,
2020-12-16 13:46:37 +00:00
" history_visibility " : HistoryVisibility . SHARED ,
2020-06-10 16:44:34 +00:00
" original_invitees_have_ops " : False ,
" guest_can_join " : False ,
" power_level_content_override " : { } ,
} ,
2021-07-16 17:22:36 +00:00
}
2020-06-10 16:44:34 +00:00
# Modify presets to selectively enable encryption by default per homeserver config
for preset_name , preset_config in self . _presets_dict . items ( ) :
encrypted = (
preset_name
2021-09-24 11:25:21 +00:00
in self . config . room . encryption_enabled_by_default_for_room_presets
2020-06-10 16:44:34 +00:00
)
preset_config [ " encrypted " ] = encrypted
2022-05-12 10:41:35 +00:00
self . _default_power_level_content_override = (
self . config . room . default_power_level_content_override
)
2020-05-22 15:11:35 +00:00
self . _replication = hs . get_replication_data_handler ( )
2019-06-25 13:19:21 +00:00
# If a user tries to update the same room multiple times in quick
# succession, only process the first attempt and return its result to
# subsequent requests
2021-07-16 17:22:36 +00:00
self . _upgrade_response_cache : ResponseCache [ Tuple [ str , str ] ] = ResponseCache (
2021-03-08 19:00:07 +00:00
hs . get_clock ( ) , " room_upgrade " , timeout_ms = FIVE_MINUTES_IN_MS
2021-07-16 17:22:36 +00:00
)
2021-09-24 11:25:21 +00:00
self . _server_notices_mxid = hs . config . servernotices . server_notices_mxid
2019-06-17 14:48:57 +00:00
self . third_party_event_rules = hs . get_third_party_event_rules ( )
2020-05-04 11:43:52 +00:00
async def upgrade_room (
2020-01-27 14:30:57 +00:00
self , requester : Requester , old_room_id : str , new_version : RoomVersion
2020-07-24 14:53:25 +00:00
) - > str :
2018-08-22 09:57:54 +00:00
""" Replace a room with a new room with a different version
Args :
2020-01-27 14:30:57 +00:00
requester : the user requesting the upgrade
old_room_id : the id of the room to be replaced
new_version : the new room version to use
2018-08-22 09:57:54 +00:00
Returns :
2020-07-24 14:53:25 +00:00
the new room id
2020-08-24 17:58:56 +00:00
Raises :
ShadowBanError if the requester is shadow - banned .
2018-08-22 09:57:54 +00:00
"""
2021-10-08 11:44:43 +00:00
await self . request_ratelimiter . ratelimit ( requester )
2018-08-22 09:57:54 +00:00
user_id = requester . user . to_string ( )
2019-06-25 13:19:21 +00:00
# Check if this room is already being upgraded by another person
2021-12-20 18:12:08 +00:00
for key in self . _upgrade_response_cache . keys ( ) :
2019-06-25 13:19:21 +00:00
if key [ 0 ] == old_room_id and key [ 1 ] != user_id :
# Two different people are trying to upgrade the same room.
# Send the second an error.
#
# Note that this of course only gets caught if both users are
# on the same homeserver.
raise SynapseError (
400 , " An upgrade for this room is currently in progress "
2018-08-22 09:57:54 +00:00
)
2022-05-16 13:06:04 +00:00
# Check whether the room exists and 404 if it doesn't.
# We could go straight for the auth check, but that will raise a 403 instead.
old_room = await self . store . get_room ( old_room_id )
if old_room is None :
raise NotFoundError ( " Unknown room id %s " % ( old_room_id , ) )
new_room_id = self . _generate_room_id ( )
# Check whether the user has the power level to carry out the upgrade.
# `check_auth_rules_from_context` will check that they are in the room and have
# the required power level to send the tombstone event.
(
tombstone_event ,
tombstone_context ,
) = await self . event_creation_handler . create_event (
requester ,
{
" type " : EventTypes . Tombstone ,
" state_key " : " " ,
" room_id " : old_room_id ,
" sender " : user_id ,
" content " : {
" body " : " This room has been replaced " ,
" replacement_room " : new_room_id ,
} ,
} ,
)
old_room_version = await self . store . get_room_version ( old_room_id )
validate_event_for_room_version ( old_room_version , tombstone_event )
await self . _event_auth_handler . check_auth_rules_from_context (
old_room_version , tombstone_event , tombstone_context
)
2019-06-25 13:19:21 +00:00
# Upgrade the room
#
# If this user has sent multiple upgrade requests for the same room
# and one of them is not complete yet, cache the response and
# return it to all subsequent requests
2020-05-04 11:43:52 +00:00
ret = await self . _upgrade_response_cache . wrap (
2019-06-25 13:19:21 +00:00
( old_room_id , user_id ) ,
self . _upgrade_room ,
requester ,
old_room_id ,
2022-05-16 13:06:04 +00:00
old_room , # args for _upgrade_room
new_room_id ,
new_version ,
tombstone_event ,
tombstone_context ,
2019-06-25 13:19:21 +00:00
)
2019-11-01 10:28:09 +00:00
2019-07-23 13:00:55 +00:00
return ret
2018-08-22 09:57:54 +00:00
2020-05-01 14:15:36 +00:00
async def _upgrade_room (
2022-05-16 13:06:04 +00:00
self ,
requester : Requester ,
old_room_id : str ,
old_room : Dict [ str , Any ] ,
new_room_id : str ,
new_version : RoomVersion ,
tombstone_event : EventBase ,
tombstone_context : synapse . events . snapshot . EventContext ,
2021-09-20 12:56:23 +00:00
) - > str :
2020-08-24 17:58:56 +00:00
"""
Args :
requester : the user requesting the upgrade
old_room_id : the id of the room to be replaced
2022-05-16 13:06:04 +00:00
old_room : a dict containing room information for the room to be replaced ,
as returned by ` RoomWorkerStore . get_room ` .
new_room_id : the id of the replacement room
new_version : the version to upgrade the room to
tombstone_event : the tombstone event to send to the old room
tombstone_context : the context for the tombstone event
2020-08-24 17:58:56 +00:00
Raises :
ShadowBanError if the requester is shadow - banned .
"""
2019-06-25 13:19:21 +00:00
user_id = requester . user . to_string ( )
2020-10-05 18:00:50 +00:00
assert self . hs . is_mine_id ( user_id ) , " User must be our own: %s " % ( user_id , )
2018-08-22 09:57:54 +00:00
2019-06-25 13:19:21 +00:00
logger . info ( " Creating new room %s to replace %s " , new_room_id , old_room_id )
2018-10-26 14:11:35 +00:00
2022-05-16 13:06:04 +00:00
# create the new room. may raise a `StoreError` in the exceedingly unlikely
# event of a room ID collision.
await self . store . store_room (
room_id = new_room_id ,
room_creator_user_id = user_id ,
is_public = old_room [ " is_public " ] ,
room_version = new_version ,
2019-06-25 13:19:21 +00:00
)
2020-05-01 14:15:36 +00:00
await self . clone_existing_room (
2019-06-25 13:19:21 +00:00
requester ,
old_room_id = old_room_id ,
new_room_id = new_room_id ,
new_room_version = new_version ,
tombstone_event_id = tombstone_event . event_id ,
)
# now send the tombstone
2020-10-02 17:10:55 +00:00
await self . event_creation_handler . handle_new_client_event (
requester = requester ,
event = tombstone_event ,
context = tombstone_context ,
2019-06-25 13:19:21 +00:00
)
2022-05-20 08:54:12 +00:00
state_filter = StateFilter . from_types (
[ ( EventTypes . CanonicalAlias , " " ) , ( EventTypes . PowerLevels , " " ) ]
)
old_room_state = await tombstone_context . get_current_state_ids ( state_filter )
2019-06-25 13:19:21 +00:00
2020-08-14 13:47:53 +00:00
# We know the tombstone event isn't an outlier so it has current state.
assert old_room_state is not None
2019-06-25 13:19:21 +00:00
# update any aliases
2020-05-01 14:15:36 +00:00
await self . _move_aliases_to_new_room (
2019-06-25 13:19:21 +00:00
requester , old_room_id , new_room_id , old_room_state
)
2019-11-01 10:28:09 +00:00
# Copy over user push rules, tags and migrate room directory state
2020-05-01 14:15:36 +00:00
await self . room_member_handler . transfer_room_state_on_room_upgrade (
2019-11-01 10:28:09 +00:00
old_room_id , new_room_id
)
# finally, shut down the PLs in the old room, and update them in the new
2019-06-25 13:19:21 +00:00
# room.
2020-05-01 14:15:36 +00:00
await self . _update_upgraded_room_pls (
2019-12-02 15:11:32 +00:00
requester ,
old_room_id ,
new_room_id ,
old_room_state ,
2019-06-25 13:19:21 +00:00
)
2019-07-23 13:00:55 +00:00
return new_room_id
2018-10-26 22:47:37 +00:00
2020-05-01 14:15:36 +00:00
async def _update_upgraded_room_pls (
2020-01-16 13:31:22 +00:00
self ,
requester : Requester ,
old_room_id : str ,
new_room_id : str ,
old_room_state : StateMap [ str ] ,
2020-07-24 14:53:25 +00:00
) - > None :
2018-10-26 22:47:37 +00:00
""" Send updated power levels in both rooms after an upgrade
Args :
2020-01-16 13:31:22 +00:00
requester : the user requesting the upgrade
old_room_id : the id of the room to be replaced
new_room_id : the id of the replacement room
old_room_state : the state map for the old room
2020-08-24 17:58:56 +00:00
Raises :
ShadowBanError if the requester is shadow - banned .
2018-10-26 22:47:37 +00:00
"""
old_room_pl_event_id = old_room_state . get ( ( EventTypes . PowerLevels , " " ) )
if old_room_pl_event_id is None :
logger . warning (
" Not supported: upgrading a room with no PL event. Not setting PLs "
" in old room. "
)
return
2020-05-01 14:15:36 +00:00
old_room_pl_state = await self . store . get_event ( old_room_pl_event_id )
2018-10-26 22:47:37 +00:00
# we try to stop regular users from speaking by setting the PL required
# to send regular events and invites to 'Moderator' level. That's normally
# 50, but if the default PL in a room is 50 or more, then we set the
# required PL above that.
2022-05-07 12:37:29 +00:00
pl_content = copy_and_fixup_power_levels_contents ( old_room_pl_state . content )
users_default : int = pl_content . get ( " users_default " , 0 ) # type: ignore[assignment]
2018-10-26 22:47:37 +00:00
restricted_level = max ( users_default + 1 , 50 )
updated = False
for v in ( " invite " , " events_default " ) :
2022-05-07 12:37:29 +00:00
current : int = pl_content . get ( v , 0 ) # type: ignore[assignment]
2018-10-26 22:47:37 +00:00
if current < restricted_level :
2020-02-06 13:31:05 +00:00
logger . debug (
2018-10-26 22:47:37 +00:00
" Setting level for %s in %s to %i (was %i ) " ,
v ,
old_room_id ,
restricted_level ,
current ,
2018-10-24 22:14:36 +00:00
)
2018-10-26 22:47:37 +00:00
pl_content [ v ] = restricted_level
updated = True
2018-10-24 22:14:36 +00:00
else :
2020-02-06 13:31:05 +00:00
logger . debug ( " Not setting level for %s (already %i ) " , v , current )
2018-10-26 22:47:37 +00:00
if updated :
try :
2020-05-01 14:15:36 +00:00
await self . event_creation_handler . create_and_send_nonmember_event (
2018-10-26 22:47:37 +00:00
requester ,
{
" type " : EventTypes . PowerLevels ,
" state_key " : " " ,
" room_id " : old_room_id ,
" sender " : requester . user . to_string ( ) ,
" content " : pl_content ,
} ,
ratelimit = False ,
)
except AuthError as e :
logger . warning ( " Unable to update PLs in old room: %s " , e )
2020-05-01 14:15:36 +00:00
await self . event_creation_handler . create_and_send_nonmember_event (
2018-10-26 22:47:37 +00:00
requester ,
{
" type " : EventTypes . PowerLevels ,
" state_key " : " " ,
" room_id " : new_room_id ,
" sender " : requester . user . to_string ( ) ,
2022-05-07 12:37:29 +00:00
" content " : copy_and_fixup_power_levels_contents (
old_room_pl_state . content
) ,
2018-10-26 22:47:37 +00:00
} ,
ratelimit = False ,
)
2018-08-22 09:57:54 +00:00
2020-05-01 14:15:36 +00:00
async def clone_existing_room (
2020-01-27 14:30:57 +00:00
self ,
requester : Requester ,
old_room_id : str ,
new_room_id : str ,
new_room_version : RoomVersion ,
tombstone_event_id : str ,
2020-07-24 14:53:25 +00:00
) - > None :
2018-08-22 09:57:54 +00:00
""" Populate a new room based on an old room
Args :
2020-01-27 14:30:57 +00:00
requester : the user requesting the upgrade
old_room_id : the id of the room to be replaced
new_room_id : the id to give the new room ( should already have been
2022-05-19 17:32:48 +00:00
created with _generate_room_id ( ) )
2020-01-27 14:30:57 +00:00
new_room_version : the new room version to use
tombstone_event_id : the ID of the tombstone event in the old room .
2018-08-22 09:57:54 +00:00
"""
user_id = requester . user . to_string ( )
2020-12-11 19:05:15 +00:00
if not await self . spam_checker . user_may_create_room ( user_id ) :
2022-01-06 13:16:42 +00:00
raise SynapseError (
403 , " You are not permitted to create rooms " , Codes . FORBIDDEN
)
2018-08-22 09:57:54 +00:00
2021-07-16 17:22:36 +00:00
creation_content : JsonDict = {
2020-01-27 14:30:57 +00:00
" room_version " : new_room_version . identifier ,
2018-08-22 09:57:54 +00:00
" predecessor " : { " room_id " : old_room_id , " event_id " : tombstone_event_id } ,
2021-07-16 17:22:36 +00:00
}
2018-08-22 09:57:54 +00:00
2019-01-30 16:33:51 +00:00
# Check if old room was non-federatable
# Get old room's create event
2020-05-01 14:15:36 +00:00
old_room_create_event = await self . store . get_create_event_for_room ( old_room_id )
2019-01-30 16:33:51 +00:00
# Check if the create event specified a non-federatable room
2021-09-08 14:00:43 +00:00
if not old_room_create_event . content . get ( EventContentFields . FEDERATE , True ) :
2019-01-30 16:33:51 +00:00
# If so, mark the new room as non-federatable as well
2021-09-08 14:00:43 +00:00
creation_content [ EventContentFields . FEDERATE ] = False
2019-01-30 16:33:51 +00:00
2020-02-21 12:15:07 +00:00
initial_state = { }
2018-10-12 11:05:18 +00:00
2019-01-17 15:22:03 +00:00
# Replicate relevant room events
2021-09-10 11:30:05 +00:00
types_to_copy : List [ Tuple [ str , Optional [ str ] ] ] = [
2018-10-12 16:05:48 +00:00
( EventTypes . JoinRules , " " ) ,
( EventTypes . Name , " " ) ,
( EventTypes . Topic , " " ) ,
( EventTypes . RoomHistoryVisibility , " " ) ,
2018-10-26 22:56:40 +00:00
( EventTypes . GuestAccess , " " ) ,
( EventTypes . RoomAvatar , " " ) ,
2020-02-04 17:25:54 +00:00
( EventTypes . RoomEncryption , " " ) ,
2019-02-11 11:30:37 +00:00
( EventTypes . ServerACL , " " ) ,
2019-04-02 16:15:24 +00:00
( EventTypes . RelatedGroups , " " ) ,
2019-12-02 15:11:32 +00:00
( EventTypes . PowerLevels , " " ) ,
2021-09-10 11:30:05 +00:00
]
2022-05-19 11:28:10 +00:00
# Copy the room type as per MSC3818.
room_type = old_room_create_event . content . get ( EventContentFields . ROOM_TYPE )
if room_type is not None :
creation_content [ EventContentFields . ROOM_TYPE ] = room_type
# If the old room was a space, copy over the rooms in the space.
if room_type == RoomTypes . SPACE :
types_to_copy . append ( ( EventTypes . SpaceChild , None ) )
2018-10-12 16:05:48 +00:00
2020-05-01 14:15:36 +00:00
old_room_state_ids = await self . store . get_filtered_current_state_ids (
2018-10-12 16:05:48 +00:00
old_room_id , StateFilter . from_types ( types_to_copy )
)
# map from event_id to BaseEvent
2020-05-01 14:15:36 +00:00
old_room_state_events = await self . store . get_events ( old_room_state_ids . values ( ) )
2018-10-12 16:05:48 +00:00
2020-06-15 11:03:36 +00:00
for k , old_event_id in old_room_state_ids . items ( ) :
2018-10-26 21:51:34 +00:00
old_event = old_room_state_events . get ( old_event_id )
if old_event :
2021-09-10 11:30:05 +00:00
# If the event is an space child event with empty content, it was
# removed from the space and should be ignored.
if k [ 0 ] == EventTypes . SpaceChild and not old_event . content :
continue
2018-10-26 21:51:34 +00:00
initial_state [ k ] = old_event . content
2018-08-22 09:57:54 +00:00
2020-01-28 11:02:55 +00:00
# deep-copy the power-levels event before we start modifying it
# note that if frozen_dicts are enabled, `power_levels` will be a frozen
# dict so we can't just copy.deepcopy it.
initial_state [
( EventTypes . PowerLevels , " " )
2022-05-07 12:37:29 +00:00
] = power_levels = copy_and_fixup_power_levels_contents (
2020-01-28 11:02:55 +00:00
initial_state [ ( EventTypes . PowerLevels , " " ) ]
)
2019-12-02 15:11:32 +00:00
# Resolve the minimum power level required to send any state event
# We will give the upgrading user this power level temporarily (if necessary) such that
# they are able to copy all of the state events over, then revert them back to their
# original power level afterwards in _update_upgraded_room_pls
# Copy over user power levels now as this will not be possible with >100PL users once
# the room has been created
# Calculate the minimum power level needed to clone the room
event_power_levels = power_levels . get ( " events " , { } )
2021-10-13 11:24:07 +00:00
if not isinstance ( event_power_levels , dict ) :
event_power_levels = { }
2021-02-16 13:31:39 +00:00
state_default = power_levels . get ( " state_default " , 50 )
2021-10-13 11:24:07 +00:00
try :
state_default_int = int ( state_default ) # type: ignore[arg-type]
except ( TypeError , ValueError ) :
state_default_int = 50
2021-02-16 13:31:39 +00:00
ban = power_levels . get ( " ban " , 50 )
2021-10-13 11:24:07 +00:00
try :
ban = int ( ban ) # type: ignore[arg-type]
except ( TypeError , ValueError ) :
ban = 50
needed_power_level = max (
state_default_int , ban , max ( event_power_levels . values ( ) )
)
2019-12-02 15:11:32 +00:00
2021-02-16 13:31:39 +00:00
# Get the user's current power level, this matches the logic in get_user_power_level,
# but without the entire state map.
user_power_levels = power_levels . setdefault ( " users " , { } )
2021-10-13 11:24:07 +00:00
if not isinstance ( user_power_levels , dict ) :
user_power_levels = { }
2021-02-16 13:31:39 +00:00
users_default = power_levels . get ( " users_default " , 0 )
current_power_level = user_power_levels . get ( user_id , users_default )
2021-10-13 11:24:07 +00:00
try :
current_power_level_int = int ( current_power_level ) # type: ignore[arg-type]
except ( TypeError , ValueError ) :
current_power_level_int = 0
2019-12-02 15:11:32 +00:00
# Raise the requester's power level in the new room if necessary
2021-10-13 11:24:07 +00:00
if current_power_level_int < needed_power_level :
2021-02-16 13:31:39 +00:00
user_power_levels [ user_id ] = needed_power_level
2019-12-02 15:11:32 +00:00
2020-05-01 14:15:36 +00:00
await self . _send_events_for_new_room (
2018-08-22 09:57:54 +00:00
requester ,
new_room_id ,
2018-10-12 16:05:48 +00:00
# we expect to override all the presets with initial_state, so this is
# somewhat arbitrary.
preset_config = RoomCreationPreset . PRIVATE_CHAT ,
2018-08-22 09:57:54 +00:00
invite_list = [ ] ,
initial_state = initial_state ,
creation_content = creation_content ,
2020-12-11 10:17:49 +00:00
ratelimit = False ,
2018-08-22 09:57:54 +00:00
)
2019-02-18 14:02:09 +00:00
# Transfer membership events
2020-05-01 14:15:36 +00:00
old_room_member_state_ids = await self . store . get_filtered_current_state_ids (
2019-02-18 16:56:34 +00:00
old_room_id , StateFilter . from_types ( [ ( EventTypes . Member , None ) ] )
)
# map from event_id to BaseEvent
2020-05-01 14:15:36 +00:00
old_room_member_state_events = await self . store . get_events (
2019-02-18 18:23:37 +00:00
old_room_member_state_ids . values ( )
)
2020-08-28 13:37:55 +00:00
for old_event in old_room_member_state_events . values ( ) :
2019-02-18 14:02:09 +00:00
# Only transfer ban events
if (
" membership " in old_event . content
and old_event . content [ " membership " ] == " ban "
) :
2020-05-01 14:15:36 +00:00
await self . room_member_handler . update_membership (
2019-02-18 14:02:09 +00:00
requester ,
2021-11-02 13:55:52 +00:00
UserID . from_string ( old_event . state_key ) ,
2019-02-18 14:02:09 +00:00
new_room_id ,
" ban " ,
ratelimit = False ,
content = old_event . content ,
)
2018-08-22 09:57:54 +00:00
# XXX invites/joins
# XXX 3pid invites
2018-10-26 14:11:35 +00:00
2020-05-01 14:15:36 +00:00
async def _move_aliases_to_new_room (
2020-02-20 21:24:04 +00:00
self ,
requester : Requester ,
old_room_id : str ,
new_room_id : str ,
old_room_state : StateMap [ str ] ,
2021-09-20 12:56:23 +00:00
) - > None :
2018-10-26 14:11:35 +00:00
# check to see if we have a canonical alias.
2020-02-20 21:24:04 +00:00
canonical_alias_event = None
2018-10-26 14:11:35 +00:00
canonical_alias_event_id = old_room_state . get ( ( EventTypes . CanonicalAlias , " " ) )
if canonical_alias_event_id :
2020-05-01 14:15:36 +00:00
canonical_alias_event = await self . store . get_event ( canonical_alias_event_id )
2018-10-26 14:11:35 +00:00
2020-05-22 10:41:41 +00:00
await self . store . update_aliases_for_room ( old_room_id , new_room_id )
if not canonical_alias_event :
2018-10-26 14:11:35 +00:00
return
2020-05-22 10:41:41 +00:00
# If there is a canonical alias we need to update the one in the old
# room and set one in the new one.
old_canonical_alias_content = dict ( canonical_alias_event . content )
new_canonical_alias_content = { }
canonical = canonical_alias_event . content . get ( " alias " )
if canonical and self . hs . is_mine_id ( canonical ) :
new_canonical_alias_content [ " alias " ] = canonical
old_canonical_alias_content . pop ( " alias " , None )
# We convert to a list as it will be a Tuple.
old_alt_aliases = list ( old_canonical_alias_content . get ( " alt_aliases " , [ ] ) )
if old_alt_aliases :
old_canonical_alias_content [ " alt_aliases " ] = old_alt_aliases
new_alt_aliases = new_canonical_alias_content . setdefault ( " alt_aliases " , [ ] )
for alias in canonical_alias_event . content . get ( " alt_aliases " , [ ] ) :
try :
if self . hs . is_mine_id ( alias ) :
new_alt_aliases . append ( alias )
old_alt_aliases . remove ( alias )
except Exception :
logger . info (
" Invalid alias %s in canonical alias event %s " ,
alias ,
canonical_alias_event_id ,
)
if not old_alt_aliases :
old_canonical_alias_content . pop ( " alt_aliases " )
2018-10-26 14:11:35 +00:00
2020-02-20 21:24:04 +00:00
# If a canonical alias event existed for the old room, fire a canonical
# alias event for the new room with a copy of the information.
2018-10-26 14:11:35 +00:00
try :
2020-05-22 10:41:41 +00:00
await self . event_creation_handler . create_and_send_nonmember_event (
requester ,
{
" type " : EventTypes . CanonicalAlias ,
" state_key " : " " ,
" room_id " : old_room_id ,
" sender " : requester . user . to_string ( ) ,
" content " : old_canonical_alias_content ,
} ,
ratelimit = False ,
)
except SynapseError as e :
# again I'm not really expecting this to fail, but if it does, I'd rather
# we returned the new room to the client at this point.
logger . error ( " Unable to send updated alias events in old room: %s " , e )
try :
await self . event_creation_handler . create_and_send_nonmember_event (
requester ,
{
" type " : EventTypes . CanonicalAlias ,
" state_key " : " " ,
" room_id " : new_room_id ,
" sender " : requester . user . to_string ( ) ,
" content " : new_canonical_alias_content ,
} ,
ratelimit = False ,
)
2018-10-26 14:11:35 +00:00
except SynapseError as e :
# again I'm not really expecting this to fail, but if it does, I'd rather
# we returned the new room to the client at this point.
logger . error ( " Unable to send updated alias events in new room: %s " , e )
2018-08-22 09:57:54 +00:00
2020-05-01 14:15:36 +00:00
async def create_room (
2020-08-14 13:47:53 +00:00
self ,
requester : Requester ,
config : JsonDict ,
ratelimit : bool = True ,
creator_join_profile : Optional [ JsonDict ] = None ,
2020-05-22 13:21:54 +00:00
) - > Tuple [ dict , int ] :
2014-08-12 14:10:52 +00:00
""" Creates a new room.
Args :
2020-08-14 13:47:53 +00:00
requester :
2018-05-17 08:01:09 +00:00
The user who requested the room creation .
2020-08-14 13:47:53 +00:00
config : A dict of configuration options .
ratelimit : set to False to disable the rate limiter
2018-05-17 10:34:28 +00:00
2020-08-14 13:47:53 +00:00
creator_join_profile :
2018-05-17 10:34:28 +00:00
Set to override the displayname and avatar for the creating
user in this room . If unset , displayname and avatar will be
derived from the user ' s profile. If set, should contain the
values to go in the body of the ' join ' event ( typically
` avatar_url ` and / or ` displayname ` .
2014-08-12 14:10:52 +00:00
Returns :
2020-05-22 13:21:54 +00:00
First , a dict containing the keys ` room_id ` and , if an alias
was , requested , ` room_alias ` . Secondly , the stream_id of the
last persisted event .
2014-08-12 14:10:52 +00:00
Raises :
2016-02-15 18:13:10 +00:00
SynapseError if the room ID couldn ' t be stored, or something went
horribly wrong .
2018-08-16 20:25:16 +00:00
ResourceLimitError if server is blocked to some resource being
exceeded
2014-08-12 14:10:52 +00:00
"""
2016-02-15 18:13:10 +00:00
user_id = requester . user . to_string ( )
2020-11-17 10:51:25 +00:00
await self . auth . check_auth_blocking ( requester = requester )
2018-08-16 20:25:16 +00:00
2019-06-17 14:48:57 +00:00
if (
self . _server_notices_mxid is not None
and requester . user . to_string ( ) == self . _server_notices_mxid
) :
# allow the server notices mxid to create rooms
is_requester_admin = True
else :
2020-05-01 14:15:36 +00:00
is_requester_admin = await self . auth . is_server_admin ( requester . user )
2019-06-17 14:48:57 +00:00
2021-07-20 10:39:46 +00:00
# Let the third party rules modify the room creation config if needed, or abort
# the room creation entirely with an exception.
await self . third_party_event_rules . on_create_room (
2019-06-17 14:48:57 +00:00
requester , config , is_requester_admin = is_requester_admin
)
2021-09-24 14:38:23 +00:00
invite_3pid_list = config . get ( " invite_3pid " , [ ] )
invite_list = config . get ( " invite " , [ ] )
if not is_requester_admin and not (
await self . spam_checker . user_may_create_room ( user_id )
2019-06-17 14:48:57 +00:00
) :
2022-01-06 13:16:42 +00:00
raise SynapseError (
403 , " You are not permitted to create rooms " , Codes . FORBIDDEN
)
2017-10-04 09:47:54 +00:00
2017-06-19 13:10:13 +00:00
if ratelimit :
2021-10-08 11:44:43 +00:00
await self . request_ratelimiter . ratelimit ( requester )
2014-08-12 14:10:52 +00:00
2020-01-27 14:30:57 +00:00
room_version_id = config . get (
2021-09-29 10:44:15 +00:00
" room_version " , self . config . server . default_room_version . identifier
2019-05-23 14:00:20 +00:00
)
2020-06-16 12:51:47 +00:00
if not isinstance ( room_version_id , str ) :
2018-07-25 21:10:39 +00:00
raise SynapseError ( 400 , " room_version must be a string " , Codes . BAD_JSON )
2020-01-27 14:30:57 +00:00
room_version = KNOWN_ROOM_VERSIONS . get ( room_version_id )
if room_version is None :
2018-07-25 21:10:39 +00:00
raise SynapseError (
400 ,
" Your homeserver does not support this room version " ,
Codes . UNSUPPORTED_ROOM_VERSION ,
)
2020-08-14 13:47:53 +00:00
room_alias = None
2014-08-12 14:10:52 +00:00
if " room_alias_name " in config :
2015-05-14 12:11:28 +00:00
for wchar in string . whitespace :
if wchar in config [ " room_alias_name " ] :
raise SynapseError ( 400 , " Invalid characters in room alias " )
2022-05-18 11:46:06 +00:00
if " : " in config [ " room_alias_name " ] :
# Prevent someone from trying to pass in a full alias here.
# Note that it's permissible for a room alias to have multiple
# hash symbols at the start (notably bridged over from IRC, too),
# but the first colon in the alias is defined to separate the local
# part from the server name.
# (remember server names can contain port numbers, also separated
# by a colon. But under no circumstances should the local part be
# allowed to contain a colon!)
raise SynapseError (
400 ,
" ' : ' is not permitted in the room alias name. "
" Please note this expects a local part — ' wombat ' , not ' #wombat:example.com ' . " ,
)
2014-08-12 14:10:52 +00:00
room_alias = RoomAlias ( config [ " room_alias_name " ] , self . hs . hostname )
2020-05-01 14:15:36 +00:00
mapping = await self . store . get_association_from_room_alias ( room_alias )
2014-08-12 14:10:52 +00:00
if mapping :
2018-06-14 12:08:40 +00:00
raise SynapseError ( 400 , " Room alias already taken " , Codes . ROOM_IN_USE )
2014-08-12 14:10:52 +00:00
2014-09-06 00:10:07 +00:00
for i in invite_list :
try :
2019-10-10 12:05:48 +00:00
uid = UserID . from_string ( i )
parse_and_validate_server_name ( uid . domain )
2017-10-23 14:52:32 +00:00
except Exception :
2014-09-06 00:10:07 +00:00
raise SynapseError ( 400 , " Invalid user_id: %s " % ( i , ) )
2020-08-20 19:07:42 +00:00
if ( invite_list or invite_3pid_list ) and requester . shadow_banned :
# We randomly sleep a bit just to annoy the requester.
await self . clock . sleep ( random . randint ( 1 , 10 ) )
# Allow the request to go through, but remove any associated invites.
invite_3pid_list = [ ]
invite_list = [ ]
2021-05-12 14:05:28 +00:00
if invite_list or invite_3pid_list :
try :
# If there are invites in the request, see if the ratelimiting settings
# allow that number of invites to be sent from the current user.
await self . room_member_handler . ratelimit_multiple_invites (
requester ,
room_id = None ,
n_invites = len ( invite_list ) + len ( invite_3pid_list ) ,
update = False ,
)
except LimitExceededError :
raise SynapseError ( 400 , " Cannot invite so many users at once " )
2021-01-29 16:38:29 +00:00
2020-05-01 14:15:36 +00:00
await self . event_creation_handler . assert_accepted_privacy_policy ( requester )
2018-05-22 07:56:52 +00:00
2019-08-15 08:45:57 +00:00
power_level_content_override = config . get ( " power_level_content_override " )
if (
power_level_content_override
and " users " in power_level_content_override
and user_id not in power_level_content_override [ " users " ]
) :
raise SynapseError (
400 ,
" Not a valid power_level_content_override: ' users ' did not contain %s "
% ( user_id , ) ,
)
2022-04-01 14:55:09 +00:00
# The spec says rooms should default to private visibility if
# `visibility` is not specified.
visibility = config . get ( " visibility " , " private " )
2016-03-23 13:49:10 +00:00
is_public = visibility == " public "
2014-08-28 09:59:15 +00:00
2022-05-16 13:06:04 +00:00
room_id = await self . _generate_and_create_room_id (
2020-01-27 14:30:57 +00:00
creator_id = user_id ,
is_public = is_public ,
room_version = room_version ,
)
2014-08-12 14:10:52 +00:00
2020-10-05 13:57:46 +00:00
# Check whether this visibility value is blocked by a third party module
allowed_by_third_party_rules = await (
self . third_party_event_rules . check_visibility_can_be_modified (
room_id , visibility
)
)
if not allowed_by_third_party_rules :
raise SynapseError ( 403 , " Room visibility value not allowed. " )
2021-10-25 14:24:49 +00:00
if is_public :
2021-11-19 15:19:32 +00:00
room_aliases = [ ]
if room_alias :
room_aliases . append ( room_alias . to_string ( ) )
2021-10-25 14:24:49 +00:00
if not self . config . roomdirectory . is_publishing_room_allowed (
2021-11-19 15:19:32 +00:00
user_id , room_id , room_aliases
2021-10-25 14:24:49 +00:00
) :
# Let's just return a generic message, as there may be all sorts of
# reasons why we said no. TODO: Allow configurable error messages
# per alias creation rule?
raise SynapseError ( 403 , " Not allowed to publish room " )
2020-10-09 11:24:34 +00:00
directory_handler = self . hs . get_directory_handler ( )
2014-11-18 15:03:01 +00:00
if room_alias :
2020-05-01 14:15:36 +00:00
await directory_handler . create_association (
2018-10-18 15:14:24 +00:00
requester = requester ,
2014-11-18 15:03:01 +00:00
room_id = room_id ,
room_alias = room_alias ,
servers = [ self . hs . hostname ] ,
2019-05-02 08:21:29 +00:00
check_membership = False ,
2014-11-18 15:03:01 +00:00
)
2015-07-13 15:48:06 +00:00
preset_config = config . get (
" preset " ,
2016-03-23 13:49:10 +00:00
RoomCreationPreset . PRIVATE_CHAT
if visibility == " private "
else RoomCreationPreset . PUBLIC_CHAT ,
2015-07-13 15:48:06 +00:00
)
2015-07-16 14:25:29 +00:00
raw_initial_state = config . get ( " initial_state " , [ ] )
initial_state = OrderedDict ( )
for val in raw_initial_state :
initial_state [ ( val [ " type " ] , val . get ( " state_key " , " " ) ) ] = val [ " content " ]
2015-09-01 14:09:23 +00:00
creation_content = config . get ( " creation_content " , { } )
2018-07-25 21:10:39 +00:00
# override any attempt to set room versions via the creation_content
2020-01-27 14:30:57 +00:00
creation_content [ " room_version " ] = room_version . identifier
2018-07-25 21:10:39 +00:00
2020-05-22 13:21:54 +00:00
last_stream_id = await self . _send_events_for_new_room (
2016-02-16 12:00:50 +00:00
requester ,
room_id ,
2015-07-13 15:48:06 +00:00
preset_config = preset_config ,
invite_list = invite_list ,
2015-07-16 14:25:29 +00:00
initial_state = initial_state ,
2015-09-01 14:09:23 +00:00
creation_content = creation_content ,
2015-09-23 09:07:31 +00:00
room_alias = room_alias ,
2019-08-15 08:45:57 +00:00
power_level_content_override = power_level_content_override ,
2018-05-17 10:34:28 +00:00
creator_join_profile = creator_join_profile ,
2020-12-11 10:17:49 +00:00
ratelimit = ratelimit ,
2014-08-27 14:11:51 +00:00
)
2014-09-02 09:02:14 +00:00
if " name " in config :
name = config [ " name " ]
2020-05-22 13:21:54 +00:00
(
_ ,
last_stream_id ,
) = await self . event_creation_handler . create_and_send_nonmember_event (
2016-03-03 16:43:42 +00:00
requester ,
{
" type " : EventTypes . Name ,
" room_id " : room_id ,
" sender " : user_id ,
" state_key " : " " ,
" content " : { " name " : name } ,
} ,
ratelimit = False ,
)
2014-09-02 09:02:14 +00:00
if " topic " in config :
topic = config [ " topic " ]
2020-05-22 13:21:54 +00:00
(
_ ,
last_stream_id ,
) = await self . event_creation_handler . create_and_send_nonmember_event (
2016-03-03 16:43:42 +00:00
requester ,
{
" type " : EventTypes . Topic ,
" room_id " : room_id ,
" sender " : user_id ,
" state_key " : " " ,
" content " : { " topic " : topic } ,
} ,
ratelimit = False ,
)
2014-09-02 09:02:14 +00:00
2020-10-29 11:48:39 +00:00
# we avoid dropping the lock between invites, as otherwise joins can
# start coming in and making the createRoom slow.
#
# we also don't need to check the requester's shadow-ban here, as we
# have already done so above (and potentially emptied invite_list).
2022-04-05 14:43:52 +00:00
async with self . room_member_handler . member_linearizer . queue ( ( room_id , ) ) :
2017-11-28 15:19:15 +00:00
content = { }
is_direct = config . get ( " is_direct " , None )
if is_direct :
content [ " is_direct " ] = is_direct
2017-11-28 15:23:26 +00:00
2020-10-29 11:48:39 +00:00
for invitee in invite_list :
(
_ ,
last_stream_id ,
) = await self . room_member_handler . update_membership_locked (
requester ,
UserID . from_string ( invitee ) ,
room_id ,
" invite " ,
ratelimit = False ,
content = content ,
2021-10-06 14:32:16 +00:00
new_room = True ,
2020-10-29 11:48:39 +00:00
)
2014-11-17 16:37:33 +00:00
2016-01-05 11:56:21 +00:00
for invite_3pid in invite_3pid_list :
id_server = invite_3pid [ " id_server " ]
2019-09-11 15:02:42 +00:00
id_access_token = invite_3pid . get ( " id_access_token " ) # optional
2016-01-05 11:56:21 +00:00
address = invite_3pid [ " address " ]
medium = invite_3pid [ " medium " ]
2020-08-20 19:07:42 +00:00
# Note that do_3pid_invite can raise a ShadowBanError, but this was
# handled above by emptying invite_3pid_list.
2020-05-22 13:21:54 +00:00
last_stream_id = await self . hs . get_room_member_handler ( ) . do_3pid_invite (
2016-01-05 11:56:21 +00:00
room_id ,
2016-02-16 12:00:50 +00:00
requester . user ,
2016-01-05 11:56:21 +00:00
medium ,
address ,
id_server ,
2016-02-15 18:21:30 +00:00
requester ,
2016-01-05 12:57:45 +00:00
txn_id = None ,
2019-09-11 15:02:42 +00:00
id_access_token = id_access_token ,
2016-01-05 11:56:21 +00:00
)
2014-08-12 14:10:52 +00:00
result = { " room_id " : room_id }
2014-11-17 16:37:33 +00:00
2014-08-12 14:10:52 +00:00
if room_alias :
result [ " room_alias " ] = room_alias . to_string ( )
2021-02-12 16:01:48 +00:00
# Always wait for room creation to propagate before returning
2020-05-22 15:11:35 +00:00
await self . _replication . wait_for_stream_position (
2020-09-14 09:16:41 +00:00
self . hs . config . worker . events_shard_config . get_instance ( room_id ) ,
" events " ,
last_stream_id ,
2020-05-22 15:11:35 +00:00
)
2020-05-22 13:21:54 +00:00
return result , last_stream_id
2014-08-12 14:10:52 +00:00
2020-05-01 14:15:36 +00:00
async def _send_events_for_new_room (
2016-02-16 12:00:50 +00:00
self ,
2020-08-14 13:47:53 +00:00
creator : Requester ,
room_id : str ,
preset_config : str ,
invite_list : List [ str ] ,
2020-08-28 11:28:53 +00:00
initial_state : MutableStateMap ,
2020-08-14 13:47:53 +00:00
creation_content : JsonDict ,
room_alias : Optional [ RoomAlias ] = None ,
power_level_content_override : Optional [ JsonDict ] = None ,
creator_join_profile : Optional [ JsonDict ] = None ,
2020-12-11 10:17:49 +00:00
ratelimit : bool = True ,
2020-05-22 13:21:54 +00:00
) - > int :
""" Sends the initial events into a new room.
2020-08-14 13:47:53 +00:00
` power_level_content_override ` doesn ' t apply when initial state has
power level state event content .
2020-05-22 13:21:54 +00:00
Returns :
The stream_id of the last event persisted .
"""
2020-08-14 13:47:53 +00:00
creator_id = creator . user . to_string ( )
event_keys = { " room_id " : room_id , " sender " : creator_id , " state_key " : " " }
2021-09-20 12:56:23 +00:00
def create ( etype : str , content : JsonDict , * * kwargs : Any ) - > JsonDict :
2014-12-04 15:50:01 +00:00
e = { " type " : etype , " content " : content }
e . update ( event_keys )
2014-12-08 10:16:18 +00:00
e . update ( kwargs )
2014-12-04 15:50:01 +00:00
return e
2014-09-01 15:15:34 +00:00
2021-09-20 12:56:23 +00:00
async def send ( etype : str , content : JsonDict , * * kwargs : Any ) - > int :
2016-02-16 12:00:50 +00:00
event = create ( etype , content , * * kwargs )
2020-02-06 13:31:05 +00:00
logger . debug ( " Sending %s in new room " , etype )
2020-08-24 17:58:56 +00:00
# Allow these events to be sent even if the user is shadow-banned to
# allow the room creation to complete.
2020-05-22 13:21:54 +00:00
(
_ ,
last_stream_id ,
) = await self . event_creation_handler . create_and_send_nonmember_event (
2020-08-24 17:58:56 +00:00
creator ,
event ,
ratelimit = False ,
ignore_shadow_ban = True ,
2016-03-03 16:43:42 +00:00
)
2020-05-22 13:21:54 +00:00
return last_stream_id
2016-02-16 12:00:50 +00:00
2021-09-03 13:46:18 +00:00
try :
config = self . _presets_dict [ preset_config ]
except KeyError :
raise SynapseError (
400 , f " ' { preset_config } ' is not a valid preset " , errcode = Codes . BAD_JSON
)
2016-02-16 12:00:50 +00:00
creation_content . update ( { " creator " : creator_id } )
2020-05-01 14:15:36 +00:00
await send ( etype = EventTypes . Create , content = creation_content )
2014-08-28 09:59:15 +00:00
2020-02-06 13:31:05 +00:00
logger . debug ( " Sending %s in new room " , EventTypes . Member )
2020-05-01 14:15:36 +00:00
await self . room_member_handler . update_membership (
2016-02-16 12:00:50 +00:00
creator ,
creator . user ,
room_id ,
" join " ,
2020-12-11 10:17:49 +00:00
ratelimit = ratelimit ,
2018-05-17 10:34:28 +00:00
content = creator_join_profile ,
2021-10-06 14:32:16 +00:00
new_room = True ,
2014-11-18 15:29:48 +00:00
)
2017-06-19 13:10:13 +00:00
# We treat the power levels override specially as this needs to be one
# of the first events that get sent into a room.
pl_content = initial_state . pop ( ( EventTypes . PowerLevels , " " ) , None )
if pl_content is not None :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
etype = EventTypes . PowerLevels , content = pl_content
)
2017-06-19 13:10:13 +00:00
else :
2021-07-16 17:22:36 +00:00
power_level_content : JsonDict = {
2016-02-16 12:00:50 +00:00
" users " : { creator_id : 100 } ,
2015-07-16 14:25:29 +00:00
" users_default " : 0 ,
" events " : {
2015-08-20 13:35:40 +00:00
EventTypes . Name : 50 ,
2015-07-16 14:25:29 +00:00
EventTypes . PowerLevels : 100 ,
EventTypes . RoomHistoryVisibility : 100 ,
2015-08-20 13:35:40 +00:00
EventTypes . CanonicalAlias : 50 ,
EventTypes . RoomAvatar : 50 ,
2020-02-17 13:23:37 +00:00
EventTypes . Tombstone : 100 ,
EventTypes . ServerACL : 100 ,
2020-04-09 17:45:38 +00:00
EventTypes . RoomEncryption : 100 ,
2015-07-16 14:25:29 +00:00
} ,
" events_default " : 0 ,
" state_default " : 50 ,
" ban " : 50 ,
" kick " : 50 ,
" redact " : 50 ,
2020-02-17 13:23:37 +00:00
" invite " : 50 ,
2021-07-28 15:46:37 +00:00
" historical " : 100 ,
2021-07-16 17:22:36 +00:00
}
2015-07-13 15:48:06 +00:00
2015-07-16 14:25:29 +00:00
if config [ " original_invitees_have_ops " ] :
for invitee in invite_list :
power_level_content [ " users " ] [ invitee ] = 100
2015-07-13 15:48:06 +00:00
2022-05-12 10:41:35 +00:00
# If the user supplied a preset name e.g. "private_chat",
# we apply that preset
2020-02-17 13:23:37 +00:00
power_level_content . update ( config [ " power_level_content_override " ] )
2022-05-12 10:41:35 +00:00
# If the server config contains default_power_level_content_override,
# and that contains information for this room preset, apply it.
if self . _default_power_level_content_override :
override = self . _default_power_level_content_override . get ( preset_config )
if override is not None :
power_level_content . update ( override )
# Finally, if the user supplied specific permissions for this room,
# apply those.
2018-10-25 16:50:06 +00:00
if power_level_content_override :
power_level_content . update ( power_level_content_override )
2017-06-19 13:10:13 +00:00
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
etype = EventTypes . PowerLevels , content = power_level_content
)
2014-08-28 09:59:15 +00:00
2015-09-30 15:46:24 +00:00
if room_alias and ( EventTypes . CanonicalAlias , " " ) not in initial_state :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
2015-09-30 15:46:24 +00:00
etype = EventTypes . CanonicalAlias ,
content = { " alias " : room_alias . to_string ( ) } ,
)
2015-09-23 09:07:31 +00:00
2015-07-16 14:25:29 +00:00
if ( EventTypes . JoinRules , " " ) not in initial_state :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
2015-07-16 14:25:29 +00:00
etype = EventTypes . JoinRules , content = { " join_rule " : config [ " join_rules " ] }
)
if ( EventTypes . RoomHistoryVisibility , " " ) not in initial_state :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
2015-07-16 14:25:29 +00:00
etype = EventTypes . RoomHistoryVisibility ,
content = { " history_visibility " : config [ " history_visibility " ] } ,
)
2016-03-17 16:07:35 +00:00
if config [ " guest_can_join " ] :
if ( EventTypes . GuestAccess , " " ) not in initial_state :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
2021-09-06 11:17:16 +00:00
etype = EventTypes . GuestAccess ,
content = { EventContentFields . GUEST_ACCESS : GuestAccess . CAN_JOIN } ,
2016-03-17 16:07:35 +00:00
)
2015-07-16 14:25:29 +00:00
for ( etype , state_key ) , content in initial_state . items ( ) :
2020-05-22 13:21:54 +00:00
last_sent_stream_id = await send (
etype = etype , state_key = state_key , content = content
)
2020-06-10 16:44:34 +00:00
if config [ " encrypted " ] :
last_sent_stream_id = await send (
etype = EventTypes . RoomEncryption ,
state_key = " " ,
content = { " algorithm " : RoomEncryptionAlgorithms . DEFAULT } ,
)
2020-05-22 13:21:54 +00:00
return last_sent_stream_id
2014-08-28 09:59:15 +00:00
2022-05-16 13:06:04 +00:00
def _generate_room_id ( self ) - > str :
""" Generates a random room ID.
Room IDs look like " !opaque_id:domain " and are case - sensitive as per the spec
at https : / / spec . matrix . org / v1 .2 / appendices / #room-ids-and-event-ids.
Does not check for collisions with existing rooms or prevent future calls from
returning the same room ID . To ensure the uniqueness of a new room ID , use
` _generate_and_create_room_id ` instead .
Synapse ' s room IDs are 18 [a-zA-Z] characters long, which comes out to around
102 bits .
Returns :
A random room ID of the form " !opaque_id:domain " .
"""
random_string = stringutils . random_string ( 18 )
return RoomID ( random_string , self . hs . hostname ) . to_string ( )
async def _generate_and_create_room_id (
2020-08-14 13:47:53 +00:00
self ,
creator_id : str ,
is_public : bool ,
room_version : RoomVersion ,
2021-09-20 12:56:23 +00:00
) - > str :
2018-10-25 16:40:41 +00:00
# autogen room IDs and try to create it. We may clash, so just
# try a few times till one goes through, giving up eventually.
attempts = 0
while attempts < 5 :
try :
2022-05-16 13:06:04 +00:00
gen_room_id = self . _generate_room_id ( )
2020-05-04 11:43:52 +00:00
await self . store . store_room (
2018-10-25 16:40:41 +00:00
room_id = gen_room_id ,
room_creator_user_id = creator_id ,
is_public = is_public ,
2020-01-27 14:30:57 +00:00
room_version = room_version ,
2018-10-25 16:40:41 +00:00
)
2019-07-23 13:00:55 +00:00
return gen_room_id
2018-10-25 16:40:41 +00:00
except StoreError :
attempts + = 1
raise StoreError ( 500 , " Couldn ' t generate a room ID. " )
2014-08-12 14:10:52 +00:00
2020-09-04 10:54:56 +00:00
class RoomContextHandler :
2020-08-14 13:47:53 +00:00
def __init__ ( self , hs : " HomeServer " ) :
2018-07-18 14:29:45 +00:00
self . hs = hs
2021-01-28 11:27:30 +00:00
self . auth = hs . get_auth ( )
2022-02-23 11:04:02 +00:00
self . store = hs . get_datastores ( ) . main
2019-10-23 16:25:54 +00:00
self . storage = hs . get_storage ( )
self . state_store = self . storage . state
2022-03-18 17:49:32 +00:00
self . _relations_handler = hs . get_relations_handler ( )
2018-07-18 14:29:45 +00:00
2020-08-14 13:47:53 +00:00
async def get_event_context (
self ,
2021-01-28 11:27:30 +00:00
requester : Requester ,
2020-08-14 13:47:53 +00:00
room_id : str ,
event_id : str ,
limit : int ,
event_filter : Optional [ Filter ] ,
2021-01-18 14:02:22 +00:00
use_admin_priviledge : bool = False ,
2022-01-26 13:27:04 +00:00
) - > Optional [ EventContext ] :
2015-10-28 14:05:50 +00:00
""" Retrieves events, pagination tokens and state around a given event
in a room .
Args :
2021-01-28 11:27:30 +00:00
requester
2020-08-14 13:47:53 +00:00
room_id
event_id
limit : The maximum number of events to return in total
2015-10-28 14:05:50 +00:00
( excluding state ) .
2020-08-14 13:47:53 +00:00
event_filter : the filter to apply to the events returned
2018-07-27 14:12:50 +00:00
( excluding the target event_id )
2021-01-18 14:02:22 +00:00
use_admin_priviledge : if ` True ` , return all events , regardless
of whether ` user ` has access to them . To be used * * ONLY * *
from the admin API .
2015-10-28 14:05:50 +00:00
Returns :
2016-01-13 14:19:22 +00:00
dict , or None if the event isn ' t found
2015-10-28 14:05:50 +00:00
"""
2021-01-28 11:27:30 +00:00
user = requester . user
if use_admin_priviledge :
await assert_user_is_admin ( self . auth , requester . user )
2016-02-02 17:18:50 +00:00
before_limit = math . floor ( limit / 2.0 )
2015-10-28 13:45:56 +00:00
after_limit = limit - before_limit
2020-05-04 11:43:52 +00:00
users = await self . store . get_users_in_room ( room_id )
2017-02-20 14:54:50 +00:00
is_peeking = user . to_string ( ) not in users
2021-09-20 12:56:23 +00:00
async def filter_evts ( events : List [ EventBase ] ) - > List [ EventBase ] :
2021-01-25 17:02:35 +00:00
if use_admin_priviledge :
2021-01-28 11:23:19 +00:00
return events
return await filter_events_for_client (
2019-10-23 16:25:54 +00:00
self . storage , user . to_string ( ) , events , is_peeking = is_peeking
2016-05-11 12:42:37 +00:00
)
2016-01-13 14:19:22 +00:00
2020-05-04 11:43:52 +00:00
event = await self . store . get_event (
2016-01-13 14:19:22 +00:00
event_id , get_prev_content = True , allow_none = True
)
if not event :
2019-07-23 13:00:55 +00:00
return None
2016-01-13 14:19:22 +00:00
2020-05-04 11:43:52 +00:00
filtered = await filter_evts ( [ event ] )
2016-01-13 14:19:22 +00:00
if not filtered :
raise AuthError ( 403 , " You don ' t have permission to access that event. " )
2020-05-04 11:43:52 +00:00
results = await self . store . get_events_around (
2018-07-27 14:12:50 +00:00
room_id , event_id , before_limit , after_limit , event_filter
2015-10-28 13:45:56 +00:00
)
2022-01-26 13:27:04 +00:00
events_before = results . events_before
events_after = results . events_after
2015-10-28 13:45:56 +00:00
2019-11-05 15:27:38 +00:00
if event_filter :
2022-01-26 13:27:04 +00:00
events_before = await event_filter . filter ( events_before )
events_after = await event_filter . filter ( events_after )
2019-11-05 15:27:38 +00:00
2022-01-26 13:27:04 +00:00
events_before = await filter_evts ( events_before )
events_after = await filter_evts ( events_after )
2019-12-16 12:14:12 +00:00
# filter_evts can return a pruned event in case the user is allowed to see that
# there's something there but not see the content, so use the event that's in
# `filtered` rather than the event we retrieved from the datastore.
2022-01-26 13:27:04 +00:00
event = filtered [ 0 ]
2015-10-28 13:45:56 +00:00
2022-01-07 14:10:46 +00:00
# Fetch the aggregations.
2022-03-18 17:49:32 +00:00
aggregations = await self . _relations_handler . get_bundled_aggregations (
2022-01-26 13:27:04 +00:00
itertools . chain ( events_before , ( event , ) , events_after ) ,
user . to_string ( ) ,
2022-01-18 16:38:57 +00:00
)
2022-01-07 14:10:46 +00:00
2022-01-26 13:27:04 +00:00
if events_after :
last_event_id = events_after [ - 1 ] . event_id
2015-10-28 13:45:56 +00:00
else :
last_event_id = event_id
2021-10-27 15:26:30 +00:00
if event_filter and event_filter . lazy_load_members :
2018-10-25 16:49:55 +00:00
state_filter = StateFilter . from_lazy_load_member_list (
ev . sender
for ev in itertools . chain (
2022-01-26 13:27:04 +00:00
events_before ,
( event , ) ,
events_after ,
2018-10-25 16:49:55 +00:00
)
)
else :
state_filter = StateFilter . all ( )
2018-07-27 14:12:50 +00:00
# XXX: why do we return the state as of the last event rather than the
# first? Shouldn't we be consistent with /sync?
# https://github.com/matrix-org/matrix-doc/issues/687
2020-05-04 11:43:52 +00:00
state = await self . state_store . get_state_for_events (
2018-10-25 16:49:55 +00:00
[ last_event_id ] , state_filter = state_filter
2015-10-28 13:45:56 +00:00
)
2019-11-06 18:14:03 +00:00
state_events = list ( state [ last_event_id ] . values ( ) )
if event_filter :
2021-11-09 13:10:58 +00:00
state_events = await event_filter . filter ( state_events )
2019-11-06 18:14:03 +00:00
2018-07-24 15:46:30 +00:00
# We use a dummy token here as we only care about the room portion of
# the token, which we replace.
token = StreamToken . START
2022-01-26 13:27:04 +00:00
return EventContext (
events_before = events_before ,
event = event ,
events_after = events_after ,
state = await filter_evts ( state_events ) ,
aggregations = aggregations ,
2022-05-16 15:35:31 +00:00
start = await token . copy_and_replace (
StreamKeyType . ROOM , results . start
) . to_string ( self . store ) ,
end = await token . copy_and_replace ( StreamKeyType . ROOM , results . end ) . to_string (
2022-01-26 13:27:04 +00:00
self . store
) ,
)
2015-10-28 13:45:56 +00:00
2021-12-02 07:02:20 +00:00
class TimestampLookupHandler :
def __init__ ( self , hs : " HomeServer " ) :
self . server_name = hs . hostname
2022-02-23 11:04:02 +00:00
self . store = hs . get_datastores ( ) . main
2021-12-02 07:02:20 +00:00
self . state_handler = hs . get_state_handler ( )
self . federation_client = hs . get_federation_client ( )
async def get_event_for_timestamp (
self ,
requester : Requester ,
room_id : str ,
timestamp : int ,
direction : str ,
) - > Tuple [ str , int ] :
""" Find the closest event to the given timestamp in the given direction.
If we can ' t find an event locally or the event we have locally is next to a gap,
it will ask other federated homeservers for an event .
Args :
requester : The user making the request according to the access token
room_id : Room to fetch the event from
timestamp : The point in time ( inclusive ) we should navigate from in
the given direction to find the closest event .
direction : [ " f " | " b " ] to indicate whether we should navigate forward
or backward from the given timestamp to find the closest event .
Returns :
A tuple containing the ` event_id ` closest to the given timestamp in
the given direction and the ` origin_server_ts ` .
Raises :
SynapseError if unable to find any event locally in the given direction
"""
local_event_id = await self . store . get_event_id_for_timestamp (
room_id , timestamp , direction
)
logger . debug (
" get_event_for_timestamp: locally, we found event_id= %s closest to timestamp= %s " ,
local_event_id ,
timestamp ,
)
# Check for gaps in the history where events could be hiding in between
# the timestamp given and the event we were able to find locally
is_event_next_to_backward_gap = False
is_event_next_to_forward_gap = False
if local_event_id :
local_event = await self . store . get_event (
local_event_id , allow_none = False , allow_rejected = False
)
if direction == " f " :
# We only need to check for a backward gap if we're looking forwards
# to ensure there is nothing in between.
is_event_next_to_backward_gap = (
await self . store . is_event_next_to_backward_gap ( local_event )
)
elif direction == " b " :
# We only need to check for a forward gap if we're looking backwards
# to ensure there is nothing in between
is_event_next_to_forward_gap = (
await self . store . is_event_next_to_forward_gap ( local_event )
)
# If we found a gap, we should probably ask another homeserver first
# about more history in between
if (
not local_event_id
or is_event_next_to_backward_gap
or is_event_next_to_forward_gap
) :
logger . debug (
" get_event_for_timestamp: locally, we found event_id= %s closest to timestamp= %s which is next to a gap in event history so we ' re asking other homeservers first " ,
local_event_id ,
timestamp ,
)
# Find other homeservers from the given state in the room
curr_state = await self . state_handler . get_current_state ( room_id )
curr_domains = get_domains_from_state ( curr_state )
likely_domains = [
domain for domain , depth in curr_domains if domain != self . server_name
]
# Loop through each homeserver candidate until we get a succesful response
for domain in likely_domains :
try :
remote_response = await self . federation_client . timestamp_to_event (
domain , room_id , timestamp , direction
)
logger . debug (
" get_event_for_timestamp: response from domain( %s )= %s " ,
domain ,
remote_response ,
)
# TODO: Do we want to persist this as an extremity?
# TODO: I think ideally, we would try to backfill from
# this event and run this whole
# `get_event_for_timestamp` function again to make sure
# they didn't give us an event from their gappy history.
remote_event_id = remote_response . event_id
origin_server_ts = remote_response . origin_server_ts
# Only return the remote event if it's closer than the local event
if not local_event or (
abs ( origin_server_ts - timestamp )
< abs ( local_event . origin_server_ts - timestamp )
) :
return remote_event_id , origin_server_ts
except ( HttpResponseException , InvalidResponseError ) as ex :
# Let's not put a high priority on some other homeserver
# failing to respond or giving a random response
logger . debug (
" Failed to fetch /timestamp_to_event from %s because of exception( %s ) %s args= %s " ,
domain ,
type ( ex ) . __name__ ,
ex ,
ex . args ,
)
except Exception as ex :
# But we do want to see some exceptions in our code
logger . warning (
" Failed to fetch /timestamp_to_event from %s because of exception( %s ) %s args= %s " ,
domain ,
type ( ex ) . __name__ ,
ex ,
ex . args ,
)
if not local_event_id :
raise SynapseError (
404 ,
" Unable to find event from %s in direction %s " % ( timestamp , direction ) ,
errcode = Codes . NOT_FOUND ,
)
return local_event_id , local_event . origin_server_ts
2021-09-21 17:34:26 +00:00
class RoomEventSource ( EventSource [ RoomStreamToken , EventBase ] ) :
2020-08-14 13:47:53 +00:00
def __init__ ( self , hs : " HomeServer " ) :
2022-02-23 11:04:02 +00:00
self . store = hs . get_datastores ( ) . main
2014-08-29 16:09:15 +00:00
2020-05-04 11:43:52 +00:00
async def get_new_events (
2020-08-14 13:47:53 +00:00
self ,
user : UserID ,
2020-09-11 11:22:55 +00:00
from_key : RoomStreamToken ,
2021-09-21 17:34:26 +00:00
limit : Optional [ int ] ,
room_ids : Collection [ str ] ,
2020-08-14 13:47:53 +00:00
is_guest : bool ,
explicit_room_id : Optional [ str ] = None ,
2020-09-11 11:22:55 +00:00
) - > Tuple [ List [ EventBase ] , RoomStreamToken ] :
2014-08-29 16:09:15 +00:00
# We just ignore the key for now.
2020-08-04 11:21:47 +00:00
to_key = self . get_current_key ( )
2014-08-29 16:09:15 +00:00
2020-09-11 11:22:55 +00:00
if from_key . topological :
2019-10-31 10:23:24 +00:00
logger . warning ( " Stream has topological part!!!! %r " , from_key )
2020-09-11 11:22:55 +00:00
from_key = RoomStreamToken ( None , from_key . stream )
2016-02-02 14:11:14 +00:00
2016-10-06 08:43:32 +00:00
app_service = self . store . get_app_service_by_user_id ( user . to_string ( ) )
2015-02-25 15:00:59 +00:00
if app_service :
2018-03-05 15:42:57 +00:00
# We no longer support AS users using /sync directly.
# See https://github.com/matrix-org/matrix-doc/issues/1144
raise NotImplementedError ( )
2015-02-25 15:00:59 +00:00
else :
2020-05-04 11:43:52 +00:00
room_events = await self . store . get_membership_changes_for_user (
2016-02-01 16:26:51 +00:00
user . to_string ( ) , from_key , to_key
)
2020-05-04 11:43:52 +00:00
room_to_events = await self . store . get_room_events_stream_for_rooms (
2016-02-01 16:26:51 +00:00
room_ids = room_ids ,
2015-02-25 15:00:59 +00:00
from_key = from_key ,
to_key = to_key ,
2016-02-01 16:26:51 +00:00
limit = limit or 10 ,
2016-02-11 10:07:27 +00:00
order = " ASC " ,
2015-02-25 15:00:59 +00:00
)
2014-08-29 16:09:15 +00:00
2016-02-01 16:26:51 +00:00
events = list ( room_events )
events . extend ( e for evs , _ in room_to_events . values ( ) for e in evs )
2016-02-01 16:32:46 +00:00
events . sort ( key = lambda e : e . internal_metadata . order )
2016-02-01 16:26:51 +00:00
if limit :
events [ : ] = events [ : limit ]
if events :
2020-09-29 20:48:33 +00:00
end_key = events [ - 1 ] . internal_metadata . after
2016-02-01 16:26:51 +00:00
else :
end_key = to_key
2021-09-23 10:59:07 +00:00
return events , end_key
2014-08-29 16:09:15 +00:00
2020-09-11 11:22:55 +00:00
def get_current_key ( self ) - > RoomStreamToken :
2020-09-29 20:48:33 +00:00
return self . store . get_room_max_token ( )
2016-10-24 12:35:51 +00:00
2022-04-06 10:40:28 +00:00
def get_current_key_for_room ( self , room_id : str ) - > Awaitable [ RoomStreamToken ] :
return self . store . get_current_room_stream_token_for_room_id ( room_id )
2020-07-14 11:36:23 +00:00
2021-11-09 13:11:47 +00:00
class ShutdownRoomResponse ( TypedDict ) :
2021-11-12 12:35:31 +00:00
"""
Attributes :
kicked_users : An array of users ( ` user_id ` ) that were kicked .
failed_to_kick_users :
An array of users ( ` user_id ` ) that that were not kicked .
local_aliases :
An array of strings representing the local aliases that were
migrated from the old room to the new .
new_room_id : A string representing the room ID of the new room .
"""
2021-11-09 13:11:47 +00:00
kicked_users : List [ str ]
failed_to_kick_users : List [ str ]
local_aliases : List [ str ]
new_room_id : Optional [ str ]
2020-09-04 10:54:56 +00:00
class RoomShutdownHandler :
2020-07-14 11:36:23 +00:00
DEFAULT_MESSAGE = (
" Sharing illegal content on this server is not permitted and rooms in "
" violation will be blocked. "
)
DEFAULT_ROOM_NAME = " Content Violation Notification "
2020-08-14 13:47:53 +00:00
def __init__ ( self , hs : " HomeServer " ) :
2020-07-14 11:36:23 +00:00
self . hs = hs
self . room_member_handler = hs . get_room_member_handler ( )
self . _room_creation_handler = hs . get_room_creation_handler ( )
self . _replication = hs . get_replication_data_handler ( )
2022-03-09 18:23:57 +00:00
self . _third_party_rules = hs . get_third_party_event_rules ( )
2020-07-14 11:36:23 +00:00
self . event_creation_handler = hs . get_event_creation_handler ( )
2022-02-23 11:04:02 +00:00
self . store = hs . get_datastores ( ) . main
2020-07-14 11:36:23 +00:00
async def shutdown_room (
self ,
room_id : str ,
requester_user_id : str ,
new_room_user_id : Optional [ str ] = None ,
new_room_name : Optional [ str ] = None ,
message : Optional [ str ] = None ,
block : bool = False ,
2021-11-09 13:11:47 +00:00
) - > ShutdownRoomResponse :
2020-07-14 11:36:23 +00:00
"""
Shuts down a room . Moves all local users and room aliases automatically
to a new room if ` new_room_user_id ` is set . Otherwise local users only
leave the room without any information .
The new room will be created with the user specified by the
` new_room_user_id ` parameter as room administrator and will contain a
message explaining what happened . Users invited to the new room will
have power level ` - 10 ` by default , and thus be unable to speak .
The local server will only have the power to move local user and room
aliases to the new room . Users on other servers will be unaffected .
Args :
room_id : The ID of the room to shut down .
requester_user_id :
User who requested the action and put the room on the
blocking list .
new_room_user_id :
If set , a new room will be created with this user ID
as the creator and admin , and all users in the old room will be
moved into that room . If not set , no new room will be created
and the users will just be removed from the old room .
new_room_name :
A string representing the name of the room that new users will
be invited to . Defaults to ` Content Violation Notification `
message :
A string containing the first message that will be sent as
` new_room_user_id ` in the new room . Ideally this will clearly
convey why the original room was shut down .
Defaults to ` Sharing illegal content on this server is not
permitted and rooms in violation will be blocked . `
block :
2021-11-09 13:11:47 +00:00
If set to ` True ` , users will be prevented from joining the old
room . This option can also be used to pre - emptively block a room ,
even if it ' s unknown to this homeserver. In this case, the room
will be blocked , and no further action will be taken . If ` False ` ,
attempting to delete an unknown room is invalid .
Defaults to ` False ` .
2020-07-14 11:36:23 +00:00
Returns : a dict containing the following keys :
kicked_users : An array of users ( ` user_id ` ) that were kicked .
failed_to_kick_users :
An array of users ( ` user_id ` ) that that were not kicked .
local_aliases :
An array of strings representing the local aliases that were
migrated from the old room to the new .
2021-11-09 13:11:47 +00:00
new_room_id :
A string representing the room ID of the new room , or None if
no such room was created .
2020-07-14 11:36:23 +00:00
"""
if not new_room_name :
new_room_name = self . DEFAULT_ROOM_NAME
if not message :
message = self . DEFAULT_MESSAGE
if not RoomID . is_valid ( room_id ) :
raise SynapseError ( 400 , " %s is not a legal room ID " % ( room_id , ) )
2022-03-09 18:23:57 +00:00
if not await self . _third_party_rules . check_can_shutdown_room (
requester_user_id , room_id
) :
raise SynapseError (
403 , " Shutdown of this room is forbidden " , Codes . FORBIDDEN
)
2021-11-09 13:11:47 +00:00
# Action the block first (even if the room doesn't exist yet)
2020-07-14 11:36:23 +00:00
if block :
2021-11-09 13:11:47 +00:00
# This will work even if the room is already blocked, but that is
# desirable in case the first attempt at blocking the room failed below.
2020-07-14 11:36:23 +00:00
await self . store . block_room ( room_id , requester_user_id )
2021-11-09 13:11:47 +00:00
if not await self . store . get_room ( room_id ) :
2021-12-07 11:37:54 +00:00
# if we don't know about the room, there is nothing left to do.
return {
" kicked_users " : [ ] ,
" failed_to_kick_users " : [ ] ,
" local_aliases " : [ ] ,
" new_room_id " : None ,
}
2021-11-09 13:11:47 +00:00
2020-07-14 11:36:23 +00:00
if new_room_user_id is not None :
if not self . hs . is_mine_id ( new_room_user_id ) :
raise SynapseError (
400 , " User must be our own: %s " % ( new_room_user_id , )
)
2020-11-17 10:51:25 +00:00
room_creator_requester = create_requester (
new_room_user_id , authenticated_entity = requester_user_id
)
2020-07-14 11:36:23 +00:00
info , stream_id = await self . _room_creation_handler . create_room (
room_creator_requester ,
config = {
" preset " : RoomCreationPreset . PUBLIC_CHAT ,
" name " : new_room_name ,
" power_level_content_override " : { " users_default " : - 10 } ,
} ,
ratelimit = False ,
)
new_room_id = info [ " room_id " ]
logger . info (
" Shutting down room %r , joining to new room: %r " , room_id , new_room_id
)
# We now wait for the create room to come back in via replication so
2020-10-23 16:38:40 +00:00
# that we can assume that all the joins/invites have propagated before
2020-07-14 11:36:23 +00:00
# we try and auto join below.
await self . _replication . wait_for_stream_position (
2020-09-14 09:16:41 +00:00
self . hs . config . worker . events_shard_config . get_instance ( new_room_id ) ,
" events " ,
stream_id ,
2020-07-14 11:36:23 +00:00
)
else :
new_room_id = None
logger . info ( " Shutting down room %r " , room_id )
2021-05-05 15:49:34 +00:00
users = await self . store . get_users_in_room ( room_id )
2020-07-14 11:36:23 +00:00
kicked_users = [ ]
failed_to_kick_users = [ ]
for user_id in users :
if not self . hs . is_mine_id ( user_id ) :
continue
logger . info ( " Kicking %r from %r ... " , user_id , room_id )
try :
# Kick users from room
2020-11-17 10:51:25 +00:00
target_requester = create_requester (
user_id , authenticated_entity = requester_user_id
)
2020-07-14 11:36:23 +00:00
_ , stream_id = await self . room_member_handler . update_membership (
requester = target_requester ,
target = target_requester . user ,
room_id = room_id ,
action = Membership . LEAVE ,
content = { } ,
ratelimit = False ,
require_consent = False ,
)
# Wait for leave to come in over replication before trying to forget.
await self . _replication . wait_for_stream_position (
2020-09-14 09:16:41 +00:00
self . hs . config . worker . events_shard_config . get_instance ( room_id ) ,
" events " ,
stream_id ,
2020-07-14 11:36:23 +00:00
)
await self . room_member_handler . forget ( target_requester . user , room_id )
# Join users to new room
if new_room_user_id :
await self . room_member_handler . update_membership (
requester = target_requester ,
target = target_requester . user ,
room_id = new_room_id ,
action = Membership . JOIN ,
content = { } ,
ratelimit = False ,
require_consent = False ,
)
kicked_users . append ( user_id )
except Exception :
logger . exception (
" Failed to leave old room and join new room for %r " , user_id
)
failed_to_kick_users . append ( user_id )
# Send message in new room and move aliases
if new_room_user_id :
await self . event_creation_handler . create_and_send_nonmember_event (
room_creator_requester ,
{
" type " : " m.room.message " ,
" content " : { " body " : message , " msgtype " : " m.text " } ,
" room_id " : new_room_id ,
" sender " : new_room_user_id ,
} ,
ratelimit = False ,
)
2020-08-27 11:08:38 +00:00
aliases_for_room = await self . store . get_aliases_for_room ( room_id )
2020-07-14 11:36:23 +00:00
await self . store . update_aliases_for_room (
room_id , new_room_id , requester_user_id
)
else :
aliases_for_room = [ ]
return {
" kicked_users " : kicked_users ,
" failed_to_kick_users " : failed_to_kick_users ,
" local_aliases " : aliases_for_room ,
" new_room_id " : new_room_id ,
}