Logto 產品更新

Logto v1.45.0 引入了 Self-Hosted Pro 授權，解鎖自託管實例的進階功能，包括 Console 團隊協作、自訂登入介面、移除品牌標記以及更高的 SAML 限制，同時還有重大 API 資源查詢優化。以下是本次的更新內容。

Self-hosted Pro 與授權#

自託管的 Logto 部署現在可以安裝並啟用訂閱授權（如 Self-Hosted Pro），完全運行於自身基礎設施內同時啟用進階功能。

• 授權安裝與管理：可在 Console 的 租戶設定 > 授權 直接安裝或更換授權，或透過管理 API 自動化（PUT /api/systems/license 與 GET /api/systems/license）。已安裝的密鑰會使用 ES256 簽章針對 Logto 內建公鑰離線驗證。
• 授權狀態與寬限期：可檢視目前方案、執行環境（生產或非生產）、到期日與每週自動刷新狀態。若授權過期或無法刷新，系統會給予 30 天寬限期，期間功能維持啟用並於 Console 中全域顯示警告，最後才會回落到開源版預設。
• 從雲端 Console 取得密鑰：具備有效自託管方案的用戶，可直接從 Logto Cloud Console 帳號選單中檢視和複製生產與非生產密鑰，無需額外建立雲端租戶。
• 解鎖權益：
  • Console 團隊協作：邀請其他系統管理員共同管理自託管部署。邀請會經由預設租戶的郵件連接器，以安全的一次性帳號設置連結發送。
  • 自訂介面＆ CSP：可上傳自訂登入介面包到你自己的儲存空間，並自訂內容安全政策（CSP）標頭。
  • 移除 Logto 品牌標記：可隱藏登入體驗中的「Powered by Logto」字樣。
  • 擴充 SAML 應用程式數量：將 SAML 應用程式限制提升至超越開源預設值。
  • 強制 Console 多因子驗證：強制所有管理員在存取 Console 時啟用多因子驗證（MFA）。 更多安裝細節請參考自託管授權指南。

更快的 API 資源查詢#

• 線性時間範圍（scope）比對：在 GET /api/resources?includeScopes=true 中，比對範圍與 API 資源時現在使用 Map.groupBy 及 PostgreSQL 陣列繫結（= ANY(...)）在資料量增加時也維持線性增長。這完全消除了平方級低速問題，也修正了管理超過 65,535 個資源的租戶會失敗的狀況。
• 排除管理 API 資源：GET /api/resources 現支援 excludeManagementApis 查詢參數，用以在資料庫層級排除內部 Logto 管理 API 資源。第三方應用程序、動態應用、組織角色和用戶角色的 Console 權限選擇，將利用此過濾條件而不是加載全部資源進入瀏覽器，有效避免資源數量龐大時的 UI 超時問題。

其他改進與修復#

• 自訂 UI 上傳驗證：現在自訂 UI 封包壓縮檔上傳前會檢查資產根目錄有無 index.html，同時針對不支援的 ZIP 壓縮格式或檔案過大提供更明確錯誤訊息。
• MFA 設定時保持 Console 工作階段：點擊 MFA 設定提示時，現在會在新分頁開啟帳號中心安全頁，讓你的 Console 工作階段和導航狀態保持不變。
• 開源租戶設定（OSS tenant settings）：增加了可黏著的「儲存變更」操作列，並偵測未儲存變更及提供放棄按鈕。
• 邀請快取即時同步：從成員分頁邀請新成員後會立即重新驗證邀請快取，讓待處理邀請能夠即時顯示，無需手動刷新頁面。
• Next.js App Router 指南：更新 Next.js App Router 快速入門中的 app/page.tsx 範例，聲明 Home 為 async 組件，以解決 TypeScript TS1308 錯誤。（感謝 @timokoethe）
• 安全性升級：tinypool 升級至 v2，修正依賴相依風險。

貢獻者#

感謝本次版本有貢獻的社群成員：

• @timokoethe：Next.js App Router 指南 async 修正 (#9692)（首次貢獻）

開始體驗#

準備升級了嗎？請參考我們的升級指南，獲得逐步操作說明。 完整的改動清單，請見 GitHub 發佈頁。 有任何疑問或回饋？歡迎加入 Discord 或在 GitHub 上提出議題。