關閉 Synapse 上的 Matrix 註冊或要求使用邀請令牌
停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。
若要封鎖在執行 Synapse 的自架 Matrix 伺服器上公開註冊,請進行對應設定enable_registration: false並homeserver.yaml重新啟動 Synapse。如果您希望受邀用戶自行建立帳戶,請保持註冊功能啟用,但改為要求使用註冊令牌。另請注意以下registration_shared_secret設定:即使停用了普通註冊,任何知道該設定的人(包括伺服器管理員)仍然可以建立帳戶。
正確的設定取決於如何建立新帳戶:
register_new_matrix_user指令或其他已核准的管理流程建立使用者。本文介紹 Synapse,它是目前部署最廣泛的自架 Matrix 主伺服器實作。其他主伺服器軟體有各自的設定方式。 Synapse 目前的設定文件指出,註冊功能預設為停用狀態,註冊令牌僅在啟用註冊功能後才能生效。如果您使用 Matrix 驗證服務 (MAS),請查閱其文件以了解相應的註冊控制;啟用 MAS 整合後,Synapse 的註冊令牌管理 API 將會停用。
/etc/matrix-synapse/homeserver.yaml;容器安裝通常會將檔案掛載到 `/etc/config.json` 目錄下/data/homeserver.yaml。請使用為您的服務配置的路徑,而不是假定某個位置。enable_registration: false
如果鍵已存在,請編輯現有條目,而不是新增重複項。 YAML 縮排和重複鍵可能會造成混淆,因此請將設定保留在頂層,並保持檔案現有結構。registration_shared_secret或registration_shared_secret_path)支援管理員註冊腳本。 Synapse 安裝指南警告說,即使公開註冊已關閉,擁有此金鑰的人仍然可以建立標準帳戶或管理員帳戶。請將其設為私有,限制對其文件的訪問,並且不要將其放在公共存儲庫、客戶端配置或發送給受邀者的消息中。如果您不使用共用金鑰註冊,請僅在確認沒有任何自動化流程依賴此設定後才將其移除。您可以改用其他支援的管理員工作流程來建立帳戶。matrix-synapse,管理員可以執行以下命令:
sudo systemctl restart matrix-synapse
sudo systemctl status matrix-synapse --no-pager
服務的具體名稱在不同的軟體包和容器部署中可能有所不同。如果服務啟動失敗,請檢查日誌;不要在未解決已報告的 YAML 或設定錯誤的情況下重複編輯設定檔。停用註冊功能不會移除現有帳戶和房間存取權限。此設定會阻止透過用戶端註冊流程進行的新使用者註冊;它並非使用者刪除或伺服器停用控制措施。
如果您希望受邀者自行完成註冊,但不希望顯示公開的註冊頁面,請使用此選項。在設定中homeserver.yaml,配置以下兩項設定:
enable_registration: true
registration_requires_token: true
儲存後請重新啟動 Synapse。啟用令牌門禁並不等於停用註冊:持有有效令牌的使用者仍然可以建立帳戶。 Synapse 設定手冊建議在啟用註冊時啟用反濫用控制措施;請根據您的使用者群體和營運能力選擇適當的策略。
對於支援文件中已記錄的註冊令牌管理 API 的 Synapse 版本,管理員可以建立一次性令牌。以下範例使用佔位符 URL 和存取權杖;請僅在受信任的管理環境中執行此範例,並替換為您的主伺服器的公用基本 URL 和管理員存取權杖,同時保護 shell 歷史記錄和日誌:
curl -X POST "https://matrix.example.com/_synapse/admin/v1/registration_tokens/new" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"uses_allowed":1}'
回應中包含產生的令牌。請私下與目標使用者分享該值。 Synapse 的 API 也支援過期時間,以自 Unix 紀元以來的毫秒數計算;請使用官方 API 參考文件計算並正確設定部署的過期時間。未設定使用次數限製或過期時間的令牌預設為無限次使用且無過期時間,因此請務必設定限制。管理員可以透過相同 API 列出、更新或刪除令牌。請勿將實際的持有者令牌或註冊令牌貼到公開的問題或文章中。
令牌管理存在版本和部署限制:請參閱與您已安裝的 Synapse 版本相符的 Admin API 文件。目前文件指出,啟用 MAS 整合後,此 Synapse API 不可用;在這種情況下,請使用 MAS Admin API 或 CLI。
registration_requires_token不會獨立啟用註冊。兩個標誌必須同時啟用才能實現預期流程。Synapse 重新啟動後,使用已登出的工作階段在 Matrix 用戶端中開啟您的主伺服器註冊流程。對於封閉伺服器,用戶端不應提供公開註冊,但現有用戶仍應能夠登入。對於需要令牌的註冊,請先嘗試不使用令牌的註冊流程,並確認其會請求令牌;然後使用受控測試帳戶中的測試令牌,並確認註冊成功。如果結果與預期策略不符,請檢查 Synapse 日誌和管理員 API 令牌狀態。如果使用真正的邀請令牌進行測試會消耗其唯一允許的使用次數,請避免使用。
停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。
Clear Element 會使用受信任的裝置或復原金鑰發出未驗證會話警告,並進行檢查以保護您的加密聊天記錄。
區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。
透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。
設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。
找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。
在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。
透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。
檢查問題是否為 OC10 和 7.x 的相容性問題,或 CSync 日誌損壞,然後套用正確的修復方法,不要刪除已同步的檔案。
選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。