Если провайдер показывает `redirect_uri_mismatch`, сравните фактический `redirect_uri` из authorize-запроса с разрешённым адресом OAuth client. Совпасть должны схема, домен, порт, path и, у Google, завершающий slash. Если callback доходит до приложения, но вход не сохраняется, переходите к cookie и server-side session.
Не удаляйте старый callback сразу. На время миграции зарегистрируйте оба HTTPS URI, направьте каждый домен на совместимую версию callback и только после окончания активных попыток входа уберите прежний адрес. Client secret при смене домена обычно не нужно переносить в браузер или менять без причины.
Место отказа видно по адресу браузера
| Где остановился поток | Наблюдаемый признак | Следующая проверка |
|---|---|---|
| До consent screen | redirect_uri_mismatch или origin_mismatch | OAuth client и точное значение параметра |
| После consent, на старом домене | Callback построен из устаревшего base URL | Proxy headers и public URL конфигурация |
| На новом callback с 404 | Route не развернут или proxy не передаёт path | Маршрут и access log |
| Callback 200, затем снова login | Session cookie не установилась | Set-Cookie, Domain, Secure, SameSite |
| invalid_state | Потеряна начальная browser session | Cookie между 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 не нужны.