Ein Leitfaden zur Migration der Logto-Integration von NextAuth.js v4 zu v5.
NextAuth.js Version 5 ist eine umfassende Überarbeitung des next-auth-Pakets, die bedeutende Änderungen mit sich bringt, die verschiedene Integrationen betreffen, einschließlich Logto. Dieser Leitfaden führt dich durch den Prozess der Migration deiner Logto-Integration von NextAuth.js v4 zu Auth.js v5.
Wir haben kürzlich unseren NextAuth-Schnellstart-Leitfaden aktualisiert. Schau ihn dir an!
NextAuth.js v5 führt mehrere große Änderungen ein. Die Hauptänderung, die die Art und Weise betrifft, wie du Logto mit deiner Anwendung integrierst, ist die Veränderung bei "OIDC/OAuth-Anbietern". In der offiziellen Dokumentation heißt es: "Auth.js baut jetzt auf @auth/core mit strengerer OAuth/OIDC-Spezifikation auf, was einige bestehende OAuth-Anbieter beeinträchtigen könnte". Für Logto-Nutzer bedeutet dies, dass du die Anbieter-Konfiguration aktualisieren musst.
Für weitere Informationen zu den Änderungen kannst du den offiziellen Migrationsleitfaden einsehen.
Die Anbieterkonfiguration für Logto wurde aktualisiert:
oauth zu oidc geändert.wellKnown-Endpunkt wurde entfernt, und stattdessen musst du das issuer-Feld angeben.id_token-Signaturalgorithmus anzugeben. Es wird jetzt ES384 unterstützt und automatisch erkannt.Aktualisiere die Anbieterkonfiguration in deiner Datei pages/api/auth/[...nextauth].js mit der neuen Konfiguration:
Ändere den Anbietertyp von oauth zu oidc.
Issuer-Feld hinzufügenFüge das issuer-Feld zur Anbieterkonfiguration hinzu. Du kannst den Wert des Issuers von der Logto-Anwendungsseite im Feld "Issuer-Endpunkt" abrufen. Er sollte wie https://xxxx.logto.app/oidc aussehen, wenn du den Logto-Cloud-Service verwendest.
Dann kannst du das wellKnown-Feld entfernen.
id_token_signed_response_alg Signaturalgorithmus entfernenDu musst den id_token_signed_response_alg Signaturalgorithmus in der Anbieterkonfiguration nicht mehr angeben. Er unterstützt jetzt ES384 und wird automatisch erkannt.
Nachdem du die Anbieterkonfiguration aktualisiert hast, musst du das next-auth-Paket auf v5 aktualisieren. Folge dem offiziellen Migrationsleitfaden, um das Paket zu aktualisieren, und stelle sicher, dass deine Anwendung wie erwartet funktioniert. Stelle sicher, dass du auch den NextAuth-Schnellstart-Leitfaden referenzierst.