The types of state events that affect authorization are:
Power levels are inferred from defaults when not explicitly supplied.
For example, mentions of the
sender’s power level can also refer to
the default power level for users in the room.
The rules are as follows:
- If type is
m.room.create:- If it has any previous events, reject.
- If the domain of the
room_iddoes not match the domain of thesender, reject. - If
content.room_versionis present and is not a recognised version, reject. - If
contenthas nocreatorfield, reject. - Otherwise, allow.
- Considering the event’s
auth_events:- If there are duplicate entries for a given
typeandstate_keypair, reject. - If there are entries whose
typeandstate_keydon’t match those specified by the auth events selection algorithm described in the server specification, reject. - If there are entries which were themselves rejected under the checks performed on receipt of a PDU, reject.
- If there is no
m.room.createevent among the entries, reject.
- If there are duplicate entries for a given
- If the
contentof them.room.createevent in the room state has the propertym.federateset tofalse, and thesenderdomain of the event does not match thesenderdomain of the create event, reject. - If type is
m.room.aliases:- If event has no
state_key, reject. - If sender’s domain doesn’t matches
state_key, reject. - Otherwise, allow.
- If event has no
- If type is
m.room.member:- If no
state_keykey ormembershipkey incontent, reject. - If
membershipisjoin:- If the only previous event is an
m.room.createand thestate_keyis the creator, allow. - If the
senderdoes not matchstate_key, reject. - If the
senderis banned, reject. - If the
join_ruleisinvitethen allow if membership state isinviteorjoin. - If the
join_ruleispublic, allow. - Otherwise, reject.
- If the only previous event is an
- If
membershipisinvite:- If
contenthasthird_party_invitekey:- If target user is banned, reject.
- If
content.third_party_invitedoes not have asignedkey, reject. - If
signeddoes not havemxidandtokenkeys, reject. - If
mxiddoes not matchstate_key, reject. - If there is no
m.room.third_party_inviteevent in the current room state withstate_keymatchingtoken, reject. - If
senderdoes not matchsenderof them.room.third_party_invite, reject. - If any signature in
signedmatches any public key in them.room.third_party_inviteevent, allow. The public keys are incontentofm.room.third_party_inviteas:- A single public key in the
public_keyfield. - A list of public keys in the
public_keysfield.
- A single public key in the
- Otherwise, reject.
- If the
sender’s current membership state is notjoin, reject. - If target user’s current membership state is
joinorban, reject. - If the
sender’s power level is greater than or equal to the invite level, allow. - Otherwise, reject.
- If
- If
membershipisleave:- If the
sendermatchesstate_key, allow if and only if that user’s current membership state isinviteorjoin. - If the
sender’s current membership state is notjoin, reject. - If the target user’s current membership state is
ban, and thesender’s power level is less than the ban level, reject. - If the
sender’s power level is greater than or equal to the kick level, and the target user’s power level is less than thesender’s power level, allow. - Otherwise, reject.
- If the
- If
membershipisban:- If the
sender’s current membership state is notjoin, reject. - If the
sender’s power level is greater than or equal to the ban level, and the target user’s power level is less than thesender’s power level, allow. - Otherwise, reject.
- If the
- Otherwise, the membership is unknown. Reject.
- If no
- If the
sender’s current membership state is notjoin, reject. - If type is
m.room.third_party_invite:- Allow if and only if
sender’s current power level is greater than or equal to the invite level.
- Allow if and only if
- If the event type’s required power level is greater than the
sender’s power level, reject. - If the event has a
state_keythat starts with an@and does not match thesender, reject. - If type is
m.room.power_levels:- If
userskey incontentis not a dictionary with keys that are valid user IDs with values that are integers (or a string that is an integer), reject. - If there is no previous
m.room.power_levelsevent in the room, allow. - For the keys
users_default,events_default,state_default,ban,redact,kick,invitecheck if they were added, changed or removed. For each found alteration:- If the current value is higher than the
sender’s current power level, reject. - If the new value is higher than the
sender’s current power level, reject.
- If the current value is higher than the
- For each entry being added, changed or removed in both the
eventsanduserskeys:- If the current value is higher than the
sender’s current power level, reject. - If the new value is higher than the
sender’s current power level, reject.
- If the current value is higher than the
- For each entry being changed under the
userskey, other than thesender’s own entry:- If the current value is equal to the
sender’s current power level, reject.
- If the current value is equal to the
- Otherwise, allow.
- If
- If type is
m.room.redaction:- If the
sender’s power level is greater than or equal to the redact level, allow. - If the domain of the
event_idof the event being redacted is the same as the domain of theevent_idof them.room.redaction, allow. - Otherwise, reject.
- If the
- Otherwise, allow.
Some consequences of these rules:
- Unless you are a member of the room, the only permitted operations (apart from the initial create/join) are: joining a public room; accepting or rejecting an invitation to a room.
- To unban somebody, you must have power level greater than or equal to both the kick and ban levels, and greater than the target user’s power level.