העברת הכניסה באמצעות קישור לאימייל מקישורים דינמיים ב-Firebase (iOS)

בעבר, אימות באמצעות קישור באימייל הסתמך על Firebase Dynamic Links, שייצא משימוש ב-25 באוגוסט 2025. פרסמנו פתרון חלופי ב-Firebase Authentication iOS SDK גרסה 11.8.0 ואילך. אם האפליקציה שלך משתמשת ב-Firebase Dynamic Links, כדאי להעביר את האפליקציה למערכת החדשה שמבוססת על Firebase Hosting.

העברת דומיין משויך Firebase Dynamic Links לדומיין Firebase Hosting

מעכשיו, במקום להשתמש בדומיין Firebase Dynamic Links, מערכת Firebase Authentication תשתמש בדומיין ברירת המחדל Firebase Hosting של הפרויקט כדי ליצור קישורים לפעולות שקשורות לקישורי אימייל ולקישורים אחרים מחוץ לפס באפליקציות לנייד. המשמעות היא שצריך לעדכן את האפליקציה כדי להשתמש בדומיין ברירת המחדל הזה כדומיין המשויך לקישורים לאימות אימיילים באפליקציה לנייד.

כדי לעדכן את האפליקציה כך שתשתמש בדומיין ברירת המחדל החדש Firebase Hosting שמוקצה באופן אוטומטי, אפשר לפעול לפי ההוראות במאמר אימות באמצעות קישור באימייל ב-Firebase בפלטפורמות של אפל.

כדי לטפל בקישורים מהדומיין החדש ולהנחות את Firebase Authentication להתחיל להשתמש בדומיין Firebase Hosting כדי ליצור קישורים לאפליקציות לנייד מעכשיו והלאה, פועלים לפי ההוראות הבאות.

אם אתם רוצים להמשיך להשתמש באחד מהדומיינים המותאמים אישית Firebase Hosting שלכם או אפילו בדומיין המותאם אישית Firebase Dynamic Links שלכם כדומיין המשויך החדש, אתם יכולים לפעול לפי ההוראות שבקטע התאמה אישית של קישורים לנייד ולהתאים את השלבים לדומיין שבו אתם רוצים להשתמש.

  1. מקשרים את הדומיין Firebase Hosting לדומיין המשויך לאפליקציה.

    תצטרכו להגדיר את הדומיין שנבחר כדומיין משויך לקישורי אפליקציות. כדי להגדיר את ההרשאה באפליקציה, פותחים את הכרטיסייה Signing & Capabilities (חתימה ויכולות) של היעד ב-Xcode ומוסיפים את הדומיינים Firebase Hosting מהשלב הקודם ליכולת Associated Domains (דומיינים משויכים). אם משתמשים בדומיין ברירת המחדל Firebase Hosting, זה יהיה applinks:PROJECT_ID.firebaseapp.com.

    מידע נוסף זמין במאמר בנושא תמיכה בדומיינים משויכים באתר מאמרי העזרה של Apple.

    קובץ של דומיין משויך נפרס בכל הדומיינים של Firebase Hosting. כדי לגשת אליו, עוברים אל PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. אפשר להחליף את קובץ ה-AASA. מידע נוסף זמין במאמר בנושא יצירה ואירוח של קובצי ההגדרות של הקישורים האוניברסליים.

  2. הגדרת הפרויקט לשימוש בקישורים החדשים.

    כשמוכנים לטפל בקישורי הדומיין החדשים, אפשר להשתמש ב-SDK של Firebase לאדמינים כדי לעדכן את אופן יצירת הקישורים לאימייל, ולהנחות את ה-בק-אנד שלנו להתחיל ליצור קישורים באמצעות הדומיין החדש Firebase Hosting.

    import { getAuth } from 'firebase-admin/auth';

const updateEmailAuthDomain = async () => {
    const updateRequest = {
        mobileLinksConfig: {
            domain: 'HOSTING_DOMAIN',
        },
    };

    const projectConfigManager = getAuth().projectConfigManager();

    try {
        const response = await projectConfigManager.updateProjectConfig(updateRequest);
        // Updated project config
        console.log('Project configuration updated successfully:', response);
    } catch (error) {
        console.error('Error updating the project:', error);
    }
};

  3. שליחה ומימוש של הקישור באימייל.

    שולחים את הקישור לכניסה לחשבון באימייל כמו קודם. כשמשתמש קצה לוחץ על הקישור, הוא מופנה לאפליקציה אם היא מותקנת במכשיר שלו, כדי להשלים את הכניסה.

אתם יכולים להשתמש בFirebase Hostingדומיין מותאם אישית או לעשות שימוש חוזר בדומיין המותאם אישית Firebase Dynamic Linksכדי להגדיר אותו כדומיין החדש של הקישורים לנייד.

שימוש בדומיין מותאם אישית Firebase Hosting

  1. כדי להגדיר דומיין מותאם אישית, פועלים לפי ההוראות במדריך של Firebase Hosting.
  2. מקשרים את הדומיין המותאם אישית לדומיין שמשויך לאפליקציה.
  3. שליחת קישור לאימות לכתובת האימייל של המשתמש עם אובייקט ActionCodeSettings מעודכן עם דומיין בהתאמה אישית בתור linkDomain.
  1. אתם יכולים להשתמש מחדש בכל אחד מהדומיינים שלכם ב-Firebase Dynamic Links בתור דומיין מותאם אישית. עם זאת, לא תהיה יותר תמיכה בפונקציונליות של Firebase Dynamic Links (לדוגמה, אי אפשר יהיה להפנות משתמשים לחנות האפליקציות אם האפליקציה לא מותקנת במכשיר שלהם).
  2. שליחת קישור לאימות לכתובת האימייל של המשתמש עם אובייקט ActionCodeSettings מעודכן עם דומיין בהתאמה אישית בתור linkDomain.