Używanie własnej domeny do uwierzytelniania e-maili

Jeśli w projekcie używasz własnej domeny, rozważ użycie jej również w e-mailach wysyłanych w związku ze zdarzeniami uwierzytelniania, takimi jak potwierdzanie adresu e-mail, zmiana adresu i odzyskiwanie hasła. Możesz skonfigurować projekt tak, aby używał Twojej własnej domeny w polu From i linkach do działań w e-mailach.

Dzięki skonfigurowaniu własnych domen dla e-maili uwierzytelniających użytkownicy będą widzieć tę samą domenę w adresie internetowym i e-mailach dotyczących zarządzania użytkownikami.

Konfiguracja składa się z 2 głównych etapów:

  • Dodaj domenę do szablonów e-maili w konsoli Firebase.
  • Potwierdź własność domeny, dodając rekordy DNS w systemie rejestratora domeny.

Dodawanie domeny do szablonów e-maili

  1. W konsoli Firebase otwórz kartę Zabezpieczenia > Uwierzytelnianie > Szablony.

  2. W przypadku każdego szablonu e-maila wykonaj te czynności:

    1. Kliknij ikonę edycji ().
    2. Kliknij własna domena.
    3. Wpisz domenę, której chcesz używać.

Zobaczysz tabelę rekordów DNS, które musisz dodać u rejestratora domeny, aby potwierdzić, że jesteś jej właścicielem.

Zweryfikuj domenę

Dodaj lub zaktualizuj rekordy DNS typu TXT i CNAME podane w konsoli Firebase. Procedura zależy od rejestratora.

Dla danej domeny możesz mieć tylko 1 rekord TXT v=spf1.... Jeśli chcesz podać kilka adresów e-mail, połącz je w jeden rekord.

Weryfikacja domeny może potrwać do 24 godzin. Gdy to nastąpi, na karcie Szablony w konsoli Firebase pojawi się zielony komunikat „Weryfikacja zakończona”. Następnie możesz kliknąć przycisk Zastosuj własną domenę, aby wprowadzić zmiany.

Projekty z wieloma najemcami

Jeśli masz uaktualnioną wersję Firebase Authentication with Identity Platform i włączoną obsługę wielu najemców, musisz zaktualizować metadane najemcy, aby umożliwić mu dziedziczenie własnych domen, szablonów e-maili i niestandardowych ustawień SMTP. W przeciwnym razie użytkownicy będą nadal otrzymywać e-maile z domeny domyślnej, nawet jeśli własna domena zostanie pomyślnie zweryfikowana i zastosowana.

Możesz sprawdzić, czy obsługa wielu najemców jest włączona, sprawdzając adres URL zawarty w wiadomościach e-mail dotyczących uwierzytelniania. Jeśli adres URL zawiera parametr tenant, musisz zaktualizować metadane najemcy projektu.

Aby to zrobić, uruchom to polecenie:

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