Если письмо пришло, но ссылка ведёт на `localhost`, внутреннее имя балансировщика или старый домен, SMTP здесь ни при чём. Ошибка возникает раньше отправки: приложение неправильно собрало абсолютный URL. Сначала найдите строку, из которой взяты scheme и host, и только потом меняйте шаблон письма.

Опасный быстрый ремонт — всегда брать домен из заголовка `Host`. Этот заголовок присылает клиент, а за несколькими proxy его происхождение легко перепутать. OWASP рекомендует заранее задавать доверенный base URL либо проверять Host по разрешённому списку, особенно в механизме восстановления пароля.

Разберите ссылку на четыре независимые части

ЧастьПравильный источникТипичная ошибка
schemeканонический https или доверенный proxyв письме появляется http
host и portPUBLIC_ORIGIN/allowlistвнутренний upstream или чужой Host
pathименованный route приложениястарый префикс после миграции
tokenкриптографический генератор и хранилищеодин токен можно применить повторно

Исправление домена не должно менять правила токена. И наоборот: хороший одноразовый токен не делает безопасной ссылку, если злоумышленник способен подставить в письмо собственный хост и получить переход пользователя.

Canonical origin задаётся как конфигурация

PUBLIC_ORIGIN=https://app.example.ru

reset_url = PUBLIC_ORIGIN
  + route('password.reset')
  + '?token=' + url_encode(token)

Значение должно быть полным origin без пользовательских данных, храниться отдельно для production и staging и проходить проверку при старте. Не склеивайте его из `HTTP_HOST`, `Referer` или адреса страницы, с которой пришёл запрос. Для нескольких легитимных брендов выбирайте origin по доверенному tenant ID из базы, а не по заголовку браузера.

Proxy-заголовки читаются только на границе доверия

Стандартный `Forwarded` умеет передать исходные `proto` и `host`, когда reverse proxy меняет соединение. Но RFC предупреждает, что эти поля нельзя считать подлинными сами по себе: клиент тоже способен прислать похожий заголовок. На внешнем proxy удалите входные копии, запишите собственные значения и разрешите приложению доверять только IP или сети этого proxy.

  • Указать список доверенных proxy, а не включать доверие ко всем адресам.
  • Отклонять host вне allowlist до создания письма.
  • Явно настроить внешний HTTPS, если до приложения идёт HTTP.
  • Не печатать reset token в access- и debug-логах.
  • Проверить отдельные пути через CDN, ingress и фонового отправителя.

Тест с подменой Host должен закончиться отказом

  1. Создать тестового пользователя без реальных персональных данных.
  2. Перехватить письмо в локальном mail sink или тестовом почтовом ящике.
  3. Послать запрос через штатный proxy с ожидаемым Host и проверить production origin.
  4. Повторить запрос с `Host: attacker.example` и собственным Forwarded.
  5. Убедиться, что сервер отклонил запрос либо всё равно использовал заданный PUBLIC_ORIGIN.
  6. Не переходя по ссылке, проверить scheme, host, path и отсутствие токена в логах.

Проверяйте именно с той сетевой цепочкой, которая работает в production. Локальный запуск без ingress не покажет, кто перезаписывает host и protocol.

Токен остаётся короткоживущим и одноразовым

OWASP рекомендует случайный токен, привязанный к пользователю, с ограниченным сроком и однократным использованием. Храните безопасное представление токена, отзывайте его после успешной смены пароля и не меняйте пароль до предъявления корректного значения. На странице сброса полезен `Referrer-Policy: no-referrer`, чтобы URL не утёк на сторонний ресурс.

После миграции проверьте все генераторы URL

Ссылка может собираться веб-контроллером, очередью писем, отдельным auth-сервисом или провайдером идентификации. Поиск по одному HTML-шаблону не гарантирует успех. Сопоставьте trace запроса с задачей очереди и зафиксируйте, какая версия конфигурации дала origin.

Для разбора подготовьте обезличенный пример URL без token, схему proxy/CDN, список источников host/proto, значение PUBLIC_ORIGIN и результат теста с чужим Host. Не пересылайте рабочую ссылку восстановления: даже короткоживущий токен остаётся секретом.

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