關閉 Synapse 上的 Matrix 註冊或要求使用邀請令牌

若要封鎖在執行 Synapse 的自架 Matrix 伺服器上公開註冊,請進行對應設定enable_registration: false並homeserver.yaml重新啟動 Synapse。如果您希望受邀用戶自行建立帳戶,請保持註冊功能啟用,但改為要求使用註冊令牌。另請注意以下registration_shared_secret設定:即使停用了普通註冊,任何知道該設定的人(包括伺服器管理員)仍然可以建立帳戶。

選擇適當的註冊政策

正確的設定取決於如何建立新帳戶:

  • 私有伺服器,由管理員建立的帳戶:停用公用註冊。使用 Synapseregister_new_matrix_user指令或其他已核准的管理流程建立使用者。
  • 僅限受邀用戶存取的伺服器,用戶可透過 Element 或其他用戶端註冊:啟用註冊功能並要求提供令牌。透過私有管道向每位使用者發放限時使用的令牌。
  • 公共伺服器:註冊令牌、驗證碼或已驗證的電子郵件/電話號碼可以減少自動濫用,但它們並不能保證每個帳戶都是可信任的。

本文介紹 Synapse,它是目前部署最廣泛的自架 Matrix 主伺服器實作。其他主伺服器軟體有各自的設定方式。 Synapse 目前的設定文件指出,註冊功能預設為停用狀態,註冊令牌僅在啟用註冊功能後才能生效。如果您使用 Matrix 驗證服務 (MAS),請查閱其文件以了解相應的註冊控制;啟用 MAS 整合後,Synapse 的註冊令牌管理 API 將會停用。

停用 Synapse 上的公開註冊

  1. 找到目前使用的設定檔。常見的軟體包安裝使用 `/etc/config.json` /etc/matrix-synapse/homeserver.yaml;容器安裝通常會將檔案掛載到 `/etc/config.json` 目錄下/data/homeserver.yaml。請使用為您的服務配置的路徑,而不是假定某個位置。
  2. 備份文件,然後設定註冊標誌。在頂層 YAML 設定檔中,新增或變更以下設定:
    enable_registration: false
    如果鍵已存在,請編輯現有條目,而不是新增重複項。 YAML 縮排和重複鍵可能會造成混淆,因此請將設定保留在頂層,並保持檔案現有結構。
  3. 檢查共享註冊密鑰。 Synapse(registration_shared_secret或registration_shared_secret_path)支援管理員註冊腳本。 Synapse 安裝指南警告說,即使公開註冊已關閉,擁有此金鑰的人仍然可以建立標準帳戶或管理員帳戶。請將其設為私有,限制對其文件的訪問,並且不要將其放在公共存儲庫、客戶端配置或發送給受邀者的消息中。如果您不使用共用金鑰註冊,請僅在確認沒有任何自動化流程依賴此設定後才將其移除。您可以改用其他支援的管理員工作流程來建立帳戶。
  4. 驗證並重新啟動 Synapse。使用執行伺服器的服務管理員、容器編排或部署方法。對於通常名為 `synapse` 的 systemd 服務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。

常見配置錯誤

  • 修改了錯誤的文件:容器可能讀取了已掛載的文件,而主機上卻有單獨的副本。請確認正在運行的 Synapse 進程所使用的路徑。
  • 忘記重啟:配置更改由服務讀取,因此僅憑成功的文本編輯並不能證明新策略已生效。
  • 假設停用註冊會阻止所有路由:已設定的共用金鑰仍然是建立帳戶的途徑。根據管理自動化是否需要,對其進行保護或刪除。
  • 啟用令牌但停用註冊: registration_requires_token不會獨立啟用註冊。兩個標誌必須同時啟用才能實現預期流程。
  • 假設僅限受邀用戶使用的代幣可以完全防止濫用:洩漏的可重複使用代幣仍可能被非授權用戶使用。因此,應限制使用次數,在可行的情況下設定有效期,並以私密方式分發代幣。

驗證結果

Synapse 重新啟動後,使用已登出的工作階段在 Matrix 用戶端中開啟您的主伺服器註冊流程。對於封閉伺服器,用戶端不應提供公開註冊,但現有用戶仍應能夠登入。對於需要令牌的註冊,請先嘗試不使用令牌的註冊流程,並確認其會請求令牌;然後使用受控測試帳戶中的測試令牌,並確認註冊成功。如果結果與預期策略不符,請檢查 Synapse 日誌和管理員 API 令牌狀態。如果使用真正的邀請令牌進行測試會消耗其唯一允許的使用次數,請避免使用。

官方參考資料

留下評論

關閉 Synapse 上的 Matrix 註冊或要求使用邀請令牌

停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。

元素會話身份警告:請安全驗證您的登入訊息

Clear Element 會使用受信任的裝置或復原金鑰發出未驗證會話警告,並進行檢查以保護您的加密聊天記錄。

使用正確的後端解決 ownCloud 檔案鎖定逾時問題

區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。

在正確的運行時清除 ownCloud PHP 記憶體警告

設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。

排查 ownCloud 10 MySQL 連線故障

找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。

為 ownCloud 公共連結設定嚴格的過期時間

為 ownCloud 公共連結設定嚴格的過期時間

在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。

透過將客戶端與伺服器匹配來恢復 ownCloud 同步

檢查問題是否為 OC10 和 7.x 的相容性問題,或 CSync 日誌損壞,然後套用正確的修復方法,不要刪除已同步的檔案。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。