Cuando Element muestre un error M_FORBIDDEN: You do not have permission, primero identifique la acción exacta que falló. La mayoría de los fallos de administración de salas se deben al nivel de privilegios o la pertenencia a la sala de la cuenta; un fallo de la API de Synapse Admin requiere una cuenta de administrador del servidor principal. Solicite a un administrador de sala actual que otorgue únicamente el permiso necesario para la sala, o utilice la API de Synapse Admin solo cuando la operación denegada sea realmente una tarea de administrador del servidor.
Ejemplo hipotético: Alex modera una sala de Matrix y puede eliminar el spam, pero tiene problemas M_FORBIDDENal cambiar quién puede invitar a personas. Alex es moderador en esa sala, no administrador. Este ejemplo es ilustrativo; no constituye una afirmación sobre una cuenta o servidor probado.
Identifique qué sistema de permisos denegó la solicitud.
Matrix utiliza este M_FORBIDDENerror como un error general de acceso prohibido. El código por sí solo no indica si el problema se debe a los niveles de privilegios de la sala, la pertenencia a la misma, una restricción de cuenta o la autorización para una API administrativa. Lea el error completo y observe qué estaba haciendo Alex: editar la configuración de una sala, invitar o expulsar a alguien, unirse a una sala o abrir una herramienta de administración de Synapse.
Los permisos de una sala se almacenan en su m.room.power_levelsevento de estado. Los roles de Elemento, como Predeterminado, Moderador y Administrador, permiten al usuario inspeccionar estos valores, pero la sala puede establecer niveles personalizados. El rol de administrador del servidor homeserver es independiente; no convierte automáticamente a ese usuario en administrador de la sala. Acción: clasifique la acción fallida antes de cambiar los roles y verifique si el error proviene de la configuración de la sala de Elemento o de un /_synapse/admin/punto final.
Arregla una acción de la habitación con los niveles de poder de la habitación.
Si Alex no puede cambiar una configuración en Element, pídale a un administrador de sala que revise los roles y permisos de la sala. En Element Web o Desktop, abra la sala, acceda a Información de la sala o al menú de la sala, seleccione Configuración de la sala y vaya a Roles y permisos. Verifique la entrada de Alex en Usuarios con privilegios y el rol requerido para la acción específica. Las etiquetas y el diseño pueden variar según la versión del cliente.
Para la tarea de permisos de invitación de Alex, el administrador debe verificar tanto el nivel de poder de Alex como el nivel requerido para modificar dicho permiso. La especificación Matrix define estos aspectos de forma independiente: el inviteumbral controla las invitaciones, mientras que el cambio del nivel de poder requiere autorización para enviar ese evento de estado. Un miembro podría tener permiso para invitar usuarios, pero carecer de permiso para modificar el umbral de invitación. El administrador actual puede ascender a Alex al nivel más bajo apropiado o realizar él mismo el cambio de permiso específico.
En la configuración predeterminada documentada de Element, el administrador suele tener nivel 100 y el moderador nivel 50, pero las salas pueden personalizar los requisitos. No asuma que todas las salas usan esa configuración predeterminada. Además, evite degradar al único administrador: Element advierte que hacerlo puede dejar la sala sin nadie que pueda gestionarla. Acción: solicite al administrador actual que confirme que existe otro administrador de confianza antes de guardar el cambio de rol.
Si ningún miembro del equipo puede administrar la sala, determine si hay un administrador disponible en otra cuenta o dispositivo. Para las salas alojadas en Synapse, el administrador del servidor puede usar la API Make Room Admin de Synapse para otorgar los permisos más altos a un usuario local que se encuentre en la sala. Esta es una vía de recuperación para el operador del servidor, no una simple omisión de permisos del lado del cliente; el punto final requiere credenciales de administrador del servidor y puede no aplicarse a salas alojadas en otros servidores. Consulte la documentación actual del punto final de Synapse y mantenga su API de administración privada, evitando el acceso público.
Si el error provino de la API de administración de Synapse
Si la solicitud fallida apunta a /_synapse/admin/...la sala Admin en Element, no es suficiente. Synapse requiere un token de acceso válido perteneciente a un administrador del servidor para muchas llamadas a la API de administración. Confirme que el token pertenece a la cuenta prevista, que no ha sido revocado ni escrito incorrectamente, y que se envía utilizando el encabezado de autorización documentado. No pegue tokens de acceso en un problema público, una captura de pantalla del navegador o un registro compartido; trátelos como contraseñas.
Synapse recomienda ocultar la API de administración al público mediante un proxy inverso y realizar las solicitudes desde la máquina donde se ejecuta Synapse. Un administrador debe usar la API correspondiente a la versión de Synapse instalada. Como primera medida, evite editar la base de datos directamente para elevar los privilegios de un usuario: la guía actual de Synapse orienta a los operadores hacia los comandos y las API de administración una vez que tengan una cuenta de administrador de servidor.
Verifique la membresía, el estado de la cuenta y el resultado.
Si la acción fallida fue unirse o enviar un evento, confirme que Alex está realmente unido a la sala y no está bloqueado. Ser invitado no es lo mismo que unirse, y las reglas de membresía pueden bloquear el acceso incluso cuando la cuenta tiene un alto nivel de poder. Si el error aparece en salas no relacionadas o durante el inicio de sesión, puede que no sea un problema del administrador de la sala; revise la respuesta de error completa y si la cuenta está bloqueada, suspendida o restringida de alguna otra manera por el servidor principal.
Después de que el administrador correcto cambie el permiso, pídale a Alex que vuelva a intentar la misma operación en la misma sala. Confirme el resultado esperado (por ejemplo, que la invitación o el cambio de configuración se realicen correctamente) y revise la vista de Roles y Permisos de la sala para asegurarse de que el nivel deseado esté presente. Si aún así falla, registre la acción exacta, el ID de la sala, la marca de tiempo, el estado HTTP y el texto de error (oculto) para el administrador del servidor principal. No incluya un token de acceso.
Para conocer el significado de los códigos de error estándar y las reglas de nivel de potencia de la sala, consulte la especificación de la API cliente-servidor de Matrix; para el flujo de trabajo de configuración de la sala, las páginas de ayuda y soporte de Element ; y para la autenticación del administrador del servidor y las operaciones de recuperación de la sala, utilice la documentación de la API de administración de Synapse . El texto exacto del mensaje y los controles dependen del cliente, el servidor principal, la versión de la sala y los niveles de potencia personalizados.