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

Jeśli w projekcie używasz domeny niestandardowej, rozważ też używanie jej w e-mailach wysyłanych na potrzeby zdarzeń uwierzytelniania, takich jak weryfikacja adresu e-mail, zmiana adresu czy odzyskiwanie hasła. Możesz skonfigurować projekt tak, aby używał Twojej domeny niestandardowej w polu From i linkach działań w e-mailach.

Gdy skonfigurujesz domeny niestandardowe na potrzeby e-maili do uwierzytelniania, użytkownicy będą widzieć tę samą domenę adresu internetowego i adresów e-mail do zarządzania użytkownikami.

Proces ten można skonfigurować w 2 krokach:

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

Dodawanie domeny do szablonów e-mail

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

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

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

Zobaczysz tabelę z rekordami DNS, które musisz dodać do rejestratora domeny, aby potwierdzić, że domena należy do Ciebie.

Potwierdź własność domeny

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

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

Weryfikacja domeny może potrwać do 24 godzin. Gdy weryfikacja się zakończy, na stronie Szablony w konsoli Firebase pojawi się zielony komunikat „Weryfikacja zakończona”. Następnie możesz kliknąć przycisk Zastosuj domenę niestandardową, aby zastosować zmiany.

Projekty z wieloma najemcami

Po przejściu na Uwierzytelnianie Firebase z Identity Platform i włączeniu wielu najemców musisz zaktualizować metadane najemcy, aby umożliwić mu dziedziczenie niestandardowych domen, szablonów e-maili 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 zweryfikowana i zastosowana.

Aby sprawdzić, czy środowisko wielu najemców jest włączone, sprawdź adres URL zawarty w e-mailach dotyczących uwierzytelniania. Jeśli adres URL zawiera parametr tenant, musisz zaktualizować metadane najemcy 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