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

NextAuth.js versio 5 on merkittävä uudelleenkirjoitus next-auth-paketille, joka tuo mukanaan yhteensopivuuskatkoksia, jotka vaikuttavat eri integraatioihin, mukaan lukien Logto. Tämä opas johdattaa sinut läpi prosessin, kuinka migroidaan Logto-integraatiosi NextAuth.js v4:stä Auth.js v5:een.

Muutosten ymmärtäminen#

Auth.js v5#

NextAuth.js v5 tuo mukanaan useita yhteensopivuuskatkoksia, joista merkittävin muutos, joka vaikuttaa tapaan, miten integroitat Logton sovellukseesi, on muutos "OIDC/OAuth Providers" -osiossa. Virallisessa dokumentaatiossa sanotaan "Auth.js perustuu nyt @auth/core:een tiukemmalla OAuth/OIDC-standardinmukaisuudella, mikä saattaa rikkoa joitain olemassa olevia OAuth-tarjoajia", mikä Logto-käyttäjille tarkoittaa, että tarjoajamääritykset on päivitettävä.

Lisätietoja muutoksista löydät virallisesta migraatio-oppaasta.

Logto-tarjoajamääritykset#

Logto-tarjoajamäärityksiä on päivitetty:

• Tyyppi on muutettu oauth:sta oidc:ksi.
• wellKnown-päätepiste on poistettu, ja sinun on annettava issuer-kenttä sen sijaan.
• Ei tarvitse enää määritellä id_token-allekirjoitusalgoritmia, se tukee nyt ES384:ää ja se havaitaan automaattisesti.

Vaiheittainen migraatio-opas#

Päivitä tarjoajamääritykset pages/api/auth/[...nextauth].js-tiedostossasi uuden määritysmallin mukaisesti:

Vaihe 1: Muuta tarjoajatyyppi#

Muuta tarjoajatyyppi oauth-mallista oidc:ksi.

Vaihe 2: Lisää issuer-kenttä#

Lisää issuer-kenttä tarjoajamäärityksiin. Saat issuer-arvon Logto Application Details -sivulta, kentästä "Issuer endpoint". Sen tulisi näyttää tältä 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 tarvitse enää määrittää id_token_signed_response_alg-allekirjoitusalgoritmia tarjoajamäärityksissä. Se tukee nyt ES384:ää ja se havaitaan automaattisesti.

Päivitä projekti#

Kun olet päivittänyt tarjoajamääritykset, sinun on päivitettävä next-auth-paketti versioon 5, noudata virallista migraatio-opasta päivittääksesi paketin ja varmistaaksesi, että sovelluksesi toimii odotetusti.