Если провайдер показывает `redirect_uri_mismatch`, сравните фактический `redirect_uri` из authorize-запроса с разрешённым адресом OAuth client. Совпасть должны схема, домен, порт, path и, у Google, завершающий slash. Если callback доходит до приложения, но вход не сохраняется, переходите к cookie и server-side session.

Не удаляйте старый callback сразу. На время миграции зарегистрируйте оба HTTPS URI, направьте каждый домен на совместимую версию callback и только после окончания активных попыток входа уберите прежний адрес. Client secret при смене домена обычно не нужно переносить в браузер или менять без причины.

Место отказа видно по адресу браузера

Где остановился потокНаблюдаемый признакСледующая проверка
До consent screenredirect_uri_mismatch или origin_mismatchOAuth client и точное значение параметра
После consent, на старом доменеCallback построен из устаревшего base URLProxy headers и public URL конфигурация
На новом callback с 404Route не развернут или proxy не передаёт pathМаршрут и access log
Callback 200, затем снова loginSession cookie не установиласьSet-Cookie, Domain, Secure, SameSite
invalid_stateПотеряна начальная browser sessionCookie между start и callback и единое хранилище state
Token exchange failedДругой redirect_uri или client credentialsПараметры server-to-server запроса

Сохраняйте request ID и безопасный код ошибки, но не authorization code, access token и client secret. Код авторизации краткоживущий и предназначен для обмена на backend; он не должен попадать в аналитику или общедоступный log.

Public URL строится из доверенной конфигурации

PUBLIC_ORIGIN=https://new.example.com
OAUTH_CALLBACK_PATH=/auth/google/callback
SESSION_COOKIE_DOMAIN=new.example.com
SESSION_COOKIE_SECURE=true
SESSION_COOKIE_SAMESITE=lax

redirect_uri = PUBLIC_ORIGIN + OAUTH_CALLBACK_PATH

Не принимайте `X-Forwarded-Host` от любого клиента как источник redirect URI. Reverse proxy должен перезаписывать forwarded headers, а приложение — доверять только известному proxy. Иначе злоумышленник сможет подменить host и увести callback.

Cookie проверяется в двух запросах

В Network панели откройте запрос, который начинает OAuth, и убедитесь, что браузер сохранил cookie со state/nonce. Затем проверьте callback: отправилась ли эта cookie и вернул ли сервер новую session cookie. Атрибут Domain старого домена невозможно расширить на независимый новый домен.

  • Для HTTPS включите Secure; не лечите проблему его отключением в production.
  • Path cookie должен охватывать start и callback routes.
  • SameSite выбирайте по реальному flow и методу callback, а не копируйте вслепую.
  • При нескольких instances храните state в общем store или используйте проверяемую защищённую конструкцию.
  • Не связывайте аккаунты только по непроверенному email из клиента.

Переезд проводится с двумя разрешёнными URI

Сначала добавьте новый redirect URI у каждого провайдера и дождитесь применения настройки. Затем разверните приложение, переключите публичные ссылки и наблюдайте долю callback по доменам. Старый домен оставьте с корректным redirect или понятным сообщением, пока начатые там сессии не закончатся.

После стабилизации удалите старый URI из allowlist, обновите privacy/consent URLs и проверьте отдельные OAuth clients для production и staging. Wildcard callback использовать не стоит: провайдеры ограничивают redirect URI именно для предотвращения перенаправления к чужому endpoint.

Контрольный прогон не ограничивается одним аккаунтом

Проверьте новый пользовательский вход, повторный вход существующего пользователя, отказ на consent screen и две параллельные вкладки. Критерий успеха: state принимается только в своей сессии, callback не раскрывает code в логах, а аккаунт не дублируется.

Для диагностики подготовьте provider, client type, полный callback без query, network timeline и атрибуты cookie без значения. Скриншот client secret и реальные authorization codes не нужны.

Проверенные источники