Миграция с NextAuth.js v4 на Auth.js v5

Версия NextAuth.js 5 является значительной переработкой пакета next-auth, которая включает в себя изменения, нарушающие обратную совместимость, и затрагивает различные интеграции, включая Logto. Это руководство поможет вам пройти процесс миграции вашей интеграции с NextAuth.js v4 на Auth.js v5.

Понимание изменений#

Auth.js v5#

NextAuth.js v5 вводит несколько изменений, нарушающих совместимость, основное изменение, которое влияет на то, как вы интегрируете Logto с приложением, — это изменение "OIDC/OAuth Providers". В официальной документации говорится: "Auth.js теперь строится на @auth/core с более строгим соблюдением спецификаций OAuth/OIDC, что может нарушить работу некоторых существующих OAuth провайдеров", для пользователей Logto это означает, что вам нужно обновить конфигурацию провайдера.

Более подробную информацию об изменениях вы можете найти в официальном руководстве по миграции.

Конфигурация провайдера Logto#

Конфигурация провайдера Logto была обновлена:

• Тип был изменен с oauth на oidc.
• Удален endpoint wellKnown, и вам необходимо указать поле issuer.
• Нет необходимости указывать алгоритм подписи id_token, теперь поддерживается ES384, и он будет определяться автоматически.

Пошаговое руководство по миграции#

Обновите конфигурацию провайдера в вашем файле pages/api/auth/[...nextauth].js с новым шаблоном конфигурации:

Шаг 1: Измените тип провайдера#

Измените тип провайдера с oauth на oidc.

Шаг 2: Добавьте поле issuer#

Добавьте поле issuer в конфигурацию провайдера. Вы можете получить значение issuer на странице сведений о приложении Logto, в поле "Issuer endpoint". Оно должно выглядеть как https://xxxx.logto.app/oidc, если вы используете облачный сервис Logto.

Затем вы можете удалить поле wellKnown.

Шаг 3: Удалите алгоритм подписи id_token_signed_response_alg#

Теперь вам не нужно указывать алгоритм подписи id_token_signed_response_alg в конфигурации провайдера. Поддерживается ES384, и он будет определяться автоматически.

Обновите проект#

После обновления конфигурации провайдера вам нужно обновить пакет next-auth до v5, следуйте официальному руководству по миграции, чтобы обновить пакет и убедиться, что ваше приложение работает как ожидалось.