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

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

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

Настройка выполняется в два этапа:

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

добавление домена в шаблоны писем;

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

  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