אם אתם משתמשים בדומיין בהתאמה אישית בפרויקט, כדאי להשתמש בדומיין בהתאמה אישית גם באימיילים שנשלחים באירועי אימות, כמו אימות אימייל, שינוי כתובת ותהליכי שחזור סיסמה. אתם יכולים להגדיר את הפרויקט כך שישתמש בדומיין המותאם אישית בשדה From ובקישורי הפעולה של האימיילים.
אם תגדירו דומיינים מותאמים אישית לאימיילים של אימות, המשתמשים יראו את אותו דומיין בכתובת האינטרנט שלכם ובאימיילים לניהול המשתמשים.
באופן כללי, יש שני שלבים להגדרה:
- צריך להוסיף את הדומיין לתבניות האימייל במסוף Firebase.
- כדי לאמת את הדומיין, צריך להוסיף רשומות DNS ב-registar של הדומיין.
הוספת הדומיין לתבניות האימייל שלך
במסוף Firebase, פותחים את דף התבניות בקטע Authentication.
מבצעים את הפעולות הבאות לכל תבנית אימייל:
- לוחצים על סמל העריכה ().
- לוחצים על התאמה אישית של הדומיין.
- מזינים את הדומיין שבו רוצים להשתמש.
לאחר מכן תוצג טבלה של רשומות DNS שצריך להוסיף לרשם הדומיינים כדי לאמת שאתם הבעלים של הדומיין.
אימות הדומיין
מוסיפים או מעדכנים את רשומות ה-DNS מסוג TXT ו-CNAME שצוינו במסוף Firebase. התהליך לעשות זאת תלוי ברשם.
אפשר להגדיר רק רשומת TXT אחת מסוג v=spf1... לדומיין מסוים. אם
לציין כמה כתובות אימייל, לשלב אותן לרשומה אחת.
תהליך האימות של הדומיין עשוי להימשך עד 24 שעות. כשהאימות יושלם, תוצג הודעה ירוקה עם הכיתוב 'Verification complete' בדף Templates במסוף Firebase. לאחר מכן, תוכלו ללחוץ על הלחצן החלת דומיין מותאם אישית כדי להוסיף שהשינויים ייכנסו לתוקף.
פרויקטים מרובי דיירים (multi-tenant)
אם שדרגתם ל-Firebase Authentication with Identity Platform והפעלתם את האפשרות multi-tenancy, צריך לעדכן את המטא-נתונים של הדייר כדי לאפשר לדייר לקבל בירושה דומיינים מותאמים אישית, תבניות אימייל והגדרות SMTP בהתאמה אישית. אחרת, המשתמשים ימשיכו לקבל אימיילים מהדומיין שמוגדרת לו ברירת המחדל, גם אם הדומיין המותאם אישית מאומת ומוגדר בהצלחה.
כדי לבדוק אם ריבוי דיירים מופעל, אפשר לבחון את כתובת ה-URL שכלולה ב'אימות'
בהודעות אימייל. אם כתובת ה-URL כוללת את הפרמטר tenant, צריך לעדכן את המטא-נתונים של הדייר בפרויקט.
כדי לעשות זאת, מריצים את הפקודה הבאה:
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