NextAuth.js v4'ten v5'e Logto entegrasyonunu geçiş kılavuzu.
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!
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 için sağlayıcı yapılandırması güncellenmiştir:
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.Yeni yapılandırma şablonu ile pages/api/auth/[...nextauth].js dosyanızdaki sağlayıcı yapılandırmasını güncelleyin:
Sağlayıcı türünü oauth'tan oidc'ye değiştirin.
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.
id_token_signed_response_alg imzalama algoritmasını kaldırınArtı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.
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.