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

Если вы используете в проекте собственный домен, рекомендуем также использовать его в письмах, отправляемых для событий аутентификации, таких как подтверждение адреса электронной почты, изменение адреса и восстановление пароля. Вы можете настроить проект так, чтобы в поле From и ссылках для действий в письмах использовался ваш собственный домен.

Если вы настроите собственные домены для писем аутентификации, пользователи будут видеть один и тот же домен в вашем веб-адресе и в письмах, связанных с управлением доступом.

Настройка состоит из двух основных этапов:

  • Добавьте домен в шаблоны электронных писем в консоли Firebase.
  • Подтвердите право собственности на домен, добавив записи DNS на сайте регистратора домена.

Добавление домена в шаблоны электронных писем

  1. В консоли Firebase перейдите в раздел Security (Безопасность) > Authentication (Аутентификация) > Templates (Шаблоны).

  2. Для каждого шаблона электронного письма выполните следующие действия:

    1. Нажмите на значок карандаша .
    2. Нажмите Настроить собственный домен.
    3. Введите домен, который хотите использовать.

Вы увидите таблицу с записями DNS, которые нужно добавить в настройки регистратора домена, чтобы подтвердить право собственности на домен.

Подтвердите домен

Добавьте или обновите записи TXT и CNAME DNS, указанные в консоли Firebase. Процедура зависит от регистратора.

Для одного домена можно создать только одну запись TXT v=spf1.... Если вам нужно указать несколько адресов электронной почты, объедините их в одну запись.

Проверка домена может занять до 24 часов. Когда это произойдет, на вкладке Шаблоны в консоли Firebase появится зеленое сообщение "Проверка завершена". Затем нажмите кнопку Применить собственный домен, чтобы изменения вступили в силу.

Проекты с несколькими клиентами

Если вы перешли на Firebase Authentication with Identity Platform и включили мультиарендность, вам нужно обновить метаданные арендатора, чтобы он мог наследовать собственные домены, шаблоны электронных писем и пользовательские настройки SMTP. В противном случае пользователи будут получать письма из домена по умолчанию, даже если собственный домен подтвержден и применяется.

Чтобы проверить, включена ли мультиарендность, посмотрите на URL в электронных письмах Auth. Если URL содержит параметр tenant, вам нужно обновить метаданные клиента в проекте.

Для этого выполните следующую команду:

curl -X PATCH -d "{'inheritance':{'emailSendingConfig': true}}" \
  -H "X-Goog-User-Project: PROJECT_ID"                          \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
  -H 'Content-Type:application/json'                            \
  https://identitytoolkit.googleapis.com/v2/projects/PROJECT_ID/tenants/TENANT_ID?updateMask=inheritance.emailSendingConfig