העברת הכניסה באמצעות קישור לאימייל מקישורים דינמיים ב-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 בפלטפורמות של אפל כדי לעדכן את האפליקציה כך שתשתמש בדומיין ברירת המחדל החדש שהוקצה באופן אוטומטי Firebase Hosting.

כדי לטפל בקישורים מהדומיין החדש ולהנחות את 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.