Logto 产品更新

Logto v1.45.0 引入了自托管 Pro 许可证，解锁自托管实例上的高级功能，包括 Console 团队协作、自定义登录界面、移除品牌标识、更高的 SAML 限额，以及重大的 API 资源查询优化。下面是本次更新的内容。

自托管 Pro 及许可证#

自托管 Logto 部署现在可以安装和激活订阅许可证（例如自托管 Pro），在完全自有基础设施中运行的同时解锁高级功能。

• 许可证的安装与管理：可以直接在 Console 的 租户设置 > 许可证 下安装或替换许可证，或者通过管理 API（PUT /api/systems/license 和 GET /api/systems/license）进行自动化。安装的密钥会使用 Logto 内嵌的公钥基于 ES256 签名进行离线验证。
• 许可证状态与宽限期：查看当前计划、环境（生产或非生产）、到期日期和每周自动刷新状态。如果许可证过期或者无法刷新，会有 30 天宽限期维持功能运行，同时在 Console 通过全局警告提醒管理员，之后功能将回退到 OSS 默认。
• 从云端 Console 获取密钥：拥有有效自托管订阅的用户可以在 Logto 云端 Console 的账号菜单直接查看许可证并复制生产和非生产密钥，无需再为此单独创建云端租户。
• 解锁的功能权限：
  • Console 团队协作：邀请其他管理员一起管理自托管部署。邀请通过默认租户的邮件连接器发送安全的一次性账号设置链接到邮箱。
  • 自定义 UI 与 CSP：使用你自己的存储上传自定义登录界面包，并自定义内容安全策略头（CSP）。
  • 移除 Logto 品牌：在登录体验中隐藏“由 Logto 驱动”。
  • 扩展 SAML 应用数量：将 SAML 应用数量上限提升到超过开源默认值。
  • 强制 Console 多因素认证：强制所有访问 Console 的管理员启用多因素验证。 详见 自托管许可证指南 获取安装和详细说明。

更快的 API 资源查询#

• 线性时间 scope 匹配：在 GET /api/resources?includeScopes=true 请求中，scope 和 API 资源的匹配现在使用 Map.groupBy 和 PostgreSQL 数组绑定（= ANY(...)）以线性时间完成，消除了二次方慢速问题，并解决了资源量超过 65,535 时出现的失败。
• 排除管理 API 资源：GET /api/resources 现在支持 excludeManagementApis 查询参数，可以在数据库层面过滤 Logto 管理 API 内部资源。Console 针对第三方应用、动态应用、组织角色和用户角色的权限选择器均采用该过滤，避免在资源量大的租户中将所有资源加载到浏览器，防止 UI 超时。

其他改进和修复#

• 自定义 UI 上传校验：自定义 UI ZIP 上传现在会在写入存储前校验 asset 根目录是否包含 index.html，同时对不支持的 ZIP 压缩格式或超大文件提供可操作的错误提示。
• 设置 MFA 时保持 Console 会话：点击 MFA 设置引导现在会在新标签页打开账户中心安全页面，保留当前 Console 会话和导航状态。
• OSS 租户设置界面：新增了吸顶的“保存更改”栏，支持未保存更改检测和撤销操作。
• 邀请缓存同步：在“成员”标签页邀请成员后，立即重新验证邀请缓存，待处理邀请将无需手动刷新页面即可显示。
• Next.js App Router 指南：在 Next.js App Router 快速入门中更新了 app/page.tsx 示例，将 Home 声明为 async 组件，修复 TypeScript 报错 TS1308。（感谢 @timokoethe）
• 安全更新：将 tinypool 升级到 v2，以修复依赖项中的安全漏洞。

贡献者#

感谢社区成员在本次版本中做出的贡献：

• @timokoethe：Next.js App Router 指南异步修复 (#9692)（首次贡献）

开始升级#

准备升级了吗？可以查看我们的 升级指南 获取逐步操作说明。 查看完整的变更列表，请访问 GitHub 发布页面。 如果你有疑问或建议，欢迎加入我们的 Discord 或在 GitHub 提交 issue。