Когда отображается сообщение Element M_FORBIDDEN: You do not have permission, сначала определите точное действие, которое завершилось с ошибкой. Большинство сбоев в управлении комнатами вызваны уровнем доступа к комнате или членством в ней; для сбоя Synapse Admin API требуется учетная запись администратора домашнего сервера. Попросите текущего администратора комнаты предоставить только необходимые разрешения для комнаты или используйте Synapse Admin API только в том случае, если отклоненная операция действительно является задачей администратора сервера.
Гипотетический пример: Алекс помогает модерировать комнату в Matrix и может удалять спам, но получает уведомления M_FORBIDDENпри изменении прав на приглашение пользователей. Алекс является модератором в этой комнате, а не администратором. Пример носит иллюстративный характер; это не утверждение, основанное на проверенном аккаунте или сервере.
Укажите, какая система управления правами отклонила запрос.
Matrix использует это M_FORBIDDENкак общую ошибку, указывающую на запрещенный доступ. Сам код не говорит о том, связана ли проблема с уровнями мощности комнаты, членством в комнате, ограничением учетной записи или авторизацией для административного API. Прочитайте полный текст ошибки и обратите внимание на то, что делал Алекс: редактировал настройки комнаты, приглашал или блокировал кого-то, присоединялся к комнате или открывал инструмент администрирования Synapse.
Права доступа комнаты хранятся в m.room.power_levelsсобытии состояния. Роли элемента, такие как «По умолчанию», «Модератор» и «Администратор», позволяют пользователю просматривать эти значения, но комната может устанавливать собственные уровни доступа. Администратор домашнего сервера — это отдельная роль; она не делает этого пользователя автоматически администратором комнаты. Действие: классифицируйте неудачное действие перед изменением ролей и проверьте, связана ли ошибка с настройками комнаты элемента или с /_synapse/admin/конечной точкой.
Устраните влияние уровня мощности помещения на действие, выполняемое в комнате.
Если Алекс не может изменить настройку в Element, попросите существующего администратора комнаты проверить роли и разрешения комнаты. В Element Web или Desktop откройте комнату, откройте информацию о комнате или меню комнаты, выберите «Настройки комнаты» и перейдите в раздел «Роли и разрешения». Проверьте запись Алекса в разделе «Привилегированные пользователи» и необходимую роль для конкретного действия. Надписи и расположение могут различаться в зависимости от версии клиента.
Для задачи, связанной с приглашением пользователей Алексом, администратор должен проверить как собственный уровень полномочий Алекса, так и уровень, необходимый для изменения этого разрешения. Спецификация Matrix определяет их независимо: inviteпороговое значение контролирует приглашения, а изменение самого события уровня полномочий требует наличия полномочий для отправки этого события состояния. Участник может иметь разрешение на приглашение пользователей, но не иметь разрешения на изменение порогового значения для приглашений. Текущий администратор может повысить уровень полномочий Алекса до самого низкого соответствующего уровня или самостоятельно изменить конкретное разрешение.
В стандартных настройках Element уровень администратора обычно составляет 100, а модератора — 50, но требования можно настроить индивидуально для каждой комнаты. Не следует предполагать, что во всех комнатах используются эти настройки по умолчанию. Также избегайте понижения в должности единственного администратора: Element предупреждает, что это может привести к тому, что в комнате не останется никого, кто мог бы ею управлять. Действие: перед сохранением изменения роли попросите текущего администратора подтвердить, что остался другой доверенный администратор.
Если никто из команды не может администрировать комнату, выясните, доступен ли текущий администратор комнаты на другой учетной записи или устройстве. Для комнат, размещенных на Synapse, администратор домашнего сервера может использовать API Synapse «Сделать комнату администратором», чтобы предоставить максимальные доступные права локальному пользователю, находящемуся в комнате. Это путь восстановления для оператора домашнего сервера, а не обычный обход разрешений на стороне клиента; для доступа к конечной точке требуются учетные данные администратора сервера, и она может не применяться к комнатам, размещенным в других местах. Используйте текущую документацию по конечной точке Synapse и держите его API администратора в секрете от публичного доступа.
Если ошибка возникла из-за Synapse Admin API.
Если неудачный запрос направлен на /_synapse/admin/...администратора комнаты в Element, этого недостаточно. Synapse требует действительный токен доступа, принадлежащий администратору сервера, для многих вызовов Admin API. Убедитесь, что токен принадлежит нужной учетной записи, не был отозван или введен с ошибкой и отправлен с использованием документированного заголовка авторизации. Не вставляйте токены доступа в публичные сообщения об ошибках, скриншоты браузера или общие журналы; относитесь к ним как к паролям.
Synapse рекомендует скрывать API администратора от публичного доступа с помощью обратного прокси-сервера и, как правило, отправлять запросы с машины, на которой запущен Synapse. Администратор должен использовать API, соответствующий установленной версии Synapse. Избегайте прямого редактирования базы данных для повышения прав пользователя в качестве первого шага: текущие рекомендации Synapse направляют операторов к командам и API администратора после получения учетной записи администратора сервера.
Проверьте членство, состояние учетной записи и результат.
Если ошибка произошла при присоединении к комнате или отправке события, убедитесь, что Алекс действительно присоединился к комнате и не забанен. Приглашение не равнозначно присоединению, и правила членства могут блокировать доступ, даже если у учетной записи высокий уровень власти. Если ошибка появляется в несвязанных комнатах или при входе в систему, это может быть не проблема администратора комнаты; проверьте полный ответ об ошибке и убедитесь, что учетная запись не заблокирована, не приостановлена или иным образом не ограничена домашним сервером.
После того, как администратор изменит права доступа, попросите Алекса повторить ту же операцию в той же комнате. Подтвердите ожидаемый результат — например, что приглашение или изменение настроек прошло успешно — и проверьте раздел «Роли и разрешения» в комнате, чтобы убедиться, что нужный уровень присутствует. Если ошибка по-прежнему не удается, зафиксируйте точное действие, идентификатор комнаты, метку времени, HTTP-статус и скрытый текст ошибки для администратора домашнего сервера. Не указывайте токен доступа.
Для получения информации о стандартных кодах ошибок и правилах уровня мощности в комнатах используйте спецификацию API Matrix Client-Server , страницы справки и поддержки Element для работы с настройками комнат, а также документацию по API Synapse Admin для аутентификации администратора сервера и операций восстановления комнат. Точный текст сообщений и элементы управления зависят от клиента, домашнего сервера, версии комнаты и заданных уровней мощности.