אימות עם Firebase באמצעות קישור אימייל בפלטפורמות של Apple

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

יש הרבה יתרונות לכניסה באמצעות כתובת אימייל:

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

לפני שמתחילים

אתם יכולים להשתמש ב-Swift Package Manager כדי להתקין ולנהל את יחסי התלות של Firebase.

  1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. בוחרים בספרייה Firebase Authentication.
  5. מוסיפים את הדגל -ObjC לקטע Other Linker Flags (דגלים אחרים של מקשרים) בהגדרות ה-build של היעד.
  6. אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם ברקע באופן אוטומטי.

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

  1. במסוף Firebase, נכנסים לאבטחה > אימות.

  2. בכרטיסייה Sign-in method, מפעילים את ספק הכניסה Email/Password. שימו לב: כדי להשתמש בכניסה באמצעות קישור באימייל, צריך להפעיל את הכניסה באמצעות אימייל/סיסמה.

  3. באותו קטע, מפעילים את הספק Email link (passwordless sign-in).

  4. לוחצים על שמירה.

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

  1. יוצרים את האובייקט ActionCodeSettings, שמספק ל-Firebase הוראות ליצירת הקישור לאימייל. מגדירים את השדות הבאים:

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

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

      2. בקטע Authorized domains, לוחצים על Add domain ומוסיפים את הדומיין.

    • ‫iOSBundleID ו-androidPackageName: עוזרים ל-Firebase Authentication לקבוע אם ליצור קישור לאינטרנט בלבד או קישור לנייד שנפתח במכשיר Android או Apple.
    • handleCodeInApp: מוגדר ל-true. בניגוד לפעולות אחרות שמתבצעות מחוץ לאפליקציה (איפוס סיסמה ואימות אימייל), את פעולת הכניסה תמיד צריך להשלים באפליקציה. הסיבה לכך היא שבסוף התהליך, המשתמש אמור להיות מחובר ומצב האימות שלו נשמר באפליקציה.
    • linkDomain: כשמגדירים דומיינים של קישורים בהתאמה אישית של Hosting לפרויקט, צריך לציין באיזה דומיין להשתמש כשהקישור נפתח על ידי אפליקציה ספציפית לנייד. אחרת, דומיין ברירת המחדל נבחר באופן אוטומטי (לדוגמה, PROJECT_ID.firebaseapp.com).
    • ‫dynamicLinkDomain: הוצא משימוש. אל תציינו את הפרמטר הזה.

    Swift

    let actionCodeSettings = ActionCodeSettings()
    actionCodeSettings.url = URL(string: "https://www.example.com")
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = true
    actionCodeSettings.setIOSBundleID(Bundle.main.bundleIdentifier!)
    actionCodeSettings.setAndroidPackageName("com.example.android",
                                             installIfNotAvailable: false, minimumVersion: "12")

    Objective-C

    FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
    [actionCodeSettings setURL:[NSURL URLWithString:@"https://www.example.com"]];
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = YES;
    [actionCodeSettings setIOSBundleID:[[NSBundle mainBundle] bundleIdentifier]];
    [actionCodeSettings setAndroidPackageName:@"com.example.android"
                        installIfNotAvailable:NO
                               minimumVersion:@"12"];

    מידע נוסף על ActionCodeSettings זמין בקטע העברת מצב בפעולות באימייל.

  2. מבקשים מהמשתמש את כתובת האימייל שלו.

  3. שולחים את קישור האימות לכתובת האימייל של המשתמש ושומרים את כתובת האימייל של המשתמש למקרה שהוא ישלים את הכניסה באמצעות האימייל באותו מכשיר.

    Swift

    Auth.auth().sendSignInLink(toEmail: email,
                               actionCodeSettings: actionCodeSettings) { error in
      // ...
        if let error = error {
          self.showMessagePrompt(error.localizedDescription)
          return
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        UserDefaults.standard.set(email, forKey: "Email")
        self.showMessagePrompt("Check your email for link")
        // ...
    }

    Objective-C

    [[FIRAuth auth] sendSignInLinkToEmail:email
                       actionCodeSettings:actionCodeSettings
                               completion:^(NSError *_Nullable error) {
      // ...
        if (error) {
          [self showMessagePrompt:error.localizedDescription];
           return;
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        [NSUserDefaults.standardUserDefaults setObject:email forKey:@"Email"];
        [self showMessagePrompt:@"Check your email for link"];
        // ...
    }];

בעיות אבטחה

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

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

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

השלמת הכניסה באפליקציה לנייד של אפל

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

הגדרה של Firebase Hosting

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

  1. הגדרת Firebase Hosting דומיינים:

    במסוף Firebase, נכנסים לקטע Hosting & Serverless > Hosting.

    • אם אתם רוצים להשתמש בדומיין שמוגדר כברירת מחדל לקישור לאימייל שנפתח באפליקציות לנייד, עברו לאתר שמוגדר כברירת מחדל ורשמו את דומיין Hosting שמוגדר כברירת מחדל. דומיין ברירת מחדל של Hosting נראה בדרך כלל כך: PROJECT_ID.firebaseapp.com.

      תצטרכו את הערך הזה כשתגדירו את האפליקציה ליירט את הקישור הנכנס.

    • אם אתם רוצים להשתמש בדומיין מותאם אישית לקישור באימייל, אתם יכולים לרשום דומיין ב-Firebase Hosting ולהשתמש בו כדומיין של הקישור.

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

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

    מידע נוסף זמין במאמר Supporting associated domains באתר התיעוד של Apple.

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

Swift

if Auth.auth().isSignIn(withEmailLink: link) {
        Auth.auth().signIn(withEmail: email, link: self.link) { user, error in
          // ...
        }
}

Objective-C

if ([[FIRAuth auth] isSignInWithEmailLink:link]) {
    [[FIRAuth auth] signInWithEmail:email
                               link:link
                         completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      // ...
    }];
}

במדריך ל-Android מוסבר איך מטפלים בכניסה באמצעות קישור באימייל באפליקציה ל-Android.

במדריך לאינטרנט מוסבר איך לטפל בכניסה באמצעות קישור באימייל באפליקציית אינטרנט.

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

ההבדל יהיה בחצי השני של הפעולה:

Swift

  let credential = EmailAuthCredential.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.link(with: credential) { authData, error in
    if (error) {
      // And error occurred during linking.
      return
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthProvider credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      linkWithCredential:credential
              completion:^(FIRAuthDataResult *_Nullable result,
                           NSError *_Nullable error) {
    if (error) {
      // And error occurred during linking.
      return;
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }];

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

Swift

  let credential = EmailAuthProvider.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.reauthenticate(with: credential) { authData, error in
    if (error) {
      // And error occurred during re-authentication.
      return
    }
    // The user was successfully re-authenticated.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthCredential credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      reauthenticateWithCredential:credential
                        completion:^(FIRAuthDataResult *_Nullable result,
                                     NSError *_Nullable error) {
    if (error) {
      // And error occurred during re-authentication
      return;
    }
    // The user was successfully re-authenticated.
  }];

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

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

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

אם יצרתם את הפרויקט ב-15 בספטמבר 2023 או אחרי התאריך הזה, ההגנה מפני ספירת כתובות אימייל מופעלת כברירת מחדל. התכונה הזו משפרת את האבטחה של חשבונות המשתמשים בפרויקט, אבל היא משביתה את השיטה fetchSignInMethodsForEmail(), שבעבר המלצנו להשתמש בה כדי להטמיע תהליכים שמתחילים בהזנת מזהה.

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

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

השלבים הבאים

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

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

  • בכללי האבטחה של Firebase Realtime Database ו-Cloud Storage, אפשר לקבל את מזהה המשתמש הייחודי של המשתמש המחובר מהמשתנה auth, ולהשתמש בו כדי לקבוע לאילו נתונים המשתמש יכול לגשת.

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

כדי להוציא משתמש מהחשבון, מפעילים את signOut:.

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

כדאי גם להוסיף קוד לטיפול בשגיאות לכל מגוון שגיאות האימות. מידע נוסף על טיפול בשגיאות