Quando o Element exibir um erro M_FORBIDDEN: You do not have permission, primeiro identifique a ação exata que falhou. A maioria das falhas de gerenciamento de salas é causada pelo nível de privilégio ou pela associação da conta à sala; uma falha na API de administração do Synapse, por outro lado, requer uma conta de administrador do servidor doméstico. Peça a um administrador da sala atual que conceda apenas a permissão necessária para a sala ou use a API de administração do Synapse somente quando a operação negada for realmente uma tarefa de administrador do servidor.
Exemplo hipotético: Alex ajuda a moderar uma sala do Matrix e pode remover spam, mas recebe notificações M_FORBIDDENao alterar quem pode convidar pessoas. Alex é moderador nessa sala, não administrador. O exemplo é ilustrativo; não se trata de uma afirmação sobre uma conta ou servidor testado.
Identifique qual sistema de permissões negou a solicitação.
O Matrix usa isso M_FORBIDDENcomo um erro geral de acesso proibido. O código por si só não indica se o problema está relacionado aos níveis de privilégios da sala, à participação na sala, a uma restrição de conta ou à autorização para uma API administrativa. Leia o erro completo e observe o que Alex estava fazendo: editando uma configuração da sala, convidando ou banindo alguém, entrando em uma sala ou abrindo uma ferramenta de administração do Synapse.
As permissões de uma sala são armazenadas em seu m.room.power_levelsevento de estado. Funções do Element, como Padrão, Moderador e Administrador, são uma maneira visível para o usuário inspecionar esses valores, mas a sala pode definir níveis personalizados. Um administrador de servidor doméstico é uma função separada; isso não torna automaticamente esse usuário um administrador da sala. Ação: classifique a ação com falha antes de alterar as funções e verifique se o erro veio das configurações da sala do Element ou de um /_synapse/admin/endpoint.
Corrija uma ação da sala com os níveis de energia da sala.
Se Alex não conseguir alterar uma configuração no Element, peça a um administrador da sala que verifique as funções e permissões da sala. No Element Web ou Desktop, abra a sala, acesse Informações da Sala ou o menu da sala, escolha Configurações da Sala e vá para Funções e Permissões. Verifique a entrada de Alex em Usuários Privilegiados e a função necessária para a ação específica. Os rótulos e o layout podem variar de acordo com a versão do cliente.
Para a tarefa de permissão de convite de Alex, o administrador deve verificar tanto o nível de poder de Alex quanto o nível necessário para alterar essa permissão. A especificação Matrix define esses dois aspectos independentemente: o invitelimite controla os convites, enquanto a alteração do evento de nível de poder em si requer autoridade para enviar esse evento de estado. Um membro pode ter permissão para convidar usuários, mas não ter permissão para alterar o limite de convites. O administrador atual pode promover Alex para o nível mais baixo apropriado ou fazer a alteração de permissão específica por conta própria.
Na configuração padrão documentada do Element, o Administrador geralmente tem nível 100 e o Moderador nível 50, mas as salas podem personalizar os requisitos. Não presuma que todas as salas usam esses padrões. Além disso, evite rebaixar o único administrador: o Element alerta que isso pode deixar a sala sem ninguém para gerenciá-la. Ação: peça ao administrador atual para confirmar se ainda há outro administrador confiável antes de salvar uma alteração de função.
Se ninguém na equipe puder administrar a sala, verifique se o administrador atual da sala está disponível em outra conta ou dispositivo. Para salas hospedadas no Synapse, um administrador do servidor doméstico pode usar a API "Tornar Administrador da Sala" do Synapse para conceder o nível máximo de privilégios a um usuário local presente na sala. Essa é uma medida de segurança para o operador do servidor doméstico, não uma simples forma de burlar as permissões do lado do cliente; o endpoint requer credenciais de administrador do servidor e pode não se aplicar a salas hospedadas em outros servidores. Utilize a documentação atual do endpoint do Synapse e mantenha a API de administração privada, impedindo o acesso público.
Se o erro foi originado na API de administração do Synapse
Se a solicitação falhar e for direcionada /_synapse/admin/...ao administrador da sala no Element, isso não será suficiente. O Synapse exige um token de acesso válido pertencente a um administrador do servidor para muitas chamadas da API de administração. Confirme se o token pertence à conta pretendida, se não foi revogado ou digitado incorretamente e se foi enviado usando o cabeçalho de autorização documentado. Não cole tokens de acesso em uma issue pública, captura de tela do navegador ou log compartilhado; trate-os como senhas.
A Synapse recomenda ocultar a API de administração da visualização pública com um proxy reverso e, normalmente, fazer solicitações a partir da máquina que executa o Synapse. Um administrador deve usar a API correspondente à versão do Synapse instalada. Evite editar o banco de dados diretamente para elevar os privilégios de um usuário como primeira opção: as diretrizes atuais da Synapse orientam os operadores a usar comandos e APIs de administração somente após obterem uma conta de administrador do servidor.
Verifique a associação, o estado da conta e o resultado.
Se a ação que falhou foi entrar ou enviar um evento, confirme se Alex realmente entrou na sala e se não está banido. Ser convidado não é o mesmo que entrar, e as regras de associação podem bloquear o acesso mesmo quando a conta tem um alto nível de privilégios. Se o erro ocorrer em salas diferentes ou durante o login, pode não ser um problema do administrador da sala; verifique a mensagem de erro completa e se a conta está bloqueada, suspensa ou com alguma restrição imposta pelo servidor.
Após o administrador correto alterar a permissão, peça para Alex tentar novamente a mesma operação na mesma sala. Confirme o resultado esperado — por exemplo, se o convite ou a alteração de configuração foi bem-sucedido — e verifique a visualização de Funções e Permissões da sala para garantir que o nível desejado esteja presente. Se ainda assim falhar, registre a ação exata, o ID da sala, o carimbo de data/hora, o status HTTP e o texto de erro (oculto) para o administrador do servidor principal. Não inclua o token de acesso.
Use a especificação da API Cliente-Servidor do Matrix para o significado dos códigos de erro padrão e regras de nível de potência da sala, as páginas de ajuda e suporte do Element para o fluxo de trabalho de configurações da sala e a documentação da API de administração do Synapse para autenticação de administrador do servidor e operações de recuperação da sala. O texto exato da mensagem e os controles dependem do cliente, do servidor doméstico, da versão da sala e dos níveis de potência personalizados.