מצב ההעברה בפעולות באימייל

אזהרה: שלוש התכונות הבאות של Firebase Authentication מושפעות מההשבתה של Firebase Dynamic Links ב-25 באוגוסט 2025: אימות קישור באימייל לאפליקציות לנייד, תהליכי OAuth לאפליקציות ל-Android שמשתמשות בגרסאות ישנות יותר של ה-SDK של Authentication ותמיכה ב-Cordova OAuth לאפליקציות אינטרנט. כדי להשתמש בתכונות האלה אחרי סגירת Dynamic Links, צריך לעבור לשימוש בגרסה חדשה יותר של ה-SDK ולבצע כמה שלבים נוספים.

למידע ספציפי ולהנחיות להעברה, אפשר לעיין בDynamic Linksשאלות נפוצות בנושא הוצאה משימוש.

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

האפשרות הזו יכולה להיות שימושית מאוד בתרחישים הנפוצים הבאים:

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

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

• במקרים אחרים, יכול להיות שהמשתמש התחיל את התהליך מהמכשיר הנייד, ומצפה לחזור לאפליקציה לנייד אחרי האימות במקום לדפדפן.

היכולת להעביר מצב באמצעות כתובת URL להמשך היא תכונה חזקה ש-Firebase Auth מספק, ויכולה לשפר משמעותית את חוויית המשתמש.

העברת המצב של כתובת URL להמשך בפעולות באימייל

כדי להעביר בצורה מאובטחת כתובת URL להמשך, צריך להוסיף את הדומיין של כתובת ה-URL כדומיין מורשה במסוף Firebase. כדי לעשות זאת, מוסיפים את הדומיין הזה לרשימת הדומיינים המורשים בכרטיסייה שיטת הכניסה בקטע אימות, אם הוא לא מופיע שם כבר.

צריך לספק מכונה של firebase.auth.ActionCodeSettings כששולחים אימייל לאיפוס סיסמה או אימייל לאימות. הממשק הזה מקבל את הפרמטרים הבאים:

פרמטר	סוג	תיאור
url	מחרוזת	הגדרת הקישור (כתובת ה-URL של המצב/המשך) שיש לו משמעויות שונות בהקשרים שונים: כשהמערכת מטפלת בקישור בווידג'טים של פעולות באינטרנט, זהו קישור העומק בפרמטר השאילתה continueUrl. כשהקישור מטופל ישירות באפליקציה, זהו פרמטר השאילתה continueUrl בקישור העומק של הקישור Hosting.
iOS	({bundleId: string}|undefined)	הגדרת מזהה החבילה ל-iOS כדי לעזור ל-Firebase Authentication לקבוע אם צריך ליצור קישור לאינטרנט בלבד או קישור לנייד שייפתח במכשיר של Apple
android	({packageName: string, installApp:boolean|undefined, minimumVersion: string|undefined}|undefined)	הגדרת שם החבילה ל-Android כדי לעזור ל-Firebase Authentication לקבוע אם ליצור קישור לאינטרנט בלבד או קישור לנייד שייפתח במכשיר Android
handleCodeInApp	(boolean|undefined)	אם קישור הפעולה באימייל ייפתח קודם באפליקציה לנייד או בקישור לאינטרנט. ברירת המחדל היא false. אם הערך של הפרמטר הזה מוגדר כ-True, הקישור לקוד הפעולה יישלח כקישור אוניברסלי או כקישור לאפליקציה ל-Android, והאפליקציה תפתח אותו אם היא מותקנת. במקרה של תוצאה שלילית, הקוד יישלח קודם לווידג'ט האינטרנט, ואז המשך הפנייה תוביל לאפליקציה אם היא מותקנת.
linkDomain	(string|undefined)	כשמגדירים דומיינים מותאמים אישית של קישורי Hosting לפרויקט, צריך לציין באיזה מהם להשתמש כשהקישור ייפתח על ידי אפליקציה ספציפית לנייד. אחרת, דומיין ברירת המחדל ייבחר באופן אוטומטי (לדוגמה, PROJECT_ID.firebaseapp.com).
dynamicLinkDomain	(string|undefined)	הוצא משימוש. אין לציין את הפרמטר הזה.

הדוגמה הבאה ממחישה איך לשלוח קישור אימות באימייל שייפתח קודם באפליקציה לנייד באמצעות הדומיין המותאם אישית Hosting‏custom-domain.com. קישור העומק יכיל את עומס העבודה של כתובת ה-URL להמשך https://www.example.com/?email=[e-mail].

