אתם יכולים להשתמש באימות ב-Firebase כדי לאפשר למשתמשים להיכנס לחשבון באמצעות קישור שנשלח באימייל. במהלך התהליך, גם כתובת האימייל של המשתמש מאומתת.
יש הרבה יתרונות לכניסה באמצעות כתובת אימייל:
- הרשמה וכניסה בקלות.
- סיכון נמוך יותר לשימוש חוזר בסיסמאות באפליקציות שונות, שעלול לפגוע באבטחה גם של סיסמאות שנבחרו בקפידה.
- היכולת לאמת משתמש וגם לוודא שהוא הבעלים החוקי של כתובת אימייל.
- כדי להיכנס, המשתמשים צריכים רק חשבון אימייל נגיש. לא צריך להיות בעלים של מספר טלפון או חשבון ברשתות החברתיות.
- המשתמשים יכולים להיכנס לחשבון בצורה מאובטחת בלי להזין (או לזכור) סיסמה, מה שיכול להיות מסורבל במכשיר נייד.
- משתמש קיים שנכנס בעבר באמצעות מזהה אימייל (סיסמה או מאוחד) יכול לשדרג את הכניסה שלו כך שיוכל להיכנס באמצעות האימייל בלבד. לדוגמה, משתמש ששכח את הסיסמה שלו עדיין יכול להיכנס בלי לאפס את הסיסמה.
לפני שמתחילים
אתם יכולים להשתמש ב-Swift Package Manager כדי להתקין ולנהל את יחסי התלות של Firebase.
- ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
- כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
- בוחרים בספרייה Firebase Authentication.
- מוסיפים את הדגל
-ObjCלקטע Other Linker Flags (דגלים אחרים של מקשרים) בהגדרות ה-build של היעד. - אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם ברקע באופן אוטומטי.
https://github.com/firebase/firebase-ios-sdk.git
הפעלת כניסה באמצעות קישור באימייל בפרויקט Firebase
כדי לאפשר למשתמשים להיכנס באמצעות קישור באימייל, קודם צריך להפעיל את ספק האימייל ואת שיטת הכניסה לחשבון באמצעות קישור באימייל בפרויקט Firebase:
במסוף Firebase, נכנסים לאבטחה > אימות.
בכרטיסייה Sign-in method, מפעילים את ספק הכניסה Email/Password. שימו לב: כדי להשתמש בכניסה באמצעות קישור באימייל, צריך להפעיל את הכניסה באמצעות אימייל/סיסמה.
באותו קטע, מפעילים את הספק Email link (passwordless sign-in).
לוחצים על שמירה.
שליחת קישור אימות לכתובת האימייל של המשתמש
כדי להתחיל את תהליך האימות, מציגים למשתמש ממשק שמבקש ממנו לספק את כתובת האימייל שלו, ואז קוראים ל-sendSignInLink כדי לבקש מ-Firebase לשלוח את קישור האימות לכתובת האימייל של המשתמש.
יוצרים את האובייקט
ActionCodeSettings, שמספק ל-Firebase הוראות ליצירת הקישור לאימייל. מגדירים את השדות הבאים:
url: קישור העומק להטמעה וכל מצב נוסף שצריך להעביר. אם עדיין לא עשיתם את זה, הוסיפו את הדומיין שלכם לרשימת הדומיינים המורשים:במסוף Firebase, נכנסים לכרטיסייה Security > Authentication > Settings.
בקטע 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זמין בקטע העברת מצב בפעולות באימייל.מבקשים מהמשתמש את כתובת האימייל שלו.
שולחים את קישור האימות לכתובת האימייל של המשתמש ושומרים את כתובת האימייל של המשתמש למקרה שהוא ישלים את הכניסה באמצעות האימייל באותו מכשיר.
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 כברירת מחדל.
הגדרת Firebase Hosting דומיינים:
במסוף Firebase, נכנסים לקטע Hosting & Serverless > Hosting.
אם אתם רוצים להשתמש בדומיין שמוגדר כברירת מחדל לקישור לאימייל שנפתח באפליקציות לנייד, עברו לאתר שמוגדר כברירת מחדל ורשמו את דומיין Hosting שמוגדר כברירת מחדל. דומיין ברירת מחדל של Hosting נראה בדרך כלל כך:
.PROJECT_ID.firebaseapp.comתצטרכו את הערך הזה כשתגדירו את האפליקציה ליירט את הקישור הנכנס.
אם אתם רוצים להשתמש בדומיין מותאם אישית לקישור באימייל, אתם יכולים לרשום דומיין ב-Firebase Hosting ולהשתמש בו כדומיין של הקישור.
הגדרת אפליקציות של אפל:
תצטרכו להגדיר את הדומיין שבחרתם כדומיין משויך לקישורים לאפליקציה. כדי להגדיר את ההרשאה באפליקציה, פותחים את הכרטיסייה 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. }];
עם זאת, יכול להיות שהתהליך לא יושלם כי הוא עלול להסתיים במכשיר אחר שבו המשתמש המקורי לא מחובר. במקרה כזה, אפשר להציג למשתמש שגיאה כדי לאלץ אותו לפתוח את הקישור באותו מכשיר. אפשר להעביר מצב מסוים בקישור כדי לספק מידע על סוג הפעולה ועל מזהה המשתמש.
הוצא משימוש: אימות מבוסס-Firebase Dynamic Links
לפני גרסה 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; }
כדאי גם להוסיף קוד לטיפול בשגיאות לכל מגוון שגיאות האימות. מידע נוסף על טיפול בשגיאות