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
W konsoli Firebase otwórz kartę Zabezpieczenia > Uwierzytelnianie > Szablony.
W przypadku każdego szablonu e-maila wykonaj te czynności:
- Kliknij ikonę edycji ().
- Kliknij własna domena.
- 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