繁體中文(香港)
從 NextAuth.js v4 遷移到 Auth.js v5
從 NextAuth.js v4 遷移到 v5 的 Logto 集成指南。
NextAuth.js 第五版是 next-auth
套件的一次重大重寫,帶來了一些影響多個集成(包括 Logto)的破壞性更新。本指南將帶你了解如何將 Logto 集成從 NextAuth.js v4 遷移到 Auth.js v5。
了解變更
Auth.js v5
NextAuth.js v5 引入了幾個重大變更,主要影響你將 Logto 與應用程式集成的方式是「OIDC/OAuth Providers」的變更。在官方文件中提到「Auth.js 現在基於 @auth/core,具有更嚴格的 OAuth/OIDC 規範兼容性,這可能會破壞一些現有的 OAuth 提供者」,對於 Logto 用戶來說,這意味著你需要更新提供者配置。
有關變更的更多資訊,您可以參考官方遷移指南。
Logto 提供者配置
Logto 的提供者配置已更新:
- 類型已從
oauth
變更為oidc
。 - 刪除了
wellKnown
端點,你需要提供issuer
欄位。 - 不需要指定
id_token
簽名算法,現在支援ES384
並將自動檢測。
詳細遷移指南
在你的 pages/api/auth/[...nextauth].js
文件中使用新的配置模板更新提供者配置: