คู่มือการย้ายการเชื่อมต่อ Logto จาก NextAuth.js v4 ไปยัง v5
NextAuth.js เวอร์ชัน 5 เป็นการเขียนใหม่ครั้งใหญ่ของแพ็กเกจ next-auth ซึ่งมีการอัปเดตที่ทำให้เกิดการเปลี่ยนแปลงที่ส่งผลต่อการเชื่อมต่อหลาย ๆ อย่าง รวมถึง Logto คู่มือนี้จะแนะนำคุณในกระบวนการย้ายการเชื่อมต่อ Logto ของคุณจาก NextAuth.js v4 ไปยัง Auth.js v5
เราเพิ่งอัปเดต คู่มือเริ่มต้นอย่างรวดเร็วของ NextAuth ลองดูเลย!
NextAuth.js v5 นำการเปลี่ยนแปลงที่ส่งผลกระทบมากมาย โดยการเปลี่ยนแปลงหลักที่ส่งผลต่อวิธีการที่คุณเชื่อมต่อ Logto กับแอปพลิเคชันของคุณคือการเปลี่ยนแปลงใน "OIDC/OAuth Providers" ในเอกสารอย่างเป็นทางการกล่าวว่า "Auth.js ตอนนี้สร้างขึ้นบน @auth/core ที่มีการปฏิบัติตามข้อกำหนดของ OAuth/OIDC ที่เข้มงวดกว่าเดิม ซึ่งอาจทำให้ OAuth providers บางรายใช้งานไม่ได้อีกต่อไป" สำหรับผู้ใช้ Logto หมายความว่าคุณต้องอัปเดตการกำหนดค่าของ provider
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลง คุณสามารถดูได้ที่ คู่มือการย้ายอย่างเป็นทางการ
การกำหนดค่าสำหรับ Logto provider ได้รับการอัปเดต:
oauth เป็น oidcwellKnown ถูกลบออกและคุณต้องระบุฟิลด์ issuer แทนid_token แล้ว ตอนนี้สนับสนุน ES384 และจะถูกตรวจจับโดยอัตโนมัติอัปเดตการกำหนดค่า provider ในไฟล์ pages/api/auth/[...nextauth].js ของคุณโดยใช้แม่แบบการกำหนดค่าใหม่:
เปลี่ยนประเภท provider จาก oauth เป็น oidc
เพิ่มฟิลด์ issuer ในการกำหนดค่าของ provider คุณสามารถรับค่า issuer จากหน้า Logto Application Details ในฟิลด์ "Issuer endpoint" ควรมีลักษณะเป็น https://xxxx.logto.app/oidc หากคุณใช้บริการ Logto cloud
จากนั้นคุณสามารถลบฟิลด์ wellKnown ได้
id_token_signed_response_algคุณไม่จำเป็นต้องระบุอัลกอริธึมการลงนาม id_token_signed_response_alg ในการกำหนดค่าของ provider อีกต่อไป ขณะนี้สนับสนุน ES384 และจะถูกตรวจจับโดยอัตโนมัติ
หลังจากอัปเดตการกำหนดค่า provider คุณต้องอัปเดตแพ็กเกจ next-auth เป็น v5 ทำตาม คู่มือการย้ายอย่างเป็นทางการ เพื่ออัปเดตแพ็กเกจและตรวจสอบให้แน่ใจว่าแอปพลิเคชันของคุณทำงานได้ตามคาด ตรวจสอบให้แน่ใจว่าคุณอ้างอิง คู่มือเริ่มต้นอย่างรวดเร็วของ NextAuth ด้วย