Când se afișează Element M_FORBIDDEN: You do not have permission, identificați mai întâi acțiunea exactă care a eșuat. Majoritatea erorilor de gestionare a camerelor sunt cauzate de nivelul de putere al camerei sau de apartenența la cont; o eroare a API-ului Synapse Admin necesită în schimb un cont de administrator de server pentru serverul principal. Solicitați unui administrator de cameră actual să acorde doar permisiunea necesară pentru cameră sau utilizați API-ul Synapse Admin numai atunci când operațiunea refuzată este într-adevăr o sarcină de administrare a serverului.
Exemplu ipotetic: Alex ajută la moderarea unei camere Matrix și poate elimina spamul, dar intervine M_FORBIDDENatunci când se schimbă cine poate invita persoane. Alex este moderator în camera respectivă, nu administrator de cameră. Exemplul este ilustrativ; nu este o afirmație despre un cont sau un server testat.
Identificați sistemul de permisiuni care a respins cererea
Matrix folosește eroarea M_FORBIDDENca o eroare generală de acces interzis. Codul în sine nu spune dacă problema este reprezentată de nivelurile de putere ale camerei, apartenența la cameră, o restricție a contului sau autorizarea pentru un API administrativ. Citiți eroarea completă și observați ce făcea Alex: editarea unei setări a camerei, invitarea sau interzicerea accesului cuiva, alăturarea unei camere sau deschiderea unui instrument de administrare Synapse.
Permisiunile unei camere sunt stocate în m.room.power_levelsevenimentul său de stare. Rolurile Element, cum ar fi Implicit, Moderator și Administrator, reprezintă o modalitate orientată către utilizator de a inspecta aceste valori, dar camera poate seta niveluri personalizate. Un administrator de server de acasă este un rol separat; nu face automat utilizatorul respectiv administrator de cameră. Acțiune: clasificați acțiunea eșuată înainte de a schimba rolurile și verificați dacă eroarea a provenit din setările camerei Element sau de la un /_synapse/admin/endpoint.
Corectează o acțiune a camerei cu nivelurile de putere ale acesteia
Dacă Alex nu poate modifica o setare în Element, rugați un administrator de cameră existent să verifice rolurile și permisiunile camerei. În Element Web sau Desktop, deschideți camera, deschideți Informații cameră sau meniul camerei, alegeți Setări cameră și accesați Roluri și permisiuni. Verificați intrarea lui Alex la utilizatori privilegiați și rolul necesar pentru acțiunea specifică. Etichetele și aspectul pot varia în funcție de versiunea clientului.
Pentru sarcina de permisiuni de invitație a lui Alex, administratorul ar trebui să verifice atât nivelul de putere al lui Alex, cât și nivelul necesar pentru a modifica acea permisiune. Specificația Matrix definește acestea independent: invitepragul controlează invitațiile, în timp ce modificarea evenimentului de nivel de putere în sine necesită autoritatea de a trimite acel eveniment de stare. Un membru ar putea avea permisiunea de a invita utilizatori, dar nu are permisiunea de a modifica pragul de invitație. Administratorul actual îl poate promova pe Alex la cel mai scăzut nivel corespunzător sau poate face singur modificarea permisiunii specifice.
În configurația implicită documentată a Element, Administratorul este de obicei nivelul 100 și Moderatorul 50, dar cerințele pot fi personalizate în camere. Nu presupuneți că fiecare cameră folosește aceste setări implicite. De asemenea, evitați retrogradarea singurului administrator: Element avertizează că, dacă faceți acest lucru, puteți părăsi camera fără ca nimeni să o poată gestiona. Acțiune: rugați administratorul actual să confirme că există un alt administrator de încredere înainte de a salva o modificare de rol.
Dacă nimeni din echipă nu poate administra camera, verificați dacă un administrator de cameră este disponibil pe un alt cont sau dispozitiv. Pentru camerele găzduite pe Synapse, un administrator de server de acasă poate utiliza API-ul Make Room Admin de la Synapse pentru a acorda cea mai mare putere disponibilă unui utilizator local care se află în cameră. Aceasta este o cale de recuperare pentru operatorul serverului de acasă, nu o ocolire obișnuită a permisiunilor din partea clientului; endpoint-ul necesită o acreditare de administrator de server și este posibil să nu se aplice camerelor găzduite în altă parte. Utilizați documentația actuală a endpoint-ului Synapse și păstrați API-ul său de administrare privat, împiedicând accesul public.
Dacă eroarea a provenit de la API-ul Synapse Admin
Dacă solicitarea eșuată vizează /_synapse/admin/..., valoarea Adminului camerei din Element nu este suficientă. Synapse necesită un token de acces valid aparținând unui administrator de server pentru mai multe apeluri API Admin. Confirmați că tokenul aparține contului dorit, nu a fost revocat sau introdus greșit și este trimis folosind antetul de autorizare documentat. Nu lipiți tokenuri de acces într-o problemă publică, o captură de ecran a browserului sau un jurnal partajat; tratați-le ca parole.
Synapse recomandă ascunderea API-ului de administrare de la vederea publică cu un proxy invers și, de obicei, efectuarea de solicitări de la mașina pe care rulează Synapse. Un administrator ar trebui să utilizeze API-ul corespunzător versiunii Synapse instalate. Evitați editarea directă a bazei de date pentru a ridica un utilizator ca primă intervenție: Ghidul actual al Synapse îi îndrumă pe operatori către comenzi și API-uri de administrare odată ce au un cont de administrator de server.
Verificați calitatea de membru, starea contului și rezultatul
Dacă acțiunea eșuată a fost intrarea în cameră sau trimiterea unui eveniment, confirmă că Alex este într-adevăr alăturat camerei și nu este interzis. A fi invitat nu este același lucru cu a fi alăturat, iar regulile de apartenență pot bloca accesul chiar și atunci când contul are un nivel ridicat de putere. Dacă eroarea apare în camere fără legătură sau în timpul autentificării, este posibil să nu fie o problemă de administrator al camerei; verifică răspunsul complet la eroare și dacă contul este blocat, suspendat sau restricționat în alt mod de serverul principal.
După ce administratorul potrivit modifică permisiunea, rugați-l pe Alex să reîncerce aceeași operațiune în aceeași cameră. Confirmați rezultatul așteptat - de exemplu, că invitația sau modificarea setărilor are succes - și verificați vizualizarea Roluri și permisiuni a camerei pentru a vă asigura că nivelul dorit este prezent. Dacă eșuează în continuare, capturați acțiunea exactă, ID-ul camerei, marcajul temporal, starea HTTP și textul de eroare redactat pentru administratorul serverului principal. Nu includeți un token de acces.
Folosește specificația API-ului Matrix Client-Server pentru a înțelege semnificația codurilor de eroare standard și a regulilor privind nivelul de alimentare al camerei, paginile de ajutor și asistență Element pentru fluxul de lucru al setărilor camerei și documentația API-ului Synapse Admin pentru autentificarea administratorului serverului și operațiunile de recuperare a camerei. Textul exact al mesajului și controalele depind de client, serverul de acasă, versiunea camerei și nivelurile de alimentare personalizate.