Rozwiąż błędy uprawnień administratora pokoju Matrix za pomocą działania
Prześledź M_FORBIDDEN do poziomów mocy pokoju, członkostwa lub dostępu administratora serwera Synapse, a następnie przywróć tylko uprawnienia potrzebne do zablokowanej akcji.
Gdy Element wyświetla M_FORBIDDEN: You do not have permission, najpierw zidentyfikuj dokładną akcję, która się nie powiodła. Większość błędów zarządzania pokojami jest spowodowana poziomem mocy pokoju lub członkostwem konta; awaria interfejsu API administratora Synapse wymaga konta administratora serwera domowego. Poproś obecnego administratora pokoju o przyznanie tylko niezbędnych uprawnień do pokoju lub skorzystaj z interfejsu API administratora Synapse tylko wtedy, gdy odrzucona operacja jest rzeczywiście zadaniem administratora serwera.
Hipotetyczny przykład: Alex pomaga moderować pokój w Matrixie i może usuwać spam, ale traci M_FORBIDDENmożliwość zmiany osób, które mogą zapraszać użytkowników. Alex jest moderatorem w tym pokoju, a nie jego administratorem. Przykład ma charakter ilustracyjny; nie dotyczy on testowanego konta ani serwera.
Matrix używa M_FORBIDDENogólnego błędu zabronionego dostępu. Sam kod nie wyjaśnia, czy problem dotyczy poziomów mocy pokoju, członkostwa w pokoju, ograniczeń konta, czy autoryzacji dla administracyjnego interfejsu API. Przeczytaj cały błąd i zanotuj, co Alex robił: edytował ustawienia pokoju, zapraszał lub banował kogoś, dołączał do pokoju lub otwierał narzędzie administracyjne Synapse.
Uprawnienia pokoju są przechowywane w jego m.room.power_levelszdarzeniu stanu. Role elementu, takie jak Domyślny, Moderator i Administrator, umożliwiają użytkownikom weryfikację tych wartości, ale pokój może ustawić poziomy niestandardowe. Rola administratora serwera domowego to osobna rola; nie czyni ona automatycznie tego użytkownika administratorem pokoju. Działanie: przed zmianą roli należy sklasyfikować nieudaną akcję i sprawdzić, czy błąd pochodzi z ustawień pokoju elementu, czy z /_synapse/admin/punktu końcowego.
Jeśli Alex nie może zmienić ustawienia w Element, poproś administratora istniejącego pokoju o sprawdzenie ról i uprawnień pokoju. W Element Web lub Desktop otwórz pokój, otwórz Informacje o pokoju lub menu pokoju, wybierz Ustawienia pokoju i przejdź do sekcji Role i uprawnienia. Sprawdź wpis Alexa w sekcji Użytkownicy uprzywilejowani oraz wymaganą rolę dla danej akcji. Etykiety i układ mogą się różnić w zależności od wersji klienta.
W przypadku zadania „Zaproś-uprawnienia” Alexa, administrator powinien sprawdzić zarówno jego własny poziom uprawnień, jak i poziom wymagany do zmiany tego uprawnienia. Specyfikacja Matrix definiuje je niezależnie: invitepróg kontroluje zaproszenia, podczas gdy zmiana samego zdarzenia poziomu uprawnień wymaga autoryzacji do wysłania tego zdarzenia stanu. Członek może mieć uprawnienia do zapraszania użytkowników, ale nie mieć uprawnień do zmiany progu zaproszeń. Aktualny administrator może awansować Alexa na najniższy odpowiedni poziom lub samodzielnie dokonać konkretnej zmiany uprawnień.
W udokumentowanej domyślnej konfiguracji Elementu, administrator ma zazwyczaj poziom 100, a moderator 50, ale pokoje można dostosować do własnych potrzeb. Nie zakładaj, że każdy pokój korzysta z tych domyślnych ustawień. Unikaj również degradowania jedynego administratora: Element ostrzega, że może to spowodować opuszczenie pokoju bez możliwości zarządzania nim przez kogokolwiek. Działanie: przed zapisaniem zmiany roli poproś obecnego administratora o potwierdzenie, że inny zaufany administrator nadal nią jest.
Jeśli nikt w zespole nie może administrować pokojem, sprawdź, czy obecny administrator pokoju jest dostępny na innym koncie lub urządzeniu. W przypadku pokoi hostowanych w Synapse, administrator serwera domowego może użyć interfejsu API „Make Room Admin” Synapse, aby przyznać najwyższe uprawnienia użytkownikowi lokalnemu znajdującemu się w pokoju. Jest to ścieżka odzyskiwania dla operatora serwera domowego, a nie zwykłe obejście uprawnień po stronie klienta; punkt końcowy wymaga poświadczeń administratora serwera i może nie mieć zastosowania do pokoi hostowanych gdzie indziej. Skorzystaj z aktualnej dokumentacji punktu końcowego Synapse i ukryj jego interfejs API administratora przed dostępem publicznym.
Jeśli nieudane żądanie dotyczy celu /_synapse/admin/..., administrator pokoju w elemencie nie wystarczy. Synapse wymaga prawidłowego tokena dostępu należącego do administratora serwera do wielu wywołań API administratora. Upewnij się, że token należy do właściwego konta, nie został unieważniony ani błędnie wpisany i jest wysyłany za pomocą udokumentowanego nagłówka autoryzacji. Nie wklejaj tokenów dostępu do publicznego zgłoszenia, zrzutu ekranu przeglądarki ani udostępnionego dziennika; traktuj je jak hasła.
Firma Synapse zaleca ukrycie interfejsu API administratora przed dostępem publicznym za pomocą odwrotnego proxy i wysyłanie żądań z komputera, na którym działa Synapse. Administrator powinien używać interfejsu API odpowiadającego zainstalowanej wersji Synapse. Należy unikać bezpośredniej edycji bazy danych w celu nadania użytkownikowi statusu pierwszej odpowiedzi: aktualne wytyczne Synapse wskazują operatorom polecenia administracyjne i interfejsy API po utworzeniu konta administratora serwera.
Jeśli nieudaną akcją było dołączenie lub wysłanie wydarzenia, upewnij się, że Alex faktycznie dołączył do pokoju i nie został zbanowany. Zaproszenie nie jest tym samym, co dołączenie, a zasady członkostwa mogą blokować dostęp nawet wtedy, gdy konto ma wysoki poziom uprawnień. Jeśli błąd pojawia się w niezwiązanych ze sobą pokojach lub podczas logowania, może nie być problemem administratora pokoju; sprawdź pełną odpowiedź błędu i czy konto nie jest zablokowane, zawieszone lub w inny sposób ograniczone przez serwer domowy.
Po zmianie uprawnień przez właściwego administratora, poproś Alexa o ponowienie tej samej operacji w tym samym pokoju. Potwierdź oczekiwany rezultat – na przykład, czy zaproszenie lub zmiana ustawień zakończyła się powodzeniem – i sprawdź widok „Role i uprawnienia” pokoju, aby upewnić się, że żądany poziom jest obecny. Jeśli nadal nie uda się, przechwyć dokładną akcję, identyfikator pokoju, znacznik czasu, status HTTP i zredagowany tekst błędu dla administratora serwera domowego. Nie dołączaj tokena dostępu.
Skorzystaj ze specyfikacji API Matrix Client-Server , aby poznać znaczenie standardowych kodów błędów i reguł poziomów mocy w pomieszczeniu, ze stron pomocy i wsparcia Element dotyczących przepływu pracy ustawień pomieszczenia oraz z dokumentacji API Synapse Admin dotyczącej uwierzytelniania serwera i administratora oraz operacji odzyskiwania pomieszczenia. Dokładny tekst komunikatu i ustawienia zależą od klienta, serwera domowego, wersji pomieszczenia i niestandardowych poziomów mocy.
Prześledź M_FORBIDDEN do poziomów mocy pokoju, członkostwa lub dostępu administratora serwera Synapse, a następnie przywróć tylko uprawnienia potrzebne do zablokowanej akcji.
Skonfiguruj wykrywanie Synapse, protokół HTTPS i routing proxy, aby inne serwery domowe Matrix mogły znaleźć Twój serwer i nawiązać z nim kontakt.
Skonfiguruj klienta Keycloak OIDC i dostawcę Synapse, aby użytkownicy Element Web mogli logować się za pośrednictwem serwera tożsamości bez ujawniania tajnych danych klienta.
Zapisz klucz odzyskiwania, zweryfikuj sesje Element i sprawdź, czy zaszyfrowane klucze wiadomości można odzyskać, nie myląc kopii zapasowej z hasłem do konta.
Diagnozuj błędy braku pamięci w Synapse podczas synchronizacji, bezpiecznie dostosowuj buforowanie, identyfikuj zaległości w żądaniach i weryfikuj stabilne wykorzystanie pamięci.
Śledź błędy certyfikatu federacji Matrix na właściwym serwerze, napraw łańcuch TLS lub zaufanie urzędu certyfikacji i zweryfikuj poprawkę bez wyłączania kontroli bezpieczeństwa.
Klienci i federacja Matrix korzystają z usługi Cloudflare na protokole HTTPS 443, zachowując wykrywanie Synapse i unikając buforowania ruchu API lub przerywania przesyłania multimediów.
Utwórz kopię zapasową Synapse za pomocą pg_dump, chroń jej klucz podpisu i nośnik, a następnie przywróć do czystej bazy danych PostgreSQL bez ponownego używania nieaktualnych kluczy jednorazowych.
Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.
Pomiń wycofany serwer proxy i skonfiguruj wbudowaną funkcję Sliding Sync w Synapse. Sprawdź wykrywanie klientów, a następnie zmierz ładowanie listy pokoi i zachowanie ponownego łączenia na kompatybilnym telefonie.