Użyj domeny niestandardowej dla e-maili uwierzytelniających

Jeśli w swoim projekcie używasz domeny niestandardowej, rozważ także użycie domeny niestandardowej w wiadomościach e-mail wysyłanych w ramach zdarzeń uwierzytelniania, takich jak weryfikacja adresu e-mail, zmiana adresu i odzyskiwanie hasła. Możesz skonfigurować swój projekt tak, aby korzystał z domeny niestandardowej w polu From i łączach akcji w wiadomościach e-mail.

Konfigurując niestandardowe domeny dla e-maili uwierzytelniających, użytkownicy będą widzieć tę samą domenę dla Twojego adresu internetowego i e-maili służących do zarządzania użytkownikami.

Zasadniczo istnieją dwa kroki, aby to skonfigurować:

  • Dodaj domenę do swoich szablonów e-maili w konsoli Firebase.
  • Zweryfikuj swoją domenę, dodając rekordy DNS w rejestratorze domeny.

Dodanie domeny do szablonów e-maili

  1. W konsoli Firebase otwórz stronę Szablony w sekcji Uwierzytelnianie.

  2. Dla każdego szablonu wiadomości e-mail wykonaj następujące czynności:

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

Zobaczysz wówczas tabelę rekordów DNS, które należy dodać do rejestratora domeny, aby zweryfikować, czy domena jest Twoją własnością.

Zweryfikuj domenę

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

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

Weryfikacja domeny może zająć do 24 godzin. Gdy tak się stanie, strona Szablony w konsoli Firebase wyświetli zielony komunikat „Weryfikacja zakończona”. Następnie możesz kliknąć przycisk Zastosuj domenę niestandardową , aby zastosować zmiany.

Projekty dla wielu najemców

Jeśli dokonałeś aktualizacji do uwierzytelniania Firebase z platformą tożsamości i włączyłeś obsługę wielu dzierżawców , musisz zaktualizować metadane dzierżawcy , aby umożliwić dzierżawcy dziedziczenie niestandardowych domen, szablonów wiadomości e-mail i niestandardowych ustawień SMTP. W przeciwnym razie użytkownicy nadal będą otrzymywać e-maile z domeny domyślnej, nawet jeśli domena niestandardowa zostanie pomyślnie zweryfikowana i zastosowana.

Możesz sprawdzić, czy wielodostępność jest włączona, sprawdzając adres URL zawarty w wiadomościach e-mail uwierzytelniających. Jeśli adres URL zawiera parametr tenant , należy zaktualizować metadane dzierżawy projektu.

Aby to zrobić, uruchom następujące 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