透過操作解決矩陣房間管理員權限錯誤
追蹤 M_FORBIDDEN 到房間功率等級、成員資格或 Synapse 伺服器管理員存取權限,然後僅恢復被封鎖操作所需的權限。
當 Element 顯示「失敗」時M_FORBIDDEN: You do not have permission,首先要確定具體是哪個操作失敗了。大多數房間管理失敗是由帳戶的房間權限等級或成員資格引起的;而 Synapse Admin API 失敗則需要 homeserver 伺服器管理員帳戶。請目前房間管理員授予所需的房間權限,或僅當被拒絕的操作確實是伺服器管理員的任務時才使用 Synapse Admin API。
假設: Alex 協助管理 Matrix 聊天室,可以刪除垃圾訊息,但M_FORBIDDEN在更改邀請權限時會遇到問題。 Alex 是該聊天室的版主,而非管理員。此範例僅供參考,並非針對已測試的帳戶或伺服器的任何聲明。
Matrix 將其顯示M_FORBIDDEN為一般的禁止存取錯誤。僅憑程式碼無法判斷問題是出在房間權限層級、房間成員資格、帳戶限製或管理 API 的授權上。請閱讀完整的錯誤訊息,並注意 Alex 當時的操作:編輯房間設定、邀請或禁止某人加入、加入房間,還是開啟 Synapse 管理工具。
房間的權限儲存在其m.room.power_levels狀態事件中。使用者可以透過「預設」、「版主」和「管理員」等元素角色來查看這些權限值,但房間也可以設定自訂等級。 homeserver 伺服器管理員是一個獨立的角色;它不會自動將該使用者設為房間管理員。操作:在更改角色之前,對失敗的操作進行分類,並檢查錯誤是來自元素的房間設定還是/_synapse/admin/端點。
如果 Alex 無法在 Element 中變更設置,請現有會議室管理員檢查會議室的角色和權限。在 Element Web 或桌面版中,開啟會議室,開啟“會議室資訊”或會議室選單,選擇“會議室設定”,然後前往“角色和權限”。在「特權使用者」下檢查 Alex 的條目以及執行特定操作所需的角色。標籤和佈局可能因客戶端版本而異。
對於 Alex 的邀請權限任務,管理員應同時檢查 Alex 本身的權限等級以及更改該權限所需的等級。 Matrix 規範對這兩項進行了獨立定義:invite閾值控制邀請,而更改權限等級事件本身則需要傳送該狀態事件的權限。成員可能被允許邀請其他用戶,但卻沒有更改邀請閾值的權限。目前管理員可以將 Alex 提升到最低的合適級別,或自行進行特定的權限變更。
在 Element 官方文件中記錄的預設設定中,管理員通常為 100 級,版主為 50 級,但房間可以自訂這些要求。請勿假定所有房間都使用這些預設值。此外,請避免降級唯一的管理員:Element 會警告,這樣做可能會導致房間無人管理。操作方法:在儲存角色變更之前,請目前管理員確認還有另一位受信任的管理員在場。
如果團隊中無人可以管理房間,請確定目前房間管理員是否在其他帳戶或裝置上可用。對於託管在 Synapse 上的房間,homeserver 伺服器管理員可以使用 Synapse 的「建立房間管理員」API 為房間內的本機使用者授予最高權限。這是 homeserver 操作員的復原路徑,並非普通的用戶端權限繞過;此介面需要伺服器管理員憑證,且可能不適用於託管在其他位置的房間。請參考最新的 Synapse 介面文檔,並確保其 Admin API 不對外公開。
如果失敗的請求指向的是/_synapse/admin/...Element 中的「管理員」房間,則此請求並不足以解決問題。 Synapse 的許多管理 API 呼叫都需要伺服器管理員的有效存取權杖。請確認令牌屬於目標帳戶,未被撤銷或輸入錯誤,並且使用了文件中規定的授權標頭。請勿將存取權杖貼到公開問題、瀏覽器螢幕截圖或共用日誌中;請像對待密碼一樣對待它們。
Synapse 建議使用反向代理程式隱藏管理 API,並通常從執行 Synapse 的機器發出請求。管理員應使用與已安裝的 Synapse 版本相符的 API。切勿先嘗試直接編輯資料庫來提升使用者權限:Synapse 目前的指南建議操作員在獲得伺服器管理員帳戶後,使用管理員命令和 API。
如果失敗的操作是加入房間或發送事件,請確認 Alex 是否已實際加入房間且未被封鎖。受邀加入房間與實際加入房間並不相同,即使帳號等級很高,成員規則也可能阻止其存取。如果錯誤出現在其他房間或登入過程中,可能並非房間管理員的問題;請檢查完整的錯誤回應,並確認帳號是否被主伺服器鎖定、暫停或受到其他限制。
管理員修改權限後,請 Alex 在同一房間重試相同的操作。確認預期結果(例如,邀請或設定變更是否成功),並檢查房間的「角色與權限」視圖,確保所需的權限等級存在。如果仍然失敗,請記錄特定的操作步驟、房間 ID、時間戳記、HTTP 狀態碼以及已編輯的錯誤文本,以便提供給 homeserver 管理員。請勿包含訪問令牌。
請參考Matrix 用戶端-伺服器 API 規範以了解標準錯誤代碼和房間功率等級規則的含義,參考 Element 的協助和支援頁面以了解房間設定工作流程,並參考Synapse 管理 API 文件以了解伺服器管理員身分驗證和房間復原作業。具體的訊息文字和控制項取決於客戶端、主伺服器、房間版本和自訂功率等級。
追蹤 M_FORBIDDEN 到房間功率等級、成員資格或 Synapse 伺服器管理員存取權限,然後僅恢復被封鎖操作所需的權限。
設定 Synapse 發現、HTTPS 和代理路由,以便其他 Matrix 主伺服器可以找到並聯絡您的伺服器。
配置 Keycloak OIDC 用戶端和 Synapse 提供程序,以便 Element Web 使用者可以透過您的身分伺服器登錄,而無需暴露客戶端金鑰。
儲存恢復金鑰,驗證您的 Element 會話,並檢查加密訊息金鑰是否可以恢復,而不會將備份與您的帳戶密碼混淆。
診斷 Synapse 在同步過程中記憶體不足的故障,安全地調整緩存,識別請求積壓,並驗證穩定的記憶體使用量。
追蹤矩陣聯合憑證故障到正確的伺服器,修復 TLS 鍊或 CA 信任,並在不停用安全檢查的情況下驗證修復。
Route Matrix 用戶端和透過 Cloudflare 在 HTTPS 443 上進行聯合,可以保留 Synapse 探索功能,避免快取 API 流量或中斷媒體上傳。
使用 pg_dump 備份 Synapse,保護其簽章金鑰和介質,並將其還原到乾淨的 PostgreSQL 資料庫中,而無需重複使用過時的一次性金鑰。
使用專用 Matrix 帳戶、加密管理室、Docker Compose、政策清單和權限檢查來設定 Mjölnir。
跳過已停用的代理,配置 Synapse 內建的滑動同步功能。檢查客戶端發現情況,然後在相容的手機上測量房間清單載入和重新連接行為。