Если письмо пришло, но ссылка ведёт на `localhost`, внутреннее имя балансировщика или старый домен, SMTP здесь ни при чём. Ошибка возникает раньше отправки: приложение неправильно собрало абсолютный URL. Сначала найдите строку, из которой взяты scheme и host, и только потом меняйте шаблон письма.
Опасный быстрый ремонт — всегда брать домен из заголовка `Host`. Этот заголовок присылает клиент, а за несколькими proxy его происхождение легко перепутать. OWASP рекомендует заранее задавать доверенный base URL либо проверять Host по разрешённому списку, особенно в механизме восстановления пароля.
Разберите ссылку на четыре независимые части
| Часть | Правильный источник | Типичная ошибка |
|---|---|---|
| scheme | канонический https или доверенный proxy | в письме появляется http |
| host и port | PUBLIC_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 должен закончиться отказом
- Создать тестового пользователя без реальных персональных данных.
- Перехватить письмо в локальном mail sink или тестовом почтовом ящике.
- Послать запрос через штатный proxy с ожидаемым Host и проверить production origin.
- Повторить запрос с `Host: attacker.example` и собственным Forwarded.
- Убедиться, что сервер отклонил запрос либо всё равно использовал заданный PUBLIC_ORIGIN.
- Не переходя по ссылке, проверить 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. Не пересылайте рабочую ссылку восстановления: даже короткоживущий токен остаётся секретом.