const actionCodeSettings = {
  url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
  iOS: {
    bundleId: 'com.example.ios'
  },
  android: {
    packageName: 'com.example.android',
  },
  handleCodeInApp: true,
  // Specify a custom Hosting link domain to use. The domain must be
  // configured in Firebase Hosting and owned by the project.
  linkDomain: "custom-domain.com"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
  .then(function() {
    // Verification email sent.
  })
  .catch(function(error) {
    // Error occurred. Inspect error.code.
  });

הגדרת קישורים ל-Firebase Hosting

Firebase Authentication משתמש ב-Firebase Hosting כששולחים קישור שמיועד לפתיחה באפליקציה לנייד. כדי להשתמש בתכונה הזו, צריך להגדיר קישורי אירוח במסוף Firebase.

1. הגדרת אפליקציות ל-Android:

   1. אם אתם מתכננים לטפל בקישורים האלה מאפליקציית Android, עליכם לציין את שם החבילה של האפליקציה בהגדרות הפרויקט במסוף Firebase. בנוסף, צריך לספק את SHA-1 ו-SHA-256 של אישור האפליקציה.
   2. תצטרכו גם להגדיר את מסנן הכוונה לקישור העומק בקובץ AndroidManifest.xml.
   3. מידע נוסף זמין במאמר קבלת הוראות לקישור לאירוח ב-Android.

2. הגדרת אפליקציות ל-iOS:

   1. אם אתם מתכננים לטפל בקישורים האלה מאפליקציית iOS, תצטרכו להגדיר את הדומיין של הקישור Hosting כדומיין משויך ביכולות של האפליקציה.
   2. מידע נוסף זמין במאמר קבלת הוראות לקישור לאירוח ב-iOS.

טיפול בפעולות אימייל באפליקציית אינטרנט

אתם יכולים לציין אם אתם רוצים לטפל בקישור לקוד הפעולה מאפליקציית אינטרנט ואז להפנות אוטומטית לדף אינטרנט אחר או לאפליקציה לנייד אחרת אחרי השלמת הפעולה, בתנאי שהאפליקציה לנייד זמינה. כדי לעשות זאת, מגדירים את handleCodeInApp לערך false באובייקט firebase.auth.ActionCodeSettings. אין צורך במזהה החבילה של iOS או בשם החבילה של Android, אבל אם תספקו אותם, המשתמש יוכל לקבל הפניה לאפליקציה שציינתם אחרי השלמת קוד הפעולה באימייל.

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

במקרה כזה, הקישור בפרמטר השאילתה continueUrl יהיה קישור אירוח, וערך העומס שלו יהיה URL שצוין באובייקט ActionCodeSettings.

כשמטפלים בפעולות אימייל כמו אימות אימייל, צריך לנתח את קוד הפעולה מתוך הפרמטר של השאילתה oobCode מהקישור העומק, ואז להחיל אותו דרך applyActionCode כדי שהשינוי ייכנס לתוקף, כלומר האימייל יאומת.

טיפול בפעולות אימייל באפליקציה לנייד

אתם יכולים לציין אם אתם רוצים לטפל בקישור של קוד הפעולה באפליקציה לנייד קודם, בתנאי שהיא מותקנת. אם הקישור נלחץ ממכשיר שלא תומך באפליקציה לנייד, הוא נפתח בדף אינטרנט במקום זאת. כדי לעשות זאת, מגדירים את handleCodeInApp לערך true באובייקט firebase.auth.ActionCodeSettings. צריך לציין גם את שם החבילה של האפליקציה לנייד ב-Android או את מזהה החבילה של האפליקציה ל-iOS.

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

במקרה כזה, הקישור לאפליקציה לנייד שיישלח למשתמש יהיה קישור Hosting, ועומס התעבורה שלו יהיה כתובת ה-URL של קוד הפעולה שהוגדרה במסוף, עם הפרמטרים של השאילתה oobCode, ‏ mode, ‏ apiKey ו-continueUrl. הערך השני יהיה הערך המקורי של URL שצוין באובייקט ActionCodeSettings. אפשר להחיל את קוד הפעולה ישירות מאפליקציה לנייד, בדומה לאופן שבו הוא מטופל בתהליך האינטרנט שמתואר בקטע התאמה אישית של שירותי אימייל.

כשמטפלים בפעולות אימייל כמו אימות אימייל, צריך לנתח את קוד הפעולה מפרמטר השאילתה oobCode מקישורי העומק, ואז להחיל אותו דרך applyActionCode כדי שהשינוי ייכנס לתוקף, כלומר האימייל יאומת.