Свой SMTP в Firebase Authentication

Firebase Authentication отправляет пользователям письма для подтверждения адреса, сброса пароля, смены email и уведомления о новом втором факторе. По умолчанию они приходят с адреса на firebaseapp.com и отправляются серверами Google. Свой SMTP переводит их на ваш домен с подписью DKIM — письма перестают попадать в спам и выглядят как ваши, а не как чужие.

Параметры подключения

Шаг 1 — включите SMTP settings

В консоли Firebase откройте Authentication → Templates, выберите SMTP settings, включите его и заполните поля:

Шаг 2 — проверьте шаблоны

На той же вкладке Templates откройте каждый тип письма значком карандаша. У всех можно задать имя отправителя, адрес для ответа и тему, а у сброса пароля — ещё и текст. Подстановки %LINK%, %EMAIL%, %NEW_EMAIL%, %APP_NAME% и %DISPLAY_NAME% заполняются для каждого письма.

%APP_NAME% — это публичное название проекта из его настроек. Укажите имя, под которым вас знают пользователи: письмо подтверждения от «project-1234» выглядит как фишинг.

Настройка через API

То же самое через административный Identity Toolkit API — для скриптов и повторяемой настройки:

PROJECT_ID=your-project-id

curl -X PATCH \
  "https://identitytoolkit.googleapis.com/admin/v2/projects/$PROJECT_ID/config?updateMask=notification.sendEmail.method,notification.sendEmail.smtp" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: $PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "notification": {
      "sendEmail": {
        "method": "CUSTOM_SMTP",
        "smtp": {
          "senderEmail": "noreply@mail.example.ru",
          "host": "smtp.fmailer.ru",
          "port": 587,
          "username": "token-login@mail.example.ru",
          "password": "token-password",
          "securityMode": "START_TLS"
        }
      }
    }
  }'

Полностью свои письма авторизации

Если редактора шаблонов мало — нужна своя вёрстка, язык письма под пользователя, отправка с вашего бэкенда, — пусть Admin SDK сгенерирует ссылку, а письмо вы отправите сами:

// Бэкенд на Node.js или Cloud Function: своё письмо со ссылкой Firebase
import { initializeApp } from "firebase-admin/app";
import { getAuth } from "firebase-admin/auth";
import nodemailer from "nodemailer";

initializeApp();

const transporter = nodemailer.createTransport({
  host: "smtp.fmailer.ru",
  port: 587,
  secure: false, // STARTTLS
  auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASS },
});

export async function sendPasswordReset(email) {
  const link = await getAuth().generatePasswordResetLink(email, {
    url: "https://example.ru/login", // куда пользователь попадёт после сброса
  });

  await transporter.sendMail({
    from: "Магазин <noreply@mail.example.ru>",
    to: email,
    subject: "Сброс пароля",
    text: "Чтобы задать новый пароль, откройте ссылку: " + link,
    html: '<p><a href="' + link + '">Задать новый пароль</a></p>',
  });
}

Так же работают generateEmailVerificationLink и generateSignInWithEmailLink.

Для писем приложения по событиям в Firestore есть официальное расширение Trigger Email from Firestore: оно отправляет по SMTP каждый документ, добавленный в коллекцию. Пароль не пишите в URI подключения — для него есть отдельное поле. Логин токена — это адрес, поэтому @ в нём записывается как %40:

# Расширение Trigger Email from Firestore
SMTP connection URI:   smtp://token-login%40mail.example.ru@smtp.fmailer.ru:587
SMTP password:         token-password
Default FROM address:  Магазин <noreply@mail.example.ru>

Проверка

Запросите сброс пароля для тестового аккаунта из приложения или из списка пользователей в Authentication → Users. Проверьте в полученном письме адрес отправителя и заголовки: там должен быть ваш домен и успешная проверка DKIM.

Разбор ошибок