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

NextAuth.js sürüm 5, next-auth paketinde çeşitli entegrasyonları, Logto da dahil olmak üzere, etkileyen büyük bir yeniden yazımdır. Bu kılavuz, Logto entegrasyonunuzu NextAuth.js v4'ten Auth.js v5'e geçirme sürecine rehberlik edecektir.

Değişiklikleri Anlama#

Auth.js v5#

NextAuth.js v5, Logto'yu uygulamanızla entegre etme şeklinizi etkileyen temel değişikliğin "OIDC/OAuth Sağlayıcıları" üzerindeki değişim olduğu çeşitli yıkıcı değişiklikler sunar. Resmi belgelerde, "Auth.js artık @auth/core'u daha sıkı OAuth/OIDC spec-uyumluluğu ile inşa ediyor, bu da bazı mevcut OAuth sağlayıcılarını bozabilir" diyor, 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ş rehberine başvurabilirsiniz.

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

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

• Tür oauth yerine oidc olarak değiştirilmiştir.
• wellKnown uç noktası kaldırıldı ve bunun yerine issuer alanını sağlamanız gerekmektedir.
• id_token imzalama algoritmasını belirtmeye gerek yok, artık ES384 destekleniyor ve otomatik olarak algılanacaktır.

Adım Adım Geçiş Rehberi#

Yeni yapılandırma şablonuyla 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 yerine oidc olarak değiştirin.

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

Issuer alanını sağlayıcı yapılandırmasına ekleyin. Issuer değerini Logto Uygulama Detayları sayfasında, "Issuer endpoint" alanında bulabilirsiniz. Logto bulut hizmetini kullanıyorsanız, bu https://xxxx.logto.app/oidc biçiminde 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#

Sağlayıcı yapılandırmasında id_token_signed_response_alg imzalama algoritmasını belirtmenize artık gerek yok. Artık ES384 destekleniyor ve otomatik olarak algılanacaktır.

Projeyi Güncelleyin#

Sağlayıcı yapılandırmasını güncelledikten sonra, next-auth paketini v5'e güncellemeniz gerekecek, paketi güncellemek için resmi geçiş rehberini takip edin ve uygulamanızın beklediğiniz gibi çalıştığından emin olun.