Jika menggunakan domain kustom di project Anda, pertimbangkan juga untuk menggunakan domain kustom di email yang dikirim untuk peristiwa autentikasi, seperti verifikasi email, perubahan alamat, dan alur pemulihan sandi. Anda dapat mengonfigurasi project agar menggunakan domain kustom di link tindakan dan kolom From email.
Dengan mengonfigurasi domain kustom untuk email autentikasi, pengguna akan melihat domain yang sama untuk alamat web dan email pengelolaan pengguna.
Ada dua langkah umum untuk menyiapkannya:
- Tambahkan domain ke template email di Firebase console.
- Verifikasi domain dengan menambahkan data DNS di registrar domain Anda.
Menambahkan domain ke template email
Di Firebase console, buka halaman Templates di bagian Authentication.
Untuk setiap template email, lakukan hal berikut:
- Klik ikon edit ().
- Klik customize domain.
- Masukkan domain yang ingin digunakan.
Kemudian, Anda akan melihat tabel data DNS untuk ditambahkan ke registrar domain guna memverifikasi bahwa Anda adalah pemilik domain tersebut.
Memverifikasi domain
Tambahkan atau perbarui data DNS TXT dan CNAME yang diberikan di Firebase console. Prosedur untuk melakukannya bergantung pada registrar.
Anda hanya dapat memiliki satu data TXT v=spf1... untuk domain tertentu. Jika perlu menentukan beberapa alamat email, gabungkan ke dalam satu data.
Perlu waktu hingga 24 jam agar domain diverifikasi. Jika verifikasi domain selesai, halaman Templates di Firebase console akan menampilkan pesan "Verification complete" berwarna hijau. Kemudian, Anda dapat mengklik tombol Apply Custom Domain untuk menerapkan perubahan.
Project multi-tenant
Jika Anda telah mengupgrade ke Firebase Authentication dengan Identity Platform dan mengaktifkan multi-tenancy, Anda perlu mengupdate metadata tenant agar tenant mewarisi domain kustom, template email, dan setelan SMTP kustom. Jika tidak, pengguna masih akan menerima email dari domain default meskipun domain kustom berhasil diverifikasi dan diterapkan.
Anda dapat memeriksa apakah multi-tenancy diaktifkan dengan memeriksa URL yang disertakan dalam pesan email Auth. Jika URL menyertakan parameter tenant, Anda perlu memperbarui metadata tenant project Anda.
Untuk melakukannya, jalankan perintah berikut:
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