Siirtyminen NextAuth.js v4:stä Auth.js v5:een

NextAuth.js versio 5 on merkittävä uudelleenkirjoitus next-auth-paketista, joka tuo mukanaan muutoksia, jotka vaikuttavat eri integraatioihin, mukaan lukien Logto. Tämä opas opastaa sinua Logton integroinnin siirtämisessä NextAuth.js v4:stä Auth.js v5:een.

Olemme äskettäin päivittäneet NextAuth pikaset aloitusoppaamme. Tutustu siihen!

Muutosten ymmärtäminen#

Auth.js v5#

NextAuth.js v5 tuo mukanaan useita muutoksia, ja tärkein muutos, joka vaikuttaa tapaan, jolla yhdistät Logton sovellukseesi, on muutos "OIDC/OAuth tarjoajissa". Virallisessa dokumentaatiossa sanotaan: "Auth.js perustuu nyt @auth/core:en tiukemmin OAuth/OIDC sääntöjen mukaisesti, mikä saattaa rikkoa joitain olemassa olevia OAuth-tarjoajia", Logton käyttäjille tämä tarkoittaa, että sinun täytyy päivittää tarjoajan kokoonpano.

Lisätietoja muutoksista löydät virallisesta siirtymäoppaasta.

Logto-tarjoajan kokoonpano#

Logto-tarjoajan kokoonpanoa on päivitetty:

• Tyyppi on muutettu oauth-tyypistä oidc:ksi.
• wellKnown-päätepiste on poistettu, ja sinun täytyy antaa issuer-kenttä sen sijaan.
• Ei tarvitse määrittää id_token allekirjoitusalgoritmia, se tukee nyt ES384:a ja se tunnistetaan automaattisesti.

Askeleittainen siirtymäopas#

Päivitä tarjoajan kokoonpano pages/api/auth/[...nextauth].js-tiedostossasi uudella kokoonpanomallilla:

Vaihe 1: Vaihda tarjoajan tyyppi#

Vaihda tarjoajan tyyppi oauth:sta oidc:ksi.

Vaihe 2: Lisää issuer-kenttä#

Lisää issuer-kenttä tarjoajan kokoonpanoon. Saat issuer-arvon Logton sovelluksen yksityiskohdat -sivulta, kentästä "Issuer endpoint". Sen pitäisi näyttää https://xxxx.logto.app/oidc, jos käytät Logton pilvipalvelua.

Ja sitten voit poistaa wellKnown-kentän.

Vaihe 3: Poista id_token_signed_response_alg allekirjoitusalgoritmi#

Sinun ei enää tarvitse määrittää id_token_signed_response_alg allekirjoitusalgoritmia tarjoajan kokoonpanossa. Se tukee nyt ES384:a ja se tunnistetaan automaattisesti.

Päivitä projekti#

Tarjoajan kokoonpanon päivittämisen jälkeen sinun täytyy päivittää next-auth-paketti versioon v5, noudata virallista siirtymäopasta päivittääksesi paketin ja varmista, että sovelluksesi toimii odotetusti. Varmista myös, että viittaat NextAuth pikaset aloitusoppaaseen.