שימוש בדומיין מותאם אישית להודעות אימות

אם אתם משתמשים בדומיין מותאם אישית בפרויקט, כדאי להשתמש בו גם באימיילים שנשלחים לאירועי אימות, כמו אימות כתובת אימייל, שינוי כתובת ותהליכי שחזור סיסמה. אתם יכולים להגדיר את הפרויקט כך שישתמש בדומיין המותאם אישית בשדה From ובקישורי הפעולה של הודעות האימייל.

אם תגדירו דומיינים מותאמים אישית לאימיילים לאימות, המשתמשים יראו את אותו דומיין בכתובת האינטרנט שלכם ובאימיילים לניהול משתמשים.

באופן כללי, יש שני שלבים להגדרה:

  • מוסיפים את הדומיין לתבניות האימייל במסוף Firebase.
  • מאמתים את הדומיין על ידי הוספה של רשומות DNS ברשם הדומיינים.

הוספת הדומיין לתבניות האימייל

  1. במסוף Firebase, נכנסים לכרטיסייה Security ‏> Authentication ‏> Templates.

  2. לכל תבנית אימייל, מבצעים את הפעולות הבאות:

    1. לוחצים על סמל העריכה ().
    2. לוחצים על דומיין מותאם אישית.
    3. מזינים את הדומיין שבו רוצים להשתמש.

לאחר מכן תופיע טבלה של רשומות DNS שצריך להוסיף לרשם הדומיינים כדי לאמת שאתם הבעלים של הדומיין.

אימות הדומיין

מוסיפים או מעדכנים את רשומות ה-TXT וה-CNAME של ה-DNS שמופיעות במסוף Firebase. התהליך לביצוע הפעולה הזו תלוי ברשם.

יכולה להיות רק רשומת TXT אחת של v=spf1... לדומיין מסוים. אם אתם צריכים לציין כמה כתובות אימייל, שלבו אותן ברשומה אחת.

תהליך אימות הדומיין יכול להימשך עד 24 שעות. כשהאימות יסתיים, בכרטיסייה Templates במסוף Firebase תופיע ההודעה Verification complete בירוק. לאחר מכן, לוחצים על הלחצן Apply Custom Domain כדי להחיל את השינויים.

פרויקטים עם כמה דיירים (multi-tenant)

אם שדרגתם ל-Firebase Authentication with Identity Platform והפעלתם ריבוי דיירים, אתם צריכים לעדכן את המטא-נתונים של הדייר כדי לאפשר לדייר לרשת דומיינים בהתאמה אישית, תבניות אימייל והגדרות 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