NextAuth.js v4'ten Auth.js v5'e Geçiş

NextAuth.js versiyon 5, next-auth paketinin büyük bir yeniden yazımıdır ve Logto gibi çeşitli entegrasyonları etkileyen kesintili güncellemeler getirir. Bu kılavuz, Logto entegrasyonunuzu NextAuth.js v4'ten Auth.js v5'e geçirmeniz konusunda size rehberlik edecektir.

NextAuth hızlı başlangıç kılavuzumuzu yakın zamanda güncelledik. İnceleyin!

Değişiklikleri Anlama#

Auth.js v5#

NextAuth.js v5, Logto entegrasyon stilinizi etkileyen ana değişiklik olan "OIDC/OAuth Sağlayıcıları" değişikliğini tanıtan birkaç kesintili değişiklik getirir. Resmi belgede, "Auth.js artık OAuth/OIDC spesifik uyumluluğu getiren @auth/core ile inşa edilmiştir ve bu bazı mevcut OAuth sağlayıcılarını bozabilir" deniyor, Logto kullanıcıları için bu, sağlayıcı yapılandırmasını güncellemeniz gerektiği anlamına gelir.

Değişiklikler hakkında daha fazla bilgi için resmi geçiş kılavuzuna başvurabilirsiniz.

Logto sağlayıcı yapılandırması#

Logto için sağlayıcı yapılandırması güncellenmiştir:

• Tür oauth'tan oidc'ye değiştirildi.
• wellKnown uç noktası kaldırıldı ve bunun yerine issuer alanını sağlamanız gerekiyor.
• id_token imzalama algoritmasını belirtmenize gerek yoktur, artık ES384 destekleniyor ve otomatik olarak algılanacak.

Adım adım geçiş kılavuzu#

Yeni yapılandırma şablonu ile pages/api/auth/[...nextauth].js dosyanızdaki sağlayıcı yapılandırmasını güncelleyin:

Adım 1: Sağlayıcı türünü değiştirin#

Sağlayıcı türünü oauth'tan oidc'ye değiştirin.

Adım 2: Issuer alanını ekleyin#

Sağlayıcı yapılandırmasına issuer alanını ekleyin. Issuer değerini Logto Uygulama Detayları sayfasından, "Issuer endpoint" alanından alabilirsiniz. Logto bulut hizmetini kullanıyorsanız https://xxxx.logto.app/oidc gibi görünmelidir.

Ve ardından wellKnown alanını kaldırabilirsiniz.

Adım 3: id_token_signed_response_alg imzalama algoritmasını kaldırın#

Artık sağlayıcı yapılandırmasında id_token_signed_response_alg imzalama algoritmasını belirtmenize gerek yoktur. Artık ES384 destekleniyor ve otomatik olarak algılanacak.

Projeyi Güncelleyin#

Sağlayıcı yapılandırmasını güncelledikten sonra, next-auth paketini v5'e güncellemeniz gerekiyor, paketi güncellemek ve uygulamanızın beklendiği gibi çalıştığından emin olmak için resmi geçiş kılavuzunu takip edin. Ayrıca NextAuth hızlı başlangıç kılavuzunu referans aldığınızdan emin olun.